Difference between revisions of "PDS4 Viewer"
m |
(Updated for v1.2 of pds4_viewer) |
||
(25 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 | + | * 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==== | ||
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 | + | * Table View: displays all PDS4 tables and arrays as tables, including arbitrarily nested GROUP fields (sub-tables). <br> |
− | * Plot View: | + | * 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, | + | Latest version, 1.2, was released on October 4, 2020. |
=== Windows === | === Windows === | ||
− | Windows | + | 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. | + | 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: <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: <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]]. | ||
=== 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 === | ||
− | + | 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 | + | 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 | ||
− | | | + | | Yes, 1-D only |
|- | |- | ||
| style="text-align: left;" | Array_2D | | style="text-align: left;" | Array_2D | ||
Line 81: | Line 97: | ||
| Yes | | Yes | ||
| Yes | | Yes | ||
− | | | + | | No |
|- | |- | ||
| style="text-align: left;" | Array_2D_* | | style="text-align: left;" | Array_2D_* | ||
Line 87: | Line 103: | ||
| Yes | | Yes | ||
| Yes | | Yes | ||
− | | | + | | No |
|- | |- | ||
| style="text-align: left;" | Array_3D | | style="text-align: left;" | Array_3D | ||
Line 93: | Line 109: | ||
| Yes | | Yes | ||
| Yes | | Yes | ||
− | | | + | | No |
|- | |- | ||
| style="text-align: left;" | Array_3D_* | | style="text-align: left;" | Array_3D_* | ||
Line 99: | Line 115: | ||
| Yes | | Yes | ||
| Yes | | Yes | ||
− | | | + | | No |
|- | |- | ||
| style="text-align: left;" | Table_Character | | style="text-align: left;" | Table_Character | ||
Line 105: | Line 121: | ||
| Yes | | Yes | ||
| No | | No | ||
− | | | + | | Yes |
|- | |- | ||
| style="text-align: left;" | Table_Binary | | style="text-align: left;" | Table_Binary | ||
Line 111: | Line 127: | ||
| Yes | | Yes | ||
| No | | No | ||
− | | | + | | Yes |
|- | |- | ||
| style="text-align: left;" | Table_Delimited | | style="text-align: left;" | Table_Delimited | ||
− | | | + | | Yes |
− | | | + | | Yes |
+ | | No | ||
+ | | Yes | ||
+ | |- | ||
+ | | style="text-align: left;" | Composite_Structure | ||
+ | | No | ||
+ | | No | ||
+ | | No | ||
| No | | No | ||
− | |||
|} | |} | ||
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 | + | [[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 | + | [[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
- 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 |