ebas-plot

Plotting utilities for EBAS datasets served via THREDDS/OPeNDAP.

Installation

For normal use, install the latest released version from the public Python Package Index (PyPI):

python3 -m pip install ebas-plot

This installs a fixed release, such as 0.1.0, together with its required dependencies. It is the recommended command for users after a version has been published through GitLab CI.

For testing changes that have not yet been published, install the current code directly from the python-package development branch:

python3 -m pip install "git+https://git.nilu.no/ebas/ebas-web/ebas-web-plotting.git@python-package"

This bypasses PyPI and installs the latest commit on that branch. It requires Git to be installed and permission to access git.nilu.no; use it only when you need unreleased changes.

Usage

Command line

ebas-plot <url>

<url> can be a local EBAS NetCDF file or a remote EBAS dataset:

• /path/to/dataset.nc
• https://doi.nilu.no/doi/8HWP-FRNN
• https://doi.org/10.48597/8HWP-FRNN
• https://thredds.nilu.no/thredds/dodsC/ebas_doi/...
• https://thredds.nilu.no/thredds/fileServer/ebas_doi/...

The plot type is selected automatically: datasets with a d_D dimension are shown as PNSD heatmaps; other supported EBAS datasets are shown as time series.

Choose the time-series rendering explicitly with --mode line or --mode scatter:

ebas-plot --mode scatter /path/to/dataset.nc

Use --var_plots to open one plot per physical quantity rather than one combined time-series plot:

ebas-plot --var_plots https://doi.nilu.no/doi/8HWP-FRNN

As a library

from ebas_plot import open_dataset, plot, plot_pnsd, plot_timeseries

# Auto-detect a remote dataset's plot type.
fig = plot("https://doi.nilu.no/doi/8HWP-FRNN")
fig.show()

# Open a local EBAS NetCDF file and select scatter points.
ds = open_dataset("/path/to/dataset.nc")
fig = plot_timeseries(ds, mode="scatter")
fig.show()

# Produce one time-series figure per physical quantity.
figures = plot("https://doi.nilu.no/doi/8HWP-FRNN", var_plots=True, mode="line")
for figure in figures:
	figure.show()

Releases

The python-package branch is the release branch. GitLab CI builds the source and wheel distributions for its commits. To publish a new version, update __version__ in ebas_plot.py, push the branch, and run the manual publish job. Configure the protected GitLab CI/CD variable PYPI_TOKEN with a PyPI project-scoped API token before publishing.

License

Copyright (C) 2026 Lise Eder Murberg, Marthe Brevig, and Jonathan Elias Holme.

This project is licensed under the GNU Affero General Public License, version 3 or later (AGPL-3.0-or-later). The full license text is available at https://www.gnu.org/licenses/agpl-3.0.html.