Difference between revisions of "PDS4 Viewer"

From The SBN Wiki
Jump to navigation Jump to search
m (Updated for v0.52 of pds4_viewer)
(Updated for v1.2 of pds4_viewer)
(20 intermediate revisions by 2 users not shown)
Line 13: Line 13:
 
* 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 all PDS4 tables and arrays as 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 20: Line 20:
 
== Download ==  
 
== Download ==  
  
Latest version, 0.52, was released on April 4, 2016.
+
Latest version, 1.2, was released on October 4, 2020.
  
 
=== Windows ===  
 
=== Windows ===  
  
Windows Vista, 7, 8 and 10 are supported. <br> Download for Windows 64-bit: [[Media:PDS4 viewer windows-0.52.zip|File:PDS4 viewer windows-0.52.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.2/PDS4_viewer_windows-1.2.zip File:PDS4 viewer windows-1.2.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.52.zip|File:PDS4 viewer mac-0.52.zip]].
+
Mac OS X 10.13 (High Sierra) through 10.15** (Catalina) are supported. <br> Download for Mac OS X (newer): <span class="plainlinks">[https://pdssbn.astro.umd.edu/toolsrc/pds4_viewer/1.2/PDS4_viewer_mac10_13-1.2.zip File:PDS4 viewer mac10_13-1.2.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.2/PDS4_viewer_mac10_6-1.2.zip File:PDS4 viewer mac10_6-1.2.zip]</span>.
 +
 
 +
<nowiki>**</nowiki>Mac OS X 10.14.6 is currently unsupported, due to a significant upstream bug.
  
 
=== Linux ===
 
=== Linux ===
  
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.52.zip|File:PDS4 viewer centos7-0.52.zip]] <br>
+
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.2/PDS4_viewer_centos7-1.2.zip File:PDS4 viewer centos7-1.2.zip]</span>. <br>
  
RedHat 6, CentOS 6, and potentially other older Linux distributions. <br> Download for Linux (older) 64-bit: [[Media:PDS4 viewer centos6-0.52.zip|File:PDS4 viewer centos6-0.52.zip]]<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.2/PDS4_viewer_centos6-1.2.zip File:PDS4 viewer centos6-1.2.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]].
 
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]].
Line 48: 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 ===
Line 60: Line 63:
  
 
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.  
 
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 66: 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>
+
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 75: 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 80: Line 91:
 
| Yes
 
| Yes
 
| Yes, N-dims
 
| Yes, N-dims
| Under Development
+
| Yes, 1-D only
 
|-
 
|-
 
| style="text-align: left;" | Array_2D  
 
| style="text-align: left;" | Array_2D  
Line 86: Line 97:
 
| Yes
 
| Yes
 
| Yes
 
| Yes
| Under Development
+
| No
 
|-
 
|-
 
| style="text-align: left;" | Array_2D_*  
 
| style="text-align: left;" | Array_2D_*  
Line 92: Line 103:
 
| Yes
 
| Yes
 
| Yes
 
| Yes
| Under Development
+
| No
 
|-
 
|-
 
| style="text-align: left;" | Array_3D
 
| style="text-align: left;" | Array_3D
Line 98: Line 109:
 
| Yes
 
| Yes
 
| Yes
 
| Yes
| Under Development
+
| No
 
|-
 
|-
 
| style="text-align: left;" | Array_3D_*
 
| style="text-align: left;" | Array_3D_*
Line 104: Line 115:
 
| Yes
 
| Yes
 
| Yes
 
| Yes
| Under Development
+
| No
 
|-
 
|-
 
| style="text-align: left;" | Table_Character
 
| style="text-align: left;" | Table_Character
Line 110: Line 121:
 
| Yes
 
| Yes
 
| No
 
| No
| Under Development
+
| Yes
 
|-
 
|-
 
| style="text-align: left;" | Table_Binary
 
| style="text-align: left;" | Table_Binary
Line 116: Line 127:
 
| Yes
 
| Yes
 
| No  
 
| No  
| Under Development
+
| Yes
 
|-
 
|-
 
| style="text-align: left;" | Table_Delimited
 
| style="text-align: left;" | Table_Delimited
Line 122: Line 133:
 
| Yes
 
| Yes
 
| No
 
| No
| Under Development
+
| Yes
 +
|-
 +
| style="text-align: left;" | Composite_Structure
 +
| No
 +
| No
 +
| No
 +
| No
 
|}
 
|}
  
Line 129: 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]]

Revision as of 22:36, 12 October 2020

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.2, was released on October 4, 2020.

Windows

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

Mac OS X

Mac OS X 10.13 (High Sierra) through 10.15** (Catalina) are supported.
Download for Mac OS X (newer): File:PDS4 viewer mac10_13-1.2.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.2.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.2.zip.

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