% @(#)createmosa.hlq	17.1.1.1 (ESO-SDAG) 01/25/02 17:48:52
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c) 1995 European Southern Observatory
%.IDENT      createmosa.hlq
%.AUTHOR     RHW, IPG/ESO
%.KEYWORDS   MIDAS, ccd package, CREATE/MOSAIC
%.PURPOSE    On-line help file for the command: CREATE/MOSAIC
%.VERSION    950719 RHW created
%---------------------------------------------------------------------
\se
SECTION./MOSAIC
\es\co
CREATE/MOSAIC                                                   19-Jul-1995 RHW
\oc\su
CREATE/MOSAIC in_cat out_frm out_tab nx_sub,ny_sub [not1,not2,...] 
        [nocol,norow] 
	Mosaic a set of (infrared) ccd frames
\us\pu
Purpose:    
	Mosaic a set of (infrared) ccd frames
\up\sy
Syntax:     
        CREATE/MOSAIC in_cat out_frm out_tab nx_sub,ny_sub 
                   [not1,not2,...] [nocol,norow]
\ys\pa
        in_cat=    The input catalogue of input subframes to be mosaiced. The 
                   frames are assumed to be ordered either by row, column, 
                   or in a raster pattern. If the frame catalogue is not in 
                   order the user must correct it or create a new catalogue. 
                   The frames in the input catalogue are assumed to have all 
                   the same size. No default.
\ap\pa 
        out_frm=   The name of the output frame. No default.
\ap\pa
        out_tab=   The name of the MIDAS table that will contain subframes and 
                   parameters produced by the command. This table can be 
                   used as input for the command ALIGN/MOSAIC and MATCH/MOSAIC.
\ap\pa 
        nx_sub,ny_syb= The number of subrasters along a row of the output 
                   frame (nx_sub), and the number of subrasters along a column
                   of the output frame (ny_sub). No default.
\ap\pa
        [not1,not2,...]= The list of unobserved subrasters. For example, if 
                   the subrasters 3 to 5 and 10 of a sequence of observations 
                   were not observed then the input should be 3:5,10. The 
                   number of unobserved subrasters plus the number of frames
                   in the input catalogue must equal to nx_sub*ny_sub. No
                   default.
\ap\pa
        [nocol,norow]= The number of columns and rows in the output frame. If 
                   nocols is 0 then the program will compute the number of 
                   columns using the size of the input subrasters. Default 0,0.

\ap\no
Note:
        The command CREATE/MOSAIC is controlled by the input parameters and an 
        additional number of CCD keywords: \\
        MO_SEC   - area in the input subraster to determine the mean;\\
        MO_SUBT  - to switch on/off ther subtraction of the mean;\\
        MO_CORN  - to define the starting corner (ll, lr, ul, ur);\\
        MO_DIREC - to define the direction of writing (row or column);\\
        MO_RAST  - to add subrasters in a raster pattern, or to returning to 
                   the start of the column or row;\\
        MO_OVER  - to define the number of blank lines between subrasters;\\
        MO_TRIM  - to  trim columns and rows of the the subrasters;\\
        MO_BLANK - to define the pixel intensity in undefined regions.
\\   
        CREATE/MOSAIC takes a catalogue of subrasters with identical 
        dimensions and combines them into a single output frame.
        The order in which the subrasters are placed in the output frame is 
        determined by the CCD keywords MO_CORN, MO_DIREC, and MO_RAST.
        The size of the individual subrasters in the output frame may 
        be altered by setting the MO_TRIM keyword.
\\
        CREATE/MOSAIC uses the subraster size, the number of subrasters, the 
        MO_NOVER keywords, and the nx_sub and ny_sub parameters to compute 
        the size of the output frame. A frame of size larger than the minimum 
        required can be specified by setting nocols and norows parameters.
        Undefined regions of the output frame are given the value MO_NUL.
\\
        The median of a section each subraster may be optionally computed
        and placed in the database file by setting MO_SEC keyword.
        The computed median will be subtracted from the input subrasters if
        the keyword MO_SUBT is set to yes.
\on\see
See also:   
        SET/CCD, SHOW/CCD, SHIFT/MOSAIC, OFFSET/MOSAIC, ALIGN/MOSAIC, 
        MATCH/MOSAIC
\ees\exs
Examples:
\ex
        CREATE/MOSAIC in_cat mosaic mosaic.dat 8,8
        Mosaic a catalogue of 64 infrared frame onto an 8 by 8 grid in column 
        order starting in lower list corner. Allow one blank column and row
        between each subraster.
\xe\ex  
        CREATE/MOSAIC in_cat mosaic mosaic.dat 8,8 3,9
        Mosaic a list of 62 infrared frame onto an 8 by 8 grid in column order
        starting in the lower left corner. Allow one blank column and row
        between each subraster. Subrasters 3 and 9 in the sequence do not exist
        and are to be replaced in the output frame with the unknown value 
        stored in the keyword MO_NUL.
\xe \sxe