BURSTAREAS

Section: User Commands (1)
Updated:
Index
Return to Main Contents
 

NAME

burstareas - calculate area under curve for bursts in run  

SYNOPSIS

burstareas [-c wfnum] [-d cols] [-f c] [-h] runfile ...  

DESCRIPTION

Burstareas calculates the area under the burst amplitude curve for waveform activity bursts in the specified runfiles.

The runfile arguments specify one or more run file names to be measured. There is no default file, so at least one runfile must be specified. The output appears on the standard output, which will generally be redirected to a .csv file.  

Options

-c wfnum
specifies the waveform number for the marked up bursts or a list of waveform numbers separated by commas (default is 0).
-d cols
specifies the data columns to be included in the output, by letter name for each column: S=start, E=end, B=burst duration, C=cycle duration, M=mean amplitude, A=area, P=peak amplitude (default is SEMA, for start, end, mean, area).
-f c
specifies an alternate field separator "c" to be used instead of the default comma ",".
-h
specifies that headings should appear above the columns and run file names appear above those column headings (default is to output only the numbers).

Output will, by default, be of the form:

Start,End,Mean-ampl.,Area

but other columns can be specified using the -d option as shown above. The start and end times indicate where each burst occurred in the run. The cycle and burst durations are calculated from the start and end values, with burst duration as end-start, and cycle duration as next-current start. For the last burst, the cycle duration is given as the burst duration, as there is no next start time to use for this calculation. The time units are as selected in the analysis parameters for the run (typically seconds or ms, which is the default). The mean amplitude will be as calibrated or as selected in the analysis parameters (typically mV), and the area will be as a product of the time and amplitude units (typically mV x s or mV x ms).

The peak amplitude is determined as a peak to peak value within the entire cycle for each burst, i.e. maximum - minumum level from the start of the burst to the start of the next burst (or end of the last burst). Because the cycle duration and peak amplitude measurements depend on whole cycles, you may want to ignore the value given for these at the last burst in any given waveform.  

EXAMPLE

burstareas -c 7,8 -d CBPA aojedro4damp02 > aoje4d2w78cbpa.csv
Exports the cycle duration, burst duration, peak amplitude and area under the burst amplitude curve for waveforms 7 and 8.
 

FILES

*.frm  frame file containing run header

*.w??  waveform files
 

SEE ALSO

analysis(1), wfampls(1)
 

Index

NAME
SYNOPSIS
DESCRIPTION
Options
EXAMPLE
FILES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 20:21:25 GMT, November 21, 2017
Copyright © G. R. Detillieux, Spinal Cord Research Centre, The University of Manitoba.