pywatershed.PRMSCanopy

pywatershed.PRMSCanopy#

class pywatershed.PRMSCanopy(control, discretization, parameters, pk_ice_prev, freeh2o_prev, transp_on, hru_ppt, hru_rain, hru_snow, potet, pptmix, imbalance_behavior='defer', calc_method=None, input_aliases=None, verbose=None, restart_read=False, restart_write=False, restart_write_freq=False)[source]#

PRMS canopy class.

A canopy or vegetation representation from PRMS.

Implementation based on PRMS 5.2.1 with theoretical documentation given in the PRMS-IV documentation:

Markstrom, S. L., Regan, R. S., Hay, L. E., Viger, R. J., Webb, R. M., Payn, R. A., & LaFontaine, J. H. (2015). PRMS-IV, the precipitation-runoff modeling system, version 4. US Geological Survey Techniques and Methods, 6, B7.

Parameters:

control (Control) – a Control object
discretization (Parameters) – a discretization of class Parameters
parameters (Parameters) – a parameter object of class Parameters
pk_ice_prev (Union[str, Path, ndarray, Adapter, PrmsDynamicParameter]) – Previous snowpack ice on each HRU
freeh2o_prev (Union[str, Path, ndarray, Adapter, PrmsDynamicParameter]) – Previous snowpack free water on each HRU
transp_on (Union[str, Path, ndarray, Adapter, PrmsDynamicParameter]) – Flag indicating whether transpiration is occurring (0=no;1=yes)
hru_ppt (Union[str, Path, ndarray, Adapter, PrmsDynamicParameter]) – Precipitation on each HRU
hru_rain (Union[str, Path, ndarray, Adapter, PrmsDynamicParameter]) – Rain on each HRU
hru_snow (Union[str, Path, ndarray, Adapter, PrmsDynamicParameter]) – Snow on each HRU
imbalance_behavior (Literal['defer', None, 'warn', 'error']) – one of [“defer”, None, “warn”, “error”] with “defer” being the default and defering to control.options[“imbalance_behavior”] when available. When control.options[“imbalance_behavior”] is not avaiable, imbalance_behavior is set to “warn”.
calc_method (Literal['numba', 'numpy']) – one of [“numba”, “numpy”]. None defaults to “numba”.
verbose (bool) – Print extra information or not?
load_n_time_batches – not-implemented
restart_read (Union[Path, bool]) – May be boolean or a Pathlib.Path. If False, control.options will be examined for this key. If True, the working directory is searched for restart files. If a Pathlib.Path, this specifies an alternative directory to search for restart files. Files searched for are of the pattern YYYY-mm-dd-varname.nc where the date is the control.init_time. The timestamp on the file is the valid time of the states in the file with the exception of processes with sub-daily timesteps. For example, the outflow_ts variable of PRMSChannel is instantaneous and valid at the 23rd hour of the timestampped day whereas its variable seg_outflow is the daily averge value over the timestampped day.
restart_write (Union[Path, bool]) – As for restart_read but for writing. The directory in either case will be attempted to be created if it does not exist.
restart_write_freq (Literal['y', 'm', 'd', 'f', False]) – If False, then control.options is examined for this key. The follwing values set the frequency of restart output with “y” for yearly, “m” for monthly, “d” for daily, or “f” for final. “Final” means that restart files are written with the states at control.end_time to files timestampped with control.end_time. Yearly and monthly restart options write files with timestamps on the last day of each year or month during the run. If daily, restarts are written every day. If restart_write is not False and restart_write_freq is False, the default of “f” is used.

__init__(control, discretization, parameters, pk_ice_prev, freeh2o_prev, transp_on, hru_ppt, hru_rain, hru_snow, potet, pptmix, imbalance_behavior='defer', calc_method=None, input_aliases=None, verbose=None, restart_read=False, restart_write=False, restart_write_freq=False)[source]#

Methods

`__init__`(control, discretization, ...[, ...])
`advance`()	Advance the Process in time.
`calculate`(time_length, **kwargs)	Calculate Process terms for a time step
`description`()	A dictionary description of this Process.
`finalize`()	Finalize the Process, output methods, and close input adapters.
`get_dimensions`()	Get a tuple of dimension names for this Process.
`get_energy_budget_terms`()	Get a dictionary of variable names for energy budget terms.
`get_init_values`()	Get a dictionary of initialization values for each public variable.
`get_inputs`()	Get a tuple of input variable names for this Process.
`get_mass_budget_terms`()	Get a dictionary of variable names for mass budget terms.
`get_parameters`()	Get a tuple of parameter names for this Process.
`get_restart_variables`()	A list of restart varible names.
`get_variables`()	Get a tuple of (public) variable names for this Process.
`initialize_netcdf`([output_dir, ...])	Initialize NetCDF output.
`output`()	Output data to previously initialized output types.
`output_to_csv`(pth)	Save each output variable to separate csv file in specified path
`set_input_to_adapter`(input_variable_name, ...)	Set input variables to adapter.current and manage the adapter.
`update_net_precip`(precip, stor_max, covden, ...)

Attributes

`budget`	Legacy property for backward compatibility - returns mass budget.
`dimensions`	A tuple of parameter names.
`energy_budget`	The energy budget for this process, if enabled.
`energy_budget_terms`	A dictionary of variable names for the energy budget terms.
`init_values`	A dictionary of initial values for each public variable.
`inputs`	A tuple of input variable names.
`mass_budget`	The mass budget for this process, if enabled.
`mass_budget_terms`	A dictionary of variable names for the mass budget terms.
`parameters`	A tuple of parameter names.
`restart_variables`	previous.
`variables`	A tuple of public variable names.

advance()#

Advance the Process in time.

Returns:: None

property budget#: Legacy property for backward compatibility - returns mass budget.

Deprecated since version The: ‘budget’ property is deprecated. Use ‘mass_budget’ instead.

calculate(time_length, **kwargs)#

Calculate Process terms for a time step

Parameters:: simulation_time – current simulation time
Return type:: None
Returns:: None

classmethod description()#

A dictionary description of this Process.

Return type:: dict
Returns:: All metadata for all variables in inputs, variables, parameters, mass_budget_terms, and energy_budget_terms for this Process.

property dimensions: tuple#: A tuple of parameter names.

property energy_budget#: The energy budget for this process, if enabled.

property energy_budget_terms: dict#: A dictionary of variable names for the energy budget terms.

finalize()#

Finalize the Process, output methods, and close input adapters.

Return type:: None
Returns:: None

static get_dimensions()[source]#

Get a tuple of dimension names for this Process.

Return type:: tuple

classmethod get_energy_budget_terms()#

Get a dictionary of variable names for energy budget terms.

Return type:: dict

static get_init_values()[source]#

Get a dictionary of initialization values for each public variable.

Return type:: dict

static get_inputs()[source]#

Get a tuple of input variable names for this Process.

Return type:: tuple

static get_mass_budget_terms()[source]#: Get a dictionary of variable names for mass budget terms.

static get_parameters()[source]#

Get a tuple of parameter names for this Process.

Return type:: tuple

static get_restart_variables()[source]#

A list of restart varible names.

Return type:: list

classmethod get_variables()#

Get a tuple of (public) variable names for this Process.

Return type:: tuple

property init_values: dict#: A dictionary of initial values for each public variable.

initialize_netcdf(output_dir=None, separate_files=None, budget_args=None, output_vars=None, extra_coords=None, addtl_output_vars=None)#

Initialize NetCDF output.

Parameters:

output_dir ([<class ‘str’>, <class ‘pathlib.Path’>]) – base directory path or NetCDF file path if separate_files is True
separate_files (bool) – boolean indicating if storage component output variables should be written to a separate file for each variable
output_vars (list) – list of variable names to output.

Return type:

None

Returns:

None

property inputs: tuple#: A tuple of input variable names.

property mass_budget#: The mass budget for this process, if enabled.

property mass_budget_terms: dict#: A dictionary of variable names for the mass budget terms.

output()#: Output data to previously initialized output types. :rtype: None :returns: None

output_to_csv(pth)#: Save each output variable to separate csv file in specified path

property parameters: tuple#: A tuple of parameter names.

property restart_variables: dict#

previous.

Type:: A dict of restart variable names mapping current

set_input_to_adapter(input_variable_name, adapter)#

Set input variables to adapter.current and manage the adapter.

TODO: make this private?

Parameters:

input_variable_name (str) – key of input variable
adapter (Adapter) – the Adapter for the input.

static update_net_precip(precip, stor_max, covden, intcp_stor, net_precip, idx)[source]#

property variables: tuple#: A tuple of public variable names.

pywatershed.PRMSCanopy

Contents

pywatershed.PRMSCanopy#