% @(#)analysinve.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:15:16 
\se
SECTION./INVENT
\es\co
ANALYSE/INVENTORY                                                    14-DEC-1988
\oc\su
ANALYSE/INVENTORY frame in_tab [out_tab] [ver_par] [deb_mode] [out_psf]
	verify the used table of objects and calculates the image parameters
\us\pu
Purpose:   
           In the VERIFY mode, the ANALYSE command verifies the used
           table of objects, and calculates the image parameters.
           In the NOVER mode the verification is omitted.
\up\sy
Syntax:    
           ANALYSE/INVENTORY frame table1 [table2] [ver_par] [debug] [out_psf]
\ys\pa
           frame     = input frame
\ap\pa
           in_tab    = input table (output of SEARCH command or other MIDAS 
                       table format file with at least two columns containing
                       world coordinates of objects with labels :X and :Y)
\ap\pa
           out_tab   = optional output table
\ap\pa
           ver_par   = VER for verification (default)
                       NOVER for non-verification
\ap\pa
           deb_mode  = debug mod: DEBUG or NODEBUG; optional (used with small 
                       frames in case of trouble); default is NODEBUG
\ap\pa
           out_psf   = name of an image frame to hold point spread
                       function extracted from the input image.
                       Effective only when the keyword ANALITER and
                       at least one of keywords FULLPSF or UNDRSMPL
                       have positive values. Subpixeling is applied
                       in accordance with value of keyword UNDRSMPL.
\ap\no
Note:      
           In the NOVERIFY mode, the verification process is omitted.
           The table of objects is produced independently of the Inventory
           procedure and the ANALYSE/INV command calculates several image
           parameters, which can be used as final results and/or as
           input for the CLASSIFY/INV command.
\\
           In the VER mode, the command verifies the used table of object,
           which is the output of the SEARCH/INV command.  Many of the
           entries are deleted, some new ones are added. The object
           positions are improved and the ANALYSE/INV command calculates
           several image parameters, which can be used as final results
           and/or as input for the CLASSIFY command.
\\
           The output table will contain all columns as described in the user 
           manual (Volume 2, Chapter 4). However, the last 3 columns used for 
           the error estimates for the position and magnitude will only be 
           filled when ANALYSE/INVENT is used with a two-dimensional psf 
           (FULLPSF larger than 0) and more than one iteration (ITERATE greater
           than 0).
\\
           Before running the command, check the values of the
           keywords used by this command with SET/INV A(nalyse) [A(ll)]

\on\exs
Examples:
\ex
           ANALYSE/INVENT IMAGE TABLEA TABLEB VER
           Analysis on frame IMAGE objects listed in table TABLEA. Some of
           the objects are deleted, some additional objects are added.
           TABLEA should contain columns named X and Y which are
           obligatory. The presence of columns BG and INT may save some
           CPU time. Output table TABLEB contains 22 parameters for each
           object including positions, magnitudes, and sizes.
\xe\ex
           ANALYSE/INVENT SMALLIMAGE TABLEA TABLEB VER DEBUG
           Displays on terminal plenty of intermediate results to help
           understanding how the analysis is done.
\xe\ex
           ANALYSE/INVENT SMALLIMAGE TABLEA ? VER DEBUG
           The same as before but output table is not created.
\xe\ex
           ANALYSE/INVENT IMAGE TABLEA TABLEB NOVER
           Analyses on frame IMAGE objects listed in table TABLEA. Obtained
           parameters are listed in table TABLEB for the same set of
           objects. The objects coordinates are not changed. The input
           table should contain columns X and Y.
\xe\ex
           ANALYSE/INVENT SMALLIMAGE TABLEA ? NOVER DEBUG
           Displays on terminal plenty of intermediate results to help
           understanding how the analysis is done.
\xe \sxe