ctdfjorder.CTD.CTD.add_haline_contraction_coefficient(self) → None

Calculates and adds haline contraction coefficient to the CTD data using the TEOS-10 formula.

The haline contraction coefficient, \(\beta\), is important for understanding how the volume of seawater changes with salinity at constant temperature. It is derived from absolute salinity, conservative temperature, and sea pressure.

Raises:

NoSamplesError – When the function is called on a CTD object with no data.

Notes

The gsw.beta function from the Gibbs SeaWater (GSW) Oceanographic Toolbox is utilized for this calculation. More information about this function can be found at the TEOS-10 website.

The haline contraction coefficient is calculated using the following equation from TEOS-10:

\[\beta^\theta = \frac{1}{\rho} \frac{\partial \rho}{\partial S_A} \bigg|_{\theta, P}\]

where: - \(\rho\) is the in-situ density of seawater, - \(S_A\) is the absolute salinity, - \(\theta\) is the conservative temperature, - \(P\) is the sea pressure.

This method adds a new column for the haline contraction coefficient in the dataset. It ensures that absolute salinity and conservative temperature are present in the data, calculating them if necessary, before computing the haline contraction coefficient.

Examples

ctd_data = CTD('example.csv')
ctd_data.add_haline_contraction_coefficient()
# This will add a new column with haline contraction coefficient values to the dataset, calculated using the TEOS-10 formula.