argopy.utils.optical_modeling.Z_euphotic

Contents

argopy.utils.optical_modeling.Z_euphotic#

Z_euphotic(axis: ndarray, par: ndarray, method: Literal['percentage', 'KdPAR'] = 'percentage', max_surface: float = 5.0, layer_min: float = 10.0, layer_max: float = 50.0) float[source]#

Depth of the euphotic zone from unlabeled arrays of pressure and PAR

Two methods are available:

  • percentage: Depth for which PAR is 1% that of the surface value, defined as the maximum above max_surface

  • KdPAR: -log(0.01) times the PAR attenuation coefficient over the layer between layer_min and layer_max

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

Parameters:
  • axis (numpy.ndarray, 1 dimensional) – Vertical axis values, pressure or depth, positive, increasing downward, typically from the PRES parameter of an Argo float.

  • par (array_like, 1 dimensional) – Photosynthetically available radiation, typically from the DOWNWELLING_PAR parameter of an Argo float.

  • method (Literal['percentage', 'KdPAR'] = 'percentage') – Computation method to use.

  • max_surface (float, optional, default: 5.) – Used only with the percentage method. Maximum value of the vertical axis above which the maximum PAR value is considered surface values.

  • layer_min (float, optional, default: 10.)

  • layer_max (float, optional, default: 50.) – Used only with the KdPAR method. Minimum and maximum values of the vertical axis over which to compute the PAR attenuation coefficient.

Returns:

Estimate of the euphotic layer depth

Return type:

float