Difference between revisions of "PDS4 Viewer"

From The SBN Wiki
Jump to navigation Jump to search
m
(Updated for v1.3 of pds4_viewer)
 
(38 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 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)
  
 
====Features====
 
====Features====
  
* Able to display N-dimensional images and spectra, allowing for zoom, rotation, pan, axis-inversion, colormap manipulation, scaling, etc.
+
[[PDS4 Viewer#Screenshots|See screenshots of the tool.]]
* Able to display PDS4 character and binary data tables, including arbitrarily nested GROUP fields (sub-tables). In future, will allow plotting table columns against each other.
 
* Consistent interface allows for easy access to meta-data (such as object labels, display settings and spectral characteristics, etc.)
 
  
[[PDS4 Viewer#Screenshots|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). <br>
 +
* 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 [[User:lnagdi1|Lev Nagdimunov]] with questions or comments regarding this tool.
 
Contact [[User:lnagdi1|Lev Nagdimunov]] with questions or comments regarding this tool.
Line 17: 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. Download for Windows 64-bit: [[File:PDS4 viewer windows-0.4.zip|Windows 64-bit]].
+
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. Download for Mac OS X: [[File:PDS4 viewer mac-0.4.zip|OS X]].
+
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. 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 41: 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 52: 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 ==
  
PDS4 Data Standards < v1.3 are not officially supported but may work.<br>
+
PDS4 Data Standards >= v1.0 are supported.<br>
PDS4 Data Standards >= v1.3 are supported.<br>
 
 
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 objects]] 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 69: 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 74: 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 80: Line 97:
 
| Yes
 
| Yes
 
| Yes
 
| Yes
| Under Development
+
| No
 
|-
 
|-
 
| style="text-align: left;" | Array_2D_*  
 
| style="text-align: left;" | Array_2D_*  
Line 86: Line 103:
 
| Yes
 
| Yes
 
| Yes
 
| Yes
| Under Development
+
| No
 
|-
 
|-
 
| style="text-align: left;" | Array_3D
 
| style="text-align: left;" | Array_3D
Line 92: Line 109:
 
| Yes
 
| Yes
 
| Yes
 
| Yes
| Under Development
+
| No
 
|-
 
|-
 
| style="text-align: left;" | Array_3D_*
 
| style="text-align: left;" | Array_3D_*
Line 98: Line 115:
 
| Yes
 
| Yes
 
| Yes
 
| Yes
| Under Development
+
| No
 
|-
 
|-
 
| style="text-align: left;" | Table_Character
 
| style="text-align: left;" | Table_Character
Line 104: Line 121:
 
| Yes
 
| Yes
 
| No
 
| No
| Under Development
+
| Yes
 
|-
 
|-
 
| style="text-align: left;" | Table_Binary
 
| style="text-align: left;" | Table_Binary
Line 110: Line 127:
 
| Yes
 
| Yes
 
| No  
 
| No  
| Under Development
+
| Yes
 
|-
 
|-
 
| style="text-align: left;" | Table_Delimited
 
| style="text-align: left;" | Table_Delimited
| Future development
+
| Yes
| Future development
+
| Yes
| Future Development
+
| No
| Future Development
+
| Yes
 +
|-
 +
| style="text-align: left;" | Composite_Structure
 +
| No
 +
| No
 +
| No
 +
| No
 
|}
 
|}
  
Line 123: 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