argopy.utils.optical_modeling.DCM

Contents

argopy.utils.optical_modeling.DCM#

DCM(CHLA: ndarray, CHLA_axis: ndarray, BBP: ndarray, BBP_axis: ndarray, max_depth: float = 300.0, resolution_threshold: float = 3.0, median_filter_size: int = 5, surface_layer: float = 15.0, median_filter_size_bbp: int = 7, uniform_filter1d_size_bbp: int = 5) Tuple[Literal['NO ', 'DBM', 'DAM'], float, float][source]#

Search and qualify Deep Chlorophyll Maxima from unlabeled arrays of pressure and CHLA/BBP

See xarray.Dataset.argo.optic.DCM for more details on the methodology.

Parameters:
  • CHLA (array_like, 1 dimensional) – Chlorophyl-a concentration profile data.

  • CHLA_axis (array_like, 1 dimensional) – Vertical axis values, pressure or depth, positive, increasing downward, for CHLA. Typically, from the PRES parameter of an Argo float.

  • BBP (array_like, 1 dimensional) – Particulate backscattering coefficient profile data.

  • BBP_axis (array_like, 1 dimensional) – Vertical axis values, pressure or depth, positive, increasing downward, for BBP. Typically, from the PRES parameter of an Argo float.

  • max_depth (float, optional, default: 300.) – Maximum depth allowed for a deep CHLA maximum to be found.

  • resolution_threshold (float, optional, default: 3.) – CHLA vertical axis resolution threshold below which a smoother is applied.

  • median_filter_size (int, optional, default: 5) – Size of the scipy.ndimage.median_filter() filter used with CHLA.

  • surface_layer (float, optional, default: 15.) – Depth value defining the surface layer above which twice the median CHLA value may qualify a DCM as such.

  • median_filter_size_bbp (int, optional, default: 7) – Size of the scipy.ndimage.median_filter() filter used with BBP.

  • uniform_filter1d_size_bbp (int, optional, default: 7) – Size of the scipy.ndimage.uniform_filter1d() filter used with BBP.

Returns:

  • str[3], Literal[β€˜NO β€˜, β€˜DBM’, β€˜DAM’] – The type of Deep Chlorophyll Maxima (DCM). Possible values are:

    • ’NO β€˜: No DCM found above max_depth

    • ’DBM’ : Deep Biomass Maximum

    • ’DAM’ : Deep photoAcclimation Maximum

  • float – Depth of the DCM, from the un-smoothed profile

  • float – Amplitude the DCM: CHLA value, from the un-smoothed profile.