Skip to main content

Planetary Data Reader

Project description

README.md

The Planetary Data Reader (pdr)

This tool provides a single command---read(‘/path/to/file’)---for ingesting all common planetary data types. It reads almost all "primary observational data" products currently archived in the PDS (under PDS3 or PDS4), and the fraction of products it does not read is continuously shrinking. Currently-supported datasets are listed here.

If the software fails while attempting to read from datasets that we have listed as supported, please submit an issue with a link to the file and information about the error (if applicable). There might also be datasets that work but are not listed. We would like to hear about those too. If a dataset is not yet supported that you would like us to consider prioritizing, please fill out this request form.

Attribution

If you use pdr in your work, please cite us using our JOSS Paper: DOI. A BibTex style citation is available in CITATION.cff.

Installation

pdr is now on conda and pip. We recommend (and only officially support) installation into a conda environment. You can do this like so:

conda create --name pdrenv
conda activate pdrenv
conda install -c conda-forge pdr

The minimum supported version of Python is 3.9.

Using the conda install will install some optional dependencies in the environment.yml file for pdr including: astropy and pillow. If you'd prefer to forego those optional dependencies, please use minimal_environment.yml in your installation. This is not supported through a direct conda install as described above and will require additional steps. Optional dependencies and the added functionality they support are listed below:

  • pvl: allows Data.load("LABEL", as_pvl=True), which will load PDS3 labels as pvl objects rather than plain text
  • astropy: adds support for FITS files
  • jupyter: allows usage of the Example Jupyter Notebook (and other jupyter notebooks you create)
  • pillow: adds support for reading a variety of 'desktop' image formats (TIFF, JPEG, etc.) and for browse image rendering
  • Levenshtein: allows use of metaget_fuzzy, a fuzzy-matching metadata parsing function

For pip users, no optional dependencies will be packaged with pdr. The extras tags are:

  • pvl: installs pvl
  • fits: installs astropy
  • notebooks: installs jupyter
  • pillow: installs pillow
  • fuzzy: installs Levenshtein

Example syntax for using pip to install syntax with astropy and pillow optional dependencies:

pip install pdr[fits, pillow]

NOTE: pdr is not currently compatible with python 3.13 when installed with pip, it can be used with python 3.13 through conda

Usage

You can check out our example Notebook on a JupyterLite server for a quick interactive demo of functionality: JupyterLite

Additional information on usage including examples, output data types, notes and caveats, tests, etc. can now be accessed in our documentation on readthedocs at: https://pdr.readthedocs.io Documentation Status

Contributing

Thank you for wanting to contribute to pdr and improving efforts to make planetary science data accessible. Please review our code of conduct before contributing. Contributor Covenant

If you have found a bug, a dataset that we claim to support that's not opening properly, or you have a feature request, please file an issue. We will also review pull requests, but would probably prefer you start the conversation with us first, so we can expect your contributions and make sure they will be within scope.

If you need general support you can find us on OpenPlanetary Slack or feel free to email the team.


This work is supported by NASA grant No. 80NSSC21K0885.

Project details


Download files

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

Source Distribution

pdr-1.3.0.tar.gz (13.3 MB view details)

Uploaded Source

Built Distribution

pdr-1.3.0-py3-none-any.whl (13.3 MB view details)

Uploaded Python 3

File details

Details for the file pdr-1.3.0.tar.gz.

File metadata

  • Download URL: pdr-1.3.0.tar.gz
  • Upload date:
  • Size: 13.3 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.11.2 requests/2.32.3 setuptools/75.1.0 requests-toolbelt/1.0.0 tqdm/4.66.5 CPython/3.13.0

File hashes

Hashes for pdr-1.3.0.tar.gz
Algorithm Hash digest
SHA256 2e921294a81c453cde235ee94d6ef3ef3df371762454b1eceabcd520dd009891
MD5 ba41364c50d2de352971dd890c96a508
BLAKE2b-256 1fa0e97808b75d2c50e37b883fd619c9582c5c05bccd92ce31bb5921c5bec27d

See more details on using hashes here.

File details

Details for the file pdr-1.3.0-py3-none-any.whl.

File metadata

  • Download URL: pdr-1.3.0-py3-none-any.whl
  • Upload date:
  • Size: 13.3 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.11.2 requests/2.32.3 setuptools/75.1.0 requests-toolbelt/1.0.0 tqdm/4.66.5 CPython/3.13.0

File hashes

Hashes for pdr-1.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 e478689ce9fa2e8820933c20cc8a13769c69ec63e50a2e73d1b4870914c6434a
MD5 d3dd927c35ea4687048cad85a884c0d6
BLAKE2b-256 c12a09b9ef8e11b964fdc7c466653f3c8a710d4319e410a144d46769ea9c067e

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page