rms-picmaker

GitHub release; latest by date GitHub Release Date Test Status Documentation Status Code coverage
PyPI - Version PyPI - Format PyPI - Downloads PyPI - Python Version
GitHub commits since latest release GitHub commit activity GitHub last commit
Number of GitHub open issues Number of GitHub closed issues Number of GitHub open pull requests Number of GitHub closed pull requests
GitHub License Number of GitHub stars GitHub forks DOI

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

Licensing

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

Project links

Data verified by PyPI on Aug 4, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for pdsrmsnode from gravatar.com pdsrmsnode

Credits

Author/Maintainer: Robert S. French

GitHub Statistics

Data verified by PyPI on Aug 4, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

Apache Software License (Apache-2.0)

Requires

Python >=3.12

Provides Extra

dev docs

Tags

astronomy PDS3 VICAR FITS imaging image conversion JPEG PNG TIFF planetary science

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

rms_picmaker-2.1.0.tar.gz (38.0 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

rms_picmaker-2.1.0-py3-none-any.whl (89.2 kB view details)

Uploaded Python 3

File details

Details for the file rms_picmaker-2.1.0.tar.gz.

File metadata

  • Download URL: rms_picmaker-2.1.0.tar.gz
  • Upload date:
  • Size: 38.0 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for rms_picmaker-2.1.0.tar.gz
Algorithm Hash digest
SHA256 a92dc8ca78f5aa780e7baccd3a7a0326320d748192069214fbe02ea6df4d6e07
MD5 abda421fa216962402ae0c9ba7268c30
BLAKE2b-256 8a96bf3504f4d582529bd278537f7f5fcb9a8d3f15418594b30b27b8485fb32a

See more details on using hashes here.

Provenance

The following attestation bundles were made for rms_picmaker-2.1.0.tar.gz:

Publisher: publish_to_pypi.yml on SETI/rms-picmaker

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file rms_picmaker-2.1.0-py3-none-any.whl.

File metadata

  • Download URL: rms_picmaker-2.1.0-py3-none-any.whl
  • Upload date:
  • Size: 89.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for rms_picmaker-2.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 84f1b26a1ffd34d17cfa3bdb66303960c287ec5c0aec708c4586a1cf71807393
MD5 15211d4affc4fe06c561e80259250c2b
BLAKE2b-256 1c8011d2623cc49960a4aeab918d0885b82ab75cc628eef9d4476eade43c20c0

See more details on using hashes here.

Provenance

The following attestation bundles were made for rms_picmaker-2.1.0-py3-none-any.whl:

Publisher: publish_to_pypi.yml on SETI/rms-picmaker

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

2.1.0 This release

2 files

2.0.0

2 files

1.1.0

2 files

1.0.1

2 files

1.0.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page