1
% @(#)createmosa.hlq 19.1 (ESO-SDAG) 02/25/03 14:14:59
2
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
3
%.COPYRIGHT (c) 1995 European Southern Observatory
6
%.KEYWORDS MIDAS, ccd package, CREATE/MOSAIC
7
%.PURPOSE On-line help file for the command: CREATE/MOSAIC
8
%.VERSION 950719 RHW created
9
%---------------------------------------------------------------------
13
CREATE/MOSAIC 19-Jul-1995 RHW
15
CREATE/MOSAIC in_cat out_frm out_tab nx_sub,ny_sub [not1,not2,...]
17
Mosaic a set of (infrared) ccd frames
20
Mosaic a set of (infrared) ccd frames
23
CREATE/MOSAIC in_cat out_frm out_tab nx_sub,ny_sub
24
[not1,not2,...] [nocol,norow]
26
in_cat= The input catalogue of input subframes to be mosaiced. The
27
frames are assumed to be ordered either by row, column,
28
or in a raster pattern. If the frame catalogue is not in
29
order the user must correct it or create a new catalogue.
30
The frames in the input catalogue are assumed to have all
31
the same size. No default.
33
out_frm= The name of the output frame. No default.
35
out_tab= The name of the MIDAS table that will contain subframes and
36
parameters produced by the command. This table can be
37
used as input for the command ALIGN/MOSAIC and MATCH/MOSAIC.
39
nx_sub,ny_syb= The number of subrasters along a row of the output
40
frame (nx_sub), and the number of subrasters along a column
41
of the output frame (ny_sub). No default.
43
[not1,not2,...]= The list of unobserved subrasters. For example, if
44
the subrasters 3 to 5 and 10 of a sequence of observations
45
were not observed then the input should be 3:5,10. The
46
number of unobserved subrasters plus the number of frames
47
in the input catalogue must equal to nx_sub*ny_sub. No
50
[nocol,norow]= The number of columns and rows in the output frame. If
51
nocols is 0 then the program will compute the number of
52
columns using the size of the input subrasters. Default 0,0.
56
The command CREATE/MOSAIC is controlled by the input parameters and an
57
additional number of CCD keywords: \\
58
MO_SEC - area in the input subraster to determine the mean;\\
59
MO_SUBT - to switch on/off ther subtraction of the mean;\\
60
MO_CORN - to define the starting corner (ll, lr, ul, ur);\\
61
MO_DIREC - to define the direction of writing (row or column);\\
62
MO_RAST - to add subrasters in a raster pattern, or to returning to
63
the start of the column or row;\\
64
MO_OVER - to define the number of blank lines between subrasters;\\
65
MO_TRIM - to trim columns and rows of the the subrasters;\\
66
MO_BLANK - to define the pixel intensity in undefined regions.
68
CREATE/MOSAIC takes a catalogue of subrasters with identical
69
dimensions and combines them into a single output frame.
70
The order in which the subrasters are placed in the output frame is
71
determined by the CCD keywords MO_CORN, MO_DIREC, and MO_RAST.
72
The size of the individual subrasters in the output frame may
73
be altered by setting the MO_TRIM keyword.
75
CREATE/MOSAIC uses the subraster size, the number of subrasters, the
76
MO_NOVER keywords, and the nx_sub and ny_sub parameters to compute
77
the size of the output frame. A frame of size larger than the minimum
78
required can be specified by setting nocols and norows parameters.
79
Undefined regions of the output frame are given the value MO_NUL.
81
The median of a section each subraster may be optionally computed
82
and placed in the database file by setting MO_SEC keyword.
83
The computed median will be subtracted from the input subrasters if
84
the keyword MO_SUBT is set to yes.
87
SET/CCD, SHOW/CCD, SHIFT/MOSAIC, OFFSET/MOSAIC, ALIGN/MOSAIC,
92
CREATE/MOSAIC in_cat mosaic mosaic.dat 8,8
93
Mosaic a catalogue of 64 infrared frame onto an 8 by 8 grid in column
94
order starting in lower list corner. Allow one blank column and row
95
between each subraster.
97
CREATE/MOSAIC in_cat mosaic mosaic.dat 8,8 3,9
98
Mosaic a list of 62 infrared frame onto an 8 by 8 grid in column order
99
starting in the lower left corner. Allow one blank column and row
100
between each subraster. Subrasters 3 and 9 in the sequence do not exist
101
and are to be replaced in the output frame with the unknown value
102
stored in the keyword MO_NUL.