GenericSystem

Basic power system model using either capacity, capacity factor, and heat rate, or an hourly power generation profile as input

PySAM.GenericSystem.default(config) → GenericSystem

Load defaults for the configuration config. Available configurations are:

  • “GenericBatteryAllEquityPartnershipFlip”
  • “GenericBatteryCommercial”
  • “GenericBatteryHostDeveloper”
  • “GenericBatteryLeveragedPartnershipFlip”
  • “GenericBatteryMerchantPlant”
  • “GenericBatteryResidential”
  • “GenericBatterySaleLeaseback”
  • “GenericBatterySingleOwner”
  • “GenericBatteryThirdParty”
  • “GenericSystemAllEquityPartnershipFlip”
  • “GenericSystemCommercial”
  • “GenericSystemHostDeveloper”
  • “GenericSystemLCOECalculator”
  • “GenericSystemLeveragedPartnershipFlip”
  • “GenericSystemMerchantPlant”
  • “GenericSystemNone”
  • “GenericSystemResidential”
  • “GenericSystemSaleLeaseback”
  • “GenericSystemSingleOwner”
  • “GenericSystemThirdParty”

Note

Some inputs do not have default values and may be assigned a value from the variable’s Required attribute. See variable attribute descriptions below.

PySAM.GenericSystem.from_existing(data, optional config) → GenericSystem

Share data with an existing PySAM class. If optional config is a valid configuration name, load the module’s defaults for that configuration.

PySAM.GenericSystem.new() → GenericSystem
PySAM.GenericSystem.wrap(ssc_data_t) → GenericSystem

Load data from a PySSC object.

Warning

Do not call PySSC.data_free on the ssc_data_t provided to wrap()

GenericSystem is a wrapper for the SSC compute module cmod_generic_system.cpp

Interdependent Variables

The variables listed below are interdependent with other variables. If you change the value of one of these variables, you may need to change values of other variables. The SAM user interface manages these interdependent variables, but in PySAM, it is up to you change the value of all interdependent variables so they are consistent. See Interdependent Variables for examples and details.

  • conv_eff
  • heat_rate

Functions

class PySAM.GenericSystem.GenericSystem

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 = { 'Plant': { var: val, ...}, ...}

execute(int verbosity) → None

Execute simulation with verbosity level 0 (default) or 1

export() → dict

Export attributes into nested dictionary

replace(dict) → None

Replace attributes from nested dictionary, except for Outputs. Unassigns all values in each Group then assigns from the input dict.

nested_dict = { 'Plant': { var: val, ...}, ...}

unassign(name) → None

Unassign a value in any of the variable groups.

value(name, optional value) → Union[None, float, dict, sequence, str]

Get or set by name a value in any of the variable groups.

Plant Group

class PySAM.GenericSystem.GenericSystem.Plant
assign(dict) → None

Assign attributes from dictionary, overwriting but not removing values.

Plant_vals = { var: val, ...}

export() → dict

Export attributes into dictionary.

replace(dict) → None

Replace attributes from dictionary, unassigning values not present in input dict.

Plant_vals = { var: val, ...}

conv_eff

Conversion Efficiency [%]

Required: True

The value of conv_eff depends on the following variables:

  • heat_rate
Type:float
derate

Derate [%]

Required: True

Type:float
energy_output_array

Array of Energy Output Profile [kW]

Required: Required if spec_mode=1

Type:sequence
heat_rate

Heat Rate [MMBTUs/MWhe]

Required: True

The value of the following variables depends on heat_rate:

  • conv_eff
Type:float
spec_mode

0=constant CF,1=profile

Required: True

Type:float
Type:Spec mode
system_capacity

Nameplace Capcity [kW]

Required: True

Type:float
user_capacity_factor

Capacity Factor [%]

Required: True

Type:float

Lifetime Group

class PySAM.GenericSystem.GenericSystem.Lifetime
assign(dict) → None

Assign attributes from dictionary, overwriting but not removing values.

Lifetime_vals = { var: val, ...}

export() → dict

Export attributes into dictionary.

replace(dict) → None

Replace attributes from dictionary, unassigning values not present in input dict.

Lifetime_vals = { var: val, ...}

analysis_period

Lifetime analysis period [years]

Required: Required if system_use_lifetime_output=1

Type:float
generic_degradation

Annual AC degradation [%/year]

Required: Required if system_use_lifetime_output=1

Type:sequence
system_use_lifetime_output

Generic lifetime simulation [0/1]

Constraints: INTEGER,MIN=0,MAX=1

Required: False. Automatically set to 0 if not assigned explicitly or loaded from defaults.

Type:float

AdjustmentFactors Group

class PySAM.GenericSystem.GenericSystem.AdjustmentFactors
assign() → None

Assign attributes from dictionary

export() → Dict

Export attributes into dictionary

constant

float

Type:type
dc_constant

DC Constant loss adjustment [%]

dc_hourly

DC Hourly Adjustment Factors [%]

dc_periods

DC Period-based Adjustment Factors [%]

hourly

AC Hourly Adjustment Factors [%]

periods

AC Period-based Adjustment Factors [%]

sf_constant

DC Constant loss adjustment [%]

sf_hourly

DC Hourly Adjustment Factors [%]

sf_periods

DC Period-based Adjustment Factors [%]

Outputs Group

class PySAM.GenericSystem.GenericSystem.Outputs
assign(dict) → None

Assign attributes from dictionary, overwriting but not removing values.

Outputs_vals = { var: val, ...}

export() → dict

Export attributes into dictionary.

replace(dict) → None

Replace attributes from dictionary, unassigning values not present in input dict.

Outputs_vals = { var: val, ...}

annual_energy

Annual Energy [kWh]

Type:float
annual_energy_distribution_time

Annual energy production as function of time [kW]

Type:sequence[sequence]
annual_fuel_usage

Annual Fuel Usage [kWht]

Type:float
capacity_factor

Capacity factor [%]

Type:float
gen

System power generated [kW]

Type:sequence
kwh_per_kw

First year kWh/kW [kWh/kW]

Type:float
monthly_energy

Monthly Energy [kWh]

Type:sequence
system_heat_rate

Heat Rate Conversion Factor [MMBTUs/MWhe]

Type:float
water_usage

Annual Water Usage

Type:float