TcstroughPhysical¶
Wrapper for SAM Simulation Core model: cmod_tcstrough_physical.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.
TcstroughPhysical model description
TcstroughPhysical
-
PySAM.TcstroughPhysical.
default
(config) → TcstroughPhysical¶ Use default attributes None
-
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
-
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.
-
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
-