Notes:

1. Starting the X server.
On some computers, the X server and the window manager are started automatically whenever you log in, and no command is needed. Otherwise, you must run a command to start the X server before you can run WAVE . This command may be `startx' or `openwin'; for details, check your X server manual (on a UNIX system, type `man X'). If you have a choice of window managers, use olwm or olvwm if possible (click here for details). If no terminal window is available after starting the X server, you can usually open one by moving the mouse pointer over the background (the root window) of the display, then clicking the left or right mouse button to open a menu. Depending on your system, the menu may include `xterm', `shell', `cmdtool', `terminal emulator', or something similar; choose any of these to open a terminal window.

2. Initializing the environment.
If you are using a recent version of WAVE , you probably will not need to do anything to initialize the environment (the WFDB path and the name of the WFDB calibration file). Unless you keep input files in non-standard places, or if you have created your own calibration file in a non-standard location, you can skip this step.

If you do need to initialize your environment, this is typically done using a command at login time. The form of this command depends on what shell (command interpreter) you use on the WAVE host. To identify your shell, log onto the WAVE host and type `echo $SHELL'. If the response contains the characters `csh', you are using the C-shell (or a variant of it); in this case, use `source /usr/bin/cshsetwfdb' to initialize the environment. Otherwise, use `. setwfdb' to do so (don't omit the `.' in this case). Usually, the appropriate command is included in your `.profile' or `.login' script on the WAVE host, so that it need not be entered each time you log onto the WAVE host. See setwfdb(1) (type `man setwfdb' on the WAVE host) for further information.

3. Simulating a middle button click.
On a two-button mouse, this is often done by clicking both buttons simultaneously; on a one-button mouse, this is usually performed by pressing and holding a keyboard key such as \Ovalbox{\small\sf Shift} while clicking the mouse button. Refer to your X server documentation.

4. Simulating a right button click.
This is usually done by pressing and holding a keyboard key while clicking the mouse button. Refer to your X server documentation.

5. Your computer's name.
If you don't know your computer's name, you may be able to discover it by typing the command `hostname' (on a UNIX system), or by logging in to the WAVE host and typing the command `who am I' (your computer's name should appear at the end of the output). If the WAVE host doesn't recognize your computer by name, use your computer's IP address (in the form a.b.c.d, where a, b, c, and d are decimal numbers between 0 and 255).

6. The WAVE host's name.
If your computer doesn't recognize the WAVE host by name, use the WAVE host's IP address.

7. Permitting access to your display.
If you use ssh (see the next item) to login to the WAVE host, skip this step. Otherwise, this command is usually needed if your computer is running UNIX. For example, if the name of the WAVE host is atlantic, this command would be `xhost +atlantic'. If your computer is not running UNIX, there may not be any command required; if in doubt, see your X server manual.

8. Logging onto the WAVE host.

This is probably a command of the form `ssh atlantic'. You will probably be prompted to enter your password when you execute this command. If you don't have ssh on your computer, and an ssh server on the WAVE host, it is very strongly recommended that you obtain and install them (both are freely available from http://www.openssh.org/). Use telnet only as a last resort, and never on a public network.

9. Redirecting WAVE output to your display.
If you use ssh (see above), skip this step. Otherwise, you will need to set the DISPLAY environment variable to point to your computer. Assume that the name of your computer is arctic. If you use the C-shell on the WAVE host (see note 2 above), the command would be `setenv DISPLAY arctic:0'. Otherwise, it would be `DISPLAY=arctic:0; export DISPLAY'. It is possible to set up your .profile or .login script so that this command can be executed automatically each time you log onto the WAVE host. Consult your system administrator for details.

George B. Moody (george@mit.edu)
2014-03-13