mkmosaic (Aug2004) |
rjtools
|
mkmosaic (Aug2004) |
mkmosaic
mkmosaic - combine two images of arbitrary dimensions into a mosaic
image
mkmosaic image1 image2 output [orient] [margin] [bgvalue] [scale]
[zero] [verbose]
- image1 = ""
- Name of first (reference) image to combine into the mosaic
- image2 = ""
- Name of second image to combine into the mosaic
- output = ""
- Name of the output mosaic image
- orient = "right" ["top"|"bottom"|"left"|"right"]
- Insert 'image2' to the top, bottom, left or right of image1 in the output
mosaic image
- margin = 4
- Width (in pixels) of the margin to leave between the images
- bgvalue = -100.
- Background value in the output mosaic image
- scale = 1.
- Scale pixel values in 'image2' by this factor before inserting it into the
output mosaic image. 'scale = 0.' switches on auto-scaling based on matching
the average background value in the two input images.
- zero = 0.
- Add 'zero' to the pixel values in 'image2' before inserting it into the
output mosaic image.
- verbose = yes
- Print information and progress status to the screen?
Task to combine two images of arbitrary dimensions into a mosaic image.
A gap of 'margin' pixels with value 'bgvalue' is left between the two
images. The pixel values of 'image2' will be offset by 'zero' and
multiplied by 'scale' before inserting the image in the output mosaic image.
If 'scale = 0.', auto-scaling is applied (i.e., the background in 'image2'
is matched to that in 'image1'). 'image2' may be placed to the top, bottom,
left or right of 'image1', depending on the value of 'orient'. Default is
to place 'image2' to the right of 'image1'.
If the 'ctio' package is available, task 'imcreate' is used to create
the template for the mosaic image. Otherwise, the mosaic image is
created by block replicating a copy of a small section of "dev$pix.imh".
1. Make a 2 x 1 mosaic of two images next to one another, using auto-scaling
to approximately match the sky intensities:
rj> mkmosaic N3795B[128:384,128:384] N5888B[128:384,128:384] mosaic \
>>> orient="right" scale=0. verbose+
Creating frame "mosaic.fits[518,257]"; pixel value = -100.00
Mosaicing input frames ...
Applying scaling and offset: 0.584089*im2 + 0.00
N3795B.fits[1:257,1:257] --> mosaic.fits[1:257,1:257]
N5888B.fits[1:257,1:257] --> mosaic.fits[262:518,1:257]
Done.
2. To create a 2 x 2 mosaic, first create two 2 x 1 mosaics placing the
two images next to one another, then combine the two 2 x 1 mosaics by
placing them atop one another. This is easy to script when large mosaics
of many images are to be generated.
- MKMOSAIC v2.10, May 10 1995 [R.A. Jansen]
- First version of this task; IRAF 2.10.3
- MKMOSAIC v2.11, Jun 4 2002 [RAJ]
- Replaced call to 'ctio.imcreate' by block replication of a small section of
"dev$pix.imh" because 'imcreate' dies (SuSE Linux and Solaris) because of
what appears to be either an OIF or a Y2K related problem. The header of the
output mosaic is copied from 'image1'. 'chkimg' is now used to check the
images and support multi-extension images and image sections. When 'scale=0.',
auto-scaling is applied; IRAF 2.11.3
- MKMOSAIC v2.12, Aug 15 2003 [RAJ]
- Added check for 'ctio' package: if defined, then use 'imcreate'. A newer
version of 'imcreate' appears to work fine (RedHat 7.x, 8.0, 9). Cleaned-up
code and wrote this help file; IRAF 2.12.1
imcreate, imcopy, chkimg, borderstat, rpparse, rpbuild