Command-line Options

To start WAVE , open a terminal window and type into it:

wave -r record options ...

In most cases, record is a single record name; you may, however, name several records to be opened by concatenating their names with + between them, as in `tt wave -r 100+101+102 -a atr', which opens records 100, 101, and 102, each in its own signal window. Note that there must be no spaces around the `+' characters (the list of records should appear as a single command-line argument without embedded spaces).

If the -r record arguments are omitted, WAVE simply prints a summary of its command-line syntax in the terminal window.

The options may include any of these, in any order:

-a annotator
Open the specified annotation file for record. If this file does not exist, it will be created once you insert an annotation.

-dpi xx [xyy ]
Calibrate WAVE for use with a display having a resolution of xx (by yy) dots per inch.

-f time
Open the record beginning at the specified time.

-g
Use shades of grey only, even on a color monitor.

-H
Operate in ``high-resolution'' mode when reading multi-frequency records.

-m
Use monochrome (usually black and white) only, even on a color or greyscale monitor. The line styles selected by the -m option may be easier to distinguish on some greyscale monitors than the default shades of grey.

-O
Use overlay graphics for maximum speed and display quality if possible. This is the usual default if the X server supports a PseudoColor or GrayScale visual. This option exists only to force use of overlay graphics if a different mode has been chosen as the default.

-s signal [ signal ... ]
Initialize the signal list. By default, the signal list includes all available signals, in numerical order.

-S
Use the standard (shared) color map, even if is possible to modify the color map. Using this option conserves color resources if you have other applications that use non-standard colors, at a small (possibly unnoticeable) expense of some speed in redrawing the display. The -S option may be used in combination with the -g option if desired.

The following group of options can be used to enable the optional display elements normallly chosen in the View window.

-Vs
Display annotation subtyp fields.

-Vc
Display annotation chan fields.

-Vn
Display annotation num fields.

-Va
Display annotation aux fields. (This is the default for annotations such as rhythm changes and comments; selecting this option causes aux fields to be displayed for all annotations, and also causes the annotation mnemonics to be displayed for rhythm changes, comments, etc.)

-Vm
Display annotation marker bars.

-VN
Display signal names along the left edge of the signal window.

-Vb
Display baselines for any DC-coupled signals, and label the zero levels and the units along the right edge of the signal window.

-Vl
While the pointer is in the signal window and any mouse button is depressed, track the intersections of the marker bar with the signals and draw horizontal marker bars across the signal window at the levels of these intersections.

The final group of options allows you to select the initial choices from the menu buttons in the View window. Each of these options should be followed by a numeric argument that matches the position of the desired choice in the menu, where the top item on each menu is in position 0, the one below it is in position 1, etc. For example, to set the initial amplitude scale to 5 mm/mV (the item at position 2 in the Amplitude scale menu), add -Vv 2 to the command line.

-Vt n
Set the time scale (0: 0.25 mm/hour, 1: 1 mm/hour, 2: 5 mm/hour, 3: 0.25 mm/min, 4: 1 mm/min, 5: 5 mm/min, 6: 25 mm/min, 7: 50 mm/min, 8: 125 mm/min, 9: 250 mm/min, 10: 500 mm/min, 11: 12.5 mm/sec, 12: 25 mm/sec (default), 13: 50 mm/sec, 14: 125 mm/sec, 15: 250 mm/sec, 16: 500 mm/sec, 17: 1000 mm/sec, 18: 2000 mm/sec, 19: 5000 mm/sec, 20: 10 mm/ms, 21: 20 mm/ms, 22: 50 mm/ms, 23: 100 mm/ms, 24: 200 mm/ms, 25: 500 mm/ms).

-Vv n
Set the amplitude scale (0: 1 mm/mV, 1: 2.5 mm/mV, 2: 5 mm/mV, 3: 10 mm/mV (default), 4: 20 mm/mV, 5: 40 mm/mV, 6: 100 mm/mV).

-VS n
Set the choice on the Draw menu (0: all signals (default), 1: listed signals only).

-VA n
Set the choice on the Show annotations menu (0: centered (default), 1: attached to signals, 2: as a signal).

-VT n
Set the choice on the Time display menu (0: elapsed (default), 1: absolute, 2: in sample intervals).

-VG n
Set the choice on the Grid menu (0: none, 1: 0.2 s, 2: 0.5 mV, 3: 0.2 s x 0.5 mV, 4: 0.04 s x 0.1 mV).

WAVE also accepts generic XView options, including the -default and -xrm options for setting X11 resources.



Subsections
George B. Moody (george@mit.edu)
2019-03-08