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 out-
     puts 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  con-
     served  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