Repository files navigation

PDSView provides support for visualizing PDS3 and PDS4 data products.

• Visualization of PDS3 data products
• Visualization of PDS4 data products

Prebuilt packages of PDSView are available; simply download the versionrelevant to your platform from the project's GitHubreleases page (click"Assets" under your chosen release version). Details for each platform aregiven below.

Download and unpackPDSView-linux.zip to extract the executable filePDSView; run this file. Note you'll need to be running the X WindowSystem. Depending on your window manager, you may be able to drag files fromthe file explorer on your platform directly into PDSView's main window.Otherwise, choose "Open" from the tool's "File" menu to open PDS dataproducts.

Download and unpackPDSView-macOS.zip to extract the executablePDSView.app which you can drag to your/Applications folder or otherconvenient location. Note that because this is an unsigned program, you willneed to control-click (⌃+click) or right-click its icon and choose "Open",followed by clicking the "Open" button, to start PDSView. The tool is known towork on the following versions of macOS:

• 10.13.6 "High Sierra"
• 10.14.3–6 "Mojave"

Other releases may or may not work. In addition, drag-and-drop from Finder orthe desktop is not guaranteed to work on macOS at all. In this case, choosing"Open" from the "File" menu is recommended.

Two downloads are provided and tested on 64-bit Windows version 10. Theseversions are identical except as noted below:

• PDSView-Windows-single-exe.zip. Downloading and unpacking this archiveyields a single executable filePDSView.exe that you can double-click tolaunch. Note that it may take along time for the tool to launch and itsinitial window to appear.Pro: single, easy to find.exe file.Con:Slow time to start the program.
• PDSView-dir.zip. Downloading and unpacking this archive yields adirectory of many files with aPDSView.exe file inside. Double-clickthis file to launch; the window will appear much faster.Pro: Fast start.Con: harder to find the.exe file in a directory littered withhundreds of other files.

Which one you use is a matter of preference. Regardless, drag-and-drop fromthe Windows desktop or file Explorer works fine. (Other versions of Windowsare untested; we would love to hear back with your success stories.)

For platforms not covered above, you can download the source code from thereleases page (click "Assets" under the appropriate release version) aseither azip or atar.gz archive. Your system will require thefollowing:

• Python 2.7
• Qt4
• PyQt4
• PDS4 Tools

See your system documentation or packaging manager to install thesedependencies. (A Python "virtualenv" is recommended to keep from pollutingyour system Python with extraneous packages.) Once installed, you can run thetool from the unpacked archive using the prepared Python.

For example, a Unix-like (including macOS-like) system could do the following:

# == Install Python 2.7, Qt4, and PyQt4 per platform-specifics ==# (commands not shown here)# == Create a virtualenv sandbox and install PDS4 tools into it ==virtualenv --system-site-packages /tmp/mypythoncd /tmp/mypthonbin/pip install matplotlib seaborn# == Download and extract PDSView ==curl -L 'https://github.com/NASA-PDSr/pds-view/archive/v0.1-beta.tar.gz' | tar xzf -cd pds-view-0.1-beta# == Install its dependencies ==../bin/python setup.py develop# == Run it ==env MPLBACKEND=Qt4Agg ../bin/PDSView

Adjust the above commands as needed for your platform.

Additional documentation is available in thedocs directory and athttps://pds-cm.jpl.nasa.gov/pds4/preparation/inspect/ … note this is onlyavailable within the Jet Propulsion Laborary.

This product has not been translated into any other languages than US English.

Within the NASA Planetary Data System, we value the health of our community as much as the code. Towards that end, we ask that you read and practice what's described in these documents:

• Ourcontributor's guide delineates the kinds of contributions we accept.
• Ourcode of conduct outlines the standards of behavior we practice and expect by everyone who participates with our software.

Meanwhile please check out:

• Ourissue tracker
• And thesource Code

If you are having issues, please let us know. You can reach us athttps://pds.nasa.gov/contact/contact.shtml

The project is licensed under the Apache License, version 2. See theLICENSE.md file for details.