Space Telescope Product Downsampling

pip install stpreview

Usage

❯ uv run stpreview --help
usage: stpreview [-h] [--observatory {roman,jwst}] [--compass]
                 INPUT OUTPUT {to,by} ...

positional arguments:
  INPUT                 path to ASDF file with 2D image data
  OUTPUT                path to output image file
  {to,by}
    to                  downsample the given ASDF image by the given integer
                        factor
    by                  downsample the given ASDF image to the desired shape (the
                        output image may be smaller than the desired shape, if no
                        even factor exists)

options:
  -h, --help            show this help message and exit
  --observatory {roman,jwst}
                        (if omitted, will attempt to infer from file)
  --compass             draw a north arrow on the image

stpreview by

❯ uv run stpreview input.asdf output.png by --help
usage: stpreview INPUT OUTPUT by [-h] FACTOR [FACTOR ...]

positional arguments:
  FACTOR      block size by which to downsample image data

options:
  -h, --help  show this help message and exit

stpreview to

❯ uv run stpreview input.asdf output.png to --help
usage: stpreview INPUT OUTPUT to [-h] SHAPE [SHAPE ...]

positional arguments:
  SHAPE       desired pixel resolution of output image

options:
  -h, --help  show this help message and exit

Examples

downsample a sample Roman image by a factor of 10, and add a compass rose

stpreview /grp/roman/TEST_DATA/23Q4_B11/aligntest/r0000501001001001001_01101_0001_WFI01_cal.asdf docs/images/by.png --compass by 10 10

downsample a sample Roman image to within 300x300 pixels

stpreview /grp/roman/TEST_DATA/23Q4_B11/aligntest/r0000501001001001001_01101_0001_WFI01_cal.asdf docs/images/to.png to 300 300