Note
Please report issues with this page on the GitHub page.
supy.init_supy¶
-
supy.
init_supy
(path_init: str, force_reload=True, check_input=False) → pandas.core.frame.DataFrame[source]¶ Initialise supy by loading initial model states.
Parameters: - path_init (str) –
- Path to a file that can initialise SuPy, which can be either of the follows:
- SUEWS RunControl.nml: a namelist file for SUEWS configurations
- SuPy
df_state.csv
: a CSV file including model states produced by a SuPy run viasupy.save_supy()
- force_reload (boolean, optional) – Flag to force reload all initialisation files by clearing all cached states, with default value
True
(i.e., force reload all files). Note: If the number of simulation grids is large (e.g., > 100),force_reload=False
is strongly recommended for better performance.
Returns: df_state_init – Initial model states. See df_state variables for details.
Return type: Examples
- Use RunControl.nml to initialise SuPy
>>> path_init = "~/SUEWS_sims/RunControl.nml" >>> df_state_init = supy.init_supy(path_init)
- Use
df_state.csv
to initialise SuPy
>>> path_init = "~/SuPy_res/df_state_test.csv" >>> df_state_init = supy.init_supy(path_init)
- path_init (str) –