Tip
Need help? Please let us know in the UMEP Community.
Find an issue within this page? Please report it in the GitHub issues.
A good understanding of SUEWS is a prerequisite to the proper use of SuPy.
supy.run_supyΒΆ
- supy.run_supy(df_forcing: pandas.core.frame.DataFrame, df_state_init: pandas.core.frame.DataFrame, save_state=False, chunk_day=3660, logging_level=20, check_input=False, serial_mode=False) Tuple[pandas.core.frame.DataFrame, pandas.core.frame.DataFrame] [source]ΒΆ
Perform supy simulation.
- Parameters
df_forcing (pandas.DataFrame) β forcing data for all grids in
df_state_init
.df_state_init (pandas.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_state (bool, 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_day (int, 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_input (bool, 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_mode (bool, 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
).
- Returns
df_output, df_state_final β
df_output: output results
df_state_final: final model states
- Return type
Tuple[pandas.DataFrame, pandas.DataFrame]
Examples
>>> df_output, df_state_final = supy.run_supy(df_forcing, df_state_init)