environmentaltools.processes.distribute_precipitation

environmentaltools.processes.distribute_precipitation(data, pattern, df, info)[source]

Distribute precipitation data temporally according to SCS rainfall pattern.

Disaggregates daily or multi-hour precipitation data into hourly values following standard SCS (Soil Conservation Service) rainfall distribution patterns.

Parameters:
  • data (pd.Series) – Precipitation time series with datetime index

  • pattern (np.ndarray) – SCS precipitation distribution pattern (cumulative fractions)

  • df (pd.DataFrame) – Empty DataFrame with hourly datetime index to fill

  • info (dict) –

    Dictionary with parameters:

    • freq_raw_datastr

      Frequency of input data (‘D’ for daily, ‘H’ for hourly, ‘nH’ for n-hour)

    • eventsbool

      Whether data represents discrete storm events

Returns:

DataFrame with distributed hourly precipitation in ‘pr’ column

Return type:

pd.DataFrame

Notes

Saves distributed precipitation to ‘distributed_precipitation.zip’ CSV file.