Name
ipaste - paste an image into another
Synopsis
ipaste [parameters] [options] frame insert [out]
Description
ipaste inserts an image into another one. insert is the
image to insert and frame the image which receives the
insertion. Default output name is 'pasted.fits'.
ipaste requires 2 coordinates in the frame image referen-
tial, indicating the point where the first pixel of the
insert image should be pasted. The image is then inserted
in its original orientation.
If the inserted image is too big to fit on right or top
side, it is clipped to the frame image limits ( ipaste
outputs a warning).
Default is: insert image starting from lower left corner
(1,1) of frame image.
Coordinates are referred to as in the FITS standard: lower
left pixel is (1,1), x increasing from left to right and y
increasing from bottom to top.
Options
-x LowerLeftXPosInFrame
Defines x coordinate lower left corner of place to
insert. Default is 1 (first column on left).
-y LowerLeftYPosInFrame
Defines y coordinate lower left corner of place to
insert. Default is 1 (first line on bottom).
Example
The frame image is frame.fits, the inserted one is
pad.fits, the output name being defaulted. Let frame.fits
be of size 400x300, and pad.fits be 20x10. To insert
pad.fits in the upper right corner of frame.fits, do:
% ipaste -x 380 -y 290 frame.fits pad.fits
The output is named pasted.fits.
To insert pad.fits in upper left corner of frame.fits, do:
% ipaste -x 1 -y 290 frame.fits pad.fits
To insert in the center of the image, do:
% ipaste -x 190 -y 145 frame.fits pad.fits
Files
Input/output files shall all comply with FITS format.
The original FITS header of the 'frame' FITS file is
conserved along, except for the following keywords: NAXIS,
NAXISn, BITPIX, BSCALE, BZERO, which are related to the
newly created file.
HISTORY keywords are appended to the FITS header to indi-
cate the eclipse process modifications, together with the
command line which was used to generate the file.
See Also
extract