Display Words

2D Displays

IMAGE (a standard FIGARO word)

Once a disk file A123F.dst containing a CCD image has been created, it can be displayed on the monitor by typing the command IMAGE. This asks a series of questions including the name of the image (i.e., A123F), the range in x and y (rows and columns) to be displayed (remember the display is 512x512 -- but if you choose to do a full 800x800 the full picture will appear, but it will take longer to display since more arithmetic is required), the black/white level, etc. If you display a series of frames such that all parameters after a certain point in the series of questions are what they were for the last call to IMAGE, answer $\backslash$ to the next query from the Microvax, and the remaining questions will be suppressed.

IMAGE now brings up the cursor automatically (unless the keyword NOCURSOR is specified, i.e. IMAGE NOCURSOR). There is also a small menu for changing the grey scale level, marking points, and getting a 11x11 matrix of values in the frame centered on the cursor typed out on the the terminal (the option P). How to manipulate the cursor is discussed in the next paragraph.

ICUR (a standard FIGARO word)

If you need it outside the IMAGE command, the cursor for two-dimensional data is obtained by typing ICUR. This produces a cursor which is controlled in position by the extra keypad centered on key 5. Thus, key 8 moves the cursor up, key 2 moves it down, key 9 moves it diagonally up and to the left, etc. The speed of the cursor is controlled by the pf1-pf4 keys, with pf4 being the fastest motion (eight tv pixels per keystroke) and pf1 moving only one tv pixel per keystroke. The cursor always starts out in the center of the picture when it is turned on.

SIMAGE

SIMAGE is a word for displaying, at full spatial resolution, a spectrum whose size X by Y is smaller than 256x1024. In that case, folding the spectrum will enable it to fit onto a 512x512 display. On the left side of the display is shown pixels (x,y) where x is 1 to X and y is 1 to y/2. On the right side of the display are the remaining pixels in y, y/2 to Y, over the full width of the saved readout (1 to X).

SICUR

SICUR is the cursor associated with the command SIMAGE. It functions in exactly the same way as ICUR.

TVCLEAR

TVCLEAR erases the screen.

PATCH

PATCH functions like ICUR, but if you hit the space bar, a 11x11 matrix of the values in the frame centered on the cursor's position is typed out on the terminal. This can be done for several locations on a given image. Exit by hitting Q. (abbreviation for QUIT).

COLOUR GREY (a standard FIGARO word)

There is a known bug such that the bit map is incorrect on a 2d image displayed following a 1d plot (i.e., IMAGE after SPLOT). To correct this, type COLOUR GREY. It only needs to be typed once (at least until you do a 1d plot again.) Symptoms of incorrect bit patterns are when the centers of bright stars are black on the tv, or when very faint things that should be black on the tv are white. COLOUR GREY will correct this.

RESETDISPLAY

After the use of a word which scrolls the peritek display an a non-standard manner (i.e. SCAN or TRANSIT), RESETDISPLAY will reset the screen to its normal position.

1D Display

SPLOT (a standard FIGARO word)

One dimensional spectra are plotted using the word SPLOT, which like image asks a series of questions. Again, if you know the answers to the remaining questions are the defaults (which are those used for the last spectrum), then answer ``$\backslash$'', and the remaining questions will be suppressed. SPLOT will plot in pixel numbers, unless a wavelength scale has already been specified. If so, it will plot in wavelength units. Note that various sophistications of plotting several line graphs on top of each other can be done -- see the FIGARO documentation for details.

To obtain a hardcopy of a 1d plot, you must have typed HARD /TOSHIBA or HARD /PRINTRONIX. Then go through SPLOT until you like the plot as its displayed on the Peritek monitor. Once you have done that, go through SPLOT again and answer YES to the question ``do you want a hardcopy''. That will create a disk file called PGPLOT.TOPLOT (or something close to PGPLOT.PRTNIX at the 200-inch). This is the file that you should print (i.e. type PRINT PGPLOT.TOPLOT will produce the plot on the printer).

(The default for the print command is actually PRINT/PASSALL on both microvaxes; this is necessary for plots to be printed successfully.)

You can also (at the 60-inch only) switch the plot display from the peritek monitor to the retrographics terminal by typing SOFT OPA0:/RETRO. To send it back to the Peritek, type SOFT /PERI.

CCUR (a standard FIGARO word)

The cursor for the one-dimensional plots is turned on by typing CCUR. This cursor is manipulated using the four arrow keys on the keyboard and its speed is again manipulated using the keys pf1-pf4. When the space bar is hit, the cursor display is typed on the terminal, not on the monitor. Type Q to exit.