module Gxg

This module contains a class GwGxg that calculates some descriptive statistics from a series of groundwater head measurements used by groundwater practitioners in the Netherlands

The structure and many of the methods in this module are adopted from the Pastas module dutch.py)

acequia.stats.gxg.stats_gxg(ts, ref='datum')

Return table with GxG statistics

Parameters
  • ts (aq.GwSeries, pd.Series) – Groundwater head time series

  • ref ({'datum','surface'}, optional) – Reference level for groundwater heads

Returns

Return type

pd.DataFrame

class acequia.stats.gxg.Gxg(gw, srname=None, ref=None)

Calculate descriptive statistics for series of measured heads

Parameters
  • gw (aq.GwSeries, pd.Series) – timeseries with groundwater head measurements

  • ref (['datum','surface'], default 'surface') – reference level for measurements

Notes

Traditionally in the Netherlands groundwater head series are decribed using decriptive statistics that characterise the mean highest level (GHG), the mean lowest level (GLG) and the mean spring level (GVG). These statistics are defined on head series with measurements on the 14th and 28th of each month. Therefore, heads series are internally resampled before calculating statistics.

For further reference: P. van der SLuijs and J.J. de Gruijter (1985). ‘Water table classes: a method to decribe seasonal fluctuation and duration of water table classes on Dutch soil maps.’ Agricultural Water Management 10 (1985) 109 - 125. Elsevier Science Publishers, Amsterdam.

vg3()

Return VG3 (Spring Level) for each year

VG3 is calculated as the mean of groundwater head levels on 14 march, 28 march and 14 april

Returns

Return type

pd.Series

vg1(maxlag=7)

Return VG (Spring Level) for each year

VG1 is calculated as measurement nearest to 1 april

Returns

Return type

pd.Series

xg()

Return table of GxG groundwater statistics for each hydrological year

Returns

Return type

pd.DataFrame

gxg()

Return table with GxG for one head series

Returns

Return type

pd.DataFrame

gt()

Return groundwater class table

Returns

Return type

str