3 Tutorial Examples

The following two sections show the same simple example. The first uses the Starlink/ICL and the second the IRAF/CL command languages.

3.1 An ICL example

In order to start PONGO you must first start ICL. This may be done by typing:

at C-shell the prompt. Or alternatively by starting ICL then using the pongo command.

In any PONGO session the first action is to open the plotting device. This is done by typing²:

Where ‘xw’ should be replaced by the name of the plotting device you are intending to use. Note that once you have begun a PONGO session with the BEGPLOT command, the ICL> prompt changes to PONGO>. This is important because the only commands you can use with success at the ICL> prompt are BEGPLOT and DEVICE, all other commands should be typed at the PONGO> prompt. The data may then be read using the command ³. Normally an ‘ordinary’ file name would be used i.e. spectrum.dat. An ICL variable is used here as it is not possible at this time to use an environment variable for accessing formatted files. The actual file is $PONGO_EXAMPLES/tutorial.dat:

Plotting limits are set up using the range of the data by the command:

Axes for the plot may be drawn using:

and finally the points may be plotted as asterisk-like symbols and the axes labelled with:

Note that the data values are remembered by PONGO and the plot you have just created may be erased and recreated by typing:

To close a device and end a PONGO plot the command ENDPLOT should be used. This is important if you are going to switch to another set of applications such as KAPPA, otherwise the plotting device characteristics will be inaccessible to the second package.

3.2 A CL example

In order to start PONGO you must first start CL and load the pongo package.

In any PONGO session the first action is to open the plotting device. This is done by typing⁴:

Where ‘xw’ should be replaced by the name of the plotting device you are intending to use. The data may then be read using the command:

Plotting limits are set up using the range of the data by the command:

Axes for the plot may be drawn using:

and finally the points may be plotted as asterisk-like symbols and the axes labelled with:

To close a device and end a PONGO plot the command: ENDPLOT should be used.