v2026.04.0

v2026.04.0 (2026-04-27)

Parameter Changes

• Add LAB_DEN_TMP [DEG C] as the name for the temperature of analysis of seawater in lab measured density. (P01 param DENTMP01)
• Update to cf standard name table v93 (2026-03-17)
• Add CTDCDOM [RU] for uv fluorometer data that has been calibrated/corrected to discrete samples normalized to the pure water Raman peak
• Add FDOM [RU] for discrete samples normalized to the pure water Raman peak.
• Removed the CTDCDOM [RU] to CTDCDOM [RFU] alias mapping
• Add CTDPH for in situ ph reported on an unknown scale, though it is probably NBS

API Changes

• (New) Add a method to look up parameter by their nc_name
• (Potentially Breaking) Rise a ValueError when attempting to coerce a parameter into an error name when an error name it not defined for it
• Add typing to WHPNames and CFStandardNames objects
• Drop python 3.11 support (SPEC 0)
• Use pattern matching to do the WHPName lookup in __getitem__ of the _WHPNames object

Full Changelog: v2025.10.0...v2026.04.0

v2025.10.0 Another Spooky Update

Unlike the last time, this release is actually happening on Halloween

Parameter Changes

• Add UMOL/L as an allowed unit for UREA, the default print precision of .4f is based on incoming .1f data in nmol units

• Add AR-39_ERROR [PCTMOD] as the error name for AR-39 [PCTMOD]

• Add CDOM-S275-295 [1/NM] describing a linear fit to log transformed attenuation coefficients in the interval 275 to 295 nanometers

• Add moles_of_ammonium_per_unit_mass_in_sea_water as the CF standard name for NH4 [UMOL/KG]

• Add mole_concentration_of_cfc11_in_sea_water as the CF standard name for CFC-11 [PMOL/L]

• Add mole_concentration_of_cfc12_in_sea_water as the CF standard name for CFC-12 [PMOL/L]

• Add moles_of_sulfur_hexafluoride_per_unit_mass_in_sea_water as the CF standard name for SF6 [FMOL/KG]

• Add mole_concentration_of_sulfur_hexafluoride_in_sea_water as the CF standard name for SF6 [FMOL/L]

• Add some particulate trace metal parameters following geotraces conventions, the default database precisions were based on incoming data:

  • Sr_TP_CONC_BOTTLE [PMOL/KG]
  • Al_TP_CONC_BOTTLE [NMOL/KG]
  • Ba_TP_CONC_BOTTLE [PMOL/KG]
  • Ca_TP_CONC_BOTTLE [PMOL/KG]

Other Changes

• Add template for parameter requests by @DocOtak in #47

Full Changelog: v2025.04.0...v2025.10.0

Params from Sea

I'm on at sea while publishing this, lets hope it works.

Parameter Changes

• (Breaking) Change allowed units for CU and NI from UMOL/L to NMOL/L, only two cruises had these parameters and neither had data, this aligns with incoming data and GEOTRACES

• Fixed typos in change log where the beta scattering angle was incorrectly written as 123 degrees, continuing a long line of typos for this angle going back to the OEM:

  • CTDBETA660_123 -> CTDBETA660_124
  • CTDBETA650_123 -> CTDBETA650_124

• Add CDOM254 [/METER]

• Add some dissolved trace metal parameters following geotraces conventions:

  • Add Co_D_CONC_BOTTLE [PMOL/L]
  • Add Zn_D_CONC_BOTTLE [NMOL/L]
  • Add Cd_D_CONC_BOTTLE [NMOL/L]
  • Add Pb_D_CONC_BOTTLE [PMOL/L]

API Changes

• The package was migrated to use uv and a /src project structure.
• WHPName instances can now be used as a key to WHPNames

Full Changelog: v2025.01.0...v2025.04.0

New Years Params

Looks like they are optical!

Parameter Changes

• Updated link to SOCCOM optics primer
• Added CTDBETA660_123 [M^-1/SR] for the volume scattering function at 660nm with a centroid angle of 123 degrees

Full Changelog: v2024.12.0...v2025.01.0

The Release Also Known As

This release adds improved support for how aliasing works, see the API Changes section.

v2024.12.0 (2024-12-06)

Parameter Changes

• Add CS137ER as the error name for CS-137 [DM/.1MG] (the other unit variations had this error mapping already)
• Add UMOL/M^2/SEC as allowed units for SPAR

API Changes

• Add support for ODV style keys in WHPNames.add_alias
• Add support for alt params and units to WHPNames.add_alias
• Attempting to set an ALT param to less than 0 will now raise a ValueError, _ALT_0 is still accepted and is equivalent to a normal parameter name.

Full Changelog: v2024.10.1...v2024.12.0

v2024.10.1 The Spooky Update

This release is the first time a second release has occurred in the same month since the switch to calver, and that's pretty spooky. The next release will officially adopt SPEC0 so this is the last version that will support (read: be tested against) python 3.10.

Parameter Changes

• Renamed DOC_NASA [UMOL/L] as DOC [UMOL/L]
  • Added DOC_NASA [UMOL/LG] as an alias for DOC [UMOL/L]
  • Renamed the netcdf variable from dissolved_organic_carbon_nasa to dissolved_organic_carbon_l
• Add DOC_ERROR as the error name for DOC [UMOL/KG] and DOC [UMOL/L]
• Add UMOL/L as an allowed unit for TDN
• Add TDN_ERROR as the error name for TDN [UMOL/KG] and TDN [UMOL/L]
• Add POC_ERROR as the error name for POC
• Add PON_ERROR as the error name for PON
• Add CTDALTIMETER [METERS] for the value reported by the altimeter, And an expected valid range of 0 to 100, hopefully its never 0 in any of the data.

---

Full Changelog: v2024.10.0...v2024.10.1

v2024.10.0

v2024.10.0 (2024-10-04)

Parameter Changes

• Add RFU as an allowed unit for CTDCDOM
• Add CTDCDOM [RU] as an alias for CTDCDOM [RFU]

API Changes

None

Full Changelog: v2024.09.0...v2024.10.0

v2024.09.0

Parameter Changes

• Add BSI [UG/L] for biogenic silica (opal) expressed in mass per volume
• Add UMOL/KG as a unit for POC
• Add UMOL/KG as a unit for PON
• Update CF standard name table from 82 to 85 to support new CCHDO params/units above
• Add VOLTS as a unit for CTDORP for raw sensor output

API Changes

• None

Full Changelog: v2024.04.0...v2024.09.0

v2024.04.0

Just keeping it regular.

Parameter Changes

• Add a warning to EXPOCODE about the value being allowed to vary in a single file.
• Add EWCT [M/S] and NSCT [M/S] for eastward and northward LADCP current vectors included in CTD data.

API Changes

• None

Maintenance

Other than the one units add, this release has a bunch of maintenance items that should affect code. We have switched to using pyproject.toml for packaging and the minimum python version is 3.10 now.

This release also switches to SPEC-0 for supported versions of python and related libraries.

Parameter Changes

• Add VOLTS as a valid unit for raw CTDTURB

API Changes

• None