pastas.model.Model.get_tmin#

pastas.model.Model.get_tmin(tmin: pandas.Timestamp | str | None = None, use_oseries: bool = True, use_stresses: bool = False) → pandas.Timestamp#

Method that checks and returns valid values for tmin.

Parameters:

  • tmin (pandas.Timestamp or str, optional) – A string or pandas.Timestamp that can be turned into a pandas Timestamp (e.g. ‘1980-01-01 00:00:00’). Strings are converted to pandas.Timestamp internally.

  • use_oseries (bool, optional) – Obtain the tmin and tmax from the oseries. Default is True.

  • use_stresses (bool, optional) – Obtain the tmin and tmax from the stresses. The minimum/maximum time from all stresses is taken.

Returns:

tmin – returns pandas timestamps for tmin.

Return type:

pandas.Timestamp

Notes

The parameters tmin and tmax are leading, unless use_oseries is True, then these are checked against the oseries index. The tmin and tmax are checked and returned according to the following rules:

  1. If no value for tmin is provided:

    1. If the use_oseries argument is True, tmin is based on the oseries.

    2. If the use_stresses argument is True, tmin is based on the stressmodels.

  2. If a values for tmin is provided:

    1. A pandas timestamp is made from the string

    2. If the use_oseries argument is True, tmin is checked against oseries.