plans.datasets.chrono

Handle chronological (time series) datasets.

Overview

# todo [major docstring improvement] – overview Mauris gravida ex quam, in porttitor lacus lobortis vitae. In a lacinia nisl. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.

Example

# todo [major docstring improvement] – examples Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla mollis tincidunt erat eget iaculis. Mauris gravida ex quam, in porttitor lacus lobortis vitae. In a lacinia nisl.

import numpy as np
print("Hello World!")

Mauris gravida ex quam, in porttitor lacus lobortis vitae. In a lacinia nisl. Mauris gravida ex quam, in porttitor lacus lobortis vitae. In a lacinia nisl.

Classes

DischargeSeries([name, alias])	A class for representing and working with discharge time series data (volumentric flow).
ETSeries([name, alias])	A class for representing and working with ET data.
PETSeries([name, alias])	A class for representing and working with PET data.
RainSeries([name, alias])	A class for representing and working with rainfall time series data.
RainSeriesSamples([name])
StageSeries([name, alias])	A class for representing and working with river stage time series data.
StageSeriesCollection([name])
StreamflowSeries([name, alias])	A class for representing and working with streamflow data (specific flow).
TemperatureSeries([name, alias])	A class for representing and working with temperature time series data.
TemperatureSeriesSamples([name])
WaterBalanceSeries([name, alias])

class plans.datasets.chrono.WaterBalanceSeries(name='MyWaterBalanceSeries', alias=None)

Bases: TimeSeries

__init__(name='MyWaterBalanceSeries', alias=None)

static view_pq_plot(ts_rain, ts_flow, specs, show=True, return_fig=False)

class plans.datasets.chrono.RainSeries(name='MyRainSeries', alias=None)

Bases: WaterBalanceSeries

A class for representing and working with rainfall time series data.

Notes

todo notes

Examples

todo examples

__init__(name='MyRainSeries', alias=None)

interpolate_gaps(inplace=False, method=None)

Fills gaps in a time series using various interpolation methods.

Parameters:

• method (str) – Specifies the interpolation method. The default value is linear.

• constant (float) – The constant value used when the constant method is selected. Default value = 0.

• inplace (bool) – If True, modifies the original DataFrame in-place. Default value = False.

Returns:

A new pandas.DataFrame with interpolated values if inplace is False, otherwise None.

Return type:

pandas.DataFrame or None

Notes

This function handles time series data, standardizing it if necessary before performing interpolation. The process is applied to each unique epoch within the series.

• linear: linear interpolation

• nearest: uses the value of the closest data point.

• zero: fills gaps with zeros.

• constant: fills gaps with a constant value provided in method parameter

• slinear: first order spline interpolation

• quadratic: second order spline interpolation

• cubic: third order spline interpolation

_set_frequency()

Guess the datetime resolution of a time series based on the consistency of timestamp components (e.g., seconds, minutes).

Caution

This method infers the datetime frequency of the time series data based on the consistency of timestamp components.

class plans.datasets.chrono.StreamflowSeries(name='MyStreaFlowSeries', alias=None)

Bases: WaterBalanceSeries

A class for representing and working with streamflow data (specific flow).

Notes

todo notes

Examples

todo examples

__init__(name='MyStreaFlowSeries', alias=None)

get_baseflow()

static separate_baseflow(df, dt_field='datetime', var_field='q')

class plans.datasets.chrono.ETSeries(name='MyETSeries', alias=None)

Bases: WaterBalanceSeries

A class for representing and working with ET data.

Notes

todo notes

Examples

todo examples

__init__(name='MyETSeries', alias=None)

class plans.datasets.chrono.PETSeries(name='MyPETSeries', alias=None)

Bases: WaterBalanceSeries

A class for representing and working with PET data.

Notes

todo notes

Examples

todo examples

__init__(name='MyPETSeries', alias=None)

class plans.datasets.chrono.TemperatureSeries(name='MyTemperatureSeries', alias=None)

Bases: TimeSeries

A class for representing and working with temperature time series data.

Notes

todo notes

Examples

todo examples

__init__(name='MyTemperatureSeries', alias=None)

class plans.datasets.chrono.StageSeries(name='MyStageSeries', alias=None)

Bases: TimeSeries

A class for representing and working with river stage time series data.

Notes

todo notes

Examples

todo examples

__init__(name='MyStageSeries', alias=None)

Initialize a StageSeries object.

get_metadata()

Get a dictionary with object metadata. Expected to increment superior methods.

Note

Metadata does not necessarily inclue all object attributes.

Returns:

dictionary with all metadata

Return type:

dict

class plans.datasets.chrono.DischargeSeries(name='MyFlowSeries', alias=None)

Bases: TimeSeries

A class for representing and working with discharge time series data (volumentric flow).

Notes

todo notes

Examples

todo examples

__init__(name='MyFlowSeries', alias=None)

static view_cfcs(freqs, specs=None, show=True, colors=None, labels=None)

class plans.datasets.chrono.RainSeriesSamples(name='MyRSColection')

Bases: TimeSeriesSpatialSamples

__init__(name='MyRSColection')

Initialize the Collection object.

Parameters:

• base_object (MbaE) – MbaE-based object for collection

• name (str) – unique object name

• alias (str) – unique object alias.

class plans.datasets.chrono.TemperatureSeriesSamples(name='MyTempSColection')

Bases: TimeSeriesSpatialSamples

__init__(name='MyTempSColection')

Initialize the Collection object.

Parameters:

• base_object (MbaE) – MbaE-based object for collection

• name (str) – unique object name

• alias (str) – unique object alias.

class plans.datasets.chrono.StageSeriesCollection(name='MySSColection')

Bases: TimeSeriesCluster

__init__(name='MySSColection')

Initialize the Collection object.

Parameters:

• base_object (MbaE) – MbaE-based object for collection

• name (str) – unique object name

• alias (str) – unique object alias.

set_data(df_info, src_dir=None, filter_dates=None)

Set data for the time series collection from a info class:pandas.DataFrame.

Parameters:

• df_info (class:pandas.DataFrame) – This DataFrame is expected to have matching fields to the metadata keys.

• src_dir (str) – Path for inputs directory in the case for only file names in File column.

• filter_dates (str) – List of Start and End dates for filter data

Notes

• The set_data method populates the time series collection with data based on the provided DataFrame.

• It creates time series objects, loads data, and performs additional processing steps.

• Adjust skip_process according to your data processing needs.