next up previous 241
Next: PRIM - Perform primitive plotting functions
Up: PONGO Command Definitions
Previous: PLOTHIST - Plot a histogram of the data


POINTS - Draw a point mark at each of the data points

Description:
Draw a symbol at each of the data points. The symbol type that is used to mark each point is determined in one of three ways:

  • If no SYMBOL parameter is supplied on the command line, and no symbol numbers have been read into the symbol data area by READF, the point style will be set by the current value of SYMBOL.

  • If no SYMBOL parameter is supplied on the command line, and values have been read into the symbol data area by READF, the symbol number for each point will determine the style of the point plotted.

  • If SYMBOL is specified on the command line, it will override each of the above options. The same specified symbol will be used to mark all points.


The value of the symbol index should be an integer which refers to the standard PGPLOT symbols.

This command is a synonym for GPOINTS P.


Usage:
points [symbol]

Parameters:

SYMBOL = _INTEGER (Read and Write)
The PGPLOT symbol number that is used to mark the data points.

If a value is specified on the command line, it will be used for plotting symbols for all the data. If no value is specified on the command line, the application attempts to use the SYMCOL data for its symbols. If no symbol values have been read into the SYMCOL data area, the current value is used for all the data. The current value is initially set to 1.

PROJECTION = _CHAR (Read)
Specifies the geometry that is to be used to plot the data. This is explained in more detail in the section on projections. Allowed values: "NONE", "TAN", "SIN", "ARC", "GLS", "AITOFF", "MERCATOR" and "STG".

This parameter is not specified on the command line. The value of the global parameter PONGO_PROJECTN is used. If PONGO_PROJECTN is not defined, the default value "NONE" is used.

RACENTRE = _CHAR (Read)
The centre of the projection in RA (i.e. the angle must be specified as hh:mm:ss.sss). This parameter is only required for PROJECTION values other than "NONE".

This parameter is not specified on the command line. The value of the global parameter PONGO_RACENTRE is used. If PONGO_RACENTRE is not defined, the default value "0" is used.

DECCENTRE = _CHAR (Read)
The centre of the projection in declination (i.e. the angle must be specified as dd:mm:ss.sss). This parameter is only required for PROJECTION values other than "NONE".

This parameter is not specified on the command line. The value of the global parameter PONGO_DECCENTRE is used. If PONGO_DECCENTRE is not defined, the default value "0" is used.




next up previous 241
Next: PRIM - Perform primitive plotting functions
Up: PONGO Command Definitions
Previous: PLOTHIST - Plot a histogram of the data

PONGO [2exof Applications for Interactive Data Plotting [2exon 2.0-2
Starlink User Note 137
Paul Harrison, Paul Rees,
Peter Draper, Alasdair Allan
27 March 2008
E-mail:starlink@jiscmail.ac.uk

Copyright © 2013 Science and Technology Facilities Council