% @(#)shift_mosa.hlq	17.1.1.1 (ESO-SDAG) 01/25/02 17:48:54
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c) 1995 European Southern Observatory
%.IDENT      shift_mosa.hlq
%.AUTHOR     RHW, IPG/ESO
%.KEYWORDS   MIDAS, ccd package, OFFSET/MOSAIC
%.PURPOSE    On-line help file for the command: OFFSET/MOSAIC
%.VERSION    950719 RHW created
%---------------------------------------------------------------------
\se
SECTION./MOSAIC
\es\co
SHIFT/MOSAIC                                                       02-Aug-1995
\oc\su
SHIFT/MOSAIC out_tab [curs_opt] [csx,csy] [clear_opt]
	Get x and y shifts of the subraster in the mosaic frame
\us\pu
Purpose:    
	Get x and y shifts of the subraster in the mosaic frame
\up\sy
Syntax:     
	SHIFT/MOSAIC out_tab [curs_opt] [csx,csy] [clear_opt]
\ys\pa
        out_tab = Output table to contain the pixel shifts in x and y of the 
                  individual subrasters in the mosaic frame. No default.
\ap\pa
        curs_opt = centering algorithm to be used for determining the position.
                  The following options are available: \\
                  GC - get the positions using the simple GET/CURSOR command; 
                  CG - get the positions using the CENTER/GAUSS 
                       command;
                  CM - get the positions using the CENTER/MOMENT command;
                  CI - get the positions using the CENTER/IQE command; \\
                  Default is SC.
\ap\pa
        csz,csy = number of x-and y-pixels for subwindow centered via the
                  single cursor; The option is only applicable for if the 
                  curs_opt is CG, CM, or CI. Default is 50,50.
\ap\pa 
        clear_opt = clear option for clearing the display overlay channel 
                  before getting the cursor positions. Default is Y.
\ap\no
Note:
        In order to align and/or match the subrasters in a frame mosaic
        created by the command CREATE/MOSAIC, the user must give pixel 
        shift information. The shift information can be input in a number
        of different ways. For more information about these possibilities see 
        the help text of the commands ALIGN/MOSAIC and MATCH/MOSAIC.\\

        This command store the positional informal of object in overlapping
        regions in adjacent subrasters in a table.  Subsequently this table
        can be used by the commands ALIGN/MOSAIC and MATCH/MOSAIC to compute 
        the pixel offsets in x and y and to align the subraster. The must be 
        loaded in the display window. \\

        In order to get the ALIGN/MOSAIC or the MATCH/MOSAIC commands work 
        correctly the positions of the objects must be obtained in the 
        following sequence: \\
           1) the x and y coordinates of the object in the first subraster;\\
           2) the x and y coordinates of the same object in the second,
              adjacent subraster;\\
           3) the x and y coordinates of the next object in the first or 
              another  subraster;\\
           4) the x and y coordinates of the same object in the second,
              adjacent, subraster;\\
              etc.\\

        The command creates an output table containing the columns :X_coordpix,
        :Y_coordpix, and :Value. Additional columns can be present and depends
        on the cursor option used.
\on\see
See also:   
        SET/CCD, SHOW/CCD, CREATE/MOSAIC, ALIGN/MOSAIC, MATCH/MOSAIC
\ees\exs
Examples:
\ex
	SHIFT/MOSAIC dorcoord CG ? N
        Get the positions of pairs of objects in adjacent subrasters in the 
        mosaic frame loaded on the display. Stored the positions in the 
        table "dorcoord". Use the CENTER/GAUSS command to get the positions.
        Don't erase the overlay channel.
\xe \sxe