Skip to main content
Join the official Python Developers Survey 2018 and win valuable prizes: Start the survey!

Planetary image parser supporting

Project description

https://travis-ci.org/planetarypy/planetaryimage.svg?branch=master https://img.shields.io/pypi/v/planetaryimage.svg

NOTE This is Alpha quality software that is being actively developed, use at your own risk.

Planetary image parser

Features

  • Reads in PDS Images as NumPy arrays.
    • Supports GZIP and BZ2 compressed PDS Images.
    • Supports writing out PDS3 images.
  • Reads in Isis Cube Files as NumPy arrays.

Check out a few simple examples of opening and viewing PDS and Isis CubeFiles in an IPython notebook.

Quickstart

The example below will walk you through setting up a Python virtual environment and installing the necessary software as well as a few handy extras. It then downloads a sample Pancam PDS image, opens and displays that image in your web browser in an IPython Notebook. The example assumes you have Python, virtualenv, and pip installed on your system. If you don’t, don’t know what this means or aren’t thrilled by the opportunity to learn what this means, this software may be a little too immature for you to use at this point.

Create and activate a virtual environment:

virtualenv venv
source venv/bin/activate

Upgrade pip, then pip install the package and IPython notebook and matplotlib to help display the image:

pip install -U pip
pip install planetaryimage matplotlib ipython[notebook]

This quick example will show how to open and display a Pancam PDS image using this module. First, grab a sample image:

wget http://pds-imaging.jpl.nasa.gov/data/mer/opportunity/mer1po_0xxx/data/sol2840/edr/1p380322615effbr43p2443l1m1.img

Now run python in an IPython Notebook (a browser window should pop up after entering the following command):

$ ipython notebook

Create a new notebook in your web browser and then paste the following code into a cell and execute it by pressing Shift+ENTER. This will load and display the image:

%matplotlib inline
import matplotlib.pyplot as plt
from planetaryimage import PDS3Image
image = PDS3Image.open('1p380322615effbr43p2443l1m1.img')
plt.imshow(image.image, cmap='gray')

See Usage for full documentation on how to use planetaryiamge.

History

0.4.1 (2016-03-26)

  • Fixes to saving PDS3 images files after modification of the data.

0.4.0 (2016-03-05)

  • Added basic support for saving PDS3 images.

0.3.0 (2015-09-29)

  • Added support for opening PDS images that are gzip or bz2 compressed.

0.2.0 (2015-06-17)

  • Improved support for float type PDS3 image types. Many types still not supported.

0.1.0 (2015-06-03)

  • First release on PyPI. Basic PDS and Isis Cube File parsing works.

Project details


Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
planetaryimage-0.4.1-py2.py3-none-any.whl (12.7 kB) Copy SHA256 hash SHA256 Wheel 2.7 Mar 27, 2016
planetaryimage-0.4.1.tar.gz (89.2 kB) Copy SHA256 hash SHA256 Source None Mar 27, 2016

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page