geoviewer
A browser-based viewer for geospatial scientific data — netCDF, HDF5, and GRIB — inspired by NASA Panoply.
Browse a whitelisted server directory, pick a variable, and get an interactive lat/lon map with a time/level slider, colormap control, and a metadata panel. It runs as a single Panel app served over the web, with no uploads — files stay on the server.
Features
- Multi-format readers behind one interface: netCDF (classic and netCDF-4/HDF5-backed), HDF5, and GRIB (via cfgrib/eccodes).
- Variable list with automatic dimension-role detection (
x/y/z/time) via naming heuristics and unit hints. - Interactive map rendered with datashader rasterization (falls back to plain rendering when unavailable).
- Time and vertical-level sliders for N-D variables.
- Colormap picker and per-dimension role overrides.
- Metadata panel showing the selected variable's attributes.
- Directory whitelist with path-traversal protection — server-side browsing only.
Installation
Requires Python 3.11+.
pip install .
For an editable install that includes the test/lint tooling:
pip install -e ".[dev]"
With uv:
uv pip install .
GRIB support needs the eccodes C library; the eccodes wheel bundles it, or install it system-wide (conda install -c conda-forge eccodes).
Usage
Start the server, pointing NC_VIEWER_ROOTS at one or more directories to browse (colon-separated):
NC_VIEWER_ROOTS=/data/mydata:/data/more python -m panel serve app.py --port 5006
Then open http://localhost:5006/app.
To serve on a remote machine, use an SSH tunnel:
ssh -L 5006:127.0.0.1:5006 user@host
Environment variables
| Variable | Default | Description |
|---|---|---|
NC_VIEWER_ROOTS |
. |
Colon-separated whitelisted directories to browse |
NUMBA_CACHE_DIR |
<tmp>/numba_cache |
Numba JIT cache directory (used by datashader rasterization) |
Architecture
readers/ unified Reader abstraction (netCDF / HDF5 / GRIB) -> xarray
services/ catalog whitelist, dimension role model, slice LRU cache
ui/ Panel components (file browser, variable panel, map, controls, metadata)
app.py Panel entrypoint wiring callbacks
Testing
python -m pytest -q
License
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file geoviewer-0.2.0.tar.gz.
File metadata
- Download URL: geoviewer-0.2.0.tar.gz
- Upload date:
- Size: 20.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ebd12d0fa5f16e319d4716360df2fad800222b532921749e976b3e3553414568
|
|
| MD5 |
fabdb596ac027bb75b401e99e2df2490
|
|
| BLAKE2b-256 |
cfb0c08b51b2acdc016499130223c654b2a14b406d1eb5df437e289fa40fbb59
|
Provenance
The following attestation bundles were made for geoviewer-0.2.0.tar.gz:
Publisher:
publish.yml on openEarthModelling/geoviewer
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
geoviewer-0.2.0.tar.gz -
Subject digest:
ebd12d0fa5f16e319d4716360df2fad800222b532921749e976b3e3553414568 - Sigstore transparency entry: 2663206142
- Sigstore integration time:
-
Permalink:
openEarthModelling/geoviewer@886a2749bf8e69788ff743d11eb004888e8bebdf -
Branch / Tag:
refs/heads/main - Owner: https://github.com/openEarthModelling
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@886a2749bf8e69788ff743d11eb004888e8bebdf -
Trigger Event:
workflow_dispatch
-
Statement type:
File details
Details for the file geoviewer-0.2.0-py3-none-any.whl.
File metadata
- Download URL: geoviewer-0.2.0-py3-none-any.whl
- Upload date:
- Size: 19.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2fedb8673e6c30895025581f7805bed2f6cdd7285e7739c587022a735150c23d
|
|
| MD5 |
caec7ed7bf84a569bf7f089b1fbfe760
|
|
| BLAKE2b-256 |
00aefa98aa2e93e66ed01e425b4e4aec519d682d384a73e317fb4cf6e0d830c5
|
Provenance
The following attestation bundles were made for geoviewer-0.2.0-py3-none-any.whl:
Publisher:
publish.yml on openEarthModelling/geoviewer
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
geoviewer-0.2.0-py3-none-any.whl -
Subject digest:
2fedb8673e6c30895025581f7805bed2f6cdd7285e7739c587022a735150c23d - Sigstore transparency entry: 2663206243
- Sigstore integration time:
-
Permalink:
openEarthModelling/geoviewer@886a2749bf8e69788ff743d11eb004888e8bebdf -
Branch / Tag:
refs/heads/main - Owner: https://github.com/openEarthModelling
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@886a2749bf8e69788ff743d11eb004888e8bebdf -
Trigger Event:
workflow_dispatch
-
Statement type:
