LinearFresnelDsgIph¶
Wrapper for SAM Simulation Core model: cmod_linear_fresnel_dsg_iph.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:
- I_bn_des
- T_amb_des_sf
- T_cold_ref
- T_hot
- nLoops
- nModBoil
- q_pb_des
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.
LinearFresnelDsgIph model description
Linear Fresnel model with steam heat transfer fluid for industrial process heat applications
-
PySAM.LinearFresnelDsgIph.default(config) → LinearFresnelDsgIph¶ Use default attributes config options:
- “DSGLIPHLCOHCalculator”
- “DSGLIPHNone”
-
PySAM.LinearFresnelDsgIph.from_existing(data, optional config) → LinearFresnelDsgIph¶ Share underlying data with an existing PySAM class. If config provided, default attributes are loaded otherwise.
-
PySAM.LinearFresnelDsgIph.new() → LinearFresnelDsgIph¶
-
PySAM.LinearFresnelDsgIph.wrap(ssc_data_t) → LinearFresnelDsgIph¶ Use existing PySSC data
Warning
Do not call PySSC.data_free on the ssc_data_t provided to
wrap
Functions¶
-
class
PySAM.LinearFresnelDsgIph.LinearFresnelDsgIph¶ 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.LinearFresnelDsgIph.LinearFresnelDsgIph.Weather¶ -
assign() → None¶ Assign attributes from dictionary
Weather_vals = { var: val, ...}
-
export() → dict¶ Export attributes into dictionary
-
file_name¶ local weather file path
Constraints: LOCAL_FILE
Required: True
Type: str
-
solar_resource_data¶ Weather resource data in memory
Required: False
Type: dict
-
Solarfield Group¶
-
class
PySAM.LinearFresnelDsgIph.LinearFresnelDsgIph.Solarfield¶ -
assign() → None¶ Assign attributes from dictionary
Solarfield_vals = { var: val, ...}
-
export() → dict¶ Export attributes into dictionary
-
A_aperture¶ (boiler, SH) Reflective aperture area of the collector module [m^2]
Required: True
Type: sequence[sequence]
-
AbsorberMaterial¶ (boiler, SH) Absorber material type [none]
Required: True
Type: sequence[sequence]
-
AnnulusGas¶ # field fracs) [none]
Required: True
Type: sequence[sequence] Type: (boiler, SH) Annulus gas type {1=air; 26=Ar; 27=H2} (4
-
ColAz¶ Collector azimuth angle [deg]
Required: True
Type: float
-
D_2¶ (boiler, SH) The inner absorber tube diameter [m]
Required: True
Type: sequence[sequence]
-
D_3¶ (boiler, SH) The outer absorber tube diameter [m]
Required: True
Type: sequence[sequence]
-
D_4¶ (boiler, SH) The inner glass envelope diameter [m]
Required: True
Type: sequence[sequence]
-
D_5¶ (boiler, SH) The outer glass envelope diameter [m]
Required: True
Type: sequence[sequence]
-
D_p¶ (boiler, SH) The diameter of the absorber flow plug (optional) [m]
Required: True
Type: sequence[sequence]
-
Design_loss¶ # field fracs) [W/m]
Required: True
Type: sequence[sequence] Type: (boiler, SH) Receiver heat loss at design (4
-
Dirt_HCE¶ # field fracs) [none]
Required: True
Type: sequence[sequence] Type: (boiler, SH) Loss due to dirt on the receiver envelope (4
-
EPSILON_4¶ # field fracs) [none]
Required: True
Type: sequence[sequence] Type: (boiler, SH) Inner glass envelope emissivities (Pyrex) (4
-
Flow_type¶ (boiler, SH) The flow type through the absorber [none]
Required: True
Type: sequence[sequence]
-
GeomEffects¶ (boiler, SH) User-defined geometry effects derate [none]
Required: True
Type: sequence[sequence]
-
GlazingIntactIn¶ # field fracs) [none]
Required: True
Type: sequence[sequence] Type: (boiler, SH) The glazing intact flag {true=0; false=1} (4
-
HCE_FieldFrac¶ # field fracs) [none]
Required: True
Type: sequence[sequence] Type: (boiler, SH) The fraction of the field occupied by this HCE type (4
-
HLCharType¶ (boiler, SH) Flag indicating the heat loss model type {1=poly.; 2=Forristall} [none]
Required: True
Type: sequence[sequence]
-
HL_W¶ (boiler, SH) Heat loss coef adj wind velocity (0,1,2,3,4 order terms) [1/(m/s)^order]
Required: True
Type: sequence[sequence]
-
HL_dT¶ (boiler, SH) Heat loss coefficient - HTF temperature (0,1,2,3,4 order terms) [W/m-K^order]
Required: True
Type: sequence[sequence]
-
IAM_L¶ (boiler, SH) Longitudinal Incident angle modifiers (0,1,2,3,4 order terms) [none]
Required: True
Type: sequence[sequence]
-
IAM_T¶ (boiler, SH) Transverse Incident angle modifiers (0,1,2,3,4 order terms) [none]
Required: True
Type: sequence[sequence]
-
I_bn_des¶ Design point irradiation value [W/m2]
Required: True
- Changes to this variable may require updating the values of the following:
- nLoops
Type: float
-
L_col¶ (boiler, SH) Active length of the superheater section collector module [m]
Required: True
Type: sequence[sequence]
-
OptCharType¶ (boiler, SH) The optical characterization method [none]
Required: True
Type: sequence[sequence]
-
P_a¶ # field fracs) [torr]
Required: True
Type: sequence[sequence] Type: (boiler, SH) Annulus gas pressure (4
-
P_turb_des¶ Design-point turbine inlet pressure [bar]
Required: True
Type: float
-
Pipe_hl_coef¶ Loss coefficient from the header.. runner pipe.. and non-HCE pipin [W/m2-K]
Required: True
Type: float
-
Rough¶ (boiler, SH) Roughness of the internal surface [m]
Required: True
Type: sequence[sequence]
-
SCA_drives_elec¶ Tracking power.. in Watts per m2 [W/m2]
Required: True
Type: float
-
Shadowing¶ # field fracs) [none]
Required: True
Type: sequence[sequence] Type: (boiler, SH) Receiver bellows shadowing loss factor (4
-
T_amb_des_sf¶ Design-point ambient temperature [C]
Required: True
- Changes to this variable may require updating the values of the following:
- nLoops
Type: float
-
T_fp¶ Freeze protection temperature (heat trace activation temperature) [C]
Required: True
Type: float
-
Tau_envelope¶ # field fracs) [none]
Required: True
Type: sequence[sequence] Type: (boiler, SH) Envelope transmittance (4
-
TrackingError¶ (boiler, SH) User-defined tracking error derate [none]
Required: True
Type: sequence[sequence]
-
V_wind_max¶ Maximum allowable wind velocity before safety stow [m/s]
Required: True
Type: float
-
alpha_abs¶ # field fracs) [none]
Required: True
Type: sequence[sequence] Type: (boiler, SH) Absorber absorptance (4
-
alpha_env¶ # field fracs) [none]
Required: True
Type: sequence[sequence] Type: (boiler, SH) Envelope absorptance (4
-
b_OpticalTable¶ Values of the optical efficiency table [none]
Required: True
Type: sequence[sequence]
-
b_eps_HCE1¶ (temperature) Absorber emittance (eps) [none]
Required: True
Type: sequence[sequence]
-
b_eps_HCE2¶ (temperature) Absorber emittance (eps) [none]
Required: True
Type: sequence[sequence]
-
b_eps_HCE3¶ (temperature) Absorber emittance (eps) [none]
Required: True
Type: sequence[sequence]
-
b_eps_HCE4¶ (temperature) Absorber emittance (eps) [none]
Required: True
Type: sequence[sequence]
-
dirt_mirror¶ (boiler, SH) User-defined dirt on mirror derate [none]
Required: True
Type: sequence[sequence]
-
e_startup¶ Thermal inertia contribution per sq meter of solar field [kJ/K-m2]
Required: True
Type: float
-
error¶ (boiler, SH) User-defined general optical error derate [none]
Required: True
Type: sequence[sequence]
-
eta_pump¶ Feedwater pump efficiency [none]
Required: True
Type: float
-
fP_hdr_c¶ Average design-point cold header pressure drop fraction [none]
Required: True
Type: float
-
fP_hdr_h¶ Average design-point hot header pressure drop fraction [none]
Required: True
Type: float
-
fP_sf_boil¶ Design-point pressure drop across the solar field boiler fraction [none]
Required: True
Type: float
-
nLoops¶ Number of loops [none]
Required: True
- This variable may need to be updated if the values of the following have changed:
- I_bn_des
- T_amb_des_sf
- T_cold_ref
- T_hot
- nModBoil
- q_pb_des
Type: float
-
nModBoil¶ Number of modules in the boiler section [none]
Constraints: INTEGER
Required: True
- Changes to this variable may require updating the values of the following:
- nLoops
Type: float
-
q_pb_des¶ Design heat input to the power block [MW]
Required: True
- Changes to this variable may require updating the values of the following:
- nLoops
Type: float
-
rho_mirror_clean¶ (boiler, SH) User-defined clean mirror reflectivity [none]
Required: True
Type: sequence[sequence]
-
sh_OpticalTable¶ Values of the optical efficiency table [none]
Required: True
Type: sequence[sequence]
-
sh_eps_HCE1¶ (temperature) Absorber emittance (eps) [none]
Required: True
Type: sequence[sequence]
-
sh_eps_HCE2¶ (temperature) Absorber emittance (eps) [none]
Required: True
Type: sequence[sequence]
-
sh_eps_HCE3¶ (temperature) Absorber emittance (eps) [none]
Required: True
Type: sequence[sequence]
-
sh_eps_HCE4¶ (temperature) Absorber emittance (eps) [none]
Required: True
Type: sequence[sequence]
-
theta_dep¶ deploy angle [deg]
Required: True
Type: float
-
theta_stow¶ stow angle [deg]
Required: True
Type: float
-
x_b_des¶ Design point boiler outlet steam quality [none]
Required: True
Type: float
-
Powerblock Group¶
-
class
PySAM.LinearFresnelDsgIph.LinearFresnelDsgIph.Powerblock¶ -
assign() → None¶ Assign attributes from dictionary
Powerblock_vals = { var: val, ...}
-
export() → dict¶ Export attributes into dictionary
-
T_cold_ref¶ Reference HTF outlet temperature at design [C]
Required: True
- Changes to this variable may require updating the values of the following:
- nLoops
Type: float
-
T_hot¶ Hot HTF inlet temperature, from storage tank [C]
Required: True
- Changes to this variable may require updating the values of the following:
- nLoops
Type: float
-
Heliostat Group¶
-
class
PySAM.LinearFresnelDsgIph.LinearFresnelDsgIph.Heliostat¶ -
assign() → None¶ Assign attributes from dictionary
Heliostat_vals = { var: val, ...}
-
export() → dict¶ Export attributes into dictionary
-
csp_lf_sf_washes_per_year¶ Mirror washing frequency [-/year]
Required: True
Type: float
-
csp_lf_sf_water_per_wash¶ Water usage per wash [L/m2_aper]
Required: True
Type: float
-
HeatSink Group¶
AdjustmentFactors Group¶
-
class
PySAM.LinearFresnelDsgIph.LinearFresnelDsgIph.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.LinearFresnelDsgIph.LinearFresnelDsgIph.Outputs¶ -
assign() → None¶ Assign attributes from dictionary
Outputs_vals = { var: val, ...}
-
export() → dict¶ Export attributes into dictionary
-
T_field_cold_in¶ Field timestep-averaged inlet temperature [C]
Type: sequence
-
T_field_hot_out¶ Field timestep-averaged outlet temperature [C]
Type: sequence
-
T_rec_cold_in¶ Loop timestep-averaged inlet temperature [C]
Type: sequence
-
T_rec_hot_out¶ Loop timestep-averaged outlet temperature [C]
Type: sequence
-
W_dot_field_pump¶ Field htf pumping power [MWe]
Type: sequence
-
W_dot_heat_sink_pump¶ Heat sink pumping power [MWe]
Type: sequence
-
W_dot_parasitic_tot¶ System total electrical parasitic [MWe]
Type: sequence
-
W_dot_sca_track¶ Field collector tracking power [MWe]
Type: sequence
-
annual_electricity_consumption¶ Annual electricity consumptoin w/ avail derate [kWe-hr]
Type: float
-
annual_energy¶ Annual Net Thermal Energy Production w/ avail derate [kWt-hr]
Type: float
-
annual_field_energy¶ Annual Gross Thermal Energy Production w/ avail derate [kWt-hr]
Type: float
-
annual_thermal_consumption¶ Annual thermal freeze protection required [kWt-hr]
Type: float
-
annual_total_water_use¶ Total Annual Water Usage [m^3]
Type: float
-
beam¶ Resource Beam normal irradiance [W/m2]
Type: sequence
-
capacity_factor¶ Capacity factor [%]
Type: float
-
defocus¶ Field collector focus fraction
Type: sequence
-
deltaP_field¶ Field pressure drop [bar]
Type: sequence
-
e_dot_field_int_energy¶ Field change in material/htf internal energy [MWt]
Type: sequence
-
eta_opt_ave¶ Field optical efficiency before defocus [deg]
Type: sequence
-
gen¶ System power generated [kW]
Type: sequence
-
hour_day¶ Resource Hour of Day
Type: sequence
-
kwh_per_kw¶ First year kWh/kW [kWht/kWt]
Type: float
-
m_dot_field¶ Field total mass flow rate [kg/s]
Type: sequence
-
m_dot_loop¶ Receiver mass flow rate [kg/s]
Type: sequence
-
month¶ Resource Month
Type: sequence
-
op_mode_1¶ 1st operating mode
Type: sequence
-
op_mode_2¶ 2nd op. mode, if applicable
Type: sequence
-
op_mode_3¶ 3rd op. mode, if applicable
Type: sequence
-
pres¶ Resource Pressure [mbar]
Type: sequence
-
q_dot_freeze_prot¶ Field freeze protection required [MWt]
Type: sequence
-
q_dot_piping_loss¶ Field piping thermal losses [MWt]
Type: sequence
-
q_dot_rec_abs¶ Receiver thermal power absorbed [MWt]
Type: sequence
-
q_dot_rec_inc¶ Receiver thermal power incident [MWt]
Type: sequence
-
q_dot_rec_thermal_loss¶ Receiver thermal losses [MWt]
Type: sequence
-
q_dot_sf_out¶ Field thermal power leaving in steam [MWt]
Type: sequence
-
q_dot_to_heat_sink¶ Heat sink thermal power [MWt]
Type: sequence
-
q_inc_sf_tot¶ Field thermal power incident [MWt]
Type: sequence
-
solazi¶ Resource Solar Azimuth [deg]
Type: sequence
-
solzen¶ Resource Solar Zenith [deg]
Type: sequence
-
tdry¶ Resource Dry bulb temperature [C]
Type: sequence
-
theta_longitudinal¶ Field traverse incidence angle [deg]
Type: sequence
-
theta_traverse¶ Field traverse incidence angle [deg]
Type: sequence
-
time_hr¶ Time at end of timestep [hr]
Type: sequence
-
twet¶ Resource Wet bulb temperature [C]
Type: sequence
-
wspd¶ Resource Wind Speed [m/s]
Type: sequence
-
x_field_hot_out¶ Field timestep-averaged outlet quality
Type: sequence
-
x_rec_hot_out¶ Loop timestep-averaged outlet quality
Type: sequence
-