NAME

wcscopy -- copy the wcs of a reference image to a list of images

USAGE

wcscopy images refimages

PARAMETERS

images

The list of input images which will inherit the wcs of the reference image.

reference

The list of reference images containing the reference wcs. The number of reference images must be one or equal to the number of input images.

verbose = yes

Print messages about the progress of the task?

DESCRIPTION

WCSCOPY copies the world coordinate system information in the header of the reference image reference to the headers of the input images images , replacing any existing world coordinate system information in the input image headers in the process. WCSCOPY assumes that the world coordinate system information in the header of the reference image is accurate and that all the input image have write permission.

If the world coordinate system of reference image cannot be read from the reference image header, the reference and input images do not have the same dimensionality, or the input image does not have write permission, the input image world coordinate system is not modified. If the reference and input images do not have the same size a warning message is issued if verbose is "yes", but the coordinate system is updated.

REFERENCES

Information on IRAF world coordinate systems including more detailed descriptions of the "logical", "physical", and "world" coordinate systems can be found in the help pages for the WCSEDIT and WCRESET tasks. Detailed documentation for the IRAF world coordinate system interface MWCS can be found in the file "iraf$sys/mwcs/MWCS.hlp". This file can be formatted and printed with the command "help iraf$sys/mwcs/MWCS.hlp fi+ | lprint". Information on the spectral coordinates systems and their suitability for use with WCSXYMATCH can be obtained by typing "help specwcs | lprint". Details of the FITS header world coordinate system interface can be found in the document "World Coordinate Systems Representations Within the FITS Format" by Hanisch and Wells, available from our anonymous ftp archive.

EXAMPLES

1. Make sure that the world coordinates systems of a list of input images that have been registered to a reference image with the xregister task are identical to the world coordinate system of the reference image.

	cl> xregister @inlist refimage [200:400,200:400] shifts \
	    output=@outlist xwindow=21 ywindow=21
	cl> wcscopy @outlist refimage

TIME REQUIREMENTS

BUGS

SEE ALSO

tprecess,imalign,xregister,geomap,register,geotran,wcsmap,wregister