GETPOINT - Retrieve information for a plotted data point

Description:

Return the attributes of a plotted data point to ICL variables.

This application has been written to aid the implementation of ICL procedures. Because it is only possible to make enquiries about a single point per invocation, any ICL procedure built around GETPOINT will work slowly if a large number of data are involved. For such cases it may be better to consider writing a customised PONGO application.

Usage:

getpoint action value

Parameters:

ACTION = _CHAR (Read)

The method of specifying the data point in question. If "N", interpret the VALUE parameter as specifying the index number of that point. If "C", the VALUE parameter is used to try to match the LABCOL entry for a point.

[The value is prompted for.]

VALUE = _CHAR (Read)

The value to be used in the search for the data point. Depending upon the value of the ACTION parameter, this may either be an integer specifying the index number of the point in the data area, or a case-sensitive minimum match string for a label column entry in the data area.

[The value is prompted for.]

X = _REAL (Write)

The returned value of the X coordinate of the selected point.

Y = _REAL (Write)

The returned value of the Y coordinate of the selected point.

Z = _REAL (Write)

The returned value of the Z coordinate of the selected point.

EX = _REAL (Write)

The returned value of the X coordinate error of the selected point.

EY = _REAL (Write)

The returned value of the Y coordinate error of the selected point.

SYMBOL = _INTEGER (Write)

The returned value of the symbol column of the selected point.

LABEL = _CHAR (Write)

The returned value of the label column of the selected point.

Examples:

PONGO$>$ GETPOINT C '3C45' X=(XP) Y=(YP)

This will return the X and Y coordinates of the data point that has the label '3C45', if it exists, to the ICL variables XP and YP.