# file: wave.info	G. Moody	21 August 1990#			Last revised:  16 September 2002	WAVE 6.5# XView spot help file for `wave'## -----------------------------------------------------------------------------# WAVE: Waveform analyzer, viewer, and editor# Copyright (C) 2002 George B. Moody## This program is free software; you can redistribute it and/or modify it under# the terms of the GNU General Public License as published by the Free Software# Foundation; either version 2 of the License, or (at your option) any later# version.## This program is distributed in the hope that it will be useful, but WITHOUT# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS# FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more# details.## You should have received a copy of the GNU General Public License along with# this program; if not, write to the Free Software Foundation, Inc., 59 Temple# Place - Suite 330, Boston, MA 02111-1307, USA.## You may contact the author by e-mail (george@mit.edu) or postal mail# (MIT Room E25-505A, Cambridge, MA 02139 USA).  For updates to this software,# please visit PhysioNet (http://www.physionet.org/).# _____________________________________________________________________________:file:%sec:file-menu%This button opens a pull-down menu containingselections for loading, saving, printing,analyzing, and logging database files.# :file.load:%sec:load-window%This selection pops up a window in which youcan enter a new record or annotator name, orchange the name of the WFDB calibrationfile or the value of the WFDB path within thiswindow.#:file.load.recordSpecifies the name of the record to be viewed.The initial value of this field is the name of therecord that you specified on the command line.To view another record, select this field andenter another record name.Your edits, if any, are saved automaticallywhenever you change records.  Only one level ofbackup is preserved, so you will overwrite theoriginal annotation file if it is in the currentdirectory and you open the same annotator morethan once.#:file.load.annotatorSpecifies the name of the annotator whoseannotations are shown.  If you specified anannotator on the command line, the annotator nameis the initial value of this field; otherwise, thefield is initially empty.  Fill in or change thisfield to view or edit a different set ofannotations.Your edits, if any, are saved automaticallywhenever you change records.  Only one level ofbackup is preserved, so you will overwrite theoriginal annotation file if it is in the currentdirectory and you open the same annotator morethan once.#:file.load.calibration_file:url_view /usr/local/help/html/wag/wfdbca-5.htmSpecifies the name of the WFDB calibration file(a text file containing information on therelative scales of many types of signals).Include path information in this field only ifthe WFDB calibration file is not found in theWFDB path.#:file.load.wfdb_pathSpecifies the search path for WAVE's inputfiles.  Components are directory names,separated by colons (`:').  An empty component(either an initial or final colon, or twoconsecutive colons) specifies the currentdirectory.  If `%r' appears in the WFDB path,it is replaced by the current record name.#:file.saveIf there are unsaved edits, this selection savesthem.  The annotator name in the title bar ismarked with parentheses if there are unsavededits.#:file.print:%fig:chart1%This selection prints the contents of the signalwindow on paper.  The output is made from theoriginal signal files, and therefore is of betterquality than a screen dump would be.  Your edits,if any, are saved before printing, so that theoutput reflects any changes you have made.#:file.printsetup:%sec:print-setup-window%This selection pops up a panel that shows thecommands WAVE uses to print PostScript and textdata from the standard input.  You may changethese commands (for example, to specify use ofa different printer) by typing the desiredcommands into the appropriate fields on the panel.#:file.printsetup.psprintWAVE supplies any PostScript data to be printed(such as the chart generated when you choosePrint from the File menu) to the standard inputof this command.  You may change this command(for example, to specify use of a differentprinter).#:file.printsetup.textprintWAVE supplies any text to be printed (such ason-line help) to the standard input of thiscommand.  You may change this command (forexample, to specify use of a different printer).#:file.analyze:%sec:analyze-window%This selection pops up a panel containing a set ofbuttons, and a terminal emulator window.  Thenames of the buttons and their assigned actionsare read from a configuration file (by default,`wavemenu' if it exists in the current directory,otherwise /usr/local/lib/wavemenu.def; this may beoverridden by setting the environment variableWAVEMENU to the name of a different file).  Thebuttons are usually configured to perform variousanalysis functions on the current record; read/usr/local/lib/wavemenu.def for details.#:file.analyze.<Press this button to shift the segment to beanalyzed in the direction of the beginning of therecord, without changing the duration of thesegment.  The current `Start:' becomes the new`End:', unless doing so would require shorteningthe length of the segment.#:file.analyze.startThis field specifies the elapsed time from thebeginning of the record to the beginning of thesegment to be analyzed.  You may enter a timedirectly in this field, or you may insert a `<'marker using the standard procedure for insertingannotations.To enter a time in sample or counter intervals,enter `s' or `c' in this field, followed by thedesired number of intervals.  Examples:   s123		sample number 123   c20		counter number 20WAVE converts your entry to hh:mm:ss format whenyou press RETURN.#:file.analyze.astartThis field specifies the time of day of thebeginning of the segment to be analyzed.  You mayenter the time directly in this field (in 24-hourclock format), or you may insert a `<' markerusing the standard procedure for insertingannotations.To set both date and time, change the date first,then the time.#:file.analyze.dstartThis field specifies the date of the beginning ofthe segment to be analyzed.  If you change thisfield, the start time will change to midnight orto the time of the beginning of the record,whichever is later.To set both date and time, change the date first,then the time.#:file.analyze.endThis field specifies the elapsed time from thebeginning of the record to the end of the segmentto be analyzed.  You may enter a time directly inthis field, or you may insert a `>' marker usingthe standard procedure for inserting annotations.To specify the end of the record, enter `e' inthis field.  WAVE converts your entry to hh:mm:ssformat when you press RETURN.To enter a time in sample or counter intervals,enter `s' or `c' in this field, followed by thedesired number of intervals.  Examples:   s123		sample number 123   c20		counter number 20#:file.analyze.aendThis field specifies the end of the segment to beanalyzed, expressed as absolute time of day.  Youmay enter a time directly in this field, or youmay insert a `<' marker using the standardprocedure for inserting annotations.To set both date and time, change the date first,then the time.#:file.analyze.dendThis field specifies the date of the end ofthe segment to be analyzed.  If you change thisfield, the end time will change to midnight orto the time of the beginning of the record,whichever is later.To set both date and time, change the date first,then the time.#:file.analyze.>Press this button to shift the segment to beanalyzed in the direction of the end of therecord, without changing the duration of thesegment.  The current `End:' becomes the new`Start:', unless the current `End:' is alreadyat or beyond the end of the record.#:file.analyze.signalThis field specifies the selected signal.  Youmay enter a signal number directly in this field,or you may point to a signal, depress the <shift>key, and click left to select the signal.In the WAVE menu, the symbol $SIGNAL refers tothe signal number of the selected signal;  thissymbol usually specifies a signal to be analyzed.The name of the selected signal appears to theright of its signal number.  The uppermost signaldisplayed by WAVE is signal 0.#:file.analyze.signal_listThis field specifies the signal list (a list ofsignal numbers, separated by spaces).  In theWAVE menu, the symbol $SIGNALS refers to thesignal list;  this symbol usually appears wherea list of signals to be analyzed is required.To change the signal list, either type into thisfield, or point to a signal, press and hold the<control> (to add the signal to the list) or the<meta> key (to delete the first occurrence of thesignal from the list), and click left.#:file.analyze.show_scope_window:%sec:scope-window%This button pops up WAVE's Scope window,which can be used to display a signal in`oscilloscope' mode.#:file.analyze.show_command_window:%fig:analysis-commands%This button pops up a terminal emulator windowthat receives commands generated by selectingmost of the other buttons in this window, andthat displays any text output of those commands.You may type commands directly into the window.#:file.analyze.edit_menu:%fig:wave-menu%This button allows you to edit the menuconfiguration file for this panel, using thetext editor named in the EDITOR environmentvariable (or `textedit' if EDITOR is not set).After you have saved your changes, select`Reread menu' to reconfigure this panel.#:file.analyze.reread_menu:%fig:wave-menu%Select this button to reconfigure this panelafter you have made changes to the menuconfiguration file (most easily done byusing the `Edit menu' button) or afterchanging records.#:file.analyze.reloadClick on this button to force WAVE to reloadits input (signal and annotation) files.  WAVEwaits for any foreground commands in the AnalysisCommands window to finish before reloading.#:file.analyze.analysis_buttonThis button performs an action determined by theWAVE analysis menu file.  If the environmentvariable WAVEMENU is set, it names that file;otherwise, `wavemenu' (if it exists in the currentdirectory) or `/usr/local/lib/wavemenu.def' is theanalysis menu file.#:file.log:%sec:log-window%This selection pops up a window that allows you toname a log file, and to record in that file thecurrent record name and start and end time entriesfrom the main panel, along with a one-linecomment.  Log files may be used as scripts for`pschart'.  You may write to as many log files ina single session as you choose, and you mayaccumulate entries from multiple sessions in asingle log file.  Your entry is not recordedunless you press the `Add' button on the logpanel.  If you press the `>>' button, WAVE willreview the log, displaying the waveformsassociated with each entry and pausing betweenentries.  The review can be stopped by pressing`Pause'.#:file.log.fileThis field names the current log file.#:file.log.loadPress this button to load (or reload) thelog if an external process (such as one startedfrom the Analyze panel) creates or modifies thelog file.#:file.log.descriptionThis field contains the description associatedwith the current log entry.#:file.log.review_delayAdjust the slider to set the length (in seconds)of the pause between log entries while using the`<<' or `>>' buttons to review the log.#:file.log.addThis button adds an entry containing the time,the record name, and the description to thelog file.  If an annotation or marker has beenselected (i.e., if it is shown marked with abox), that annotation will be selected wheneverthe entry is redisplayed.#:file.log.replaceThis button replaces the description attachedto the current log entry with the currentcontents of the description field.  It doesnot create a new entry (use the `Add' buttonfor that purpose).#:file.log.deleteThis button deletes the current entry fromthe log.  This button also causes WAVE todisplay the next log entry if it exists.#:file.log.editThis button is currently non-functional.#:file.log.|<This button causes WAVE to show the firstlog entry.#:file.log.<<This button causes WAVE to begin reviewingeach entry in the log file in reverse order,pausing between entries.  While a review isin progress, only the Pause button isenabled.Adjust the length of the pause (in seconds)using the `Delay' slider.#:file.log.<This button causes WAVE to show the previouslog entry.#:file.log.pauseThis button causes WAVE to stop the review ofthe log file that was begun by the `<<' or`>>' button.  This button is disabled unless areview is in progress.#:file.log.>This button causes WAVE to show the nextlog entry.#:file.log.>>This button causes WAVE to begin reviewingeach entry in the log file, pausing betweenentries.  While a review is in progress,only the Pause button is enabled.Adjust the length of the pause (in seconds)using the `Delay' slider.#:file.log.>|This button causes WAVE to show the lastlog entry.#:view:%sec:view-window%This button pops up the View window, which allowsyou to choose (or merely examine) display scales,grid styles, and annotation, signal, and timedisplay styles.  Changes are not effective untilthe signal window is redrawn.#:view.showToggle these options by selecting them.  Multipleannotation fields are shown in the followingarrangement:	annotation mnemonic	subtype	`chan' field	`num' field	`aux' fieldSignal names and baselines are defined in theheader file.  Markers show the precise locationsof all annotations.  Levels show the amplitudes ofeach signal at the time indicated by the pointer,whenever a mouse button is depressed.  Changes arenot effective until the signal window is redrawn.#:view.time_scaleChoose the horizontal scale by selecting one ofthe choices.You can check the calibration of the display byenabling the 0.2 s or 0.2 s x 0.5 mV grid, andthen by measuring the spacing of the grid lines.If the spacing is incorrect, your X server doesnot know the actual display resolution.  See yourX server documentation if this is the case, or usethe -dpi option when starting `wave' (start `wave'with no arguments for instructions).#:view.amplitude_scaleChoose the vertical scale by selecting one of thechoices.You can check the calibration of the display byenabling the 0.5 mV or 0.2 s x 0.5 mV grid, andthen by measuring the spacing of the grid lines.If the spacing is incorrect, your X server doesnot know the actual display resolution.  See yourX server documentation if this is the case, or usethe -dpi option when starting `wave' (start `wave'with no arguments for instructions).#:view.drawUse this control to toggle WAVE's signal displaymode.  By default, WAVE displays all signals inorder of signal number, with signal 0 at the topof the signal window.  If you select `listedsignals only', WAVE displays only those signalsthat appear in the signal list (on the Analyzepanel).  Changes are not effective until thesignal window is redrawn.#:view.show_annotationsUse this menu button to choose how annotationsare to be displayed.  By default, WAVE displays