TcstroughPhysical

TcstroughPhysical

PySAM.TcstroughPhysical.default(config) TcstroughPhysical

Load defaults for the configuration config. Available configurations are:

  • None

Note

Some inputs do not have default values and may be assigned a value from the variable’s Required attribute. See variable attribute descriptions below.

PySAM.TcstroughPhysical.from_existing(data, optional config) TcstroughPhysical

Share data with an existing PySAM class. If optional config is a valid configuration name, load the module’s defaults for that configuration.

PySAM.TcstroughPhysical.new() TcstroughPhysical
PySAM.TcstroughPhysical.wrap(ssc_data_t) TcstroughPhysical

Load data from a PySSC object.

Warning

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

TcstroughPhysical is a wrapper for the SSC compute module cmod_tcstrough_physical.cpp

Interdependent Variables

The variables listed below are interdependent with other variables. If you change the value of one of these variables, you may need to change values of other variables. The SAM user interface manages these interdependent variables, but in PySAM, it is up to you change the value of all interdependent variables so they are consistent. See Interdependent Variables for examples and details.

  • None

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

get_data_ptr() Pointer

Get ssc_data_t pointer

replace(dict) None

Replace attributes from nested dictionary, except for Outputs. Unassigns all values in each Group then assigns from the input dict.

nested_dict = { 'weather': { var: val, ...}, ...}

unassign(name) None

Unassign a value in any of the variable groups.

value(name, optional value) 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(dict) None

Assign attributes from dictionary, overwriting but not removing values.

Weather_vals = { var: val, ...}

export() dict

Export attributes into dictionary.

replace(dict) None

Replace attributes from dictionary, unassigning values not present in input dict.

Weather_vals = { var: val, ...}

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(dict) None

Assign attributes from dictionary, overwriting but not removing values.

Trough_vals = { var: val, ...}

export() dict

Export attributes into dictionary.

replace(dict) None

Replace attributes from dictionary, unassigning values not present in input dict.

Trough_vals = { var: val, ...}

system_capacity

Nameplate capacity [kW]

Required: True

Type:

float

SolarField Group

class PySAM.TcstroughPhysical.TcstroughPhysical.SolarField
assign(dict) None

Assign attributes from dictionary, overwriting but not removing values.

SolarField_vals = { var: val, ...}

export() dict

Export attributes into dictionary.

replace(dict) None

Replace attributes from dictionary, unassigning values not present in input dict.

SolarField_vals = { var: val, ...}

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(dict) None

Assign attributes from dictionary, overwriting but not removing values.

Controller_vals = { var: val, ...}

export() dict

Export attributes into dictionary.

replace(dict) None

Replace attributes from dictionary, unassigning values not present in input dict.

Controller_vals = { var: val, ...}

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(dict) None

Assign attributes from dictionary, overwriting but not removing values.

TouTranslator_vals = { var: val, ...}

export() dict

Export attributes into dictionary.

replace(dict) None

Replace attributes from dictionary, unassigning values not present in input dict.

TouTranslator_vals = { var: val, ...}

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(dict) None

Assign attributes from dictionary, overwriting but not removing values.

Powerblock_vals = { var: val, ...}

export() dict

Export attributes into dictionary.

replace(dict) None

Replace attributes from dictionary, unassigning values not present in input dict.

Powerblock_vals = { var: val, ...}

CT

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

Required: Required 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: Required if pc_config=0

Type:

sequence

P_cond_min

Minimum condenser pressure [inHg]

Required: Required if pc_config=0

Type:

float

P_cond_ratio

Condenser pressure ratio [none]

Required: Required if pc_config=0

Type:

float

T_ITD_des

ITD at design for dry system [C]

Required: Required if pc_config=0

Type:

float

T_amb_des

Reference ambient temperature at design point [C]

Required: Required if pc_config=0

Type:

float

T_approach

Cooling tower approach temperature [C]

Required: Required if pc_config=0

Type:

float

dT_cw_ref

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

Required: Required 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: Required if pc_config=0

Type:

float

pb_bd_frac

Power block blowdown steam fraction [none]

Required: Required if pc_config=0

Type:

float

pc_config

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

Constraints: INTEGER

Required: False. Automatically set to 0 if not assigned explicitly or loaded from defaults.

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: Required if pc_config=0

Type:

float

UserDefinedPC Group

class PySAM.TcstroughPhysical.TcstroughPhysical.UserDefinedPC
assign(dict) None

Assign attributes from dictionary, overwriting but not removing values.

UserDefinedPC_vals = { var: val, ...}

export() dict

Export attributes into dictionary.

replace(dict) None

Replace attributes from dictionary, unassigning values not present in input dict.

UserDefinedPC_vals = { var: val, ...}

ud_T_amb_des

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

Required: Required if pc_config=1

Type:

float

ud_T_amb_high

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

Required: Required 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: False. Automatically set to [[0]] if not assigned explicitly or loaded from defaults.

Type:

sequence[sequence]

ud_T_amb_low

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

Required: Required if pc_config=1

Type:

float

ud_T_htf_high

High level HTF inlet temperature for T_amb parametric [C]

Required: Required 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: False. Automatically set to [[0]] if not assigned explicitly or loaded from defaults.

Type:

sequence[sequence]

ud_T_htf_low

Low level HTF inlet temperature for T_amb parametric [C]

Required: Required 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: Required 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: False. Automatically set to [[0]] if not assigned explicitly or loaded from defaults.

Type:

sequence[sequence]

ud_m_dot_htf_high

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

Required: Required 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: False. Automatically set to [[0]] if not assigned explicitly or loaded from defaults.

Type:

sequence[sequence]

ud_m_dot_htf_low

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

Required: Required 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: Required if pc_config=1

Type:

float

Enet Group

class PySAM.TcstroughPhysical.TcstroughPhysical.Enet
assign(dict) None

Assign attributes from dictionary, overwriting but not removing values.

Enet_vals = { var: val, ...}

export() dict

Export attributes into dictionary.

replace(dict) None

Replace attributes from dictionary, unassigning values not present in input dict.

Enet_vals = { var: val, ...}

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.AdjustmentFactors.AdjustmentFactors
assign() None

Assign attributes from dictionary

export() Dict

Export attributes into dictionary

constant

AC Constant loss adjustment [%]

dc_constant

DC Constant loss adjustment [%]

dc_en_hourly

Enable DC hourly-based adjustment factors [0/1]

dc_en_periods

Enable DC period-based adjustment factors [0/1]

dc_en_timeindex

Enable DC lfetime adjustment factors [0/1]

dc_hourly

DC Hourly Adjustment Factors [%]

dc_periods

DC Period-based Adjustment Factors [%]

dc_timeindex

DC Lifetime Adjustment Factors [%]

en_hourly

Enable AC hourly-based adjustment factors [0/1]

en_periods

Enable AC period-based adjustment factors [0/1]

en_timeindex

Enable AC lfetime adjustment factors [0/1]

hourly

AC Hourly Adjustment Factors [%]

periods

AC Period-based Adjustment Factors [%]

sf_constant

DC Constant loss adjustment [%]

sf_en_hourly

Enable SF hourly-based adjustment factors [0/1]

sf_en_periods

Enable SF period-based adjustment factors [0/1]

sf_en_timeindex

Enable SF lfetime adjustment factors [0/1]

sf_hourly

SF Hourly Adjustment Factors [%]

sf_periods

SF Period-based Adjustment Factors [%]

sf_timeindex

SF Lifetime Adjustment Factors [%]

timeindex

AC Lifetime Adjustment Factors [%]

Outputs Group

class PySAM.TcstroughPhysical.TcstroughPhysical.Outputs
assign(dict) None

Assign attributes from dictionary, overwriting but not removing values.

Outputs_vals = { var: val, ...}

export() dict

Export attributes into dictionary.

replace(dict) None

Replace attributes from dictionary, unassigning values not present in input dict.

Outputs_vals = { var: val, ...}

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_energy_distribution_time

Annual energy production as function of time [kW]

Type:

sequence[sequence]

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 Gross [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