% @(#)adstarroma.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:17:45
\se
SECTION./ROMAFOT
\es\co
ADSTAR/ROMAFOT                                                 26-AUG-1989 RHW
\oc\su
ADSTAR/ROMAFOT in_frame out_frame [reg_tab] [cat_tab] [x_dim,y_dim] [n_sub]
	create an artificial image with subframes added at random positions
\us\pu
Purpose: 
          Create an artificial image identical to the original but with some
          subframes added at random positions.
\up\sy
Syntax:  
          ADSTAR/ROMAFOT in_frame out_frame [reg_tab] [cat_tab] [x_dim,y_dim]
                         [n_sub]
\ys\pa
          in_frame = original frame
\ap\pa
          out_frame = output frame. This is created by selecting subframes from
             the registration table and adding these as new components to some
             to the original frame at random positions.
\ap\pa
          reg_tab = registration table. This table gives position and
             calculated background of the objects to select the windows to be
             added to the original image.
\\
             Default name is the input frame name extended with `REG'.
\ap\pa
          cat_tab = output catalogue table to store the output random positions.
\\
             Default name is the output frame extended with `CAT'.
\ap\pa
          x_size,y_size = size of the subframe in x and y; default is 21,21
\ap\pa
          n_sub = number of added subframes for each input from the 
             registration table;
\\
             default is 1.
\ap\no
Note: 
          A useful feature is that, if the output cat_tab created by 
          ADSTAR/ROMAFOT is used as input for ANALYSE/ROMAFOT. By doing so, the
          artificial objects can be displayed and the fraction of objects lost
          can eventually be estimated.
\on\exs
Examples:
\ex
          ADSTAR/ROMAFOT GCLUST GCLART WIND ? 21,21
          Select some windows from WIND.tbl, add several times these
          windows to the image GCLUST and create the new image GCLART.
          Store the random output positions in the table GCLUSTCAT.
\xe \sxe