1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
|
Metadata-Version: 2.1
Name: hdf_compass
Version: 0.7b15
Summary: An experimental viewer program for HDF5 and related formats.
Home-page: https://github.com/HDFGroup/hdf-compass/
Author: HDFGroup
Author-email: help@hdfgroup.org
License: BSD-like license
Keywords: data hdf bag ascii grid opendap
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Science/Research
Classifier: Natural Language :: English
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Classifier: Topic :: Office/Business :: Office Suites
Classifier: Topic :: Utilities
License-File: COPYING
Requires-Dist: numpy
Requires-Dist: matplotlib
Requires-Dist: h5py
Requires-Dist: pypubsub
Requires-Dist: wxPython
Requires-Dist: requests
Provides-Extra: geonodes
Requires-Dist: cartopy[plotting]; extra == "geonodes"
Provides-Extra: bag
Requires-Dist: hyo2.bag>=1.2.4; extra == "bag"
Provides-Extra: opendap
Requires-Dist: pydap>=3.2; extra == "opendap"
Provides-Extra: adios
Requires-Dist: adios>=1.9.1b19; extra == "adios"
HDF Compass
===========
.. image:: https://badge.fury.io/py/hdf_compass.svg
:target: https://badge.fury.io/py/hdf_compass
:alt: PyPI Status
.. image:: https://readthedocs.org/projects/hdf-compass/badge/?version=stable
:target: http://hdf-compass.readthedocs.org/en/stable/?badge=stable
:alt: Stable Documentation Status
.. image:: https://readthedocs.org/projects/hdf-compass/badge/?version=latest
:target: http://hdf-compass.readthedocs.org/en/latest/?badge=latest
:alt: Latest Documentation Status
.. image:: https://github.com/HDFGroup/hdf-compass/actions/workflows/hdf-compass_on_windows.yml/badge.svg?branch=py3
:target: https://github.com/HDFGroup/hdf-compassg/actions/workflows/hdf-compass_on_windows.yml
:alt: Windows
.. image:: https://github.com/HDFGroup/hdf-compass/actions/workflows/hdf-compass_on_linux.yml/badge.svg?branch=py3
:target: https://github.com/HDFGroup/hdf-compass/actions/workflows/hdf-compass_on_linux.yml
:alt: Linux
.. image:: https://coveralls.io/repos/github/HDFGroup/hdf-compass/badge.svg?branch=py3
:target: https://coveralls.io/github/HDFGroup/hdf-compass?branch=py3
:alt: coverall
Welcome to the project! HDF Compass is an experimental viewer program for
HDF5 and related formats, designed to complement other more complex
applications like HDFView. Strong emphasis is placed on clean minimal design,
and maximum extensibility through a plugin system for new formats.
HDF Compass is written in Python, but ships as a native application on
Windows, OS X, and Linux, by using PyInstaller to package the app.
Binary executables are available for Windows (Windows 7 or later) and Mac OS X (Yosemite or later) at
the Project Page listed below.
Bug reports and pull requests are welcome! For non-trivial PRs please
open an issue first, so the core developers can give feedback on your idea.
Development Environment
-----------------------
You will need:
* `Python 3.6 <https://www.python.org/downloads/>`_
* `NumPy <https://github.com/numpy/numpy>`_
* `Matplotlib <https://github.com/matplotlib/matplotlib>`_
* `wxPython Phoenix 4.0.0+ <https://github.com/wxWidgets/Phoenix>`_ (`PyPI <https://pypi.python.org/pypi/wxPython>`_ and `extra wheels for Linux <https://wxpython.org/pages/downloads/>`_)
* `Cartopy <https://github.com/SciTools/cartopy>`_
* `h5py <https://github.com/h5py/h5py>`_ *[HDF plugin]*
* `hyo2.bag <https://bitbucket.org/ccomjhc/hyo_bag>`_ *[BAG plugin]*
* `Pydap <https://github.com/robertodealmeida/pydap>`_ *[OPeNDAP plugin]* (>=3.3)
* `Requests <https://github.com/kennethreitz/requests>`_ *[HDF Rest API plugin]*
* `adios <https://github.com/ornladios/ADIOS>`_ *[ADIOS Plugin]* (Linux/OSX only)
For packaging the app:
* `PyInstaller <https://github.com/pyinstaller/pyinstaller>`_ *(>= 3.3 or `latest dev <https://github.com/pyinstaller/pyinstaller/archive/develop.zip>`_ )*
Running the Program
-------------------
``$ python HDFCompass.py``
Note: If you are using the Anaconda distribution on the Mac, you will see the
message: "This program needs access to the screen. Please run with a Framework
build of python...". In this case use the pythonw command:
``$ pythonw HDFCompass.py``
Note: on Mac, HDF Compass doesn't create an initial window, use the system Application
menu to open a file or remote resource.
Note: If you are using conda and see debug message like "No module named 'h5py'" with the h5py package installed,
install python.app: ``$ conda install python.app``
Packaging
---------
Single-file:
``$ pyinstaller --clean -y HDFCompass.1file.spec``
Single-folder (useful for debugging the ``pyinstaller`` settings):
``$ pyinstaller --clean -y HDFCompass.1folder.spec``
Other info
----------
* Github: `http://github.com/HDFGroup/hdf-compass <http://github.com/HDFGroup/hdf-compass>`_
* Project page: `https://www.hdfgroup.org/projects/compass/ <https://www.hdfgroup.org/projects/compass/>`_
* License: BSD-like HDF Group license (See `COPYING <https://raw.githubusercontent.com/HDFGroup/hdf-compass/master/COPYING>`_)
|
