Event Database

This section contains information on how to use the EventDatabase generated by the program.

Structure (1)

The event database generated by the program is an array (vector) of structures. A structure is a data type that groups related data using data containers called fields. Each field can contain data of any type or size. Such types of variables are very readable and the desired information can be found very quickly.

Structure (2)

Double-click on the EventDatabase variable opens the variable editor. Each field in this array corresponds to one event. The row number is thus the number of the event as it occured in the raw signal.

Structure (3)

Another double click on one of the structure-fields reveals the informations about the given event.

Informations available

  1. AllLevelFits: A vector containing the values of the fit. Please note that all these values are relative to the baseline before the event and do not reflect the actual current drop. Level information on the absolute current drop can be found in the Levels category.
  2. ConcatenatedStartCoordinates: This value is the location of the event in the corresponding concatenated signal.
  3. EventType: The type of the event is stored in this variable. This is either 'Standard Event', 'Too many levels', 'Impulsion'or'Impulsion not detected by CUSUM'.
  4. Levels: This variable contains the most important informations. It recapit- ulates the informations about each level of the event. This variable is a matrix which contains in its rows the different levels of the event. The columns give the following information: [LevelNumber, Relative Fit, Absolute Fit, Start-Point, End-Point, Length of Level]
  5. NumberOfLevels: The number of levels this event contains
  6. StartAndEndPoint: Contains the location of the event in the raw signal.
  7. AreaCoulob: The area of the event (integration of the raw signal)

Show all the information about one event

The command EventDatabase(i), where i is the desired event number, displays all the fields of this structure.

Show specific informations

The command EventDatabase(i).Fieldname gives direct access to the desired information. Remember Fieldname has to be one of the variables specified before.

Combine several events

The command a=[{EventDatabase.Levels}]' exports the level informations of all the events to the variable a. If you want to export only a fraction of the events, you can use: a=[{EventDatabase(1-10).Levels}]', which in this case exports only events 1 to 10. The same syntax applies to other fields.

Convert to single matrix

The command cell2mat(a) can convert the before created cell array to one single matrix containing the level informations of all the events. Conversion to a single matrix is only possible for fields with constant row-size, i.e. all the fields except 'AllLevelFits' and 'EventType'.

Previous Page: Using the Scripts Table of Contents Next Page: List of Available Functions