meta/l3_resample-1.2.0

Resample Parameters

Outline

Schema Definitions
Original Schema

Schema Definitions ¶

This type is an object with the following properties:

good_bits
string Required
Bit Mask

Bit mask used in the resample step. This key contains strings that correspond to bits in the data quality (DQ) arrays of calibrated rate images. Bits are combined using plus signs (+) and use the bitwise operator tilde (~) to denote exclusion. For example, the string “~DO_NOT_USE+NON_SCIENCE” means to allow all data quality bits except DO_NOT_USE and NON_SCIENCE to be included in the final product. Conversely, a string of “GOOD” would only allow pixels with DQ bits equal to 0 in the calibrated rate images to be included in the final product.

No length restriction
pixel_scale_ratio
number Required
Pixel Scale Ratio

The ratio of the pixel scale compared to the native detector pixel scale. For example, a pixel scale of 0.9 will produce a resampled image with smaller pixels compared to the input calibrated rate images.
pixfrac
number Required
Pixel Fraction

The fraction of a pixel to use for pixel convolution.
pixmap_order
integer
Interpolation order

Order of the 2D spline to interpolate the sparse pixel mapping if stepsize>1. Supported values are: 1 (bilinear) or 3 (bicubic). This parameter is ignored when stepsize <= 1.
pixmap_stepsize
integer
Grid stepsize

If stepsize>1, perform the full WCS calculation on a sparser grid and use interpolation to fill in the rest of the pixels. This option speeds up pixel map computation by reducing the number of WCS calls, though at the cost of reduced pixel map accuracy. The loss of accuracy is typically negligible if the underlying distortion correction is smooth, but if the distortion is non-smooth, stepsize>1 is not recommended. Large stepsize values are automatically reduced to no more than 1/10 of image size.
pointings
integer Required
Number of Input Images

The number of input images combined with resample into an output product.
members
array Required
Resample Input Filenames

Names of the calibrated rate image files input into the resample code to create the output product.

No length restriction

Items in the array are restricted to the following types:

string
No length restriction
weight_type
string Required
Weight Type

The weight type used by the drizzle algorithm in the resample step. The two weight options available are exposure time (“exptime”) and inverse variance map (“ivm”) weighting.

No length restriction

Original Schema ¶

%YAML 1.1
---
$schema: asdf://stsci.edu/datamodels/roman/schemas/rad_schema-1.1.0
id: asdf://stsci.edu/datamodels/roman/schemas/meta/l3_resample-1.2.0

title: Resample Parameters
type: object
properties:
  good_bits:
    title: Bit Mask
    description: >
      Bit mask used in the resample step. This key contains
      strings that correspond to bits in the data quality (DQ) arrays
      of calibrated rate images. Bits are combined using plus signs
      (+) and use the bitwise operator tilde (~) to denote exclusion.
      For example, the string "~DO_NOT_USE+NON_SCIENCE" means to allow
      all data quality bits except DO_NOT_USE and NON_SCIENCE to be
      included in the final product. Conversely, a string of "GOOD"
      would only allow pixels with DQ bits equal to 0 in the
      calibrated rate images to be included in the final product.
    type: string
  pixel_scale_ratio:
    title: Pixel Scale Ratio
    description: >
      The ratio of the pixel scale compared to the native
      detector pixel scale. For example, a pixel scale of 0.9 will
      produce a resampled image with smaller pixels compared to the
      input calibrated rate images.
    type: number
  pixfrac:
    title: Pixel Fraction
    description: The fraction of a pixel to use for pixel convolution.
    type: number
  pixmap_order:
    title: Interpolation order
    description: >
      Order of the 2D spline to interpolate the sparse pixel mapping
      if stepsize>1.  Supported values are: 1 (bilinear) or 3 (bicubic).
      This parameter is ignored when stepsize <= 1.
    type: integer
  pixmap_stepsize:
    title: Grid stepsize
    description: >
      If ``stepsize>1``, perform the full WCS calculation on a sparser
      grid and use interpolation to fill in the rest of the pixels.  This
      option speeds up pixel map computation by reducing the number of WCS
      calls, though at the cost of reduced pixel map accuracy.  The loss
      of accuracy is typically negligible if the underlying distortion
      correction is smooth, but if the distortion is non-smooth,
      ``stepsize>1`` is not recommended.  Large ``stepsize`` values are
      automatically reduced to no more than 1/10 of image size.
    type: integer
  pointings:
    title: Number of Input Images
    description: >
      The number of input images combined with resample into an output product.
    type: integer
  members:
    title: Resample Input Filenames
    description: >
      Names of the calibrated rate image files input into
      the resample code to create the output product.
    type: array
    items:
      type: string
  weight_type:
    title: Weight Type
    description: >
      The weight type used by the drizzle algorithm in the
      resample step. The two weight options available are exposure
      time ("exptime") and inverse variance map ("ivm") weighting.
    type: string
required:
  [good_bits, members, pixel_scale_ratio, pixfrac, pointings, weight_type]