rms-picmaker 1.0.0

Convert PDS3, VICAR, and FITS astronomy images to JPEG, TIFF, and other display formats.

rms-picmaker

Features

rms-picmaker converts binary 2-D or 3-D astronomy images — PDS3-labeled images, VICAR images, and FITS images — into JPEG, TIFF, PNG, or other popular display formats. It is used by the PDS Ring-Moon Systems Node (SETI Institute) for image preview generation.

It ships both as a command-line tool (picmaker) and as an importable Python library (from picmaker.picmaker import images_to_pics). Features include percentile stretching, gamma correction, histogram equalization, colormap and filter-aware tinting, cropping, resizing, padding, and 16-bit TIFF output.

Installation

The picmaker module is available via the rms-picmaker package on PyPI and can be installed with:

pip install rms-picmaker

Getting Started

Convert a single image to JPEG with the defaults:

picmaker input.IMG --directory out/

Process a directory of VICAR images into 8-bit PNGs with a 1–99% percentile stretch and a gamma of 0.7:

picmaker -r --pattern '*.vic' --extension png \
         --percentiles 1 99 --gamma 0.7 \
         --directory out/ inputs/

Use as a library:

from picmaker.picmaker import images_to_pics

images_to_pics(
    ['input.IMG'],
    directory='out/',
    extension='jpg',
    percentiles=(1.0, 99.0),
    gamma=0.7,
)

Security note: picmaker also accepts Python pickle files as a fallback input format. Only pass pickle inputs you trust — unpickling executes arbitrary code from the file.

Details are available in the module documentation.

Contributing

Information on contributing to this package can be found in the Contributing Guide.

Links

• Documentation
• Repository
• Issue tracker
• PyPi

Licensing

This code is licensed under the Apache License v2.0.