SUN/137.7

Starlink Project
Starlink User Note 137.7

Paul Harrison, Paul Rees,
Peter Draper, Alasdair Allan

27 March 2008

PONGO — A Set of Applications for Interactive Data Plotting

2.0-3

User’s Manual

pdfpict

Abstract

PONGO is a suite of commands for interactively plotting data stored in text files.

Contents

1 Introduction
2 Starlink/ICL or IRAF/CL?
3 Tutorial Examples
 3.1 An ICL example
 3.2 A CL example
4 Classified List of Commands
 4.1 Commands which begin and end PONGO
 4.2 Commands for plotting
 4.3 Commands which control plotting
 4.4 Commands for manipulating data
 4.5 Commands for performing simple statistics
5 Data File Formats
 5.1 Column delimiters
 5.2 Column labels
 5.3 Comments
 5.4 Astronomical coordinates
6 Internal Data Areas
7 Projections
8 Creating Complex Plots
 8.1 A simple ICL procedure
 8.2 A simple CL procedure
 8.3 Example procedures
  8.3.1 Spectrum
  8.3.2 Errors
  8.3.3 Histogram
  8.3.4 Ppdotdiag
  8.3.5 Ellipses
  8.3.6 Projections
  8.3.7 Radec
  8.3.8 Vector
  8.3.9 Interactive
  8.3.10 AGI
9 Using PONGO with other Starlink Applications
10 Panic Section
 10.1 Getting help in ICL
 10.2 BEGPLOT or DEVICE does not work in ICL
 10.3 READF cannot find a column label
 10.4 Strange behaviour of DLIMITS
 10.5 Error messages from SHOWPONGO in ICL
 10.6 AGI problems
 10.7 RESET peculiarity (ICL only)
 10.8 Plotting large numbers of positions
11 References
A Alphabetical List of Commands
B PONGO Command Definitions
ADVANCE – Clear the graphics screen
ANNOTATE – Annotate the plotted data
ARC – Draw an arc of an ellipse
AVEDAT – Average the data in the XCOL and YCOL areas
BEGPLOT – Open a plotting device
BIN – Plot a histogram using previously binned data
BOXFRAME – Draw a frame and axes on the plot
CCMATH – Perform inter-column maths
CHANGE – Change plotting attributes
CLEAR – Clear plotting attributes
CLOG – Take the logarithm of a column
CONNECT – Draw straight lines between the data points
CURSE – Use the cursor to get interactive input
DATA – Specify the data file name
DEGTOR – Convert the specified data area from degrees to radians
DEVICE – Open a plotting device
DLIMITS – Set the world coordinate limits using the data range
DRAW – Draw a line from the current pen position to the specified point
DRAWPOLY – Draw a polygon
ELLIPSES – Draw error ellipses
ENDPLOT – Close down the current plotting device
ERASE – Clear the graphics screen
ERRORBAR – Draw error bars on the plotted data
ERRX – Draw symmetric error bars in the X direction
ERRY – Draw symmetric error bars in the Y direction
EXCOLUMN – Specify the column containing the X-axis error data
EXPAND – Set the character height
EYCOLUMN – Specify the column containing the Y-axis error data
FILLSTY – Change fill-style plotting attributes
FITCURVE – Fit a curve to the data
FITLINE – Fit a straight line to the data
FONT – Set the text font
GETPOINT – Retrieve information for a plotted data point
GPOINTS – Plot points or lines between the data
GRID – Draw a coordinate grid at specified intervals
GT_CIRCLE – Draw a great circle between two points
HISTOGRAM – Bin and plot a histogram of the data
INQUIRE – Display PONGO status information
LABCOLUMN – Specify the column used for data labels
LABEL – Draw the axis labels and title on the plot
LIMITS – Set the world coordinate limits
LTYPE – Set the line style
LWEIGHT – Set the line width
MARK – Draw a point mark at the specified position
MOVE – Set the current pen position
MTEXT – Draw a text string relative to the viewport
PALETTE – Change the plotting pen colours
PAPER – Change the size and aspect ratio of the plotting surface
PCOLUMN – Specify the column used for symbol codes
PEN – Set the current pen
PLOTFUN – Plot a given function
PLOTHIST – Plot a histogram of the data
POINTS – Draw a point mark at each of the data points
PRIM – Perform primitive plotting functions
PTEXT – Draw a text string at the specified position and angle
PTINFO – Get the coordinates of a specified data point
PVECT – Draw proper motion vectors
RADIATE – Draw a line from the given point to the first NP data points
READF – Read from a formatted data file
RESETPONGO – Reset the state of PONGO.
RTODEG – Convert the specified data area from radians to degrees
SETPROJ – Set the projection geometry
SHOWPONGO – Show the PONGO global parameters
SIZEPLOT – Draw point marks of differing sizes at each of the data points
SYMCOLUMN – Specify the column used for symbol codes
TEXT – Draw a text string on the plot at the specified position
VECT – Draw vectors from each data point
VIEWPORT – Set the viewport for the current plotting device
VPORT – Set the viewport using normalised device coordinates
VP_BH – Set the viewport to the bottom half of the plotting surface
VP_BL – Set the viewport to the bottom-left quarter of the plotting surface
VP_BR – Set the viewport to the bottom-right quarter of the plotting surface
VP_TH – Set the viewport to the top half of the plotting surface
VP_TL – Set the viewport to the top-left quarter of the plotting surface
VP_TR – Set the viewport to the top-right quarter of the plotting surface
VSIZE – Set the viewport using its physical size in inches
VSTAND – Set the standard viewport
WNAD – Adjust the viewport so that the X and Y scales are the same
WORLD – Set the world coordinates for the plot
WRITEI – Write information to an output file
WTEXT – Draw a text string on the plot
XCOLUMN – Specify the column containing the X-axis data
XERR – Draw symmetric error bars in the X direction
XLINEAR – Put 1 ... N into the XCOL data area
XLOGARITHM – Take the logarithm of the X-axis data
XOFFSET – Add a constant offset to the X-axis data
XSCALE – Multiply the values in the XCOL and EXCOL data areas by a constant
YCOLUMN – Specify the column containing the Y-axis data
YERR – Draw symmetric error bars in the Y direction
YLINEAR – Put 1 ... N into the YCOL data area
YLOGARITHM – Take the logarithm of the Y-axis data
YOFFSET – Add a constant offset to the Y-axis data
YSCALE – Multiply the values in the YCOL and EYCOL data areas by a constant
ZCOLUMN – Specify the column containing the Z-axis data
ZSCALE – Multiply the values in the ZCOL data area by a constant

C PONGO and the MONGO Graphics Package
D Notes for IRAF/CL users
E Changes
 E.1 This release (2.0-2)
 E.2 Previous release (2.0-1)
 E.3 Release 1.3
 E.4 Release 1.2