Cashloan

Wrapper for SAM Simulation Core model: cmod_cashloan.cpp

Input Consistency Warning

As described in Possible Problems, some input parameters are interdependent but the equations that enforce consistency are not available in this PySAM module. Therefore, the onus is on the PySAM user to check that interdependencies are correctly handled. The variables which may require additional logic include:

Provided for each of these inputs is a list of other inputs that are potentially interdependent.

Creating an Instance

Refer to the Initializing a Model page for details on the different ways to create an instance of a PySAM class.

Cashloan model description

Cashloan

PySAM.Cashloan.default(config) → Cashloan

Use default attributes config options:

  • “DSLFCommercial”
  • “EmpiricalTroughCommercial”
  • “FlatPlatePVCommercial”
  • “FlatPlatePVResidential”
  • “FuelCellCommercial”
  • “GenericBatteryCommercial”
  • “GenericBatteryResidential”
  • “GenericCSPSystemCommercial”
  • “GenericSystemCommercial”
  • “GenericSystemResidential”
  • “MSLFCommercial”
  • “PVBatteryCommercial”
  • “PVBatteryResidential”
  • “PVWattsBatteryCommercial”
  • “PVWattsBatteryResidential”
  • “PVWattsCommercial”
  • “PVWattsResidential”
  • “PhysicalTroughCommercial”
  • “SolarWaterHeatingCommercial”
  • “SolarWaterHeatingResidential”
  • “WindPowerCommercial”
  • “WindPowerResidential”
PySAM.Cashloan.from_existing(data, optional config) → Cashloan

Share underlying data with an existing PySAM class. If config provided, default attributes are loaded otherwise.

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

Use existing PySSC data

Warning

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

Functions

class PySAM.Cashloan.Cashloan

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

execute(int verbosity) → None

Execute simulation with verbosity level 0 (default) or 1

export() → dict

Export attributes into nested dictionary

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.

FinancialParameters Group

class PySAM.Cashloan.Cashloan.FinancialParameters
assign() → None

Assign attributes from dictionary

FinancialParameters_vals = { var: val, ...}

export() → dict

Export attributes into dictionary

analysis_period

Analyis period [years]

Constraints: INTEGER,MIN=0,MAX=50

Required: If not provided, assumed to be 30

Type:float
debt_fraction

Debt percentage [%]

Constraints: MIN=0,MAX=100

Required: If not provided, assumed to be 0

Type:float
federal_tax_rate

Federal income tax rate [%]

Required: True

Type:sequence
inflation_rate

Inflation rate [%]

Constraints: MIN=-99

Required: True

Type:float
insurance_rate

Insurance rate [%]

Constraints: MIN=0,MAX=100

Required: If not provided, assumed to be 0.0

Type:float
loan_rate

Loan rate [%]

Constraints: MIN=0,MAX=100

Required: If not provided, assumed to be 0

Type:float
loan_term

Loan term [years]

Constraints: INTEGER,MIN=0,MAX=50

Required: If not provided, assumed to be 0

Type:float
market

Residential or Commercial Market [0/1]

Options: 0=residential,1=comm.

Constraints: INTEGER,MIN=0,MAX=1

Required: If not provided, assumed to be 1

Type:float
mortgage

Use mortgage style loan (res. only) [0/1]

Options: 0=standard loan,1=mortgage

Constraints: INTEGER,MIN=0,MAX=1

Required: If not provided, assumed to be 0

Type:float
prop_tax_assessed_decline

Assessed value annual decline [%]

Constraints: MIN=0,MAX=100

Required: If not provided, assumed to be 5

Type:float
prop_tax_cost_assessed_percent

Percent of pre-financing costs assessed [%]

Constraints: MIN=0,MAX=100

Required: If not provided, assumed to be 95

Type:float
property_tax_rate

Property tax rate [%]

Constraints: MIN=0,MAX=100

Required: If not provided, assumed to be 0.0

Type:float
real_discount_rate

Real discount rate [%]

Constraints: MIN=-99

Required: True

Type:float
salvage_percentage

Salvage value percentage [%]

Constraints: MIN=0,MAX=100

Required: If not provided, assumed to be 0.0

Type:float
state_tax_rate

State income tax rate [%]

Required: True

Type:sequence
system_capacity

System nameplate capacity [kW]

Constraints: POSITIVE

Required: True

Type:float
system_heat_rate

System heat rate [MMBTus/MWh]

Constraints: MIN=0

Required: If not provided, assumed to be 0.0

Type:float

SystemCosts Group

class PySAM.Cashloan.Cashloan.SystemCosts
assign() → None

Assign attributes from dictionary

SystemCosts_vals = { var: val, ...}

export() → dict

Export attributes into dictionary

add_om_num_types

Number of O and M types

Constraints: INTEGER,MIN=0,MAX=2

Required: If not provided, assumed to be 0

Type:float
annual_fuel_usage

Fuel usage (yr 1) [kWht]

Constraints: MIN=0

Required: If not provided, assumed to be 0

Type:float
annual_fuel_usage_lifetime

Fuel usage (lifetime) [kWht]

Type:sequence
om_capacity

Capacity-based O&M amount [$/kWcap]

Required: If not provided, assumed to be 0.0

Type:sequence
om_capacity1

Battery capacity-based System Costs amount [$/kWcap]

Required: If not provided, assumed to be 0.0

Type:sequence
om_capacity1_nameplate

Battery capacity for System Costs values [kW]

Required: If not provided, assumed to be 0

Type:float
om_capacity2

Fuel cell capacity-based System Costs amount [$/kWcap]

Required: If not provided, assumed to be 0.0

Type:sequence
om_capacity2_nameplate

Fuel cell capacity for System Costs values [kW]

Required: If not provided, assumed to be 0

Type:float
om_capacity_escal

Capacity-based O&M escalation [%/year]

Required: If not provided, assumed to be 0.0

Type:float
om_fixed

Fixed O&M annual amount [$/year]

Required: If not provided, assumed to be 0.0

Type:sequence
om_fixed1

Battery fixed System Costs annual amount [$/year]

Required: If not provided, assumed to be 0.0

Type:sequence
om_fixed2

Fuel cell fixed System Costs annual amount [$/year]

Required: If not provided, assumed to be 0.0

Type:sequence
om_fixed_escal

Fixed O&M escalation [%/year]

Required: If not provided, assumed to be 0.0

Type:float
om_fuel_cost

Fuel cost [$/MMBtu]

Required: If not provided, assumed to be 0.0

Type:sequence
om_fuel_cost_escal

Fuel cost escalation [%/year]

Required: If not provided, assumed to be 0.0

Type:float
om_opt_fuel_1_cost

Biomass feedstock cost [$/unit]

Required: If not provided, assumed to be 0.0

Type:sequence
om_opt_fuel_1_cost_escal

Biomass feedstock cost escalation [%/year]

Required: If not provided, assumed to be 0.0

Type:float
om_opt_fuel_1_usage

Biomass feedstock usage [unit]

Required: If not provided, assumed to be 0.0

Type:float
om_opt_fuel_2_cost

Coal feedstock cost [$/unit]

Required: If not provided, assumed to be 0.0

Type:sequence
om_opt_fuel_2_cost_escal

Coal feedstock cost escalation [%/year]

Required: If not provided, assumed to be 0.0

Type:float
om_opt_fuel_2_usage

Coal feedstock usage [unit]

Required: If not provided, assumed to be 0.0

Type:float
om_production

Production-based O&M amount [$/MWh]

Required: If not provided, assumed to be 0.0

Type:sequence
om_production1

Battery production-based System Costs amount [$/MWh]

Required: If not provided, assumed to be 0.0

Type:sequence
om_production1_values

Battery production for System Costs values [kWh]

Required: If not provided, assumed to be 0

Type:sequence
om_production2

Fuel cell production-based System Costs amount [$/MWh]

Required: If not provided, assumed to be 0.0

Type:sequence
om_production2_values

Fuel cell production for System Costs values [kWh]

Required: If not provided, assumed to be 0

Type:sequence
om_production_escal

Production-based O&M escalation [%/year]

Required: If not provided, assumed to be 0.0

Type:float
om_replacement_cost1

Replacement cost 1 [$/kWh]

Required: If not provided, assumed to be 0.0

Type:sequence
om_replacement_cost2

Replacement cost 2 [$/kW]

Required: If not provided, assumed to be 0.0

Type:sequence
om_replacement_cost_escal

Replacement cost escalation [%/year]

Required: If not provided, assumed to be 0.0

Type:float
total_installed_cost

Total installed cost [$]

Constraints: MIN=0

Required: True

Type:float

Depreciation Group

class PySAM.Cashloan.Cashloan.Depreciation
assign() → None

Assign attributes from dictionary

Depreciation_vals = { var: val, ...}

export() → dict

Export attributes into dictionary

depr_fed_custom

Federal custom depreciation [%/year]

Required: True if depr_fed_type=3

Type:sequence
depr_fed_sl_years

Federal depreciation straight-line Years [years]

Constraints: INTEGER,POSITIVE

Required: True if depr_fed_type=2

Type:float
depr_fed_type

Federal depreciation type

Options: 0=none,1=macrs_half_year,2=sl,3=custom

Constraints: INTEGER,MIN=0,MAX=3

Required: If not provided, assumed to be 0

Type:float
depr_sta_custom

State custom depreciation [%/year]

Required: True if depr_sta_type=3

Type:sequence
depr_sta_sl_years

State depreciation straight-line years [years]

Constraints: INTEGER,POSITIVE

Required: True if depr_sta_type=2

Type:float
depr_sta_type

State depreciation type

Options: 0=none,1=macrs_half_year,2=sl,3=custom

Constraints: INTEGER,MIN=0,MAX=3

Required: If not provided, assumed to be 0

Type:float

TaxCreditIncentives Group

class PySAM.Cashloan.Cashloan.TaxCreditIncentives
assign() → None

Assign attributes from dictionary

TaxCreditIncentives_vals = { var: val, ...}

export() → dict

Export attributes into dictionary

itc_fed_amount

Federal amount-based ITC amount [$]

Required: If not provided, assumed to be 0

Type:float
itc_fed_amount_deprbas_fed

Federal amount-based ITC reduces federal depreciation basis [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 1

Type:float
itc_fed_amount_deprbas_sta

Federal amount-based ITC reduces state depreciation basis [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 1

Type:float
itc_fed_percent

Federal percentage-based ITC percent [%]

Required: If not provided, assumed to be 0

Type:float
itc_fed_percent_deprbas_fed

Federal percentage-based ITC reduces federal depreciation basis [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 1

Type:float
itc_fed_percent_deprbas_sta

Federal percentage-based ITC reduces state depreciation basis [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 1

Type:float
itc_fed_percent_maxvalue

Federal percentage-based ITC maximum value [$]

Required: If not provided, assumed to be 1e99

Type:float
itc_sta_amount

State amount-based ITC amount [$]

Required: If not provided, assumed to be 0

Type:float
itc_sta_amount_deprbas_fed

State amount-based ITC reduces federal depreciation basis [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 0

Type:float
itc_sta_amount_deprbas_sta

State amount-based ITC reduces state depreciation basis [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 0

Type:float
itc_sta_percent

State percentage-based ITC percent [%]

Required: If not provided, assumed to be 0

Type:float
itc_sta_percent_deprbas_fed

State percentage-based ITC reduces federal depreciation basis [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 0

Type:float
itc_sta_percent_deprbas_sta

State percentage-based ITC reduces state depreciation basis [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 0

Type:float
itc_sta_percent_maxvalue

State percentage-based ITC maximum Value [$]

Required: If not provided, assumed to be 1e99

Type:float
ptc_fed_amount

Federal PTC amount [$/kWh]

Required: If not provided, assumed to be 0

Type:sequence
ptc_fed_escal

Federal PTC escalation [%/year]

Required: If not provided, assumed to be 0

Type:float
ptc_fed_term

Federal PTC term [years]

Required: If not provided, assumed to be 10

Type:float
ptc_sta_amount

State PTC amount [$/kWh]

Required: If not provided, assumed to be 0

Type:sequence
ptc_sta_escal

State PTC escalation [%/year]

Required: If not provided, assumed to be 0

Type:float
ptc_sta_term

State PTC term [years]

Required: If not provided, assumed to be 10

Type:float

PaymentIncentives Group

class PySAM.Cashloan.Cashloan.PaymentIncentives
assign() → None

Assign attributes from dictionary

PaymentIncentives_vals = { var: val, ...}

export() → dict

Export attributes into dictionary

cbi_fed_amount

Federal CBI amount [$/Watt]

Required: If not provided, assumed to be 0.0

Type:float
cbi_fed_deprbas_fed

Federal CBI reduces federal depreciation basis [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 0

Type:float
cbi_fed_deprbas_sta

Federal CBI reduces state depreciation basis [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 0

Type:float
cbi_fed_maxvalue

Federal CBI maximum [$]

Required: If not provided, assumed to be 1e99

Type:float
cbi_fed_tax_fed

Federal CBI federal taxable [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 1

Type:float
cbi_fed_tax_sta

Federal CBI state taxable [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 1

Type:float
cbi_oth_amount

Other CBI amount [$/Watt]

Required: If not provided, assumed to be 0.0

Type:float
cbi_oth_deprbas_fed

Other CBI reduces federal depreciation basis [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 0

Type:float
cbi_oth_deprbas_sta

Other CBI reduces state depreciation basis [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 0

Type:float
cbi_oth_maxvalue

Other CBI maximum [$]

Required: If not provided, assumed to be 1e99

Type:float
cbi_oth_tax_fed

Other CBI federal taxable [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 1

Type:float
cbi_oth_tax_sta

Other CBI state taxable [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 1

Type:float
cbi_sta_amount

State CBI amount [$/Watt]

Required: If not provided, assumed to be 0.0

Type:float
cbi_sta_deprbas_fed

State CBI reduces federal depreciation basis [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 0

Type:float
cbi_sta_deprbas_sta

State CBI reduces state depreciation basis [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 0

Type:float
cbi_sta_maxvalue

State CBI maximum [$]

Required: If not provided, assumed to be 1e99

Type:float
cbi_sta_tax_fed

State CBI federal taxable [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 1

Type:float
cbi_sta_tax_sta

State CBI state taxable [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 1

Type:float
cbi_uti_amount

Utility CBI amount [$/Watt]

Required: If not provided, assumed to be 0.0

Type:float
cbi_uti_deprbas_fed

Utility CBI reduces federal depreciation basis [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 0

Type:float
cbi_uti_deprbas_sta

Utility CBI reduces state depreciation basis [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 0

Type:float
cbi_uti_maxvalue

Utility CBI maximum [$]

Required: If not provided, assumed to be 1e99

Type:float
cbi_uti_tax_fed

Utility CBI federal taxable [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 1

Type:float
cbi_uti_tax_sta

Utility CBI state taxable [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 1

Type:float
ibi_fed_amount

Federal amount-based IBI amount [$]

Required: If not provided, assumed to be 0

Type:float
ibi_fed_amount_deprbas_fed

Federal amount-based IBI reduces federal depreciation basis [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 0

Type:float
ibi_fed_amount_deprbas_sta

Federal amount-based IBI reduces state depreciation basis [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 0

Type:float
ibi_fed_amount_tax_fed

Federal amount-based IBI federal taxable [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 1

Type:float
ibi_fed_amount_tax_sta

Federal amount-based IBI state taxable [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 1

Type:float
ibi_fed_percent

Federal percentage-based IBI percent [%]

Required: If not provided, assumed to be 0.0

Type:float
ibi_fed_percent_deprbas_fed

Federal percentage-based IBI reduces federal depreciation basis [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 0

Type:float
ibi_fed_percent_deprbas_sta

Federal percentage-based IBI reduces state depreciation basis [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 0

Type:float
ibi_fed_percent_maxvalue

Federal percentage-based IBI maximum value [$]

Required: If not provided, assumed to be 1e99

Type:float
ibi_fed_percent_tax_fed

Federal percentage-based IBI federal taxable [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 1

Type:float
ibi_fed_percent_tax_sta

Federal percentage-based IBI state taxable [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 1

Type:float
ibi_oth_amount

Other amount-based IBI amount [$]

Required: If not provided, assumed to be 0

Type:float
ibi_oth_amount_deprbas_fed

Other amount-based IBI reduces federal depreciation basis [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 0

Type:float
ibi_oth_amount_deprbas_sta

Other amount-based IBI reduces state depreciation basis [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 0

Type:float
ibi_oth_amount_tax_fed

Other amount-based IBI federal taxable [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 1

Type:float
ibi_oth_amount_tax_sta

Other amount-based IBI state taxable [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 1

Type:float
ibi_oth_percent

Other percentage-based IBI percent [%]

Required: If not provided, assumed to be 0.0

Type:float
ibi_oth_percent_deprbas_fed

Other percentage-based IBI reduces federal depreciation basis [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 0

Type:float
ibi_oth_percent_deprbas_sta

Other percentage-based IBI reduces state depreciation basis [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 0

Type:float
ibi_oth_percent_maxvalue

Other percentage-based IBI maximum value [$]

Required: If not provided, assumed to be 1e99

Type:float
ibi_oth_percent_tax_fed

Other percentage-based IBI federal taxable [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 1

Type:float
ibi_oth_percent_tax_sta

Other percentage-based IBI state taxable [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 1

Type:float
ibi_sta_amount

State amount-based IBI amount [$]

Required: If not provided, assumed to be 0

Type:float
ibi_sta_amount_deprbas_fed

State amount-based IBI reduces federal depreciation basis [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 0

Type:float
ibi_sta_amount_deprbas_sta

State amount-based IBI reduces state depreciation basis [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 0

Type:float
ibi_sta_amount_tax_fed

State amount-based IBI federal taxable [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 1

Type:float
ibi_sta_amount_tax_sta

State amount-based IBI state taxable [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 1

Type:float
ibi_sta_percent

State percentage-based IBI percent [%]

Required: If not provided, assumed to be 0.0

Type:float
ibi_sta_percent_deprbas_fed

State percentage-based IBI reduces federal depreciation basis [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 0

Type:float
ibi_sta_percent_deprbas_sta

State percentage-based IBI reduces state depreciation basis [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 0

Type:float
ibi_sta_percent_maxvalue

State percentage-based IBI maximum value [$]

Required: If not provided, assumed to be 1e99

Type:float
ibi_sta_percent_tax_fed

State percentage-based IBI federal taxable [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 1

Type:float
ibi_sta_percent_tax_sta

State percentage-based IBI state taxable [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 1

Type:float
ibi_uti_amount

Utility amount-based IBI amount [$]

Required: If not provided, assumed to be 0

Type:float
ibi_uti_amount_deprbas_fed

Utility amount-based IBI reduces federal depreciation basis [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 0

Type:float
ibi_uti_amount_deprbas_sta

Utility amount-based IBI reduces state depreciation basis [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 0

Type:float
ibi_uti_amount_tax_fed

Utility amount-based IBI federal taxable [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 1

Type:float
ibi_uti_amount_tax_sta

Utility amount-based IBI state taxable [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 1

Type:float
ibi_uti_percent

Utility percentage-based IBI percent [%]

Required: If not provided, assumed to be 0.0

Type:float
ibi_uti_percent_deprbas_fed

Utility percentage-based IBI reduces federal depreciation basis [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 0

Type:float
ibi_uti_percent_deprbas_sta

Utility percentage-based IBI reduces state depreciation basis [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 0

Type:float
ibi_uti_percent_maxvalue

Utility percentage-based IBI maximum value [$]

Required: If not provided, assumed to be 1e99

Type:float
ibi_uti_percent_tax_fed

Utility percentage-based IBI federal taxable [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 1

Type:float
ibi_uti_percent_tax_sta

Utility percentage-based IBI state taxable [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 1

Type:float
pbi_fed_amount

Federal PBI amount [$/kWh]

Required: If not provided, assumed to be 0

Type:sequence
pbi_fed_escal

Federal PBI escalation [%]

Required: If not provided, assumed to be 0

Type:float
pbi_fed_tax_fed

Federal PBI federal taxable [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 1

Type:float
pbi_fed_tax_sta

Federal PBI state taxable [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 1

Type:float
pbi_fed_term

Federal PBI term [years]

Required: If not provided, assumed to be 0

Type:float
pbi_oth_amount

Other PBI amount [$/kWh]

Required: If not provided, assumed to be 0

Type:sequence
pbi_oth_escal

Other PBI escalation [%]

Required: If not provided, assumed to be 0

Type:float
pbi_oth_tax_fed

Other PBI federal taxable [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 1

Type:float
pbi_oth_tax_sta

Other PBI state taxable [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 1

Type:float
pbi_oth_term

Other PBI term [years]

Required: If not provided, assumed to be 0

Type:float
pbi_sta_amount

State PBI amount [$/kWh]

Required: If not provided, assumed to be 0

Type:sequence
pbi_sta_escal

State PBI escalation [%]

Required: If not provided, assumed to be 0

Type:float
pbi_sta_tax_fed

State PBI federal taxable [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 1

Type:float
pbi_sta_tax_sta

State PBI state taxable [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 1

Type:float
pbi_sta_term

State PBI term [years]

Required: If not provided, assumed to be 0

Type:float
pbi_uti_amount

Utility PBI amount [$/kWh]

Required: If not provided, assumed to be 0

Type:sequence
pbi_uti_escal

Utility PBI escalation [%]

Required: If not provided, assumed to be 0

Type:float
pbi_uti_tax_fed

Utility PBI federal taxable [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 1

Type:float
pbi_uti_tax_sta

Utility PBI state taxable [0/1]

Constraints: BOOLEAN

Required: If not provided, assumed to be 1

Type:float
pbi_uti_term

Utility PBI term [years]

Required: If not provided, assumed to be 0

Type:float

BatterySystem Group

class PySAM.Cashloan.Cashloan.BatterySystem
assign() → None

Assign attributes from dictionary

BatterySystem_vals = { var: val, ...}

export() → dict

Export attributes into dictionary

batt_bank_replacement

Battery bank replacements per year [number/year]

Type:sequence
batt_computed_bank_capacity

Battery bank capacity [kWh]

Required: If not provided, assumed to be 0.0

Type:float
batt_replacement_option

Enable battery replacement? [0=none,1=capacity based,2=user schedule]

Constraints: INTEGER,MIN=0,MAX=2

Required: If not provided, assumed to be 0

Type:float
batt_replacement_schedule_percent

Percentage of battery capacity to replace in each year [%]

Options: length <= analysis_period

Type:sequence
battery_per_kWh

Battery cost [$/kWh]

Required: If not provided, assumed to be 0.0

Type:float
en_batt

Enable battery storage model [0/1]

Required: If not provided, assumed to be 0

Type:float

FuelCell Group

class PySAM.Cashloan.Cashloan.FuelCell
assign() → None

Assign attributes from dictionary

FuelCell_vals = { var: val, ...}

export() → dict

Export attributes into dictionary

en_fuelcell

Enable fuel cell storage model [0/1]

Required: If not provided, assumed to be 0

Type:float
fuelcell_computed_bank_capacity

Fuel cell capacity [kWh]

Required: If not provided, assumed to be 0.0

Type:float
fuelcell_per_kWh

Fuel cell cost [$/kWh]

Required: If not provided, assumed to be 0.0

Type:float
fuelcell_replacement

Fuel cell replacements per year [number/year]

Type:sequence
fuelcell_replacement_option

Enable fuel cell replacement? [0=none,1=capacity based,2=user schedule]

Constraints: INTEGER,MIN=0,MAX=2

Required: If not provided, assumed to be 0

Type:float
fuelcell_replacement_schedule

Fuel cell replacements per year (user specified) [number/year]

Type:sequence

SystemOutput Group

class PySAM.Cashloan.Cashloan.SystemOutput
assign() → None

Assign attributes from dictionary

SystemOutput_vals = { var: val, ...}

export() → dict

Export attributes into dictionary

annual_energy_value

Energy value [$]

Required: True

Type:sequence
annual_themal_value

Energy value [$]

Type:sequence
degradation

Annual degradation [%]

Required: True

Type:sequence
gen

Power generated by renewable resource [kW]

Required: True

Type:sequence

Lifetime Group

class PySAM.Cashloan.Cashloan.Lifetime
assign() → None

Assign attributes from dictionary

Lifetime_vals = { var: val, ...}

export() → dict

Export attributes into dictionary

system_use_lifetime_output

Lifetime hourly system outputs [0/1]

Options: 0=hourly first year,1=hourly lifetime

Constraints: INTEGER,MIN=0

Required: True

Type:float

ThirdPartyOwnership Group

class PySAM.Cashloan.Cashloan.ThirdPartyOwnership
assign() → None

Assign attributes from dictionary

ThirdPartyOwnership_vals = { var: val, ...}

export() → dict

Export attributes into dictionary

elec_cost_with_system

Energy value [$]

Required: True

Type:sequence
elec_cost_without_system

Energy value [$]

Required: True

Type:sequence

Outputs Group

class PySAM.Cashloan.Cashloan.Outputs
assign() → None

Assign attributes from dictionary

Outputs_vals = { var: val, ...}

export() → dict

Export attributes into dictionary

adjusted_installed_cost

Net capital cost [$]

Type:float
cbi_fedtax_total

Federal taxable CBI income [$]

Type:float
cbi_statax_total

State taxable CBI income [$]

Type:float
cbi_total

Total CBI income [$]

Type:float
cbi_total_fed

Federal CBI income [$]

Type:float
cbi_total_oth

Other CBI income [$]

Type:float
cbi_total_sta

State CBI income [$]

Type:float
cbi_total_uti

Utility CBI income [$]

Type:float
cf_after_tax_cash_flow

After-tax cash flow [$]

Type:sequence
cf_after_tax_net_equity_cost_flow

After-tax annual costs [$]

Type:sequence
cf_battery_replacement_cost

Battery replacement cost [$]

Type:sequence
cf_battery_replacement_cost_schedule

Battery replacement cost schedule [$]

Type:sequence
cf_cumulative_payback_with_expenses

Cumulative simple payback with expenses [$]

Type:sequence
cf_cumulative_payback_without_expenses

Cumulative simple payback without expenses [$]

Type:sequence
cf_debt_balance

Debt balance [$]

Type:sequence
cf_debt_payment_interest

Interest payment [$]

Type:sequence
cf_debt_payment_principal

Principal payment [$]

Type:sequence
cf_debt_payment_total

Total P&I debt payment [$]

Type:sequence
cf_deductible_expenses

Deductible expenses [$]

Type:sequence
cf_discounted_costs

Discounted costs [$]

Type:sequence
cf_discounted_cumulative_payback

Cumulative discounted payback [$]

Type:sequence
cf_discounted_payback

Discounted payback [$]

Type:sequence
cf_discounted_savings

Discounted savings [$]

Type:sequence
cf_effective_tax_frac

Effective income tax rate [frac]

Type:sequence
cf_energy_net

Energy [kWh]

Type:sequence
cf_energy_value

Value of electricity savings [$]

Type:sequence
cf_fed_depr_sched

Federal depreciation schedule [%]

Type:sequence
cf_fed_depreciation

Federal depreciation [$]

Type:sequence
cf_fed_incentive_income_less_deductions

Federal incentive income less deductions [$]

Type:sequence
cf_fed_tax_savings

Federal tax savings [$]

Type:sequence
cf_fed_taxable_incentive_income

Federal taxable incentive income [$]

Type:sequence
cf_fed_taxable_income_less_deductions

Federal taxable income less deductions [$]

Type:sequence
cf_federal_tax_frac

Federal income tax rate [frac]

Type:sequence
cf_fuelcell_replacement_cost

Fuel cell replacement cost [$]

Type:sequence
cf_fuelcell_replacement_cost_schedule

Fuel cell replacement cost schedule [$/kW]

Type:sequence
cf_insurance_expense

Insurance expense [$]

Type:sequence
cf_length

Number of periods in cash flow

Type:float
cf_net_salvage_value

Net salvage value [$]

Type:sequence
cf_nte

Not to exceed (NTE) [cents/kWh]

Type:sequence
cf_om_capacity1_expense

Battery capacity-based expense [$]

Type:sequence
cf_om_capacity2_expense

Fuel cell capacity-based expense [$]

Type:sequence
cf_om_capacity_expense

O&M capacity-based expense [$]

Type:sequence
cf_om_fixed1_expense

Battery fixed expense [$]

Type:sequence
cf_om_fixed2_expense

Fuel cell fixed expense [$]

Type:sequence
cf_om_fixed_expense

O&M fixed expense [$]

Type:sequence
cf_om_fuel_expense

O&M fuel expense [$]

Type:sequence
cf_om_opt_fuel_1_expense

O&M biomass feedstock expense [$]

Type:sequence
cf_om_opt_fuel_2_expense

O&M coal feedstock expense [$]

Type:sequence
cf_om_production1_expense

Battery production-based expense [$]

Type:sequence
cf_om_production2_expense

Fuel cell production-based expense [$]

Type:sequence
cf_om_production_expense

O&M production-based expense [$]

Type:sequence
cf_operating_expenses

Total operating expense [$]

Type:sequence
cf_payback_with_expenses

Simple payback with expenses [$]

Type:sequence
cf_payback_without_expenses

Simple payback without expenses [$]

Type:sequence
cf_pbi_fedtax_total

Federal taxable PBI income [$]

Type:sequence
cf_pbi_statax_total

State taxable PBI income [$]

Type:sequence
cf_pbi_total

Total PBI income [$]

Type:sequence
cf_pbi_total_fed

Federal PBI income [$]

Type:sequence
cf_pbi_total_oth

Other PBI income [$]

Type:sequence
cf_pbi_total_sta

State PBI income [$]

Type:sequence
cf_pbi_total_uti

Utility PBI income [$]

Type:sequence
cf_property_tax_assessed_value

Property tax net assessed value [$]

Type:sequence
cf_property_tax_expense

Property tax expense [$]

Type:sequence
cf_ptc_fed

Federal PTC income [$]

Type:sequence
cf_ptc_sta

State PTC income [$]

Type:sequence
cf_ptc_total

Total PTC [$]

Type:sequence
cf_sta_and_fed_tax_savings

Total tax savings (federal and state) [$]

Type:sequence
cf_sta_depr_sched

State depreciation schedule [%]

Type:sequence
cf_sta_depreciation

State depreciation [$]

Type:sequence
cf_sta_incentive_income_less_deductions

State incentive income less deductions [$]

Type:sequence
cf_sta_tax_savings

State tax savings [$]

Type:sequence
cf_sta_taxable_incentive_income

State taxable incentive income [$]

Type:sequence
cf_sta_taxable_income_less_deductions

State taxable income less deductions [$]

Type:sequence
cf_state_tax_frac

State income tax rate [frac]

Type:sequence
cf_thermal_value

Value of thermal savings [$]

Type:sequence
cf_value_added

Real estate value added [$]

Type:sequence
discounted_payback

Discounted payback period [years]

Type:float
effective_tax_rate

Effective tax rate [%]

Type:float
first_cost

Equity [$]

Type:float
ibi_fedtax_total

Federal taxable IBI income [$]

Type:float
ibi_statax_total

State taxable IBI income [$]

Type:float
ibi_total

Total IBI income [$]

Type:float
ibi_total_fed

Federal IBI income [$]

Type:float
ibi_total_oth

Other IBI income [$]

Type:float
ibi_total_sta

State IBI income [$]

Type:float
ibi_total_uti

Utility IBI income [$]

Type:float
itc_total

Total ITC income [$]

Type:float
itc_total_fed

Federal ITC income [$]

Type:float
itc_total_sta

State ITC income [$]

Type:float
lcoe_nom

Nominal LCOE [cents/kWh]

Type:float
lcoe_real

Real LCOE [cents/kWh]

Type:float
lcoptc_fed_nom

Levelized federal PTC (nominal) [cents/kWh]

Type:float
lcoptc_fed_real

Levelized federal PTC (real) [cents/kWh]

Type:float
lcoptc_sta_nom

Levelized state PTC (nominal) [cents/kWh]

Type:float
lcoptc_sta_real

Levelized state PTC (real) [cents/kWh]

Type:float
lnte_nom

Nominal LNTE [cents/kWh]

Type:float
lnte_real

Real LNTE [cents/kWh]

Type:float
loan_amount

Debt [$]

Type:float
npv

Net present value [$]

Type:float
payback

Payback period [years]

Type:float
present_value_fuel

Present value of fuel expenses [$]

Type:float
present_value_insandproptax

Present value of insurance and property tax [$]

Type:float
present_value_oandm

Present value of O&M expenses [$]

Type:float
present_value_oandm_nonfuel

Present value of non-fuel O&M expenses [$]

Type:float
total_cost

Total installed cost [$]

Type:float
wacc

Weighted average cost of capital (WACC)

Type:float
year1_nte

Year 1 NTE [cents/kWh]

Type:float