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  out-
       put name is ’pasted.fits’.

       ipaste  requires 2 coordinates in the frame image referential, indicat-
       ing 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 xpos
              Defines  x  coordinate  lower  left  corner  of place to insert.
              Default is 1 (first column on left).

       -y ypos
              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  indicate  the
       eclipse process modifications, together with the command line which was
       used to generate the file.

See Also
       extract