pastas.stressmodels.ChangeModel
===============================

.. toctree::
   :hidden:

   /api/pastas/stressmodels/ChangeModel.set_stress
   /api/pastas/stressmodels/ChangeModel.set_init_parameters
   /api/pastas/stressmodels/ChangeModel.simulate
   /api/pastas/stressmodels/ChangeModel.to_dict

.. py:class:: pastas.stressmodels.ChangeModel(stress: pandas.Series, rfunc1: pastas.typing.RFunc, rfunc2: pastas.typing.RFunc, tchange: str | pandas.Timestamp, name: str = 'change', up: bool = True, settings: str | pastas.typing.StressSettingsDict | None = None, metadata: dict | None = None)



   
   Model where the response function changes from one to another over time.

   :param stress: pandas Series object containing the stress.
   :type stress: pandas.Series
   :param rfunc1: The instance of the response function used in the convolution with the stress.
   :type rfunc1: pastas.rfunc instance
   :param rfunc2: The instance of the response function used in the convolution with the stress.
   :type rfunc2: pastas.rfunc instance
   :param tchange: string with the approximate date of the change.
   :type tchange: str | pandas.Timestamp
   :param name: Name of the stressmodel. Default is "change".
   :type name: str
   :param up: True if response function is positive (default), False if negative. None if
              you don't want to define if response is positive or negative.
   :type up: bool or None, optional
   :param settings: The settings of the stress. This can be a string referring to a predefined
                    settings dict (defined in ps.rcParams["timeseries"]), or a dict with the
                    settings to apply. For more information, refer to the docs of pastas.Timeseries
                    for further information.
   :type settings: dict or str, optional
   :param metadata: dictionary containing metadata about the stress. This is passed onto the
                    TimeSeries object.
   :type metadata: dict, optional

   :param Time series settings:
   :param fill_nan:
                    Method for filling NaNs.
                       * `drop`: drop NaNs from time series
                       * `mean`: fill NaNs with mean value of time series
                       * `interpolate`: fill NaNs by interpolating between finite values
                       * `float`: fill NaN with provided value, e.g. 0.0
   :type fill_nan: {"drop", "mean", "interpolate"} or float
   :param fill_before:
                       Method for extending time series into past.
                          * `mean`: extend time series into past with mean value of time series
                          * `bfill`: extend time series into past by back-filling first value
                          * `float`: extend time series into past with provided value, e.g. 0.0
   :type fill_before: {"mean", "bfill"} or float
   :param fill_after:
                      Method for extending time series into future.
                         * `mean`: extend time series into future with mean value of time series
                         * `ffill`: extend time series into future by forward-filling last value
                         * `float`: extend time series into future with provided value, e.g. 0.0
   :type fill_after: {"mean", "ffill"} or float
   :param sample_up: Method for up-sampling time series (increasing frequency, e.g. going from weekly
                     to daily values).
                        * `bfill` or `backfill`: fill up-sampled time steps by back-filling current
                          values
                        * `ffill` or `pad`: fill up-sampled time steps by forward-filling current
                          values
                        * `mean`: fill up-sampled time steps with mean of timeseries
                        * `interpolate`: fill up-sampled time steps by interpolating between current
                          values
                        * `divide`: fill up-sampled steps with current value divided by length of
                          current time steps (i.e. spread value over new time steps).
   :type sample_up: {"mean", "interpolate", "divide"} or float
   :param sample_down: Method for down-sampling time series (decreasing frequency, e.g. going from
                       daily to weekly values).
                          * `mean`: resample time series by taking the mean
                          * `drop`: resample the time series by taking the mean, dropping any
                            NaN-values
                          * `sum`: resample time series by summing values
                          * `max`: resample time series with maximum value
                          * `min`: resample time series with minimum value
   :type sample_down: {"mean", "drop", "sum", "min", "max"}

   .. rubric:: Notes

   This model is based on :cite:t:`obergfell_identification_2019`.















   ..
       !! processed by numpydoc !!

   .. py:property:: stress
      :type: pastas.timeseries.TimeSeries


      
      Return the stress time series.
















      ..
          !! processed by numpydoc !!


   .. py:property:: stresses
      :type: tuple[pastas.timeseries.TimeSeries]


      
      Return the stress time series as a tuple.
















      ..
          !! processed by numpydoc !!


   .. py:property:: nsplit
      :type: int


      
      Determine in how many time series the contribution can be split.
















      ..
          !! processed by numpydoc !!

Methods
-------

.. autoapisummary::

   pastas.stressmodels.ChangeModel.set_stress
   pastas.stressmodels.ChangeModel.set_init_parameters
   pastas.stressmodels.ChangeModel.simulate
   pastas.stressmodels.ChangeModel.to_dict