% @(#)group_roma.hlq	19.1 (ESO-IPG) 02/25/03 13:29:28 
\se                                                                             
SECTION./ROMAFOT
\es\co                                                                          
GROUP/ROMAFOT                                                    07-AUG-1989 RHW
\oc\su                                                                          
GROUP/ROMAFOT frame [area] [cat_tab] [int_tab] [thres] [wnd_max] 
	[end_rad,sta_rad] [wnd_perc]
	automatic grouping of objects
\us\pu
Purpose:      Automatic grouping of objects
\up\sy                                                                          
Syntax:       GROUP/ROMAFOT frame [area] [cat_tab] [int_tab] [thres] 
                            [wnd_max] [end_rad,sta_rad] [wnd_perc]
\ys\pa                                                                          
              frame    = input frame.
\ap\pa                                                                          
              area     = area to perform the actual search. Input as can be
                         done using the standard MIDAS notation.
\ap\pa                                                                          
              cat_tab  = catalogue table which contains the object parameters
                         and created by the commmand SEARCH/ROMAFOT; default
                         is the name of the frame extended with `CAT'.
\ap\pa                                                                          
              int_tab =  intermediate table that will contain the selected 
                         objects. If the table already exists one can give the
                         switch `/A' to append the table, or `/O' to overwrite
                         it. If no switch has been given the user is asked for;
                         here the default is OVERWRITE.
\ap\pa
              thres    = photometric threshold below which objects are
                         not considered as primary objects. They are however
                         included in the windows where their influence is not
                         negligible. Default is the threshold used by
                         SEARCH/ROMAFOT.
\ap\pa
              wnd_max =  maximum number of object per window. The maximum 
                         number of object that can be selected is 36. However
                         a second constraint is the relation between the 
                         number of objects (MO) and holes (MH):\\
                         6.5*MO + 3*MH = 238.\\
                         MO=25 should be considered as a maximum; MO=15 is
                         more common. The default value is 10.
\ap\pa                                                                          
              end_rad,sta_rad = limiting percentages of action radius; default
                         is 90.,100. 
\ap\pa
              wnd_perc = percentage of the window to be computed. Default is
                         100. See the note below.
\ap\no
Note:         The option wnd_perc may be useful if the user wants wider
              windows (e.g. if one gets too many holes and too few pixels to
              sample the background), a value greater than 100 can, in fact,
              be given. However subframes larger than 55 by 55 pixels are not
              allowed.
              
              For a more extended explanation of the command see the MIDAS 
              Users Guide Volume 2, Chapter 5
\on\exs                                                                         
Examples:                                                                       
\ex
              GROUP/ROMAFOT GCLUS ? CATTBL ? ? ? 15 80,100
              Group the objects in the catalogue table CATTBL and store the
              groups found in the default intermediate table GCLUSTINT. Take 
              the same area of the frame on which SEARCH/ROMAFOT has worked 
              and the same photometric threshold . The maximum number of 
              objects per window is 15, and the limiting action radii are
              at the 80 and 100 percent level.
\xe \sxe                                                                        
