Events analysis

Average event

Analysis

Following events analysis an average event may be generated and analyzed. To generate an average event, click the Average All Events button in the Analyze Events popup window (for both Template Matching and Thresholding analysis).

Generate an Average Event

Average Event Analysis. Following event detection, an average event can be generated and its kinetics calculated. Average event data can be copied or saved, and results displayed in a table.

To generate an average event, a point on each event is chosen to align (Peak, Rise half-width, or Baseline). The data around this point is windowed and displayed in the Average Events window. If a window around an event extends further than the limits of the data, the event is excluded from analysis. This means that events to the extreme edge of the record are not included.

Click Copy Event to Clipboard and Save Average Event to copy or save (to .xlsx or .csv) the displayed data, respectively.

The averaged event can be filtered prior to analysis with the Filter (Hz) box (8th order Bessel). The averaged event can also be normalized using ScaleAmplitude to 1 and ShiftDemean.

Analyze the Average Event

Click the Find Peak and Calculate Event Kinetics button to start Average Event analysis. This will bring up a region on the plot that defines the analysis space.

The dropdown box to the right of the Calculate Kinetics button can be used to set the baseline detection method. Set Auto. for automatic baseline detection, or Use Baseline to manually set the baseline. If Use Baseline is selected, a baseline region will appear and can be moved to set the baseline for the data (This is analogous to the Linear baseline during event detection).

To fit a biexponential function to the average event and calculate the kinetics on the function, select Fit biexponential curve, calculate kinetics on fit. The region displayed on the graph can be used to define the fit start and end points.

The results of average event analysis can be viewed by clicking Display Results Table and copied to the clipboard with the mouse and keyboard.

Events overlay

The Events Overlay window displays all detected events on the same plot, providing a convenient way to find and remove outliers.

Events Overlay can be opened (after event detection has been performed) by clicking the Overlay button on the Events Analyze window. All detected events are shown overlaid on the plot in black. The display of the overlaid events can be adjusted with the Alignment method and Window size (ms) settings:

  • Alignment method determines the point of the event used for alignment (e.g. the event peak).

  • Window size (ms) controls the size of the window used to display the events (the displayed period prior to the peak is fixed, this setting controls the window from the peak to the right edge of the data).

The Selected Event and Average Event

In the Events Overlay window, the currently selected individual event is shown in blue. When the window first opens, the individual event mode is set to Selected. Clicking the left or right arrow buttons in Selected mode will scroll through all events in numerical order. Changing the selected event through the Events Overlay window also scrolls through the individual events shown on the Events Analysis window, and vice versa.

Events Overlay. All detected events are overlaid in black. The selected event is shown in blue in Most Distant mode and has the greatest L2 distance from the average event.

Alternatively, individual events can be scrolled through in Most Distant mode. The selected event will become the most distant event; here, distance is measured as the L2 norm from the average of all events. Clicking the left or right buttons will scroll through selected events based on their distance (in the order most to least distant). This can be a very useful way to detect and remove outlier events.

Further, individual events can be selected by clicking on them directly on the plot.

To remove an event from the analysis the Del. button can be clicked on the Events Overlay window or the Delete keyboard button pressed. The currently selected event will be removed from all analyses.

The average of all detected events can be displayed instead of the currently selected event by clicking Show Average Event. Then, clicking Analyze Average Event will open the analyze event dialog window, allowing analysis of the average event kinetics. This provides the possibility to shift and scale individual events prior to analysis of the average event.

Shift and scale

The Shift and Scale options shift (add a constant) and scale (multiply by a constant) the individual events prior to presentation. When shift and scale operations are applied to data, scale operations are applied prior to shift operations.

Shift

  • Demean – The mean of the event is subtracted (so the mean of the event becomes zero).

  • Aligned param to zero – The parameter used to align the events (e.g. rise half-width) is subtracted from the event (so that the aligned parameter value becomes zero).

  • First sample to zero – The first datapoint value of the event is subtracted (so the first sample of the event is zero).

Scale

  • Amplitude to 1 – The event is multiplied by a constant such that the amplitude (from most negative to most positive sample) becomes 1.

  • Std. Dev. to 1 – The event is multiplied by a constant such that the standard deviation of the event becomes 1.

Note that the shift and scale operations are identical to those in the Average Event window.

Cumulative probability and histograms

Frequency data (as Histograms or Cumulative Probabilities) for all analyzed parameters can be calculated by selecting the check boxes on the Events Table tab.

To specify how the frequency data is calculated click OptionsEvents. In the Frequency Data section it is possible to select Cumulative Probability or Histogram format. Clicking More Options will provide options for binning. These options will come into effect from the next analysis run (that is, re-run the analysis for the new options to take effect).

In the More Options window, the binning method can be selected from the top drop-down menu. If Auto., the maximum of the Sturges or Freedman-Diaconis Estimation methods is used, as implemented in the NumPy method histogram_bin_edges(). In some instances, depending on the scaling and units of the data, this will erroneously return a very large number of bins – in this case the square root method is used instead.

Alternatively, the number of bins can be set manually (Custom Bin number), the size of the bins in the units of the relevant parameter can be set (Custom Bin Size) or the number of bins can be a function of the total number of events (total number of events divided by). Finally, the bin edges can be chosen as Bin Centre, Left Edge, or Right Edge from the X axis display drop-down menu.

For example, for bins spanning \(0\)\(1\), \(1\)\(2\), and \(2\)\(3\), the x-axis values are:

  • Bin Centre\(0.5\), \(1.5\), \(2.5\)

  • Left Edge\(0\), \(1\), \(2\)

  • Right Edge\(1\), \(2\), \(3\)

Events Frequency Plots. Cumulative probability and histogram plots of decay-time frequency data. Line and fill colour, line thickness, marker size, axis limits, and grid lines can be customized.

Note that when calculating inter-event interval for multi-record files, the IEI between the last event of a record and first event of the following record will be ignored unless records are time-contiguous.

By default, frequency data is sorted on the table by value (e.g. smallest to largest amplitude). To sort by event number, right click the table header and select Sort by Event Num.. At the bottom of the result table, the summary statistics for each column are shown.

Frequency Data Plots

On the table tab, clicking Plot Frequency Data will bring up the events frequency plots. Note that changing any of these options only changes the current display of the plot and not how the data is binned and presented in the table.

The data can be displayed as a histogram or cumulative probability plot, and any event parameter selected for display. If analysis is run in Batch Mode, any analyzed file can be selected for display. Finally, clicking Plot Options allows customization of the plot, including removing the gridlines, setting marker and line color, size and X axis limits.