Tcsdish¶

Wrapper for SAM Simulation Core model: cmod_tcsdish.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.

Tcsdish model description

CSP dish-Stirling model with parameters for SES and WGA-ADDS systems for power generation

PySAM.Tcsdish.default(config) → Tcsdish¶

Use financial model-specific default attributes config options:

“DishStirlingAllEquityPartnershipFlip”
“DishStirlingCommercial”
“DishStirlingCommercialPPA”
“DishStirlingIndependentPowerProducer”
“DishStirlingLCOECalculator”
“DishStirlingLeveragedPartnershipFlip”
“DishStirlingNone”
“DishStirlingSaleLeaseback”
“DishStirlingSingleOwner”

PySAM.Tcsdish.new() → Tcsdish¶

PySAM.Tcsdish.wrap(ssc_data_t) → Tcsdish¶: Use existing PySSC data

Warning

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

Functions¶

class PySAM.Tcsdish.Tcsdish¶

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

execute(int verbosity) → None¶: Execute simulation with verbosity level 0 (default) or 1

export() → dict¶: Export attributes into nested dictionary

Weather Group¶

class PySAM.Tcsdish.Tcsdish.Weather¶

assign() → None¶

Assign attributes from dictionary

Weather_vals = { var: val, ...}

export() → dict¶: Export attributes into dictionary

file_name¶

str: local weather file path

Constraints: LOCAL_FILE

Required: True

Dish Group¶

class PySAM.Tcsdish.Tcsdish.Dish¶

assign() → None¶

Assign attributes from dictionary

Dish_vals = { var: val, ...}

export() → dict¶: Export attributes into dictionary

system_capacity¶

float: Nameplate capacity [kW]

Required: True

Type295 Group¶

class PySAM.Tcsdish.Tcsdish.Type295¶

assign() → None¶

Assign attributes from dictionary

Type295_vals = { var: val, ...}

export() → dict¶: Export attributes into dictionary

A_proj¶

float: Projected mirror area [m^2]

Required: True

A_total¶

float: Total Area [m^2]

Required: True

I_cut_in¶

float: Insolation cut in value [W/m^2]

Required: True

d_ap¶

float: Dish aperture diameter [m]

Required: True

d_ap_test¶

float: Receiver aperture diameter during test [m]

Required: True

ew_dish_sep¶

float: Collector separation East-West [m]

Required: True

h_slot_gap¶

float: Slot gap height [m]

Required: True

n_ew¶

float: Number of collectors East-West [-]

Constraints: INTEGER

Required: True

n_ns¶

float: Number of collectors North-South [-]

Constraints: INTEGER

Required: True

ns_dish_sep¶

float: Collector separation North-South [m]

Required: True

rho¶

float: Mirror surface reflectivity [-]

Required: True

slope_ew¶

float: East-West ground slope [%]

Required: True

slope_ns¶

float: North-South ground slope [%]

Required: True

test_L_focal¶

float: Focal length of mirror system [m]

Required: True

test_if¶

float: Test intercept factor [-]

Required: True

w_slot_gap¶

float: Slot gap width [m]

Required: True

wind_stow_speed¶

float: Wind stow speed [m/s]

Required: True

Type296 Group¶

class PySAM.Tcsdish.Tcsdish.Type296¶

assign() → None¶

Assign attributes from dictionary

Type296_vals = { var: val, ...}

export() → dict¶: Export attributes into dictionary

A_absorber¶

float: Absorber surface area [m^2]

Required: True

A_wall¶

float: Cavity surface area [m^2]

Required: True

DELTA_T_DIR¶

float: Delta temperature for DIR receiver [K]

Required: True

DELTA_T_REFLUX¶

float: Delta temp for REFLUX receiver (always = 40) [K]

Required: True

L_cav¶

float: Internal depth of cavity perp to aperture [m]

Required: True

L_insulation¶

float: Insulation thickness [m]

Required: True

P_cav¶

float: Internal cavity pressure with aperture covered [kPa]

Required: True

T_heater_head_high¶

float: Heater Head Set Temperature [K]

Required: True

T_heater_head_low¶

float: Header Head Lowest Temperature [K]

Required: True

alpha_absorber¶

float: Absorber absorptance [-]

Required: True

alpha_wall¶

float: Cavity absorptance [-]

Required: True

d_cav¶

float: Internal diameter of cavity perp to aperture [m]

Required: True

k_insulation¶

float: Insulation thermal conductivity [W/m-K]

Required: True

rec_type¶

float: Receiver type (always = 1) [-]

Required: True

transmittance_cover¶

float: Transmittance cover (always = 1) [-]

Required: True

Type297 Group¶

class PySAM.Tcsdish.Tcsdish.Type297¶

assign() → None¶

Assign attributes from dictionary

Type297_vals = { var: val, ...}

export() → dict¶: Export attributes into dictionary

Beale_const_coef¶

float: Beale Constant Coefficient [-]

Required: True

Beale_first_coef¶

float: Beale first-order coefficient [1/W]

Required: True

Beale_fourth_coef¶

float: Beale fourth-order coefficient [1/W^4]

Required: True

Beale_square_coef¶

float: Beale second-order coefficient [1/W^2]

Required: True

Beale_third_coef¶

float: Beale third-order coefficient [1/W^3]

Required: True

Pressure_coef¶

float: Pressure constant coefficient [MPa]

Required: True

Pressure_first¶

float: Pressure first-order coefficient [MPa/W]

Required: True

T_compression_in¶

float: Receiver efficiency [C]

Required: True

V_displaced¶

float: Displaced engine volume [m3]

Required: True

engine_speed¶

float: Engine operating speed [rpm]

Required: True

Type298 Group¶

class PySAM.Tcsdish.Tcsdish.Type298¶

assign() → None¶

Assign attributes from dictionary

Type298_vals = { var: val, ...}

export() → dict¶: Export attributes into dictionary

P_controls¶

float: Control System Parasitic Power, Avg. [W]

Required: True

P_tower_fan¶

float: Tower fan power (set to 0) [kJ/hr]

Required: True

T_cool_speed2¶

float: Cooling Fluid Temp. For Fan Speed 2 Cut-In [C]

Required: True

T_cool_speed3¶

float: Cooling Fluid Temp. For Fan Speed 3 Cut-In [C]

Required: True

Tower_water_outlet_temp¶

float: Tower water outlet temperature (set to 20) [C]

Required: True

b_cooler¶

float: b_cooler parameter [-]

Required: True

b_radiator¶

float: b_radiator parameter [-]

Required: True

cooling_fluid¶

float: Reference Condition Cooling Fluid: 1=Water,2=V50%EG,3=V25%EG,4=V40%PG,5=V25%PG [-]

Constraints: INTEGER

Required: True

cooling_tower_on¶

float: Option to use a cooling tower (set to 0=off) [-]

Required: True

d_pipe_tower¶

float: Runner pipe diameter to the cooling tower (set to 0.4m) [m]

Required: True

epsilon_cooler_test¶

float: Cooler effectiveness [-]

Required: True

epsilon_power_test¶

float: Test value for cooling tower effectiveness (set to 0.7) [-]

Required: True

epsilon_radiator_test¶

float: Radiator effectiveness [-]

Required: True

eta_tower_pump¶

float: Tower pump efficiency (set to 0.6) [-]

Required: True

ew_dish_separation¶

float: East-West dish separation used in the simulation [m]

Required: True

fan_control_signal¶

float: Fan control signal (set to 1, not used in this model) [-]

Required: True

fan_speed1¶

float: Cooling system fan speed 1 [rpm]

Required: True

fan_speed2¶

float: Cooling system fan speed 2 [rpm]

Required: True

fan_speed3¶

float: Cooling system fan speed 3 [rpm]

Required: True

ns_dish_separation¶

float: North-South dish separation used in the simulation [m]

Required: True

pump_speed¶

float: Reference Condition Pump Speed [rpm]

Required: True

system_availability¶

float: System availability (set to 1.0) [-]

Required: True

test_P_fan¶

float: Reference Condition Cooling System Fan Power [W]

Required: True

test_P_pump¶

float: Reference Condition Pump Parasitic Power [W]

Required: True

test_T_fluid¶

float: Reference Condition Cooling Fluid Temperature [K]

Required: True

test_V_dot_fluid¶

float: Reference Condition Cooling Fluid Volumetric Flow Rate [gpm]

Required: True

test_cooling_fluid¶

float: Reference Condition Cooling Fluid [-]

Constraints: INTEGER

Required: True

test_fan_cfm¶

float: Reference condition van volumentric flow rate [cfm]

Required: True

test_fan_rho_air¶

float: Reference condition fan air density [kg/m^3]

Required: True

test_fan_speed¶

float: Reference Condition Cooling System Fan Speed [rpm]

Required: True

test_pump_speed¶

float: Reference Condition Pump Speed [rpm]

Required: True

tower_m_dot_water¶

float: Tower cooling water flow rate (set to 134,000 kg/hr) [kg/s]

Required: True

tower_m_dot_water_test¶

float: Test value for the cooling water flow rate (set to 134,000 kg/hr) [kg/s]

Required: True

tower_mode¶

float: Cooling tower type (natural or forced draft) [-]

Required: True

tower_pipe_material¶

float: Tower pipe material (1=plastic, 2=new cast iron, 3=riveted steel) [-]

Required: True

AdjustmentFactors Group¶

class PySAM.Tcsdish.Tcsdish.AdjustmentFactors¶

assign() → None¶: Assign attributes from dictionary

export() → Dict¶: Export attributes into dictionary

constant¶: type: float

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.Tcsdish.Tcsdish.Outputs¶

assign() → None¶

Assign attributes from dictionary

Outputs_vals = { var: val, ...}

export() → dict¶: Export attributes into dictionary

Collector_Losses¶: sequence: Collector loss total [kWt]

P_SE_losses¶: sequence: Engine power loss [kWt]

P_out_SE¶: sequence: Engine power output (gross) [kWe]

P_out_rec¶: sequence: Receiver thermal power output [kWt]

P_parasitic¶: sequence: Parasitic power [We]

Phi_shade¶: sequence: Collector shading efficiency

Power_in_collector¶: sequence: Collector thermal power incident [kWt]

Power_in_rec¶: sequence: Receiver thermal power input [kWt]

Power_out_col¶: sequence: Collector thermal power produced [kWt]

Q_rec_losses¶: sequence: Receiver thermal power loss [kWt]

T_compression¶: sequence: Engine compression temperature [K]

T_heater_head_operate¶: sequence: Receiver temperature - head operating [K]

T_tower_in¶: sequence: Cooling fluid temperature - cooler out/tower in [C]

T_tower_out¶: sequence: Cooling fluid temperature - cooler in/tower out [C]

annual_Collector_Losses¶: float: Total collector losses (Incident - P_out) [MWh]

annual_P_out_SE¶: float: Stirling engine gross output [MWh]

annual_P_out_rec¶: float: Receiver output power [MWh]

annual_P_parasitic¶: float: Total parasitic power load [MWh]

annual_Power_in_collector¶: float: Power incident on the collector [MWh]

annual_Power_in_rec¶: float: Power entering the receiver from the collector [MWh]

annual_Power_out_col¶: float: Total power from the collector dish [MWh]

annual_Q_rec_losses¶: float: Receiver thermal losses [MWh]

annual_energy¶: float: Annual Energy [kWh]

beam¶: sequence: Resource Beam normal irradiance [W/m2]

capacity_factor¶: float: Capacity factor [%]

conversion_factor¶: float: Gross to Net Conversion Factor [%]

engine_pressure¶: sequence: Engine pressure [Pa]

eta_SE¶: sequence: Engine efficiency

eta_collector¶: sequence: Collector efficiency

eta_net¶: sequence: System total: Net efficiency

eta_rec¶: sequence: Receiver efficiency

gen¶: sequence: System power generated [kW]

hour¶: sequence: Resource Hour of Day

hourly_Collector_Losses¶: sequence: System total: Collector loss total [MWt]

hourly_P_out_SE¶: sequence: System total: Engine power output (gross) [MWe]

hourly_P_out_rec¶: sequence: System total: Receiver thermal power output [MWt]

hourly_P_parasitic¶: sequence: System total: Parasitic power [MWe]

hourly_Power_in_collector¶: sequence: System total: Collector thermal power incident [MWt]

hourly_Power_in_rec¶: sequence: System total: Receiver thermal power input [MWt]

hourly_Power_out_col¶: sequence: System total: Collector thermal power produced [MWt]

hourly_Q_rec_losses¶: sequence: System total: Receiver thermal loss [MWt]

kwh_per_kw¶: float: First year kWh/kW [kWh/kW]

month¶: sequence: Resource Month

monthly_Collector_Losses¶: sequence: Total collector losses (Incident - P_out) [MWh]

monthly_P_out_SE¶: sequence: Stirling engine gross output [MWh]

monthly_P_out_rec¶: sequence: Receiver output power [MWh]

monthly_P_parasitic¶: sequence: Total parasitic power load [MWh]

monthly_Power_in_collector¶: sequence: Power incident on the collector [MWh]

monthly_Power_in_rec¶: sequence: Power entering the receiver from the collector [MWh]

monthly_Power_out_col¶: sequence: Total power from the collector dish [MWh]

monthly_Q_rec_losses¶: sequence: Receiver thermal losses [MWh]

monthly_energy¶: sequence: Monthly Energy [kWh]

net_power¶: sequence: Engine power output (net) [kWe]

pres¶: sequence: Resource Pressure [mbar]

solazi¶: sequence: Resource Solar Azimuth [deg]

solzen¶: sequence: Resource Solar Zenith [deg]

tdry¶: sequence: Resource Dry bulb temperature [C]

twet¶: sequence: Resource Wet bulb temperature [C]

wspd¶: sequence: Resource Wind Speed [m/s]

Table of Contents

This Page

Tcsdish¶

Creating an Instance¶

Functions¶

Weather Group¶

Dish Group¶

Type295 Group¶

Type296 Group¶

Type297 Group¶

Type298 Group¶

AdjustmentFactors Group¶

Outputs Group¶