find_optimal_celestial_wcs

reproject.mosaicking.find_optimal_celestial_wcs(input_data, frame=None, auto_rotate=False, projection='TAN', resolution=None, reference=None)[source]

Given one or more images, return an optimal WCS projection object and shape.

This currently only works with 2-d images with celestial WCS.

Parameters:
input_dataiterable

One or more input data specifications to include in the calculation of the final WCS. This should be an iterable containing one entry for each specification, where a single data specification is one of:

  • The name of a FITS file

  • An HDUList object

  • An image HDU object such as a PrimaryHDU, ImageHDU, or CompImageHDU instance

  • A tuple where the first element is an Numpy array shape tuple the second element is either a WCS or a Header object

  • A tuple where the first element is a ndarray and the second element is either a WCS or a Header object

framestr or BaseCoordinateFrame

The coordinate system for the final image (defaults to the frame of the first image specified)

auto_rotatebool

Whether to rotate the header to minimize the final image area (if True, requires shapely>=1.6 to be installed)

projectionstr

Three-letter code for the WCS projection

resolutionQuantity

The resolution of the final image. If not specified, this is the smallest resolution of the input images.

referenceSkyCoord

The reference coordinate for the final header. If not specified, this is determined automatically from the input images.

Returns:
wcsWCS

The optimal WCS determined from the input images.

shapetuple

The optimal shape required to cover all the output.