nctoolkit.DataSet.vertical_integration

DataSet.vertical_integration(self, thickness=None, depth_range=None, fixed=None)

Calculate the vertically integrated sum over the water column This calculates the sum of the variable multiplied by the cell thickness

Parameters
  • thickness (str or Dataset) – This must be supplied when vertical levels vary spatially. One of: a variable, in the dataset, which contains the variable thicknesses; a .nc file which contains the thicknesses; or a Dataset that contains the thicknesses. Note: the .nc file or Dataset must only contain one variable.

  • depth_range (list) – Set a depth range if desired. Should be of the form [min_depth, max_depth].

  • fixed (bool) – Define whether the vertical levels are the same in all spatial locations. Set to True if they are, e.g. you have z-levels. If you have the likes of sigma-coordinates, set this to True.

Examples

If you wanted to sum of values across all vertical levels of every variable in a dataset that has spatially fixed vertical levels, you would do this:

>>> ds.vertical_sum(fixed = True)