oceanarray 0.2.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.2.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.2.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}
@@ -54,3 +54,10 @@ jobs:
           publish_dir: docs/build/html
           # Optional: publish_branch: gh-pages
           # Optional: cname: docs.example.org
+          # Replace gh-pages with a single commit each deploy. The built site is
+          # regenerable, so its history has no value. The saving is smaller than it
+          # looks: git deltas near-identical HTML well, and squashing 70-120 deploys
+          # shrinks a fresh clone by only 4-18%. What it does bound is the growth from
+          # re-executed demo notebooks, whose embedded PNGs differ every build and so
+          # never delta. Current site size dominates, not history - keep _static small.
+          force_orphan: true

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.2.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.4.0/CHANGELOG.md

@@ -0,0 +1,151 @@
+# Changelog
+
+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.logsheet` subpackage deleted** ([#66](https://github.com/ocean-uhh/oceanarray/pull/66)): the deprecated `logsheet` subpackage has been removed from the tree. `oceanarray logsheet` still emits a `DeprecationWarning` and exits 1. Use the standalone [`logsheet`](https://github.com/eleanorfrajka/logsheet) package: `pip install git+https://github.com/eleanorfrajka/logsheet`, then `logsheet build ...`.
+- **`oceanarray run` skips grid when stack fails** ([#65](https://github.com/ocean-uhh/oceanarray/pull/65)): if the stack stage fails, the grid stage is now skipped rather than attempted on incomplete input. This matches `process()` behaviour.
+
+### Bug fixes
+
+- **Grid report N² computed at latitude 0**: the grid report derived buoyancy frequency (N²) at latitude 0° because its `_dms_to_deg` import still pointed at the removed `mooring_level` module and failed silently inside a broad `except`. The import now resolves from `utilities`, so N² uses the mooring's actual latitude.
+
+### Refactoring
+
+- **`STAGES` registry as single source of truth in CLI dispatch** ([#65](https://github.com/ocean-uhh/oceanarray/pull/65)): `process()` accepts a stage list (always applied in `STAGES` order); `cmd_process` and `cmd_run` route through a single `process()` call; argparse `choices` are derived from `STAGES`.
+- **Plot/report hardening** ([#64](https://github.com/ocean-uhh/oceanarray/pull/64)): `render_b64` guard, `plt.style.context`, `vlabel()` helper, `SIGMA_GRID` fix, and a `VARIABLES` registry (21 entries with `valid_min`/`valid_max`).
+
+### Documentation
+
+- Updated developer docs (`project_structure.md`, `methods/standardisation.rst`, `methods/vertical_gridding.rst`, `methods/nortek_coordinate_transform.rst`, `legacy.rst`) to the current `oceanarray.processors.*` module layout after the reorg; fixed broken import examples and API references.
+
+### Tests
+
+- Golden Stage 1 tests, reader and `_array` helper tests, plus associated bug fixes and dead-code removal ([#63](https://github.com/ocean-uhh/oceanarray/pull/63)).
+
+---
+
+## [0.2.0] — 2026-08-07
+
+### Breaking changes
+
+- **`oceanarray logsheet` disabled**: calling `oceanarray logsheet` now emits a `DeprecationWarning` and exits 1. The `logsheet` subpackage remains in the tree but is unused (deleted in v0.3.0). Use the standalone [`logsheet`](https://github.com/eleanorfrajka/logsheet) package: `pip install git+https://github.com/eleanorfrajka/logsheet`, then `logsheet build ...`.
+- **`--basedir` removed** ([#52](https://github.com/ocean-uhh/oceanarray/pull/52)): use `--raw-dir` and `--proc-dir` instead. See the [migration guide](https://ocean-uhh.github.io/oceanarray/migration.html).
+- **`plotter.py` retired** ([#53](https://github.com/ocean-uhh/oceanarray/pull/53)): the monolithic `oceanarray/plotter.py` and all backward-compatibility re-export shims have been removed. Import from canonical modules (`oceanarray.plotters.current`, `oceanarray.plotters.timeseries`, etc.).
+- **Subpackage reorganisation** ([#49](https://github.com/ocean-uhh/oceanarray/pull/49), [#59](https://github.com/ocean-uhh/oceanarray/pull/59)): processing modules moved from `oceanarray/instrument/` and `oceanarray/mooring/` into `oceanarray.processors.*`. Top-level `oceanarray` imports unchanged; internal paths have moved.
+
+### New features
+
+- **`--stage stack grid` in `oceanarray process`**: the `--stage` flag now accepts `stack` and `grid` in addition to `1`, `2`, `3`. Run the full pipeline as `oceanarray process MOORING --stage 1 2 3 stack grid`. New flags `--dt`, `--dp`, `--pmin`, `--pmax` added to `process` (same defaults as `oceanarray run`).
+- **`process()` public API** ([#58](https://github.com/ocean-uhh/oceanarray/pull/58)): `oceanarray.process(mooring_yaml, proc_dir, stages=…)` runs any combination of Stage 1–3, stack, and grid in a single call. `oceanarray.STAGES` is the registry of available stages.
+- **Array report** ([#48](https://github.com/ocean-uhh/oceanarray/pull/48)): `oceanarray report <array.yaml> --array` generates a multi-mooring HTML summary with smart rebuild (only re-renders sections whose NC files are newer than the existing report).
+- **Wave / frequency diagnostics** ([#47](https://github.com/ocean-uhh/oceanarray/pull/47)): rotary power spectra, near-inertial band energy, and wave diagnostics added to ADCP instrument reports.
+- **Release automation** ([#61](https://github.com/ocean-uhh/oceanarray/pull/61)): pushing a `v*` tag now auto-creates a draft GitHub release with PR-based release notes; publishing the draft triggers PyPI upload.
+
+### Bug fixes
+
+- **QC flags unified to OceanSITES table** ([#54](https://github.com/ocean-uhh/oceanarray/pull/54)): all QC flag values now use the standard OceanSITES convention (0 no QC, 1 good, 2 probably good, 3 probably bad, 4 bad, 9 missing). Previously mixed conventions caused flag collisions on merge.
+- **Plot regularisation** ([#50](https://github.com/ocean-uhh/oceanarray/pull/50)): fixed irregular time-axis sampling in instrument report figures.
+- **Turbidity `units=MISSING`** ([#61](https://github.com/ocean-uhh/oceanarray/pull/61)): stage1 now strips placeholder `units` strings (`"MISSING"`, `""`) written by the RBR RSK reader when the instrument database has no units entry, and emits a `UserWarning` so the operator can verify the sensor spec.
+
+### Deprecations
+
+- **`oceanarray stack`**: deprecated in favour of `oceanarray process MOORING --stage stack`. Emits `DeprecationWarning`. Will be removed in v0.3.0.
+- **`oceanarray grid`**: deprecated in favour of `oceanarray process MOORING --stage grid`. Emits `DeprecationWarning`. Will be removed in v0.3.0.
+- `file_type: rbr-hex-oa` remapped automatically to `rbr-hex` with a `DeprecationWarning`; update mooring YAMLs.
+- `file_type: sbe-asc` remapped automatically to `sbe-ascii`.
+
+### Refactoring
+
+- Single-source variable registries in `parameters.py`; `validation.py` derives from it ([#51](https://github.com/ocean-uhh/oceanarray/pull/51)).
+- Figure-returning shape for `report/_plots.py` ([#56](https://github.com/ocean-uhh/oceanarray/pull/56)); `draw_*` helpers relocated to `plotters/` ([#57](https://github.com/ocean-uhh/oceanarray/pull/57)).
+- Type annotations backfilled on `hydrographic.py` and `temporal.py`; two ANN per-file-ignores removed from `pyproject.toml`.
+
+### Tests
+
+- Integration chain tests (stage1 → stage2 → stage3 → stack → grid) over committed `dune2_1_2026` fixtures ([#60](https://github.com/ocean-uhh/oceanarray/pull/60)).
+- CI: integration job now installs seasenselib from PyPI; Windows and macOS unit jobs run seasenselib-free.
+
+---
+
+## [0.1.0] — 2026-07-27
+
+First public release.
+
+### Processing pipeline
+
+- **Stage 1** — raw instrument files → CF-NetCDF: Sea-Bird SBE37 MicroCAT (`sbe-cnv`, `sbe-ascii`), Nortek Aquadopp (`nortek-raw`, `nortek-ascii`, `nortek-csv`), RBR Solo/Duet (`rbr-rsk`, `rbr-dat`), RDI WorkHorse ADCP (`rdi-raw`). Nortek BEAM→XYZ transformation matrix parsed from `.hdr` file and applied at stage 1; matrix stored in output for reproducibility.
+- **Stage 2** — deployment trimming (YAML `deployment_time`/`recovery_time`) and linear clock-drift correction from recovery timestamps.
+- **Stage 3** — QARTOD gross-range and spike QC on T/C/S/P; pressure interpolation (QC flag 8) for instruments without a pressure sensor; Aquadopp XYZ→ENU rotation using heading/pitch/roll + IGRF magnetic declination (`ppigrf`); tilt QC on velocity; potential density via `gsw`.
+
+### Mooring-level commands
+
+- `oceanarray stack` — resample all instruments to a common time axis, stack into a single `(time, N_LEVELS)` dataset ordered deep-first.
+- `oceanarray grid` — linearly interpolate the stacked dataset onto a regular pressure grid (`--pmin`, `--pmax`, `--dp`).
+
+### Reporting
+
+- `oceanarray report` — self-contained HTML reports (all figures base64-embedded, offline-readable):
+  - Mooring summary: deployment metadata, instrument pipeline status, QC flag breakdown, clock corrections, knockdown figures, clock alignment check.
+  - Per-instrument pages (`--instruments`): full time series with QC markers, T-S diagram, current roses, data histograms, QC table, scalar metadata.
+  - Stack report (`--stack`): pressure/T/S/velocity time series, T-S diagram, current roses, spacing histogram.
+  - Grid report (`--grid`): T/S/density pcolormesh, N², velocity sections, T-S diagram, power spectra.
+  - Array report (`--array`): position map, summary table with clickable links to mooring reports.
+
+### CLI
+
+- `oceanarray process` — run stage 1, 2, and/or 3 for a mooring or a single instrument (`--serial`).
+- `oceanarray run` — complete pipeline in one command (process + stack + grid + report).
+- `oceanarray validate` — check mooring YAML for missing fields and unknown instrument types.
+- `oceanarray list` — print accepted `instrument:` names and `file_type:` values.
+- `oceanarray logsheet` — generate PDF logsheets from YAML instrument inventory.
+
+### Logsheets
+
+- `oceanarray logsheet` subcommand generates LaTeX-rendered PDF deployment logsheets from a cruise configuration YAML.
+
+### Notable design choices
+
+- Data provenance: all processing parameters (QC thresholds, declination value, transformation matrix) stored as NetCDF attributes so any file can be reprocessed exactly from itself.
+- Discrete colorbars throughout (≤ 20 levels, `BoundaryNorm`).
+- CF-convention variable names and standard names throughout; OceanSITES QC flag values.
+- `seasenselib` is used for raw file reading but is a separate install (`pip install seasenselib --no-deps` — see installation docs).

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

@@ -6,15 +6,14 @@ authors:
   orcid: https://orcid.org/0000-0001-8773-7838
   affiliation: University of Hamburg, Bundesstraße 53, 20146 Hamburg, Germany
 title: oceanarray
-version: 0.2.0
-date-released: 2026-07-27
+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
 abstract: >
-  Multi-stage processing pipeline for moored oceanographic array observations:
-  converts raw instrument files (Sea-Bird, RBR, Nortek, RDI) to QC-flagged,
-  CF-compliant NetCDF and generates self-contained HTML mooring recovery reports.
+  Multi-stage processing pipeline for moored oceanographic array observations: converts raw instrument files (Sea-Bird, RBR, Nortek, RDI) to QC-flagged, CF-compliant NetCDF and generates self-contained HTML mooring recovery reports.
 keywords:
   - oceanography
   - mooring

{oceanarray-0.2.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.2.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.2.0/oceanarray.egg-info → oceanarray-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: oceanarray
-Version: 0.2.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,18 +47,43 @@ 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
 
+[![PyPI](https://img.shields.io/pypi/v/oceanarray.svg)](https://pypi.org/project/oceanarray/)
+[![Python versions](https://img.shields.io/pypi/pyversions/oceanarray.svg)](https://pypi.org/project/oceanarray/)
+[![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.
 
 **Documentation**: https://ocean-uhh.github.io/oceanarray/
@@ -70,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
 
@@ -98,11 +123,17 @@ 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.
 
+## Acknowledgements
+
+Development was assisted by Claude Code (Anthropic) and GitHub Copilot code review.
+
+The data-processing approach draws on methods developed for the RAPID mooring array programme (UK/US funded). `oceanarray` is developed toward the DFG Ocean Array infrastructure project (DFG project number 571027118), from which it takes its name, and was first applied in the AEI–DFG MIXSED project (DFG project number 541914507).
+
 ## License
 
 MIT License