Tip
Need help? Please let us know in the UMEP Community.
Please report issues with the manual on the GitHub Issues.
Please cite SUEWS with proper information from our Zenodo page.
6.1.3.1.3. supy.run_supy#
- supy.run_supy(df_forcing: DataFrame, df_state_init: DataFrame, save_state=False, chunk_day=3660, logging_level=20, check_input=False, serial_mode=False) Tuple[DataFrame, DataFrame] [source]#
Perform supy simulation.
6.1.3.1.3. Parameters#
- df_forcingpandas.DataFrame
forcing data for all grids in
df_state_init
.- df_state_initpandas.DataFrame
initial model states; or a collection of model states with multiple timestamps, whose last temporal record will be used as the initial model states.
- save_statebool, optional
flag for saving model states at each time step, which can be useful in diagnosing model runtime performance or performing a restart run. (the default is False, which instructs supy not to save runtime model states).
- chunk_dayint, optional
chunk size (
chunk_day
days) to split simulation periods so memory usage can be reduced. (the default is 3660, which implies ~10-year forcing chunks used in simulations).- logging_level: logging level
one of these values [50 (CRITICAL), 40 (ERROR), 30 (WARNING), 20 (INFO), 10 (DEBUG)]. A lower value informs SuPy for more verbose logging info.
- check_inputbool, optional
flag for checking validity of input:
df_forcing
anddf_state_init
. If set toTrue
, any detected invalid input will stop SuPy simulation; aFalse
flag will bypass such validation and may incur kernel error if any invalid input. Note: such checking procedure may take some time if the input is large. (the default isFalse
, which bypasses the validation).- serial_modebool, optional
If set to
True
, SuPy simulation will be conducted in serial mode; aFalse
flag will try parallel simulation if possible (Windows not supported, i.e., always serial). (the default isFalse
).
6.1.3.1.3. Returns#
- df_output, df_state_finalTuple[pandas.DataFrame, pandas.DataFrame]
df_output: output results
df_state_final: final model states
6.1.3.1.3. Examples#
>>> df_output, df_state_final = supy.run_supy(df_forcing, df_state_init)