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 import picmaker). 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 import picmaker
from picmaker.options import get_parser

# Let the argument parser fill in every default, then run the pipeline.
options = get_parser().parse_args([
    'input.IMG',
    '--directory', 'out/',
    '--extension', 'jpg',
    '--percentiles', '1', '99',
    '--gamma', '0.7',
])
picmaker(**vars(options))

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.