Skip to main content

ctdcast

PyPI Python versions License: MIT Tests Documentation DOI

Processing and reporting for shipboard CTD and LADCP data: raw Sea-Bird files → per-cast netCDF at each stage (read, trim, process/QC) → a compiled profiles.nc aligned with CF and CCHDO naming → self-contained HTML reports. Built for use at sea: every output works offline, with no external requests.

Documentation: https://ocean-uhh.github.io/ctdcast/ · example report

Installation

pip install ctdcast

Reading raw .cnv files needs seasenselib (pip install seasenselib); land coastlines on the interactive maps need the optional maps extra (pip install "ctdcast[maps]"). Python 3.11–3.14 is supported. See the installation notes for isolated-environment and from-source options.

Quick start

Raw CNV files fresh off the instrument — one command gives station pages, an index and a map:

ctdcast draft /path/to/cnv/ --cruise odb2026     # writes ./ctd_draft/index.html

For the full pipeline — sections, time series, LADCP, the sensor inventory — write a config and process stage by stage:

ctdcast init --interactive        # guided config.yaml
ctdcast validate config.yaml      # check paths before the first run
ctdcast process config.yaml --stage 1 2 3 profiles
ctdcast run config.yaml           # the report; --force rebuilds, --only 42 one cast

ctdcast clock config.yaml diagnoses the acquisition-clock error and prints a paste-ready processing.clock block. See the quickstart for the recommended first-cruise workflow, the config reference and the CLI reference.

To check an installation, run the bundled demo against the committed fixture casts:

ctdcast run config_demo.yaml      # writes demo_report/index.html

Python API

import ctdcast

ctdcast.report(
    "ctd_nc", "report", profiles_path="profiles.nc", groupings_yaml="ctd_groupings.yaml"
)

See the API reference for process, stage1, profiles and the full interface.

Acknowledgements

Development of this package started during the Odón de Buen cruise of AEI-DFG DS-MIXSED. DS-MIXSED is funded by the Agencia Estatal de Investigación (AEI) through the PCI 2024 call — projects PCI2024-155022-2 and PCI2024-155084-2 — and the Deutsche Forschungsgemeinschaft (DFG, German Research Foundation) — Projektnummer 541914507.

Development was assisted by Claude Code (Anthropic) and GitHub Copilot code review.

License

MIT License

Metadata

Release files for ctdcast 0.4.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ctdcast 0.4.1
File Size Uploaded Provenance Actions
ctdcast-0.4.1.tar.gz 602.8 kB With provenance Details for ctdcast-0.4.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for ctdcast 0.4.1
File Interpreter ABI Platform Actions
ctdcast-0.4.1-py3-none-any.whl Python 3 none any Details for ctdcast-0.4.1-py3-none-any.whl

Total release size: 1.1 MB

Release files / ctdcast-0.4.1.tar.gz

Download URL ctdcast-0.4.1.tar.gz
Size 602.8 kB
Tags Source
SHA-256 checksum
How to use checksums
ce720217ea61be2de0928225bd471d66e28872b31c322306c694432d34cb26bd
BLAKE2b-256 checksum
How to use checksums
6aab6cf90b4c454fe08a0a85dcbe1718a8a60cd0a10716d92c85c5739d59870f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 1, 2026.

Transparency log

Release files / ctdcast-0.4.1-py3-none-any.whl

Download URL ctdcast-0.4.1-py3-none-any.whl
Size 514.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
44d0499f3edfb66431edb59cc449f1eb6ea2c7e6d2765bd3f4f0e02baa632de1
BLAKE2b-256 checksum
How to use checksums
5385034d11a4fcf5375fdf421ca965fef595bd22aec127259d6f6a9b64ebd189
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 1, 2026.

Transparency log

Security for ctdcast 0.4.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for ctdcast-0.4.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 1, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page