Resample Utilities

romancal.resample.resample_utils.make_output_wcs(input_models, pscale_ratio=1.0, pscale=None, rotation=None, shape=None, crpix: tuple[float, float] | None = None, crval: tuple[float, float] | None = None)[source]

Generate output WCS here based on footprints of all input WCS objects

Parameters:

  • input_models (list of roman_datamodels.datamodels.DataModel) – Each datamodel must have a gwcs.wcs.WCS object.

  • pscale_ratio (float, optional) – Ratio of output pixel scale to input pixel scale. Ignored when pscale is provided.

  • pscale (float, None, optional) – Absolute pixel scale in degrees. When provided, overrides pscale_ratio.

  • rotation (float, None, optional) – Position angle (in degrees) of output image’s Y-axis relative to North. A value of 0.0 would orient the final output image to be North up. The default of None specifies that the images will not be rotated, but will instead be resampled in the default orientation for the camera with the x and y axes of the resampled image corresponding approximately to the detector axes.

  • shape (tuple of int, None, optional) – Shape of the image (data array) using numpy.ndarray convention (ny first and nx second). This value will be assigned to pixel_shape and array_shape properties of the returned WCS object.

  • crpix (tuple of float, None, optional) – Position of the reference pixel in the image array. If ref_pixel is not specified, it will be set to the center of the bounding box of the returned WCS object.

  • crval (tuple of float, None, optional) – Right ascension and declination of the reference pixel. Automatically computed if not provided.

Returns:

  • output_wcs (object) – WCS object, with defined domain, covering entire set of input frames

  • pscale (float) – The computed (or provided) input pixel scale.

  • pscale_ratio (float, optional) – The computed (or provided) input pixel scale ratio.