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¶
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
-