RAWWFPLT

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

NAME

rawwfplt - generate a series of raw waveform plot files  

SYNOPSIS

rawwfplt [-g gifopts] [-s start] [-e end] [-f fps] [-l length] [-W 'wflist'] runfile [outname]  

DESCRIPTION

Rawwfplt creates a series of HPGL plot files, or GIF images, that can be used as frames for an animated movie of the plotting of raw waveforms over time. The runfile argument, which must be specified, gives the name of the run file or analysis parameter file for the run of data to be plotted. The outname specifies the first file name in the series of plot files or image files. The number in that name will be incremented for subsequent frames. A maximum of 10000 plot or image files will be generated, so 4 digits in the file name will ensure correct sorting of output files by name. The default name is raww0000.plt for HPGL output, or raww0000.gif for GIF output.  

Options

-g
Specifies that you want the HPGL plot files converted to GIF images. This can be followed by options to hpgl2gif(1), if desired, to set size and colours. Also, if valid hpgl2gif options are given without the -g option, this option is assumed.
-s start
Specifies the start time in the runfile, in seconds (default is 0). Note that the start time, as well as the end and length arguments below, must be specified in seconds, and unit specifiers are not allowed after the numbers. This is unlike the analysis program and some other analysis scripts where time values are generally specified in ms with an optional unit specifier to override the default.
-e end
Specifies the end time (i.e. the start time of the last frame), in seconds (default is the end of the runfile).
-f fps
Specifies the frame rate, in plot files per second of data (default is 10). Note that in the context of this program, the term frame refers to an output plot or image in a series, and not the frames that make up the triggered traces in the runfile.
-l length
Specifies the length of data per frame, in seconds (default is 1). The purpose of this option is to display more data in a frame than occurs in the time-scale of a single frame. This has the effect of having the waveform data progressively appearing from left to right in the frame, until the frame is filled, and then scrolling left as more of the waveforms are shown. For example, in the default case of 10 frames per second with 1 second of data per frame, you will see the waveforms building up from left to right in the first 11 frames (the first will not show any waveform data), and in subsequent frames they will shift over to the left by 10% (or 100 ms of data) to reveal the next 100 ms slice of the waveforms.
-W 'wflist'
Specifies the list of waveforms to be plotted. This list must appear as a single argument, so it should be quoted or it should be written without any space characters in it. Note also that the W option is capitalized to distinguish it from the -w option which specifies the image width for hpgl2gif. By default, the "Raw W.F. # list" in the runfile's parameters will be used for the list of waveforms to plot, and if no analysis parameters are set, then all waveforms in the runfile are plotted.
--help
Causes the program to output a summary of command usage and options.
 

FILES

rawwnnnn.plt   default output HPGL plot files

rawwnnnn.gif   default output GIF image files
 

SEE ALSO

analysis(1), hpgl2gif(1)
 

Index

NAME
SYNOPSIS
DESCRIPTION
Options
FILES
SEE ALSO

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