Utilityrate4¶
Wrapper for SAM Simulation Core model: cmod_utilityrate4.cpp
Creating an Instance¶
There are three methods to create a new instance of a PySAM module. Using default populates the newclass’ attributes with default values specific to a config. Each technology-financialconfiguration corresponds to a SAM GUI configuration. Using new creates an instance with empty attributes. The wrap function allows compatibility with PySSC, for details, refer to PySSC.
Utilityrate4 model description
Utilityrate4
-
PySAM.Utilityrate4.default(config) → Utilityrate4¶ Use financial config-specific default attributes
-
PySAM.Utilityrate4.from_existing(data, optional config) → Utilityrate4¶ Share underlying data with an existing PySAM class. If config provided, default attributes are loaded otherwise.
-
PySAM.Utilityrate4.new() → Utilityrate4¶
-
PySAM.Utilityrate4.wrap(ssc_data_t) → Utilityrate4¶ Use existing PySSC data
Warning
Do not call PySSC.data_free on the ssc_data_t provided to
wrap
Functions¶
-
class
PySAM.Utilityrate4.Utilityrate4¶ This class contains all the variable information for running a simulation. Variables are grouped together in the subclasses as properties. If property assignments are the wrong type, an error is thrown.
-
assign(dict) → None¶ Assign attributes from nested dictionary, except for Outputs
nested_dict = { 'Common': { var: val, ...}, ...}
-
execute(int verbosity) → None¶ Execute simulation with verbosity level 0 (default) or 1
-
export() → dict¶ Export attributes into nested dictionary
-
value(name, optional value) → Union[None, float, dict, sequence, str]¶ Get or set by name a value in any of the variable groups.
-
Common Group¶
-
class
PySAM.Utilityrate4.Utilityrate4.Common¶ -
assign() → None¶ Assign attributes from dictionary
Common_vals = { var: val, ...}
-
export() → dict¶ Export attributes into dictionary
-
analysis_period¶ Number of years in analysis [years]
Constraints: INTEGER,POSITIVE
Required: True
Type: float
-
load_escalation¶ Annual load escalation [%/year]
Required: If not provided, assumed to be 0
Type: sequence
-
rate_escalation¶ Annual electricity rate escalation [%/year]
Required: If not provided, assumed to be 0
Type: sequence
-
system_use_lifetime_output¶ Lifetime hourly system outputs [0/1]
Options: 0=hourly first year,1=hourly lifetime
Constraints: INTEGER,MIN=0,MAX=1
Required: True
Type: float
-
ur_annual_min_charge¶ Annual minimum charge [$]
Required: If not provided, assumed to be 0.0
Type: float
-
ur_dc_enable¶ Enable demand charge [0/1]
Constraints: BOOLEAN
Required: If not provided, assumed to be 0
Type: float
-
ur_dc_flat_mat¶ Demand rates (flat) table
Required: True if ur_dc_enable=1
Type: sequence[sequence]
-
ur_dc_sched_weekday¶ Demand charge weekday schedule
Info: 12x24
Type: sequence[sequence]
-
ur_dc_sched_weekend¶ Demand charge weekend schedule
Info: 12x24
Type: sequence[sequence]
-
ur_dc_tou_mat¶ Demand rates (TOU) table
Required: True if ur_dc_enable=1
Type: sequence[sequence]
-
ur_ec_sched_weekday¶ Energy charge weekday schedule
Info: 12x24
Required: True
Type: sequence[sequence]
-
ur_ec_sched_weekend¶ Energy charge weekend schedule
Info: 12x24
Required: True
Type: sequence[sequence]
-
ur_ec_tou_mat¶ Energy rates table
Required: True
Type: sequence[sequence]
-
ur_metering_option¶ Metering options [0=Single meter with monthly rollover credits in kWh,1=Single meter with monthly rollover credits in $,2=Single meter with no monthly rollover credits,3=Two meters with all generation sold and all load purchased]
Info: Net metering monthly excess
Constraints: INTEGER
Required: If not provided, assumed to be 0
Type: float
-
ur_monthly_fixed_charge¶ Monthly fixed charge [$]
Required: If not provided, assumed to be 0.0
Type: float
-
ur_monthly_min_charge¶ Monthly minimum charge [$]
Required: If not provided, assumed to be 0.0
Type: float
-
ur_nm_yearend_sell_rate¶ Year end sell rate [$/kWh]
Required: If not provided, assumed to be 0.0
Type: float
-
ur_sell_eq_buy¶ Set sell rate equal to buy rate [0/1]
Info: Optional override
Constraints: BOOLEAN
Required: If not provided, assumed to be 0
Type: float
-
TimeSeries Group¶
-
class
PySAM.Utilityrate4.Utilityrate4.TimeSeries¶ -
assign() → None¶ Assign attributes from dictionary
TimeSeries_vals = { var: val, ...}
-
export() → dict¶ Export attributes into dictionary
-
gen¶ System power generated [kW]
Required: True
Type: sequence
-
load¶ Electricity load (year 1) [kW]
Required: True
Type: sequence
-
Financials Group¶
AnnualOutput Group¶
Outputs Group¶
-
class
PySAM.Utilityrate4.Utilityrate4.Outputs¶ -
assign() → None¶ Assign attributes from dictionary
Outputs_vals = { var: val, ...}
-
export() → dict¶ Export attributes into dictionary
-
annual_electric_load¶ Electricity load total in each year [kWh]
Type: sequence
-
annual_energy_value¶ Energy value in each year [$]
Type: sequence
-
charge_w_sys_dc_fixed¶ Demand charge with system (flat) [$]
Type: sequence
-
charge_w_sys_dc_fixed_ym¶ Demand charge with system (flat) [$]
Type: sequence[sequence]
-
charge_w_sys_dc_tou¶ Demand charge with system (TOU) [$]
Type: sequence
-
charge_w_sys_dc_tou_ym¶ Demand charge with system (TOU) [$]
Type: sequence[sequence]
-
charge_w_sys_ec¶ Energy charge with system [$]
Type: sequence
-
charge_w_sys_ec_apr_tp¶ Energy charge with system Apr [$]
Type: sequence[sequence]
-
charge_w_sys_ec_aug_tp¶ Energy charge with system Aug [$]
Type: sequence[sequence]
-
charge_w_sys_ec_dec_tp¶ Energy charge with system Dec [$]
Type: sequence[sequence]
-
charge_w_sys_ec_feb_tp¶ Energy charge with system Feb [$]
Type: sequence[sequence]
-
charge_w_sys_ec_jan_tp¶ Energy charge with system Jan [$]
Type: sequence[sequence]
-
charge_w_sys_ec_jul_tp¶ Energy charge with system Jul [$]
Type: sequence[sequence]
-
charge_w_sys_ec_jun_tp¶ Energy charge with system Jun [$]
Type: sequence[sequence]
-
charge_w_sys_ec_mar_tp¶ Energy charge with system Mar [$]
Type: sequence[sequence]
-
charge_w_sys_ec_may_tp¶ Energy charge with system May [$]
Type: sequence[sequence]
-
charge_w_sys_ec_nov_tp¶ Energy charge with system Nov [$]
Type: sequence[sequence]
-
charge_w_sys_ec_oct_tp¶ Energy charge with system Oct [$]
Type: sequence[sequence]
-
charge_w_sys_ec_sep_tp¶ Energy charge with system Sep [$]
Type: sequence[sequence]
-
charge_w_sys_ec_ym¶ Energy charge with system [$]
Type: sequence[sequence]
-
charge_w_sys_fixed¶ Fixed monthly charge with system [$]
Type: sequence
-
charge_w_sys_fixed_ym¶ Fixed monthly charge with system [$]
Type: sequence[sequence]
-
charge_w_sys_minimum¶ Minimum charge with system [$]
Type: sequence
-
charge_w_sys_minimum_ym¶ Minimum charge with system [$]
Type: sequence[sequence]
-
charge_wo_sys_dc_fixed¶ Demand charge without system (flat) [$]
Type: sequence
-
charge_wo_sys_dc_fixed_ym¶ Demand charge without system (flat) [$]
Type: sequence[sequence]
-
charge_wo_sys_dc_tou¶ Demand charge without system (TOU) [$]
Type: sequence
-
charge_wo_sys_dc_tou_ym¶ Demand charge without system (TOU) [$]
Type: sequence[sequence]
-
charge_wo_sys_ec¶ Energy charge without system [$]
Type: sequence
-
charge_wo_sys_ec_apr_tp¶ Energy charge without system Apr [$]
Type: sequence[sequence]
-
charge_wo_sys_ec_aug_tp¶ Energy charge without system Aug [$]
Type: sequence[sequence]
-
charge_wo_sys_ec_dec_tp¶ Energy charge without system Dec [$]
Type: sequence[sequence]
-
charge_wo_sys_ec_feb_tp¶ Energy charge without system Feb [$]
Type: sequence[sequence]
-
charge_wo_sys_ec_jan_tp¶ Energy charge without system Jan [$]
Type: sequence[sequence]
-
charge_wo_sys_ec_jul_tp¶ Energy charge without system Jul [$]
Type: sequence[sequence]
-
charge_wo_sys_ec_jun_tp¶ Energy charge without system Jun [$]
Type: sequence[sequence]
-
charge_wo_sys_ec_mar_tp¶ Energy charge without system Mar [$]
Type: sequence[sequence]
-
charge_wo_sys_ec_may_tp¶ Energy charge without system May [$]
Type: sequence[sequence]
-
charge_wo_sys_ec_nov_tp¶ Energy charge without system Nov [$]
Type: sequence[sequence]
-
charge_wo_sys_ec_oct_tp¶ Energy charge without system Oct [$]
Type: sequence[sequence]
-
charge_wo_sys_ec_sep_tp¶ Energy charge without system Sep [$]
Type: sequence[sequence]
-
charge_wo_sys_ec_ym¶ Energy charge without system [$]
Type: sequence[sequence]
-
charge_wo_sys_fixed¶ Fixed monthly charge without system [$]
Type: sequence
-
charge_wo_sys_fixed_ym¶ Fixed monthly charge without system [$]
Type: sequence[sequence]
-
charge_wo_sys_minimum¶ Minimum charge without system [$]
Type: sequence
-
charge_wo_sys_minimum_ym¶ Minimum charge without system [$]
Type: sequence[sequence]
-
elec_cost_with_system¶ Electricity bill with system [$/yr]
Type: sequence
-
elec_cost_with_system_year1¶ Electricity bill with system (year 1) [$/yr]
Type: float
-
elec_cost_without_system¶ Electricity bill without system [$/yr]
Type: sequence
-
elec_cost_without_system_year1¶ Electricity bill without system (year 1) [$/yr]
Type: float
-
energy_w_sys_ec_apr_tp¶ Electricity usage with system Apr [kWh]
Type: sequence[sequence]
-
energy_w_sys_ec_aug_tp¶ Electricity usage with system Aug [kWh]
Type: sequence[sequence]
-
energy_w_sys_ec_dec_tp¶ Electricity usage with system Dec [kWh]
Type: sequence[sequence]
-
energy_w_sys_ec_feb_tp¶ Electricity usage with system Feb [kWh]
Type: sequence[sequence]
-
energy_w_sys_ec_jan_tp¶ Electricity usage with system Jan [kWh]
Type: sequence[sequence]
-
energy_w_sys_ec_jul_tp¶ Electricity usage with system Jul [kWh]
Type: sequence[sequence]
-
energy_w_sys_ec_jun_tp¶ Electricity usage with system Jun [kWh]
Type: sequence[sequence]
-
energy_w_sys_ec_mar_tp¶ Electricity usage with system Mar [kWh]
Type: sequence[sequence]
-
energy_w_sys_ec_may_tp¶ Electricity usage with system May [kWh]
Type: sequence[sequence]
-
energy_w_sys_ec_nov_tp¶ Electricity usage with system Nov [kWh]
Type: sequence[sequence]
-
energy_w_sys_ec_oct_tp¶ Electricity usage with system Oct [kWh]
Type: sequence[sequence]
-
energy_w_sys_ec_sep_tp¶ Electricity usage with system Sep [kWh]
Type: sequence[sequence]
-
energy_wo_sys_ec_apr_tp¶ Electricity usage without system Apr [kWh]
Type: sequence[sequence]
-
energy_wo_sys_ec_aug_tp¶ Electricity usage without system Aug [kWh]
Type: sequence[sequence]
-
energy_wo_sys_ec_dec_tp¶ Electricity usage without system Dec [kWh]
Type: sequence[sequence]
-
energy_wo_sys_ec_feb_tp¶ Electricity usage without system Feb [kWh]
Type: sequence[sequence]
-
energy_wo_sys_ec_jan_tp¶ Electricity usage without system Jan [kWh]
Type: sequence[sequence]
-
energy_wo_sys_ec_jul_tp¶ Electricity usage without system Jul [kWh]
Type: sequence[sequence]
-
energy_wo_sys_ec_jun_tp¶ Electricity usage without system Jun [kWh]
Type: sequence[sequence]
-
energy_wo_sys_ec_mar_tp¶ Electricity usage without system Mar [kWh]
Type: sequence[sequence]
-
energy_wo_sys_ec_may_tp¶ Electricity usage without system May [kWh]
Type: sequence[sequence]
-
energy_wo_sys_ec_nov_tp¶ Electricity usage without system Nov [kWh]
Type: sequence[sequence]
-
energy_wo_sys_ec_oct_tp¶ Electricity usage without system Oct [kWh]
Type: sequence[sequence]
-
energy_wo_sys_ec_sep_tp¶ Electricity usage without system Sep [kWh]
Type: sequence[sequence]
-
lifetime_load¶ Lifetime electricity load [kW]
Type: sequence
-
savings_year1¶ Electricity net savings with system (year 1) [$/yr]
Type: float
-
surplus_w_sys_ec_apr_tp¶ Electricity exports with system Apr [kWh]
Type: sequence[sequence]
-
surplus_w_sys_ec_aug_tp¶ Electricity exports with system Aug [kWh]
Type: sequence[sequence]
-
surplus_w_sys_ec_dec_tp¶ Electricity exports with system Dec [kWh]
Type: sequence[sequence]
-
surplus_w_sys_ec_feb_tp¶ Electricity exports with system Feb [kWh]
Type: sequence[sequence]
-
surplus_w_sys_ec_jan_tp¶ Electricity exports with system Jan [kWh]
Type: sequence[sequence]
-
surplus_w_sys_ec_jul_tp¶ Electricity exports with system Jul [kWh]
Type: sequence[sequence]
-
surplus_w_sys_ec_jun_tp¶ Electricity exports with system Jun [kWh]
Type: sequence[sequence]
-
surplus_w_sys_ec_mar_tp¶ Electricity exports with system Mar [kWh]
Type: sequence[sequence]
-
surplus_w_sys_ec_may_tp¶ Electricity exports with system May [kWh]
Type: sequence[sequence]
-
surplus_w_sys_ec_nov_tp¶ Electricity exports with system Nov [kWh]
Type: sequence[sequence]
-
surplus_w_sys_ec_oct_tp¶ Electricity exports with system Oct [kWh]
Type: sequence[sequence]
-
surplus_w_sys_ec_sep_tp¶ Electricity exports with system Sep [kWh]
Type: sequence[sequence]
-
utility_bill_w_sys¶ Utility bill with system [$]
Type: sequence
-
utility_bill_w_sys_ym¶ Utility bill with system [$]
Type: sequence[sequence]
-
utility_bill_wo_sys¶ Utility bill without system [$]
Type: sequence
-
utility_bill_wo_sys_ym¶ Utility bill without system [$]
Type: sequence[sequence]
-
year1_electric_load¶ Electricity load total (year 1) [kWh/yr]
Type: float
-
year1_hourly_dc_peak_per_period¶ Electricity peak from grid per TOU period [kW]
Type: sequence
-
year1_hourly_dc_tou_schedule¶ TOU period for demand charges
Type: sequence
-
year1_hourly_dc_with_system¶ Demand charge with system [$]
Type: sequence
-
year1_hourly_dc_without_system¶ Demand charge without system [$]
Type: sequence
-
year1_hourly_e_fromgrid¶ Electricity from grid [kWh]
Type: sequence
-
year1_hourly_e_tofromgrid¶ Electricity to/from grid [kWh]
Type: sequence
-
year1_hourly_e_togrid¶ Electricity to grid [kWh]
Type: sequence
-
year1_hourly_ec_tou_schedule¶ TOU period for energy charges
Type: sequence
-
year1_hourly_ec_with_system¶ Energy charge with system [$]
Type: sequence
-
year1_hourly_ec_without_system¶ Energy charge without system [$]
Type: sequence
-
year1_hourly_p_system_to_load¶ Electricity peak from system to load [kW]
Type: sequence
-
year1_hourly_p_tofromgrid¶ Electricity to/from grid peak [kW]
Type: sequence
-
year1_hourly_salespurchases_with_system¶ Electricity sales/purchases with sytem [$]
Type: sequence
-
year1_hourly_salespurchases_without_system¶ Electricity sales/purchases without sytem [$]
Type: sequence
-
year1_hourly_system_to_load¶ Electricity from system to load [kWh]
Type: sequence
-
year1_monthly_cumulative_excess_dollars¶ Net metering credit in $ [$/mo]
Type: sequence
-
year1_monthly_cumulative_excess_generation¶ Net metering credit in kWh [kWh/mo]
Type: sequence
-
year1_monthly_dc_fixed_with_system¶ Demand charge (flat) with system [$/mo]
Type: sequence
-
year1_monthly_dc_fixed_without_system¶ Demand charge (flat) without system [$/mo]
Type: sequence
-
year1_monthly_dc_tou_with_system¶ Demand charge (TOU) with system [$/mo]
Type: sequence
-
year1_monthly_dc_tou_without_system¶ Demand charge (TOU) without system [$/mo]
Type: sequence
-
year1_monthly_ec_charge_with_system¶ Energy charge with system [$/mo]
Type: sequence
-
year1_monthly_ec_charge_without_system¶ Energy charge without system [$/mo]
Type: sequence
-
year1_monthly_electricity_to_grid¶ Electricity to/from grid [kWh/mo]
Type: sequence
-
year1_monthly_fixed_with_system¶ Fixed monthly charge with system [$/mo]
Type: sequence
-
year1_monthly_fixed_without_system¶ Fixed monthly charge without system [$/mo]
Type: sequence
-
year1_monthly_load¶ Electricity load [kWh/mo]
Type: sequence
-
year1_monthly_minimum_with_system¶ Minimum charge with system [$/mo]
Type: sequence
-
year1_monthly_minimum_without_system¶ Minimum charge without system [$/mo]
Type: sequence
-
year1_monthly_peak_w_system¶ Peak demand with system [kW/mo]
Type: sequence
-
year1_monthly_peak_wo_system¶ Peak demand without system [kW/mo]
Type: sequence
-
year1_monthly_use_w_system¶ Energy use with system [kWh/mo]
Type: sequence
-
year1_monthly_use_wo_system¶ Energy use without system [kWh/mo]
Type: sequence
-
year1_monthly_utility_bill_w_sys¶ Utility bill with system [$/mo]
Type: sequence
-
year1_monthly_utility_bill_wo_sys¶ Utility bill without system [$/mo]
Type: sequence
-