glidertools.optics.photic_depth

glidertools.optics.photic_depth(par, dives, depth, return_mask=False, ref_percentage=1)

Algebraically calculates the euphotic depth.

The function calculates the euphotic depth and attenuation coefficient (Kd) based upon the linear fit of the natural log of par with depth.

Parameters:
  • par (numpy.ndarray or pandas.Series) – The par data with units uE/m2/sec.

  • dives (numpy.ndarray or pandas.Series) – The dive count (round is down dives, 0.5 is up dives).

  • depth (numpy.ndarray or pandas.Series) – The depth array in metres.

  • return_mask (bool) – If True, will return a mask for the photic layer (depth < euphotic depth).

  • ref_percentage (int) – The percentage light depth to calculate the euphotic layer, typically assumed to be 1% of surface par.

Returns:

  • light_depths (numpy.ndarray) – An array of the euphotic depths in metres.

  • slopes (numpy.ndarray) – An array of the par attenuation coefficient (Kd).