TcstroughPhysical¶

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

TcstroughPhysical model description

TcstroughPhysical

PySAM.TcstroughPhysical.default(config) → TcstroughPhysical¶: Use financial config-specific default attributes

PySAM.TcstroughPhysical.from_existing(data, optional config) → TcstroughPhysical¶: Share underlying data with an existing PySAM class. If config provided, default attributes are loaded otherwise.

PySAM.TcstroughPhysical.new() → TcstroughPhysical¶

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

Warning

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

Functions¶

class PySAM.TcstroughPhysical.TcstroughPhysical¶

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

value(name, optional value) → Union[None, float, dict, sequence, str]¶: Get or set by name a value in any of the variable groups.

Weather Group¶

class PySAM.TcstroughPhysical.TcstroughPhysical.Weather¶

assign() → None¶

Assign attributes from dictionary

Weather_vals = { var: val, ...}

export() → dict¶: Export attributes into dictionary

azimuth¶

Azimuth angle of surface/axis [none]

Required: True

Type:	float

file_name¶

Local weather file with path [none]

Constraints: LOCAL_FILE

Required: True

Type:	str

tilt¶

Tilt angle of surface/axis [none]

Required: True

Type:	float

track_mode¶

Tracking mode [none]

Required: True

Type:	float

Trough Group¶

class PySAM.TcstroughPhysical.TcstroughPhysical.Trough¶

assign() → None¶

Assign attributes from dictionary

Trough_vals = { var: val, ...}

export() → dict¶: Export attributes into dictionary

system_capacity¶

Nameplate capacity [kW]

Required: True

Type:	float

SolarField Group¶

class PySAM.TcstroughPhysical.TcstroughPhysical.SolarField¶

assign() → None¶

Assign attributes from dictionary

SolarField_vals = { var: val, ...}

export() → dict¶: Export attributes into dictionary

A_aperture¶

Reflective aperture area of the collector [m2]

Required: True

Type:	sequence

AbsorberMaterial¶

Absorber material type [none]

Required: True

Type:	sequence[sequence]

AnnulusGas¶

Annulus gas type (1=air, 26=Ar, 27=H2) [none]

Required: True

Type:	sequence[sequence]

Ave_Focal_Length¶

Average focal length of the collector [m]

Required: True

Type:	sequence

ColperSCA¶

Number of individual collector sections in an SCA [none]

Required: True

Type:	sequence

D_2¶

Inner absorber tube diameter [m]

Required: True

Type:	sequence[sequence]

D_3¶

Outer absorber tube diameter [m]

Required: True

Type:	sequence[sequence]

D_4¶

Inner glass envelope diameter [m]

Required: True

Type:	sequence[sequence]

D_5¶

Outer glass envelope diameter [m]

Required: True

Type:	sequence[sequence]

D_cpnt¶

Interconnect component diameters, row=intc, col=cpnt [none]

Required: True

Type:	sequence[sequence]

D_p¶

Diameter of the absorber flow plug (optional) [m]

Required: True

Type:	sequence[sequence]

Design_loss¶

Receiver heat loss at design [W/m]

Required: True

Type:	sequence[sequence]

Dirt_HCE¶

Loss due to dirt on the receiver envelope [none]

Required: True

Type:	sequence[sequence]

Dirt_mirror¶

User-defined dirt on mirror derate [none]

Required: True

Type:	sequence

Distance_SCA¶

Piping distance between SCA’s in the field [m]

Required: True

Type:	sequence

EPSILON_4¶

Inner glass envelope emissivities (Pyrex) [none]

Required: True

Type:	sequence[sequence]

EPSILON_5¶

Outer glass envelope emissivities (Pyrex) [none]

Required: True

Type:	sequence[sequence]

Error¶

User-defined general optical error derate [none]

Required: True

Type:	sequence

FieldConfig¶

Number of subfield headers [none]

Required: True

Type:	float

Flow_type¶

Flow type through the absorber [none]

Required: True

Type:	sequence[sequence]

Fluid¶

Field HTF fluid ID number [none]

Required: True

Type:	float

GeomEffects¶

User-defined geometry effects derate [none]

Required: True

Type:	sequence

GlazingIntactIn¶

Glazing intact (broken glass) flag {1=true, else=false} [none]

Required: True

Type:	sequence[sequence]

HCE_FieldFrac¶

Fraction of the field occupied by this HCE type [none]

Required: True

Type:	sequence[sequence]

HDR_rough¶

Header pipe roughness [m]

Required: True

Type:	float

IAM_matrix¶

IAM coefficients, matrix for 4 collectors [none]

Required: True

Type:	sequence[sequence]

I_bn_des¶

Solar irradiation at design [W/m2]

Required: True

Type:	float

K_cpnt¶

Interconnect component minor loss coefficients, row=intc, col=cpnt [none]

Required: True

Type:	sequence[sequence]

L_SCA¶

Length of the SCA [m]

Required: True

Type:	sequence

L_aperture¶

Length of a single mirror/HCE unit [m]

Required: True

Type:	sequence

L_cpnt¶

Interconnect component lengths, row=intc, col=cpnt [none]

Required: True

Type:	sequence[sequence]

L_rnr_pb¶

Length of runner pipe in power block [m]

Required: True

Type:	float

L_rnr_per_xpan¶

Threshold length of straight runner pipe without an expansion loop [m]

Required: True

Type:	float

L_xpan_hdr¶

Compined perpendicular lengths of each header expansion loop [m]

Required: True

Type:	float

L_xpan_rnr¶

Compined perpendicular lengths of each runner expansion loop [m]

Required: True

Type:	float

Min_rnr_xpans¶

Minimum number of expansion loops per single-diameter runner section [none]

Required: True

Type:	float

N_hdr_per_xpan¶

Number of collector loops per expansion loop [none]

Required: True

Type:	float

N_max_hdr_diams¶

Maximum number of diameters in each of the hot and cold headers [none]

Required: True

Type:	float

P_a¶

Annulus gas pressure [torr]

Required: True

Type:	sequence[sequence]

P_ref¶

Rated plant capacity [MWe]

Required: True

Type:	float

Pipe_hl_coef¶

Loss coefficient from the header, runner pipe, and non-HCE piping [W/m2-K]

Required: True

Type:	float

Rho_mirror_clean¶

User-defined clean mirror reflectivity [none]

Required: True

Type:	sequence

Rough¶

Relative roughness of the internal HCE surface [-]

Required: True

Type:	sequence[sequence]

Row_Distance¶

Spacing between rows (centerline to centerline) [m]

Required: True

Type:	float

SCADefocusArray¶

Collector defocus order [none]

Required: True

Type:	sequence

SCAInfoArray¶

Receiver (,1) and collector (,2) type for each assembly in loop [none]

Required: True

Type:	sequence[sequence]

SCA_drives_elec¶

Tracking power, in Watts per SCA drive [W/SCA]

Required: True

Type:	float

Shadowing¶

Receiver bellows shadowing loss factor [none]

Required: True

Type:	sequence[sequence]

T_fp¶

Freeze protection temperature (heat trace activation temperature) [C]

Required: True

Type:	float

T_loop_in_des¶

Design loop inlet temperature [C]

Required: True

Type:	float

T_loop_out¶

Target loop outlet temperature [C]

Required: True

Type:	float

T_startup¶

Required temperature of the system before the power block can be switched on [C]

Required: True

Type:	float

Tau_envelope¶

Envelope transmittance [none]

Required: True

Type:	sequence[sequence]

TrackingError¶

User-defined tracking error derate [none]

Required: True

Type:	sequence

Type_cpnt¶

Interconnect component type, row=intc, col=cpnt [none]

Required: True

Type:	sequence[sequence]

V_hdr_cold_max¶

Maximum HTF velocity in the cold headers at design [m/s]

Required: True

Type:	float

V_hdr_cold_min¶

Minimum HTF velocity in the cold headers at design [m/s]

Required: True

Type:	float

V_hdr_hot_max¶

Maximum HTF velocity in the hot headers at design [m/s]

Required: True

Type:	float

V_hdr_hot_min¶

Minimum HTF velocity in the hot headers at design [m/s]

Required: True

Type:	float

W_aperture¶

The collector aperture width (Total structural area used for shadowing) [m]

Required: True

Type:	sequence

accept_init¶

In acceptance testing mode - require steady-state startup [none]

Required: True

Type:	float

accept_loc¶

In acceptance testing mode - temperature sensor location [1/2]

Info: hx/loop

Required: True

Type:	float

accept_mode¶

Acceptance testing mode? [0/1]

Info: no/yes

Required: True

Type:	float

alpha_abs¶

Absorber absorptance [none]

Required: True

Type:	sequence[sequence]

alpha_env¶

Envelope absorptance [none]

Required: True

Type:	sequence[sequence]

calc_design_pipe_vals¶

Calculate temps and pressures at design conditions for runners and headers [none]

Required: True

Type:	float

custom_sf_pipe_sizes¶

Use custom solar field pipe diams, wallthks, and lengths [none]

Required: True

Type:	float

epsilon_3_11¶

Absorber emittance for receiver type 1 variation 1 [none]

Required: True

Type:	sequence[sequence]

epsilon_3_12¶

Absorber emittance for receiver type 1 variation 2 [none]

Required: True

Type:	sequence[sequence]

epsilon_3_13¶

Absorber emittance for receiver type 1 variation 3 [none]

Required: True

Type:	sequence[sequence]

epsilon_3_14¶

Absorber emittance for receiver type 1 variation 4 [none]

Required: True

Type:	sequence[sequence]

epsilon_3_21¶

Absorber emittance for receiver type 2 variation 1 [none]

Required: True

Type:	sequence[sequence]

epsilon_3_22¶

Absorber emittance for receiver type 2 variation 2 [none]

Required: True

Type:	sequence[sequence]

epsilon_3_23¶

Absorber emittance for receiver type 2 variation 3 [none]

Required: True

Type:	sequence[sequence]

epsilon_3_24¶

Absorber emittance for receiver type 2 variation 4 [none]

Required: True

Type:	sequence[sequence]

epsilon_3_31¶

Absorber emittance for receiver type 3 variation 1 [none]

Required: True

Type:	sequence[sequence]

epsilon_3_32¶

Absorber emittance for receiver type 3 variation 2 [none]

Required: True

Type:	sequence[sequence]

epsilon_3_33¶

Absorber emittance for receiver type 3 variation 3 [none]

Required: True

Type:	sequence[sequence]

epsilon_3_34¶

Absorber emittance for receiver type 3 variation 4 [none]

Required: True

Type:	sequence[sequence]

epsilon_3_41¶

Absorber emittance for receiver type 4 variation 1 [none]

Required: True

Type:	sequence[sequence]

epsilon_3_42¶

Absorber emittance for receiver type 4 variation 2 [none]

Required: True

Type:	sequence[sequence]

epsilon_3_43¶

Absorber emittance for receiver type 4 variation 3 [none]

Required: True

Type:	sequence[sequence]

epsilon_3_44¶

Absorber emittance for receiver type 4 variation 4 [none]

Required: True

Type:	sequence[sequence]

eta_pump¶

HTF pump efficiency [none]

Required: True

Type:	float

fthrctrl¶

Defocusing strategy [none]

Required: True

Type:	float

fthrok¶

Flag to allow partial defocusing of the collectors

Constraints: INTEGER

Required: True

Type:	float

m_dot_htfmax¶

Maximum loop HTF flow rate [kg/s]

Required: True

Type:	float

m_dot_htfmin¶

Minimum loop HTF flow rate [kg/s]

Required: True

Type:	float

mc_bal_cold¶

Heat capacity of the balance of plant on the cold side [kWht/K-MWt]

Required: True

Type:	float

mc_bal_hot¶

Heat capacity of the balance of plant on the hot side [kWht/K-MWt]

Info: none

Required: True

Type:	float

mc_bal_sca¶

Non-HTF heat capacity associated with each SCA - per meter basis [Wht/K-m]

Required: True

Type:	float

nColt¶

Number of collector types [none]

Options: constant=4

Required: True

Type:	float

nHCEVar¶

Number of HCE variants per type [none]

Required: True

Type:	float

nHCEt¶

Number of HCE types [none]

Required: True

Type:	float

nLoops¶

Number of loops in the field [none]

Required: True

Type:	float

nSCA¶

Number of SCAs in a loop [none]

Required: True

Type:	float

northsouth_field_sep¶

North/south separation between subfields. 0 = SCAs are touching [m]

Required: True

Type:	float

offset_xpan_hdr¶

Location of first header expansion loop. 1 = after first collector loop [none]

Required: True

Type:	float

sf_hdr_diams¶

Custom header diameters [m]

Required: True

Type:	sequence

sf_hdr_lengths¶

Custom header lengths [m]

Required: True

Type:	sequence

sf_hdr_wallthicks¶

Custom header wall thicknesses [m]

Required: True

Type:	sequence

sf_rnr_diams¶

Custom runner diameters [m]

Required: True

Type:	sequence

sf_rnr_lengths¶

Custom runner lengths [m]

Required: True

Type:	sequence

sf_rnr_wallthicks¶

Custom runner wall thicknesses [m]

Required: True

Type:	sequence

solar_mult¶

Solar multiple [none]

Required: True

Type:	float

theta_dep¶

Deploy angle [deg]

Required: True

Type:	float

theta_stow¶

Stow angle [deg]

Required: True

Type:	float

washing_frequency¶

Mirror washing frequency [none]

Required: True

Type:	float

water_usage_per_wash¶

Water usage per wash [L/m2_aper]

Required: True

Type:	float

Controller Group¶

class PySAM.TcstroughPhysical.TcstroughPhysical.Controller¶

assign() → None¶

Assign attributes from dictionary

Controller_vals = { var: val, ...}

export() → dict¶: Export attributes into dictionary

DP_SGS¶

Pressure drop within the steam generator [bar]

Required: True

Type:	float

HDR_rough¶

Header pipe roughness - used as general pipe roughness [m]

Required: True

Type:	float

T_set_aux¶

Aux heater outlet temp set point [C]

Required: True

Type:	float

T_tank_cold_ini¶

Initial cold tank fluid tmeperature [C]

Required: True

Type:	float

T_tank_hot_inlet_min¶

Minimum hot tank htf inlet temperature [C]

Required: True

Type:	float

V_tank_hot_ini¶

Initial hot tank fluid volume [m3]

Required: True

Type:	float

V_tes_des¶

Design-point velocity to size the TES pipe diameters [m/s]

Required: True

Type:	float

W_pb_design¶

Rated plant capacity [MWe]

Required: True

Type:	float

aux_array¶

Coefficients for auxiliary heater parasitics calcs [-]

Required: True

Type:	sequence

bop_array¶

Coefficients for balance of plant parasitics calcs [-]

Required: True

Type:	sequence

cold_tank_Thtr¶

Minimum allowable cold tank HTF temp [C]

Required: True

Type:	float

custom_sgs_pipe_sizes¶

Use custom SGS pipe diams, wallthks, and lengths [-]

Required: True

Type:	float

custom_tes_p_loss¶

TES pipe losses are based on custom lengths and coeffs [-]

Required: True

Type:	float

cycle_cutoff_frac¶

Minimum turbine operation fraction before shutdown [-]

Required: True

Type:	float

cycle_max_frac¶

Maximum turbine over design operation fraction [-]

Required: True

Type:	float

dt_cold¶

Cold side HX approach temp [C]

Required: True

Type:	float

dt_hot¶

Hot side HX approach temp [C]

Required: True

Type:	float

eta_pump¶

HTF pump efficiency [none]

Required: True

Type:	float

f_tc_cold¶

0=entire tank is hot, 1=entire tank is cold [-]

Required: True

Type:	float

ffrac¶

Fossil dispatch logic [-]

Required: True

Type:	sequence

field_fl_props¶

User defined field fluid property data [-]

Required: True

Type:	sequence[sequence]

fossil_mode¶

Fossil backup mode 1=Normal 2=Topping [-]

Constraints: INTEGER

Required: True

Type:	float

h_tank¶

Total height of tank (height of HTF when tank is full [m]

Required: True

Type:	float

h_tank_min¶

Minimum allowable HTF height in storage tank [m]

Required: True

Type:	float

has_hot_tank_bypass¶

Bypass valve connects field outlet to cold tank [-]

Required: True

Type:	float

hot_tank_Thtr¶

Minimum allowable hot tank HTF temp [C]

Required: True

Type:	float

hx_config¶

HX configuration [-]

Required: True

Type:	float

is_hx¶

Heat exchanger (HX) exists (1=yes, 0=no) [-]

Required: True

Type:	float

k_tes_loss_coeffs¶

Minor loss coeffs for the coll, gen, and bypass loops [-]

Required: True

Type:	sequence

nodes¶

Nodes modeled in the flow path [-]

Required: True

Type:	float

pb_fixed_par¶

Fraction of rated gross power constantly consumed [-]

Required: True

Type:	float

pb_pump_coef¶

Pumping power to move 1kg of HTF through PB loop [kW/(kg/s)]

Required: True

Type:	float

q_max_aux¶

Max heat rate of auxiliary heater [MWt]

Required: True

Type:	float

q_pb_design¶

Design heat input to power block [MWt]

Required: True

Type:	float

sf_type¶

Solar field type, 1 = trough, 2 = tower [-]

Required: True

Type:	float

sgs_diams¶

Custom SGS diameters [m]

Required: True

Type:	sequence

sgs_lengths¶

Custom SGS lengths [m]

Required: True

Type:	sequence

sgs_wallthicks¶

Custom SGS wall thicknesses [m]

Required: True

Type:	sequence

store_fl_props¶

User defined storage fluid property data [-]

Required: True

Type:	sequence[sequence]

store_fluid¶

Material number for storage fluid [-]

Required: True

Type:	float

t_ch_out_max¶

Max allowable cold side outlet temp during charge [C]

Required: True

Type:	float

t_dis_out_min¶

Min allowable hot side outlet temp during discharge [C]

Required: True

Type:	float

t_standby_reset¶

Maximum allowable time for PB standby operation [hr]

Required: True

Type:	float

tank_max_heat¶

Rated heater capacity for tank heating [MW]

Required: True

Type:	float

tank_pairs¶

Number of equivalent tank pairs [-]

Constraints: INTEGER

Required: True

Type:	float

tanks_in_parallel¶

Tanks are in parallel, not in series, with solar field [-]

Required: True

Type:	float

tc_fill¶

Thermocline fill material [-]

Required: True

Type:	float

tc_void¶

Thermocline void fraction [-]

Required: True

Type:	float

tes_pump_coef¶

Pumping power to move 1kg of HTF through tes loop [kW/(kg/s)]

Required: True

Type:	float

tes_type¶

1=2-tank, 2=thermocline [-]

Required: True

Type:	float

tshours¶

Equivalent full-load thermal storage hours [hr]

Required: True

Type:	float

tslogic_a¶

Dispatch logic without solar [-]

Required: True

Type:	sequence

tslogic_b¶

Dispatch logic with solar [-]

Required: True

Type:	sequence

tslogic_c¶

Dispatch logic for turbine load fraction [-]

Required: True

Type:	sequence

u_tank¶

Loss coefficient from the tank [W/m2-K]

Required: True

Type:	float

vol_tank¶

Total tank volume, including unusable HTF at bottom [m3]

Required: True

Type:	float

TouTranslator Group¶

class PySAM.TcstroughPhysical.TcstroughPhysical.TouTranslator¶

assign() → None¶

Assign attributes from dictionary

TouTranslator_vals = { var: val, ...}

export() → dict¶: Export attributes into dictionary

weekday_schedule¶

Dispatch 12mx24h schedule for week days

Required: True

Type:	sequence[sequence]

weekend_schedule¶

Dispatch 12mx24h schedule for weekends

Required: True

Type:	sequence[sequence]

Powerblock Group¶

class PySAM.TcstroughPhysical.TcstroughPhysical.Powerblock¶

assign() → None¶

Assign attributes from dictionary

Powerblock_vals = { var: val, ...}

export() → dict¶: Export attributes into dictionary

CT¶

Flag for using dry cooling or wet cooling system [none]

Required: True if pc_config=0

Type:	float

F_wc¶

Fraction indicating wet cooling use for hybrid system [none]

Options: constant=[0,0,0,0,0,0,0,0,0]

Required: True if pc_config=0

Type:	sequence

P_boil¶

Boiler operating pressure [bar]

Required: True if pc_config=0

Type:	float

P_cond_min¶

Minimum condenser pressure [inHg]

Required: True if pc_config=0

Type:	float

P_cond_ratio¶

Condenser pressure ratio [none]

Required: True if pc_config=0

Type:	float

T_ITD_des¶

ITD at design for dry system [C]

Required: True if pc_config=0

Type:	float

T_amb_des¶

Reference ambient temperature at design point [C]

Required: True if pc_config=0

Type:	float

T_approach¶

Cooling tower approach temperature [C]

Required: True if pc_config=0

Type:	float

dT_cw_ref¶

Reference condenser cooling water inlet/outlet T diff [C]

Required: True if pc_config=0

Type:	float

eta_ref¶

Reference conversion efficiency at design condition [none]

Required: True

Type:	float

n_pl_inc¶

Number of part-load increments for the heat rejection system [none]

Required: True if pc_config=0

Type:	float

pb_bd_frac¶

Power block blowdown steam fraction [none]

Required: True if pc_config=0

Type:	float

pc_config¶

Steam Rankine (224), 1: user defined [-]

Constraints: INTEGER

Required: If not provided, assumed to be 0

Type:	float
Type:	0

q_sby_frac¶

Fraction of thermal power required for standby mode [none]

Required: True

Type:	float

startup_frac¶

Fraction of design thermal power needed for startup [none]

Required: True

Type:	float

startup_time¶

Time needed for power block startup [hr]

Required: True

Type:	float

tech_type¶

Turbine inlet pressure control flag (sliding=user, fixed=trough) [1/2/3]

Info: tower/trough/user

Required: True if pc_config=0

Type:	float

UserDefinedPC Group¶

class PySAM.TcstroughPhysical.TcstroughPhysical.UserDefinedPC¶

assign() → None¶

Assign attributes from dictionary

UserDefinedPC_vals = { var: val, ...}

export() → dict¶: Export attributes into dictionary

ud_T_amb_des¶

Ambient temperature at user-defined power cycle design point [C]

Required: True if pc_config=1

Type:	float

ud_T_amb_high¶

High level ambient temperature for HTF mass flow rate parametric [C]

Required: True if pc_config=1

Type:	float

ud_T_amb_ind_od¶

Off design table of user-defined power cycle performance formed from parametric on T_amb [C]

Required: If not provided, assumed to be [[0]]

Type:	sequence[sequence]

ud_T_amb_low¶

Low level ambient temperature for HTF mass flow rate parametric [C]

Required: True if pc_config=1

Type:	float

ud_T_htf_high¶

High level HTF inlet temperature for T_amb parametric [C]

Required: True if pc_config=1

Type:	float

ud_T_htf_ind_od¶

Off design table of user-defined power cycle performance formed from parametric on T_htf_hot [C]

Required: If not provided, assumed to be [[0]]

Type:	sequence[sequence]

ud_T_htf_low¶

Low level HTF inlet temperature for T_amb parametric [C]

Required: True if pc_config=1

Type:	float

ud_f_W_dot_cool_des¶

Percent of user-defined power cycle design gross output consumed by cooling [%]

Required: True if pc_config=1

Type:	float

ud_ind_od¶

Off design user-defined power cycle performance as function of T_htf, m_dot_htf [ND], and T_amb

Required: If not provided, assumed to be [[0]]

Type:	sequence[sequence]

ud_m_dot_htf_high¶

High level normalized HTF mass flow rate for T_HTF parametric [-]

Required: True if pc_config=1

Type:	float

ud_m_dot_htf_ind_od¶

Off design table of user-defined power cycle performance formed from parametric on m_dot_htf [ND]

Required: If not provided, assumed to be [[0]]

Type:	sequence[sequence]

ud_m_dot_htf_low¶

Low level normalized HTF mass flow rate for T_HTF parametric [-]

Required: True if pc_config=1

Type:	float

ud_m_dot_water_cool_des¶

Mass flow rate of water required at user-defined power cycle design point [kg/s]

Required: True if pc_config=1

Type:	float

Enet Group¶

class PySAM.TcstroughPhysical.TcstroughPhysical.Enet¶

assign() → None¶

Assign attributes from dictionary

Enet_vals = { var: val, ...}

export() → dict¶: Export attributes into dictionary

eta_lhv¶

Fossil fuel lower heating value - Thermal power generated per unit fuel [MW/MMBTU]

Required: True

Type:	float

eta_tes_htr¶

Thermal storage tank heater efficiency (fp_mode=1 only) [none]

Required: True

Type:	float

AdjustmentFactors Group¶

class PySAM.TcstroughPhysical.TcstroughPhysical.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.TcstroughPhysical.TcstroughPhysical.Outputs¶

assign() → None¶

Assign attributes from dictionary

Outputs_vals = { var: val, ...}

export() → dict¶: Export attributes into dictionary

CosTh_ave¶

Field collector cosine efficiency

Type:	sequence

DP_tot¶

Field HTF pressure drop total [bar]

Type:	sequence

E_bal_startup¶

Field HTF energy inertial (consumed) [MWht]

Type:	sequence

EndLoss_ave¶

Field collector optical end loss

Type:	sequence

EqOpteff¶

Field collector optical efficiency

Type:	sequence

Fuel_usage¶

Fossil fuel usage (all subsystems) [MMBTU]

Type:	sequence

IAM_ave¶

Field collector incidence angle modifier

Type:	sequence

Pipe_hl¶

Field thermal power header pipe losses [MWt]

Type:	sequence

Q_aux_backup¶

Fossil thermal power produced [MWt]

Type:	sequence

Q_par_sf_fp¶

Parasitic thermal field freeze protection [MWt]

Type:	sequence

Q_par_tes_fp¶

Parasitic thermal TES freeze protection [MWt]

Type:	sequence

RowShadow_ave¶

Field collector row shadowing loss

Type:	sequence

SCA_par_tot¶

Parasitic power field collector drives [MWe]

Type:	sequence

SCAs_def¶

Field collector fraction of focused SCA’s

Type:	sequence

T_field_in¶

Field HTF temperature collector inlet [C]

Type:	sequence

T_pb_in¶

Cycle HTF temperature in (hot) [C]

Type:	sequence

T_pb_out¶

Cycle HTF temperature out (cold) [C]

Type:	sequence

T_sys_c¶

Field HTF temperature cold header inlet [C]

Type:	sequence

T_sys_h¶

Field HTF temperature hot header outlet [C]

Type:	sequence

T_tank_cold_fin¶

TES HTF temperature in cold tank [C]

Type:	sequence

T_tank_cold_in¶

TES HTF temperature cold tank inlet [C]

Type:	sequence

T_tank_hot_fin¶

TES HTF temperature in hot tank [C]

Type:	sequence

T_tank_hot_in¶

TES HTF temperature hot tank inlet [C]

Type:	sequence

Theta_ave¶

Field collector solar incidence angle [deg]

Type:	sequence

Ts_cold¶

TES HTF temperature HX field side cold [C]

Type:	sequence

Ts_hot¶

TES HTF temperature HX field side hot [C]

Type:	sequence

W_cool_par¶

Parasitic power condenser operation [MWe]

Type:	sequence

W_cycle_gross¶

Cycle electrical power output (gross) [MWe]

Type:	sequence

W_dot_pump¶

Parasitic power solar field HTF pump [MWe]

Type:	sequence

W_net¶

Cycle electrical power output (net) [MWe]

Type:	sequence

annual_W_cycle_gross¶

Electrical source - Power cycle gross output [MWhe]

Type:	float

annual_energy¶

Annual Energy [kWh]

Type:	float

annual_fuel_usage¶

Annual fuel usage [kWht]

Type:	float

annual_q_abs_tot¶

Total absorbed energy [MWht]

Type:	float

annual_q_aux¶

Total fossil fuel usage by all plant subsystems [MMBTU]

Type:	float

annual_q_avail¶

Thermal power produced by the field [MWht]

Type:	float

annual_q_dump¶

Dumped thermal energy [MWht]

Type:	float

annual_q_inc_sf_tot¶

Total power incident on the field [MWht]

Type:	float

annual_q_pb¶

Thermal energy to the power block [MWht]

Type:	float

annual_q_to_tes¶

Thermal energy into storage [MWht]

Type:	float

annual_total_water_use¶

cycle + mirror washing [m3]

Type:	float
Type:	Total Annual Water Usage

aux_par¶

Parasitic power auxiliary heater operation [MWe]

Type:	sequence

beam¶

Resource Beam normal irradiance [W/m2]

Type:	sequence

bop_par¶

Parasitic power generation-dependent load [MWe]

Type:	sequence

capacity_factor¶

Capacity factor [%]

Type:	float

conversion_factor¶

Gross to Net Conversion Factor [%]

Type:	float

dni_costh¶

Field collector DNI-cosine product [W/m2]

Type:	sequence

eta¶

Cycle efficiency (gross)

Type:	sequence

fixed_par¶

Parasitic power fixed load [MWe]

Type:	sequence

gen¶

System power generated [kW]

Type:	sequence

hour¶

Resource Hour of Day

Type:	sequence

htf_pump_power¶

Parasitic power TES and Cycle HTF pump [MWe]

Type:	sequence

kwh_per_kw¶

First year kWh/kW [kWh/kW]

Type:	float

m_dot_aux¶

Fossil HTF mass flow rate [kg/hr]

Type:	sequence

m_dot_avail¶

Field HTF mass flow rate total [kg/hr]

Type:	sequence

m_dot_charge_field¶

TES HTF mass flow rate - field side of HX [kg/hr]

Type:	sequence

m_dot_discharge_tank¶

TES HTF mass flow rate - storage side of HX [kg/hr]

Type:	sequence

m_dot_htf2¶

Field HTF mass flow rate loop [kg/s]

Type:	sequence

m_dot_makeup¶

Cycle cooling water mass flow rate - makeup [kg/hr]

Type:	sequence

m_dot_pb¶

Cycle HTF mass flow rate [kg/hr]

Type:	sequence

mass_tank_cold¶

TES HTF mass in cold tank [kg]

Type:	sequence

mass_tank_hot¶

TES HTF mass in hot tank [kg]

Type:	sequence

month¶

Resource Month

Type:	sequence

monthly_Fuel_usage¶

Total fossil fuel usage by all plant subsystems [MMBTU]

Type:	sequence

monthly_W_cycle_gross¶

Electrical source - Power cycle gross output [MWhe]

Type:	sequence

monthly_energy¶

Monthly Energy [kWh]

Type:	sequence

monthly_m_dot_makeup¶

Cooling water makeup flow rate [kg/hr]

Type:	sequence

monthly_q_abs_tot¶

Total absorbed energy [MWht]

Type:	sequence

monthly_q_avail¶

Thermal power produced by the field [MWht]

Type:	sequence

monthly_q_dump¶

Dumped thermal energy [MWht]

Type:	sequence

monthly_q_inc_sf_tot¶

Total power incident on the field [MWht]

Type:	sequence

monthly_q_pb¶

Thermal energy to the power block [MWht]

Type:	sequence

monthly_q_to_tes¶

Thermal energy into storage [MWht]

Type:	sequence

pipe_header_P_dsn¶

Field piping header pressure at design [bar]

Type:	sequence

pipe_header_T_dsn¶

Field piping header temperature at design [C]

Type:	sequence

pipe_header_diams¶

Field piping header diameters [m]

Type:	sequence

pipe_header_expansions¶

Number of field piping header expansions [-]

Type:	sequence

pipe_header_lengths¶

Field piping header lengths [m]

Type:	sequence

pipe_header_mdot_dsn¶

Field piping header mass flow at design [kg/s]

Type:	sequence

pipe_header_vel_dsn¶

Field piping header velocity at design [m/s]

Type:	sequence

pipe_header_wallthk¶

Field piping header wall thicknesses [m]

Type:	sequence

pipe_loop_P_dsn¶

Field piping loop pressure at design [bar]

Type:	sequence

pipe_loop_T_dsn¶

Field piping loop temperature at design [C]

Type:	sequence

pipe_runner_P_dsn¶

Field piping runner pressure at design [bar]

Type:	sequence

pipe_runner_T_dsn¶

Field piping runner temperature at design [C]

Type:	sequence

pipe_runner_diams¶

Field piping runner diameters [m]

Type:	sequence

pipe_runner_expansions¶

Number of field piping runner expansions [-]

Type:	sequence

pipe_runner_lengths¶

Field piping runner lengths [m]

Type:	sequence

pipe_runner_mdot_dsn¶

Field piping runner mass flow at design [kg/s]

Type:	sequence

pipe_runner_vel_dsn¶

Field piping runner velocity at design [m/s]

Type:	sequence

pipe_runner_wallthk¶

Field piping runner wall thicknesses [m]

Type:	sequence

pipe_sgs_P_dsn¶

Pressure in SGS pipes at design conditions [bar]

Type:	sequence

pipe_sgs_T_dsn¶

Temperature in SGS pipes at design conditions [C]

Type:	sequence

pipe_sgs_diams¶

Pipe diameters in SGS [m]

Type:	sequence

pipe_sgs_mdot_dsn¶

Mass flow SGS pipes at design conditions [kg/s]

Type:	sequence

pipe_sgs_vel_dsn¶

Velocity in SGS pipes at design conditions [m/s]

Type:	sequence

pipe_sgs_wallthk¶

Pipe wall thickness in SGS [m]

Type:	sequence

pres¶

Resource Pressure [mbar]

Type:	sequence

q_abs_tot¶

Field thermal power absorbed [MWt]

Type:	sequence

q_avail¶

Field thermal power produced [MWt]

Type:	sequence

q_dump¶

Field thermal power dumped [MWt]

Type:	sequence

q_inc_sf_tot¶

Field thermal power incident [MWt]

Type:	sequence

q_loss_spec_tot¶

Field thermal power avg. receiver loss [W/m]

Type:	sequence

q_loss_tot¶

Field thermal power receiver loss [MWt]

Type:	sequence

q_pb¶

Cycle thermal power input [MWt]

Type:	sequence

q_to_tes¶

TES thermal energy into storage [MWt]

Type:	sequence

qinc_costh¶

Field thermal power incident after cosine [MWt]

Type:	sequence

recirculating¶

Field recirculating (bypass valve open) [-]

Type:	sequence

solazi¶

Resource Solar Azimuth [deg]

Type:	sequence

solzen¶

Resource Solar Zenith [deg]

Type:	sequence

system_heat_rate¶

System heat rate [MMBtu/MWh]

Type:	float

tank_losses¶

TES thermal losses from tank(s) [MWt]

Type:	sequence

tdry¶

Resource Dry bulb temperature [C]

Type:	sequence

tou_value¶

Resource Time-of-use value

Type:	sequence

twet¶

Resource Wet bulb temperature [C]

Type:	sequence

vol_tank_cold_fin¶

TES HTF volume in cold tank [m3]

Type:	sequence

vol_tank_hot_fin¶

TES HTF volume in hot tank [m3]

Type:	sequence

vol_tank_total¶

TES HTF volume total [m3]

Type:	sequence

wspd¶

Resource Wind Speed [m/s]

Type:	sequence

Table of Contents

This Page

TcstroughPhysical¶

Creating an Instance¶

Functions¶

Weather Group¶

Trough Group¶

SolarField Group¶

Controller Group¶

TouTranslator Group¶

Powerblock Group¶

UserDefinedPC Group¶

Enet Group¶

AdjustmentFactors Group¶

Outputs Group¶