Difference between revisions of "PDS4 Viewer"

From The SBN Wiki
Jump to navigation Jump to search
m (Change TOC position)
(Updated for v0.5 of pds4_viewer)
Line 3: Line 3:
 
'''PDS4 Viewer'''  
 
'''PDS4 Viewer'''  
 
* A read-in and visualization tool for PDS4 data
 
* A read-in and visualization tool for PDS4 data
* Available stand-alone, no installation necessary, on Windows and Mac (Linux planned)
+
* Available stand-alone, no installation necessary, on Windows, Mac and Linux
 
* Supports all[[PDS4 Viewer#Supported Data Structures|**]] PDS4 data (images, spectra, arrays, tables)
 
* Supports all[[PDS4 Viewer#Supported Data Structures|**]] PDS4 data (images, spectra, arrays, tables)
  
Line 12: Line 12:
 
* Summary View: displays a summary of the available data structures in the label, giving various options to view them
 
* Summary View: displays a summary of the available data structures in the label, giving various options to view them
 
* Image View: displays N-dimensional images and spectra, allowing for zoom, rotation, pan, axis-inversion, colormap manipulation, scaling, etc.  
 
* Image View: displays N-dimensional images and spectra, allowing for zoom, rotation, pan, axis-inversion, colormap manipulation, scaling, etc.  
* Table View: displays PDS4 character and binary data tables, including arbitrarily nested GROUP fields (sub-tables). <br>  
+
* Table View: displays all PDS4 tables and arrays as tables, including arbitrarily nested GROUP fields (sub-tables). <br>  
 
* Plot View: Not currently available but in the future will allow plotting columns against each other.
 
* Plot View: Not currently available but in the future will allow plotting columns against each other.
 
* Label View: Easy, human-readable, access to meta-data (such as structure labels, display settings and spectral characteristics, etc.)
 
* Label View: Easy, human-readable, access to meta-data (such as structure labels, display settings and spectral characteristics, etc.)
Line 20: Line 20:
 
== Download ==  
 
== Download ==  
  
Latest version, 0.4, was released on December 3, 2015.
+
Latest version, 0.5, was released on March 10, 2016.
  
 
=== Windows ===  
 
=== Windows ===  
  
Windows Vista, 7, 8 and 10 are supported. <br> Download for Windows 64-bit: [[Media:PDS4 viewer windows-0.4.zip|File:PDS4 viewer windows-0.4.zip]].
+
Windows Vista, 7, 8 and 10 are supported. <br> Download for Windows 64-bit: [[Media:PDS4 viewer windows-0.5.zip|File:PDS4 viewer windows-0.5.zip]].
  
 
=== Mac OS X ===
 
=== Mac OS X ===
  
Mac OS X 10.6 (Snow Leopard) through 10.11 (El Capitan) are supported. <br> Download for Mac OS X: [[Media:PDS4 viewer mac-0.4.zip|File:PDS4 viewer mac-0.4.zip]].
+
Mac OS X 10.6 (Snow Leopard) through 10.11 (El Capitan) are supported. <br> Download for Mac OS X: [[Media:PDS4 viewer mac-0.5.zip|File:PDS4 viewer mac-0.5.zip]].
  
 
=== Linux ===
 
=== Linux ===
  
A Linux binary version is not yet available. <br> A Python version is available for [[Python PDS4 Tools|download]].
+
RedHat 7, CentOS 7, Fedora 19+, Ubuntu 13+, Mint 15+, Debian 8+, openSUSE 13+ are supported. <br> Download for Linux (newer) 64-bit: [[Media:PDS4 viewer centos7-0.5.zip|File:PDS4 viewer centos7-0.5.zip]] <br>
 +
 
 +
RedHat 6, CentOS 6, and potentially other older Linux distributions. <br> Download for Linux (older) 64-bit: [[Media:PDS4 viewer centos6-0.5.zip|File:PDS4 viewer centos6-0.5.zip]]<br>
 +
 
 +
If you use a Linux distribution other than those above, and neither of the above versions work for your distribution, you can run the viewer from Python, available [[Python PDS4 Tools|here]].
  
 
=== Source ===
 
=== Source ===
Line 49: Line 53:
 
=== Mac OS X ===
 
=== Mac OS X ===
  
Extract the ZIP file. Double click on "<tt>pds4_viewer.app"</tt>
+
Extract the ZIP file. Double click on "<tt>pds4_viewer.app"</tt>.
  
 
On newer OS X versions a Security Warning may popup, which will not allow you to proceed. Instead hold the 'Control' key, then click on the app icon again and choose 'Open' from the shortcut window.
 
On newer OS X versions a Security Warning may popup, which will not allow you to proceed. Instead hold the 'Control' key, then click on the app icon again and choose 'Open' from the shortcut window.
Line 55: Line 59:
 
=== Linux ===
 
=== Linux ===
  
Installation instructions are available [[Python PDS4 Tools#Installation|here]].
+
Extract the ZIP file. Add permissions to execute (via "<tt>chmod +x pds4_viewer</tt>") and then double click on "<tt>pds4_viewer"</tt> or run it from command line.  
  
 
== Supported Data Structures ==
 
== Supported Data Structures ==
Line 62: Line 66:
 
PDS3 Data Standards are not supported.
 
PDS3 Data Standards are not supported.
  
The table below lists the main [[Filling_Out_the_File_Area_Observational_Classes#Data_Structures|PDS4 data structure]] and the current status. <br><br>
+
The table below lists the main [[Filling_Out_the_File_Area_Observational_Classes#Data_Structures|PDS4 data structure]] and the current status. <br>
  
 
{| class="wikitable" style="text-align: center; width: 800px; "  
 
{| class="wikitable" style="text-align: center; width: 800px; "  
Line 76: Line 80:
 
| Yes
 
| Yes
 
| Yes, N-dims
 
| Yes, N-dims
| Future Development
+
| Under Development
 
|-
 
|-
 
| style="text-align: left;" | Array_2D  
 
| style="text-align: left;" | Array_2D  
Line 82: Line 86:
 
| Yes
 
| Yes
 
| Yes
 
| Yes
| Future Development
+
| Under Development
 
|-
 
|-
 
| style="text-align: left;" | Array_2D_*  
 
| style="text-align: left;" | Array_2D_*  
Line 88: Line 92:
 
| Yes
 
| Yes
 
| Yes
 
| Yes
| Future Development
+
| Under Development
 
|-
 
|-
 
| style="text-align: left;" | Array_3D
 
| style="text-align: left;" | Array_3D
Line 94: Line 98:
 
| Yes
 
| Yes
 
| Yes
 
| Yes
| Future Development
+
| Under Development
 
|-
 
|-
 
| style="text-align: left;" | Array_3D_*
 
| style="text-align: left;" | Array_3D_*
Line 100: Line 104:
 
| Yes
 
| Yes
 
| Yes
 
| Yes
| Future Development
+
| Under Development
 
|-
 
|-
 
| style="text-align: left;" | Table_Character
 
| style="text-align: left;" | Table_Character
Line 106: Line 110:
 
| Yes
 
| Yes
 
| No
 
| No
| Future Development
+
| Under Development
 
|-
 
|-
 
| style="text-align: left;" | Table_Binary
 
| style="text-align: left;" | Table_Binary
Line 112: Line 116:
 
| Yes
 
| Yes
 
| No  
 
| No  
| Future Development
+
| Under Development
 
|-
 
|-
 
| style="text-align: left;" | Table_Delimited
 
| style="text-align: left;" | Table_Delimited
| Under development
+
| Yes
| Under development
+
| Yes
 
| No
 
| No
| Future Development
+
| Under Development
 
|}
 
|}
  

Revision as of 20:55, 10 March 2016

PDS4 Viewer

  • A read-in and visualization tool for PDS4 data
  • Available stand-alone, no installation necessary, on Windows, Mac and Linux
  • Supports all** PDS4 data (images, spectra, arrays, tables)

Features

See screenshots of the tool.

  • Summary View: displays a summary of the available data structures in the label, giving various options to view them
  • Image View: displays N-dimensional images and spectra, allowing for zoom, rotation, pan, axis-inversion, colormap manipulation, scaling, etc.
  • Table View: displays all PDS4 tables and arrays as tables, including arbitrarily nested GROUP fields (sub-tables).
  • Plot View: Not currently available but in the future will allow plotting columns against each other.
  • Label View: Easy, human-readable, access to meta-data (such as structure labels, display settings and spectral characteristics, etc.)

Contact Lev Nagdimunov with questions or comments regarding this tool.

Download

Latest version, 0.5, was released on March 10, 2016.

Windows

Windows Vista, 7, 8 and 10 are supported.
Download for Windows 64-bit: File:PDS4 viewer windows-0.5.zip.

Mac OS X

Mac OS X 10.6 (Snow Leopard) through 10.11 (El Capitan) are supported.
Download for Mac OS X: File:PDS4 viewer mac-0.5.zip.

Linux

RedHat 7, CentOS 7, Fedora 19+, Ubuntu 13+, Mint 15+, Debian 8+, openSUSE 13+ are supported.
Download for Linux (newer) 64-bit: File:PDS4 viewer centos7-0.5.zip

RedHat 6, CentOS 6, and potentially other older Linux distributions.
Download for Linux (older) 64-bit: File:PDS4 viewer centos6-0.5.zip

If you use a Linux distribution other than those above, and neither of the above versions work for your distribution, you can run the viewer from Python, available here.

Source

The source code, which is written in Python, is available for download.

Installation

Windows

Extract the ZIP file. Double click on "pds4_viewer.exe".

On newer Windows versions a Security Warning may popup. Click 'Run' or click 'More Info' and then 'Run' to ignore the warning.

Mac OS X

Extract the ZIP file. Double click on "pds4_viewer.app".

On newer OS X versions a Security Warning may popup, which will not allow you to proceed. Instead hold the 'Control' key, then click on the app icon again and choose 'Open' from the shortcut window.

Linux

Extract the ZIP file. Add permissions to execute (via "chmod +x pds4_viewer") and then double click on "pds4_viewer" or run it from command line.

Supported Data Structures

PDS4 Data Standards >= v1.0 are supported.
PDS3 Data Standards are not supported.

The table below lists the main PDS4 data structure and the current status.

Structure Read-in Display as Table Display as Image Display Columns as Plot
Array Yes Yes Yes, N-dims Under Development
Array_2D Yes Yes Yes Under Development
Array_2D_* Yes Yes Yes Under Development
Array_3D Yes Yes Yes Under Development
Array_3D_* Yes Yes Yes Under Development
Table_Character Yes Yes No Under Development
Table_Binary Yes, except BitFields Yes No Under Development
Table_Delimited Yes Yes No Under Development

Screenshots

PDS4 Viewer
PDS4 Viewer's Image View example
PDS4 Viewer
PDS4 Viewer's Label Image View example (with additional options shown)
PDS4 Viewer
PDS4 Viewer's Label Table View example (with sub-table shown)
PDS4 Viewer
PDS4 Viewer's Label Summary and Label View example