oceanarray 0.3.0__tar.gz → 0.4.0__tar.gz

oceanarray-0.4.0/.gitattributes

@@ -0,0 +1,8 @@
+# Generated report HTML: exclude both from GitHub language stats and collapse in
+# PR diffs (linguist-generated). Golden fixtures stay diffable — their images are
+# masked, so text/structure diffs are meaningful on rebaseline. The hosted demo
+# reports are pure display artifacts: `binary` (= -diff -merge -text) treats them
+# as opaque blobs — no textual diff, no merge, no line-ending normalization. Both
+# remain tracked/committed (the demo suite is served from _static by Sphinx).
+tests/fixtures/golden/** linguist-generated=true
+docs/source/_static/demo/** linguist-generated=true binary

oceanarray-0.4.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,29 @@
+<!--
+Title: prefix with one tag — [DOC] [FIX] [FEAT] [REFACTOR] [TEST] [CI] [CLEANUP]
+Example: [FIX] Correct dimension handling in RBR reader
+Keep it concise. Delete any section that does not apply (except Summary).
+Write each bullet/paragraph as one continuous line — GitHub soft-wraps.
+-->
+
+## Summary
+
+What changed and why, in one short paragraph.
+
+## What's changed
+
+- Concrete change (one bullet each).
+
+## Breaking changes
+
+Each breaking change and how to migrate (removed/renamed public API or CLI flag, changed signature or parameter meaning, changed output/config layout). Write "None" if there are none — keep the section so reviewers see it was considered.
+
+## Notes
+
+Optional — design decisions or trade-offs, screenshots if outputs changed, related issues (Fixes #, Related to #), and anything reviewers should look at closely.
+
+## Checklist
+
+- [ ] Followed the [code conventions](CONTRIBUTING.md)
+- [ ] Added or updated tests to cover the change
+- [ ] Updated documentation if needed
+- [ ] Ran `ruff check . --fix` and `pytest` — all pass

oceanarray-0.4.0/.github/dependabot.yml

@@ -0,0 +1,18 @@
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "monthly"
+      time: "09:00"
+    open-pull-requests-limit: 5
+    commit-message:
+      prefix: "[CI]"
+      include: "scope"
+    reviewers:
+      - "eleanorfrajka"
+    assignees:
+      - "eleanorfrajka"
+    labels:
+      - "github-actions"
+      - "automated"

{oceanarray-0.3.0 → oceanarray-0.4.0}/.github/workflows/docs.yml

@@ -23,7 +23,7 @@ jobs:
       - name: Setup Micromamba
         uses: mamba-org/setup-micromamba@v2
         with:
-          environment-file: environment.yml
+          environment-file: docs/environment.yml
           init-shell: bash
           condarc: |
             channels:
@@ -35,7 +35,7 @@ jobs:
         shell: bash -l {0}
         run: |
           micromamba run -n oceanarray python -m pip install --upgrade pip
-          micromamba run -n oceanarray python -m pip install -e . --no-deps --force-reinstall
+          micromamba run -n oceanarray python -m pip install -e ".[dev]" --force-reinstall
 
       - name: Build documentation
         shell: bash -l {0}

{oceanarray-0.3.0 → oceanarray-0.4.0}/.github/workflows/docs_deploy.yml

@@ -22,7 +22,7 @@ jobs:
       - name: Setup Micromamba
         uses: mamba-org/setup-micromamba@v2
         with:
-          environment-file: environment.yml
+          environment-file: docs/environment.yml
           init-shell: bash
           condarc: |
             channels:
@@ -34,7 +34,7 @@ jobs:
         shell: bash -l {0}
         run: |
           micromamba run -n oceanarray python -m pip install --upgrade pip
-          micromamba run -n oceanarray python -m pip install -e . --no-deps --force-reinstall
+          micromamba run -n oceanarray python -m pip install -e ".[dev]" --force-reinstall
 
       - name: Build documentation
         shell: bash -l {0}

oceanarray-0.4.0/.github/workflows/tests.yml

@@ -0,0 +1,91 @@
+name: Run tests
+
+on:
+  push:
+    branches: [main]      # post-merge on main only
+  pull_request:           # every PR (branch pushes run here, not twice)
+
+# Cancel superseded runs when a branch/PR is pushed again in quick succession.
+concurrency:
+  group: tests-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  unit:
+    runs-on: ${{ matrix.os }}
+    # Experimental legs (3.13) are allowed to fail without cancelling real jobs.
+    continue-on-error: ${{ matrix.experimental == true }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python-version: ["3.11"]     # full 3-OS coverage on the primary version
+        include:
+          # Verify the supported range (requires-python >=3.10; docs say 3.10–3.12),
+          # ubuntu-only to keep the job count down.
+          - { os: ubuntu-latest, python-version: "3.10" }
+          - { os: ubuntu-latest, python-version: "3.12" }
+          # 3.13: experimental (allow-failure) — deps such as numba/llvmlite
+          # (via pylablib -> seasenselib) may not have 3.13 wheels yet.
+          - { os: ubuntu-latest, python-version: "3.13", experimental: true }
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: "pip"
+
+      - name: Install oceanarray (test extra = runtime + pytest)
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[test]"
+
+      - name: Run unit tests
+        # Coverage gate runs once, on the canonical ubuntu + 3.11 leg; the extra
+        # version legs run --no-cov so they only verify install + test pass.
+        run: >
+          pytest tests/unit -m "not slow and not local and not needs_seasenselib" -q
+          ${{ (matrix.os == 'ubuntu-latest' && matrix.python-version == '3.11') && '--cov=oceanarray --cov-report=term-missing --cov-fail-under=38' || '--no-cov' }}
+
+  integration:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python 3.11
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+          cache: "pip"
+
+      # seasenselib is a core dependency, so the golden integration tests
+      # (stage2/stage3/grid) run for real here rather than skipping.
+      - name: Install oceanarray (test extra)
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[test]"
+
+      - name: Run integration tests
+        run: pytest tests/integration -m "not local" -q
+
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python 3.11
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install ruff
+        run: pip install ruff
+
+      - name: Lint (ruff check)
+        run: ruff check .
+
+      - name: Format check (ruff format)
+        run: ruff format --check .

{oceanarray-0.3.0 → oceanarray-0.4.0}/.gitignore

@@ -22,8 +22,6 @@ debug_caldip.py
 example_caldip_usage.py
 simple_caldip_plot.py
 plot_calibration_data.py
-test_caldip.py
-test_caldip_simple.py
 data/moor/proc_calib/
 calibration_data_plot.png
 calibration_dip_comparison.png
@@ -32,6 +30,9 @@ matlab_calibration/
 logs/*log
 
 
+# macOS
+.DS_Store
+
 # VSCode settings
 .vscode/*
 
@@ -212,3 +213,7 @@ data/moor/raw/msm76_2018/sbe56/DSE18_SBE05606397_2018_08_27.cnv
 data/moor/raw/msm76_2018/sbe56/DSE18_SBE05606401_2018_08_27.cnv
 data/moor/raw/msm76_2018/sbe56/DSE18_SBE05606402_2018_08_27.cnv
 data/moor/raw/msm76_2018/sbe56/DSE18_SBE05606409_2018_08_27.cnv
+
+# Generated report output under test fixtures (HTML + multi-MB PDFs) — regenerated
+# by `oceanarray report ... --pdf`; never commit into history.
+tests/fixtures/proc/*/report/

{oceanarray-0.3.0 → oceanarray-0.4.0}/CHANGELOG.md

@@ -4,6 +4,40 @@ All notable changes to oceanarray are documented here.
 
 ---
 
+## [Unreleased]
+
+## [0.4.0] — 2026-09-08
+
+### Added
+
+- **caldip calibration-dip stub** ([#92](https://github.com/ocean-uhh/oceanarray/pull/92)): `processors/caldip.py` carries the shared contract (constants, `normalize_serial`, `Offsets`) and a five-function interface for the planned front-of-Stage-3 correction. Stage 3 gains a `caldip_dir` argument that is a null action — it logs a warning and stamps a `caldip_applied` provenance attribute — until the correction lands.
+- **PDF reports**: `report --pdf` renders a merged A4 PDF per mooring ([#69](https://github.com/ocean-uhh/oceanarray/pull/69)); `report --pdf-dir DIR` collects each mooring's PDF into one directory ([#90](https://github.com/ocean-uhh/oceanarray/pull/90)), which also sped up PDF rendering (~50 s → ~6 s).
+- **Manifest-driven report system**: a section-manifest model and resolver ([#78](https://github.com/ocean-uhh/oceanarray/pull/78)) now drive the grid ([#79](https://github.com/ocean-uhh/oceanarray/pull/79)) and stack / instrument / mooring ([#80](https://github.com/ocean-uhh/oceanarray/pull/80)) report pages — per-page registries, automatic panel numbering, generated jump-nav, and defect-visible stubs.
+- **`oceanarray run` report redirection** ([#88](https://github.com/ocean-uhh/oceanarray/pull/88)): `run` accepts `-o/--output-dir`, `--report-dir`, and `--sig-level`, threaded through to the report step, so the full pipeline can write a portable central report tree with custom grid isopycnal targets in one command.
+- **Zenodo DOI** ([#68](https://github.com/ocean-uhh/oceanarray/pull/68)): concept-DOI badge in the README and `CITATION.cff`.
+- A hosted, clickable dune2 example report suite in the docs ([#82](https://github.com/ocean-uhh/oceanarray/pull/82)).
+
+### Changed
+
+- **Report subsystem refactor**: vendored the shared design tokens, encoder, and CSS ([#71](https://github.com/ocean-uhh/oceanarray/pull/71)); added a golden-file regression net ([#72](https://github.com/ocean-uhh/oceanarray/pull/72)); renamed `report/` → `reports/` ([#73](https://github.com/ocean-uhh/oceanarray/pull/73)); reworked page templates ([#74](https://github.com/ocean-uhh/oceanarray/pull/74)); encoder / figure sizing ([#75](https://github.com/ocean-uhh/oceanarray/pull/75)); uniform layout fixes ([#76](https://github.com/ocean-uhh/oceanarray/pull/76), [#77](https://github.com/ocean-uhh/oceanarray/pull/77)); plot polish — colorbar ticks, cyclic current direction, T-S bounds, tilt panels ([#83](https://github.com/ocean-uhh/oceanarray/pull/83)); layout polish — shared title helper, trajectory y-labels, clock legend, rose whitespace ([#84](https://github.com/ocean-uhh/oceanarray/pull/84)); smaller files, updated fonts, and multi-panel pagination ([#70](https://github.com/ocean-uhh/oceanarray/pull/70)).
+- **Packaging**: consolidated configuration into `pyproject.toml`, expanded the CI test matrix, and added a ruff lint gate ([#86](https://github.com/ocean-uhh/oceanarray/pull/86)); moved the dev install to pyproject extras ([#85](https://github.com/ocean-uhh/oceanarray/pull/85)); dropped the unused direct `dolfyn` dependency ([#81](https://github.com/ocean-uhh/oceanarray/pull/81)).
+- **Docs**: PyPI-first install instructions ([#81](https://github.com/ocean-uhh/oceanarray/pull/81)); caldip documented as the planned optional front-of-Stage-3 correction ([#91](https://github.com/ocean-uhh/oceanarray/pull/91)).
+
+### Fixed
+
+- Cross-page links now resolve in the merged PDF — the document is built once and rendered once, with per-page anchor-id namespacing ([#89](https://github.com/ocean-uhh/oceanarray/pull/89)).
+- Conservative QC-flag resampling fix, with unit tests added for the pressure, helpers, and qc paths ([#87](https://github.com/ocean-uhh/oceanarray/pull/87)).
+- `process` / `report` / `run` `--help` no longer crash on Python 3.11 — an argparse usage-formatting `AssertionError` from a single-member mutually-exclusive group around the suppressed `--basedir` flag; the group is removed ([#88](https://github.com/ocean-uhh/oceanarray/pull/88)).
+
+### Breaking changes
+
+- **`oceanarray stack` / `oceanarray grid` removed** ([#88](https://github.com/ocean-uhh/oceanarray/pull/88)): the standalone subcommands (deprecated since 0.2.0) are deleted. Use `oceanarray process MOORING --stage stack grid` — all flags (`--dt`, `--dp`, `--pmin`, `--pmax`, `--force`, `--proc-dir`) carry over; `stack`/`grid` remain available as `--stage` tokens.
+- **`oceanarray logsheet` removed** ([#88](https://github.com/ocean-uhh/oceanarray/pull/88)): the disabled subcommand is deleted (now an argparse "invalid choice" error, not a `DeprecationWarning`). Use the standalone [`logsheet`](https://github.com/eleanorfrajka/logsheet) package.
+- **Python 3.9 dropped** ([#85](https://github.com/ocean-uhh/oceanarray/pull/85)): the minimum supported version is now 3.10.
+- Internal: `oceanarray.cli.cmd_stub` renamed to `cmd_init`; `cmd_stack`, `cmd_grid`, `cmd_logsheet` deleted. Affects only code importing these functions directly; the `oceanarray init` command is unchanged.
+
+---
+
 ## [0.3.0] — 2026-08-11
 
 ### Breaking changes

{oceanarray-0.3.0 → oceanarray-0.4.0}/CITATION.cff

@@ -6,8 +6,9 @@ authors:
   orcid: https://orcid.org/0000-0001-8773-7838
   affiliation: University of Hamburg, Bundesstraße 53, 20146 Hamburg, Germany
 title: oceanarray
-version: 0.3.0
-date-released: 2026-08-11
+doi: 10.5281/zenodo.21890564
+version: 0.4.0
+date-released: 2026-09-08
 url: https://github.com/ocean-uhh/oceanarray
 repository-code: https://github.com/ocean-uhh/oceanarray
 license: MIT

{oceanarray-0.3.0 → oceanarray-0.4.0}/CONTRIBUTING.md

@@ -6,6 +6,8 @@ All contributions are welcome: bug reports, feature suggestions, documentation i
 
 ## Table of Contents
 
+- [Licensing of contributions](#licensing-of-contributions)
+- [Credit and authorship](#credit-and-authorship)
 - [I Have a Question](#i-have-a-question)
 - [Reporting Bugs](#reporting-bugs)
 - [Suggesting Enhancements](#suggesting-enhancements)
@@ -14,6 +16,33 @@ All contributions are welcome: bug reports, feature suggestions, documentation i
 
 ---
 
+## Licensing of contributions
+
+oceanarray is MIT licensed, and contributions are accepted **under the same licence** — what GitHub calls "inbound = outbound". By opening a pull request you confirm that:
+
+1. you wrote the contribution, or you have the right to submit it; and
+2. you agree to license it to the project under the MIT licence.
+
+This does not transfer your copyright, which remains yours.
+
+**If your contribution contains code from somewhere else** — another repository, a paper's supplementary material, a Stack Overflow answer, a colleague's script, or generated output you did not review — say so in the pull request and name the source and its licence. This is the single most useful thing you can tell a reviewer. Code from an unlicensed source cannot be merged until its author agrees, so flagging it early avoids the work being wasted.
+
+---
+
+## Credit and authorship
+
+Three separate things.
+
+**Copyright** stays with whoever wrote the code. You are not asked to assign it.
+
+**Contributor credit** is automatic: everyone whose pull request is merged appears in the git history. If your name or preferred email in the git log is wrong, add a `.mailmap` entry via a pull request — that is the correct fix.
+
+**Citation authorship** is the author list in `CITATION.cff`, which propagates into the Zenodo DOI for every release and therefore into other people's bibliographies. It reflects *substantial* contribution to the software — its design, a significant body of its implementation, its test suite, or its documentation architecture — and is decided by the maintainer at release time. Funding or supervision alone does not qualify. There is no line count that guarantees it or excludes it. If you believe your contribution crosses that line and it has not been reflected, please say so in an issue — being asked is better than being resented.
+
+Where a contribution is adapted from someone else's work rather than written from scratch, we credit it **in the docstring of the code itself**, so the attribution travels with the code rather than living in a file nobody reads (see the existing examples in `utilities.py` and `plotters/current.py`).
+
+---
+
 ## I Have a Question
 
 Read the [documentation](https://ocean-uhh.github.io/oceanarray/) first.
@@ -75,19 +104,31 @@ Processing flows from raw files → Stage 1 (CF-NetCDF) → Stage 2 (trimming +
 git clone https://github.com/ocean-uhh/oceanarray.git
 cd oceanarray
 python -m venv venv && source venv/bin/activate
-pip install -e .
-pip install -r requirements-dev.txt
-# seasenselib (needed for raw file reading):
-pip install pyrsktools pycnv
-pip install seasenselib --no-deps
+pip install --upgrade pip
+pip install -e ".[dev]"
 ```
 
+This installs the runtime stack (including `seasenselib` for raw-file reading),
+plus the test and docs tooling and `ruff`, in one resolution. To also work on
+PDF report output (WeasyPrint, which needs native pango/cairo libraries), use
+`pip install -e ".[all]"` (everything, equivalent to `.[dev,pdf]`).
+
 ### Workflow
 
 1. Fork the repository and create a feature branch from `main`.
 2. Make your changes, following the conventions below.
 3. Run `ruff check . --fix` and then `pytest` — all tests must pass.
-4. Open a pull request against `main`. Use a title prefixed with `[FEAT]`, `[FIX]`, `[REFACTOR]`, `[DOC]`, `[TEST]`, or `[CLEANUP]`.
+4. Open a pull request against `main`. Prefix the title with a bracket tag: `[FEAT]`, `[FIX]`, `[REFACTOR]`, `[DOC]`, `[TEST]`, `[CI]`, or `[CLEANUP]`. (PR titles use bracket tags; individual **commit messages** use conventional-commit prefixes — see below.)
+
+Keep each pull request to one logical change. A rename PR that also fixes a bug is a PR nobody can review — split them. (This matters most once more than one person is working on the code.)
+
+### Commit messages
+
+Use conventional-commit prefixes (`feat:`, `fix:`, `refactor:`, `docs:`, `test:`, `ci:`, `chore:`) with an imperative subject. If you worked with someone, or adapted their code, add a trailer:
+
+```
+Co-authored-by: Name <email@example.com>
+```
 
 ### Code conventions
 
@@ -97,6 +138,7 @@ pip install seasenselib --no-deps
 - **Units**: never strip or assume units. Use `gsw` for all seawater property calculations.
 - **Plot style**: discrete colorbars (`BoundaryNorm`, ≤ 20 levels); call `plt.style.use(str(P.MPLSTYLE))` at the start of every plot function.
 - **Data provenance**: store all processing parameters (thresholds, coefficients) in NC output attributes so any file can be reprocessed exactly from itself.
+- **No silent defaults**: never substitute a default, guess, or approximation when the correct value cannot be determined. Raise, or warn loudly and record what was assumed in the output's metadata. A plausible wrong number is worse than an error, because nothing downstream can detect it.
 
 ### Testing
 
@@ -108,7 +150,7 @@ pytest tests/unit -m "not slow and not needs_seasenselib"  # without seasenselib
 pytest --cov=oceanarray --cov-report=term-missing -q  # with coverage
 ```
 
-New or changed code must have test coverage. Integration tests use committed NetCDF fixtures in `tests/fixtures/`.
+New or changed code must have a test. For anything numerical, assert a **value** you can justify independently of the code — `pytest.approx` or `numpy.testing.assert_allclose` against an analytic case, an invariant that must hold for any input, or a cross-check against `gsw` or another implementation — rather than a value produced by running the code (which proves only that the code has not changed). Do not add tests that pass when nothing happened: `assert result is not None` on a function that returns `None` on failure is the shape to avoid. Integration tests use committed NetCDF fixtures in `tests/fixtures/`.
 
 ---
 
@@ -117,7 +159,7 @@ New or changed code must have test coverage. Integration tests use committed Net
 Documentation is built with Sphinx from `docs/source/`. To build locally:
 
 ```bash
-pip install -r requirements-dev.txt
+pip install -e ".[docs]"
 cd docs && make clean html
 open build/html/index.html
 ```

{oceanarray-0.3.0 → oceanarray-0.4.0}/MIGRATION-BASEDIR.md

@@ -88,9 +88,7 @@ oceanarray run "$MOORING" \
 Individual steps:
 
 ```bash
-oceanarray process dsG3_1_2026 --raw-dir $RAW --proc-dir $PROC --stage 1 2 3
-oceanarray stack   dsG3_1_2026 --proc-dir $PROC
-oceanarray grid    dsG3_1_2026 --proc-dir $PROC --dp 10
+oceanarray process dsG3_1_2026 --raw-dir $RAW --proc-dir $PROC --stage 1 2 3 stack grid --dp 10
 oceanarray report  dsG3_1_2026 --raw-dir $RAW --proc-dir $PROC --instruments --stack --grid
 ```
 

{oceanarray-0.3.0/oceanarray.egg-info → oceanarray-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: oceanarray
-Version: 0.3.0
+Version: 0.4.0
 Summary: Multi-stage processing pipeline for moored oceanographic observations: raw instrument files to QC-flagged CF-compliant NetCDF with automated HTML reports.
 Maintainer-email: Eleanor Frajka-Williams <eleanorfrajka@gmail.com>
 License: MIT License
@@ -35,11 +35,10 @@ Classifier: Intended Audience :: Science/Research
 Classifier: Topic :: Scientific/Engineering :: Oceanography
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: numpy>=1.23
@@ -48,14 +47,32 @@ Requires-Dist: xarray>=2023.12.0
 Requires-Dist: netcdf4>=1.6
 Requires-Dist: scipy>=1.10
 Requires-Dist: matplotlib>=3.7
+Requires-Dist: pillow>=9.0
 Requires-Dist: gsw>=3.6.16
 Requires-Dist: ppigrf
 Requires-Dist: ioos_qc
-Requires-Dist: dolfyn
 Requires-Dist: pycwt
+Requires-Dist: seasenselib
 Requires-Dist: jinja2>=3.0
-Requires-Dist: packaging>=21.0
 Requires-Dist: ruamel.yaml>=0.18
+Provides-Extra: pdf
+Requires-Dist: weasyprint>=60; extra == "pdf"
+Provides-Extra: test
+Requires-Dist: pytest>=8.0; extra == "test"
+Requires-Dist: pytest-cov>=4.1; extra == "test"
+Provides-Extra: docs
+Requires-Dist: sphinx>=7.2; extra == "docs"
+Requires-Dist: sphinx-rtd-theme>=2.0; extra == "docs"
+Requires-Dist: myst-nb>=1.0; extra == "docs"
+Requires-Dist: nbsphinx>=0.9; extra == "docs"
+Requires-Dist: pypandoc>=1.11; extra == "docs"
+Provides-Extra: dev
+Requires-Dist: oceanarray[docs,test]; extra == "dev"
+Requires-Dist: ruff>=0.3; extra == "dev"
+Requires-Dist: jupyterlab>=4.0; extra == "dev"
+Requires-Dist: nbconvert>=7.8; extra == "dev"
+Provides-Extra: all
+Requires-Dist: oceanarray[dev,pdf]; extra == "all"
 Dynamic: license-file
 
 # OceanArray
@@ -65,6 +82,7 @@ Dynamic: license-file
 [![License: MIT](https://img.shields.io/pypi/l/oceanarray.svg)](https://github.com/ocean-uhh/oceanarray/blob/main/LICENSE)
 [![Tests](https://github.com/ocean-uhh/oceanarray/actions/workflows/tests.yml/badge.svg)](https://github.com/ocean-uhh/oceanarray/actions/workflows/tests.yml)
 [![Documentation](https://img.shields.io/badge/docs-ocean--uhh.github.io-blue.svg)](https://ocean-uhh.github.io/oceanarray/)
+[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.21890564.svg)](https://doi.org/10.5281/zenodo.21890564)
 
 Python tools for processing moored oceanographic array observations from raw instrument files to quality-controlled, CF-compliant NetCDF.
 
@@ -76,14 +94,15 @@ Python tools for processing moored oceanographic array observations from raw ins
 pip install oceanarray
 ```
 
-`seasenselib` is required for reading raw instrument files (available on PyPI but needs `--no-deps`):
+Or, with [uv](https://docs.astral.sh/uv/):
 
 ```bash
-pip install pyrsktools pycnv
-pip install seasenselib --no-deps
+uv pip install oceanarray
 ```
 
-Python 3.9–3.12 is supported.
+This pulls in `seasenselib` (used to read raw instrument files in stage 1) automatically.
+
+Python 3.10–3.12 is supported. See the [installation guide](https://ocean-uhh.github.io/oceanarray/installation.html) for isolated-environment (conda / venv / uv) and from-source options.
 
 ## Quick start
 
@@ -104,7 +123,7 @@ See the [documentation](https://ocean-uhh.github.io/oceanarray/) for the recomme
 ```python
 import oceanarray
 
-oceanarray.process('dsG3_1_2026', raw_dir='/data/raw', proc_dir='/data/proc')
+oceanarray.process("dsG3_1_2026", raw_dir="/data/raw", proc_dir="/data/proc")
 ```
 
 See the [API reference](https://ocean-uhh.github.io/oceanarray/oceanarray.html) for the full interface.

{oceanarray-0.3.0 → oceanarray-0.4.0}/README.md

@@ -5,6 +5,7 @@
 [![License: MIT](https://img.shields.io/pypi/l/oceanarray.svg)](https://github.com/ocean-uhh/oceanarray/blob/main/LICENSE)
 [![Tests](https://github.com/ocean-uhh/oceanarray/actions/workflows/tests.yml/badge.svg)](https://github.com/ocean-uhh/oceanarray/actions/workflows/tests.yml)
 [![Documentation](https://img.shields.io/badge/docs-ocean--uhh.github.io-blue.svg)](https://ocean-uhh.github.io/oceanarray/)
+[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.21890564.svg)](https://doi.org/10.5281/zenodo.21890564)
 
 Python tools for processing moored oceanographic array observations from raw instrument files to quality-controlled, CF-compliant NetCDF.
 
@@ -16,14 +17,15 @@ Python tools for processing moored oceanographic array observations from raw ins
 pip install oceanarray
 ```
 
-`seasenselib` is required for reading raw instrument files (available on PyPI but needs `--no-deps`):
+Or, with [uv](https://docs.astral.sh/uv/):
 
 ```bash
-pip install pyrsktools pycnv
-pip install seasenselib --no-deps
+uv pip install oceanarray
 ```
 
-Python 3.9–3.12 is supported.
+This pulls in `seasenselib` (used to read raw instrument files in stage 1) automatically.
+
+Python 3.10–3.12 is supported. See the [installation guide](https://ocean-uhh.github.io/oceanarray/installation.html) for isolated-environment (conda / venv / uv) and from-source options.
 
 ## Quick start
 
@@ -44,7 +46,7 @@ See the [documentation](https://ocean-uhh.github.io/oceanarray/) for the recomme
 ```python
 import oceanarray
 
-oceanarray.process('dsG3_1_2026', raw_dir='/data/raw', proc_dir='/data/proc')
+oceanarray.process("dsG3_1_2026", raw_dir="/data/raw", proc_dir="/data/proc")
 ```
 
 See the [API reference](https://ocean-uhh.github.io/oceanarray/oceanarray.html) for the full interface.

{oceanarray-0.3.0 → oceanarray-0.4.0}/docs/Makefile

@@ -12,7 +12,17 @@ BUILDDIR      = build
 help:
 	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
 
-.PHONY: help Makefile
+.PHONY: help Makefile demo-report
+
+# Refresh the hosted example report suite under source/_static/demo/dune2/ from
+# the dune2_1_2026 fixture reports.  Those fixtures are regenerated by the test
+# suite (tests/unit/test_report_golden.py); run pytest first if they are stale.
+demo-report:
+	rm -rf source/_static/demo/dune2
+	mkdir -p source/_static/demo/dune2/instrument
+	cp ../tests/fixtures/proc/dune2_1_2026/report/*.html source/_static/demo/dune2/
+	cp ../tests/fixtures/proc/dune2_1_2026/report/instrument/*.html \
+		source/_static/demo/dune2/instrument/
 
 # Catch-all target: route all unknown targets to Sphinx using the new
 # "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).

oceanarray-0.4.0/docs/environment.yml

@@ -0,0 +1,12 @@
+name: oceanarray
+channels: [conda-forge]
+dependencies:
+  - python=3.11
+  - pip
+  - pandoc
+  # The editable install (`-e .[dev]`, dev extra = runtime incl. seasenselib +
+  # test + docs + pdf + ruff) is done in the workflow's "Install package
+  # (editable)" step, not here: setup-micromamba runs an environment-file pip
+  # section from the file's own directory (docs/), where `.` has no
+  # pyproject.toml. The run step executes from the repo root, so the path
+  # resolves correctly and cannot drift with the action's working directory.