% @(#)identicurs.hlq	2.3 (ESO-IPG) 10/27/91 14:13:46 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      identicurs.hlq
%.AUTHOR     JDP, IPG/ESO
%.KEYWORDS   MIDAS, help files, IDENTIFY/CURSOR
%.PURPOSE    On-line help file for the command: IDENTIFY/CURSOR
%.VERSION    1.0  07-OCT-1985 : Creation, JDP
%----------------------------------------------------------------
\se
SECTION./CURS
\es\co
IDENTIFY/CURSOR						07-OCT-1985  JDP
\oc\su
IDENTIFY/CURSOR table ident x [y] [error]
	identify table entries from display
\us\pu
Purpose:      Identify table entries from image display system.
              This command : 1.finds entries in the table with the
              smallest distance (see note below) to the cursor position,
              and 2. asks for the identification (see note below)
\up\sy
Syntax:       IDENTIFY/CURSOR table ident x [y] [error]
\ys\pa
              table = table name
\ap\pa
              ident = reference to the column to be identified.
                      If the column does not exist it is created
                      with type 'R*4.
\ap\pa
              x     = reference to the column with the abscisae
\ap\pa
              y     = optional reference to the column with the ordinates
\ap\pa
              error = optional upper limit in the calculation of the
                      distance

\ap\no
Note:         1.The cursor box has to be set up as follows:
                Defined cursor on, TRACK off, RATE on.
                Pressing the ENTER button will list the table entry.
                Set defined cursor(s) off + press ENTER
                to exit.
              2.The identification is entered from the keyboard as
                - a valid number of character string to be written into
                  the table.
                - the symbol * to delete the identification.
                - RETURN to skip to the next cursor position.
              3.The distance is the euclidean distance in one or two
                dimensions according to the reference to the ordinate column.
	
\on\exs
Examples:
\ex
              IDENTIFY/CURSOR POSITIONS :IDENT :X :Y
\xe \sxe