Difference between revisions of "PDS4 Viewer"

From The SBN Wiki
Jump to navigation Jump to search
m
(Updated for v1.3 of pds4_viewer)
 
(26 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 +
<div style="clear: {{{clear|right}}}; margin-bottom: .5em; float: right; padding: .5em 0 .8em 1.4em; background: none; width: {{{width|{{{1|auto}}}}}};" {{#if:{{{limit|}}}|class="toclimit-{{{limit}}}"}}>__TOC__</div><noinclude></noinclude>
  
 
'''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)<br>
+
* Supports all[[PDS4 Viewer#Supported Data Structures|**]] PDS4 data (images, spectra, arrays, tables)
  
 
====Features====
 
====Features====
Line 11: 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: allows plotting PDS4 table columns against each other, including error bars.
 
* 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 19: Line 20:
 
== Download ==  
 
== Download ==  
  
Latest version, 0.4, was released on December 3, 2015.
+
Latest version, 1.3, was released on October 10, 2021.
  
 
=== 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 7, 8 and 10 are supported. <br> Download for Windows 64-bit: <span class="plainlinks">[https://pdssbn.astro.umd.edu/toolsrc/pds4_viewer/1.3/PDS4_viewer_windows-1.3.zip File:PDS4 viewer windows-1.3.zip]</span>.
  
 
=== 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.13 (High Sierra) through 11 (Big Sur) are supported. <br> Download for Mac OS X (newer): <span class="plainlinks">[https://pdssbn.astro.umd.edu/toolsrc/pds4_viewer/1.3/PDS4_viewer_mac10_13-1.3.zip File:PDS4 viewer mac10_13-1.3.zip]</span>.
 +
 
 +
Mac OS X 10.6 (Snow Leopard) through 10.12 (Sierra) are supported. <br> Download for Mac OS X (older): <span class="plainlinks">[https://pdssbn.astro.umd.edu/toolsrc/pds4_viewer/1.3/PDS4_viewer_mac10_6-1.3.zip File:PDS4 viewer mac10_6-1.3.zip]</span>.
 +
 
 +
<nowiki>**</nowiki>Mac OS X 10.14.6 is currently unsupported, due to a significant upstream bug.
  
 
=== 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: <span class="plainlinks">[https://pdssbn.astro.umd.edu/toolsrc/pds4_viewer/1.3/PDS4_viewer_centos7-1.3.zip File:PDS4 viewer centos7-1.3.zip]</span>. <br>
 +
 
 +
RedHat 6, CentOS 6, and potentially other older Linux distributions. <br> Download for Linux (older) 64-bit: <span class="plainlinks">[https://pdssbn.astro.umd.edu/toolsrc/pds4_viewer/1.3/PDS4_viewer_centos6-1.3.zip File:PDS4 viewer centos6-1.3.zip]</span> <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 43: Line 52:
 
Extract the ZIP file. Double click on "<tt>pds4_viewer.exe"</tt>.  
 
Extract the ZIP file. Double click on "<tt>pds4_viewer.exe"</tt>.  
  
On newer Windows versions a Security Warning may popup. Click 'Run' or click 'More Info' and then 'Run' to ignore the
+
On newer Windows versions a Security Warning may popup. Click 'Run' or click 'More Info' and then 'Run' to ignore the warning.
warning.
 
  
 
=== 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 54: Line 62:
 
=== 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.
 +
 
 +
An 'Operation not permitted' error can be emitted when /tmp is mounted as noexec; the following [https://pyinstaller.readthedocs.io/en/stable/when-things-go-wrong.html?highlight=noexec#operation-not-permitted-error link] provides for a workaround.
  
 
== Supported Data Structures ==
 
== Supported Data Structures ==
Line 61: Line 71:
 
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 structures]] and the current status. <br>
  
 
{| class="wikitable" style="text-align: center; width: 800px; "  
 
{| class="wikitable" style="text-align: center; width: 800px; "  
Line 70: Line 80:
 
! Display as Image
 
! Display as Image
 
! Display Columns as Plot
 
! Display Columns as Plot
 +
|-
 +
| style="text-align: left;" | Header
 +
| Yes
 +
| No
 +
| No
 +
| No
 
|-
 
|-
 
| style="text-align: left;" | Array  
 
| style="text-align: left;" | Array  
Line 75: Line 91:
 
| Yes
 
| Yes
 
| Yes, N-dims
 
| Yes, N-dims
| Future Development
+
| Yes, 1-D only
 
|-
 
|-
 
| style="text-align: left;" | Array_2D  
 
| style="text-align: left;" | Array_2D  
Line 81: Line 97:
 
| Yes
 
| Yes
 
| Yes
 
| Yes
| Future Development
+
| No
 
|-
 
|-
 
| style="text-align: left;" | Array_2D_*  
 
| style="text-align: left;" | Array_2D_*  
Line 87: Line 103:
 
| Yes
 
| Yes
 
| Yes
 
| Yes
| Future Development
+
| No
 
|-
 
|-
 
| style="text-align: left;" | Array_3D
 
| style="text-align: left;" | Array_3D
Line 93: Line 109:
 
| Yes
 
| Yes
 
| Yes
 
| Yes
| Future Development
+
| No
 
|-
 
|-
 
| style="text-align: left;" | Array_3D_*
 
| style="text-align: left;" | Array_3D_*
Line 99: Line 115:
 
| Yes
 
| Yes
 
| Yes
 
| Yes
| Future Development
+
| No
 
|-
 
|-
 
| style="text-align: left;" | Table_Character
 
| style="text-align: left;" | Table_Character
Line 105: Line 121:
 
| Yes
 
| Yes
 
| No
 
| No
| Future Development
+
| Yes
 
|-
 
|-
 
| style="text-align: left;" | Table_Binary
 
| style="text-align: left;" | Table_Binary
Line 111: Line 127:
 
| Yes
 
| Yes
 
| No  
 
| No  
| Future Development
+
| Yes
 
|-
 
|-
 
| style="text-align: left;" | Table_Delimited
 
| style="text-align: left;" | Table_Delimited
| Under development
+
| Yes
| Under development
+
| Yes
 +
| No
 +
| Yes
 +
|-
 +
| style="text-align: left;" | Composite_Structure
 +
| No
 +
| No
 +
| No
 
| No
 
| No
| Future Development
 
 
|}
 
|}
  
Line 124: Line 146:
 
[[File:Pds4 viewer image view1.png|thumb|upright=3|center|alt=PDS4 Viewer|PDS4 Viewer's Image View example]]
 
[[File:Pds4 viewer image view1.png|thumb|upright=3|center|alt=PDS4 Viewer|PDS4 Viewer's Image View example]]
  
[[File:Pds4 viewer image view2.png|thumb|upright=3|center|alt=PDS4 Viewer|PDS4 Viewer's Label Image View example (with additional options shown)]]
+
[[File:Pds4 viewer image view2.png|thumb|upright=3|center|alt=PDS4 Viewer|PDS4 Viewer's Image View example (with additional options shown)]]
 +
 
 +
[[File:Pds4 viewer plot view.png|thumb|upright=3|center|alt=PDS4 Viewer|PDS4 Viewer's Plot View example]]
  
[[File:Pds4 viewer table view.png|thumb|upright=3|center|alt=PDS4 Viewer|PDS4 Viewer's Label Table View example (with sub-table shown)]]
+
[[File:Pds4 viewer table view.png|thumb|upright=3|center|alt=PDS4 Viewer|PDS4 Viewer's Table View example (with sub-table shown)]]
  
 
[[File:Pds4 viewer summary window.png|thumb|upright=3|center|alt=PDS4 Viewer|PDS4 Viewer's Label Summary and Label View example]]
 
[[File:Pds4 viewer summary window.png|thumb|upright=3|center|alt=PDS4 Viewer|PDS4 Viewer's Label Summary and Label View example]]

Latest revision as of 06:40, 19 October 2021

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: allows plotting PDS4 table columns against each other, including error bars.
  • 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, 1.3, was released on October 10, 2021.

Windows

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

Mac OS X

Mac OS X 10.13 (High Sierra) through 11 (Big Sur) are supported.
Download for Mac OS X (newer): File:PDS4 viewer mac10_13-1.3.zip.

Mac OS X 10.6 (Snow Leopard) through 10.12 (Sierra) are supported.
Download for Mac OS X (older): File:PDS4 viewer mac10_6-1.3.zip.

**Mac OS X 10.14.6 is currently unsupported, due to a significant upstream bug.

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-1.3.zip.

RedHat 6, CentOS 6, and potentially other older Linux distributions.
Download for Linux (older) 64-bit: File:PDS4 viewer centos6-1.3.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.

An 'Operation not permitted' error can be emitted when /tmp is mounted as noexec; the following link provides for a workaround.

Supported Data Structures

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

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

Structure Read-in Display as Table Display as Image Display Columns as Plot
Header Yes No No No
Array Yes Yes Yes, N-dims Yes, 1-D only
Array_2D Yes Yes Yes No
Array_2D_* Yes Yes Yes No
Array_3D Yes Yes Yes No
Array_3D_* Yes Yes Yes No
Table_Character Yes Yes No Yes
Table_Binary Yes, except BitFields Yes No Yes
Table_Delimited Yes Yes No Yes
Composite_Structure No No No No

Screenshots

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