environmentaltools.common.ecdf

environmentaltools.common.ecdf(df: DataFrame, variable: str, num_percentiles: int | bool = False) → DataFrame[source]

Compute the empirical cumulative distribution function (ECDF).

Calculates non-exceedance probabilities for the variable values. Can optionally interpolate to a specified number of percentiles.

Parameters:

  • df (pd.DataFrame) – Raw time series data.

  • variable (str) – Name of the variable column to analyze.

  • num_percentiles (int | bool, optional) – Number of empirical percentiles to interpolate. If False, returns all data points. Defaults to False.

Returns:

DataFrame with variable values and their non-exceedance

probabilities. Index represents probability values.

Return type:

pd.DataFrame