Skip to content

Latest commit

 

History

History
276 lines (215 loc) · 17.7 KB

datadictionary.md

File metadata and controls

276 lines (215 loc) · 17.7 KB

Parameters

calc_design_pipe_vals

true if the htf temperatures and pressures at design conditions in the runners, farthest header, and farthest loop should be calculated and output. Default = true. ^

custom_sf_pipe_sizes

true if the runner and header diameters, wall thicknesses and lengths parameters should be used instead of calculating them. Note that changing the lengths does not affect the field layout. ^

custom_sgs_pipe_sizes

true if the SGS diameters and wall thicknesses parameters should be used instead of calculating them. (Note that the SGS lengths are always input). ^

custom_tes_p_loss

true if the TES piping losses should be calculated using the TES pipe lengths and minor loss coefficients (k_tes_loss_coeffs) or false if using the pumping power parameters on the parasitics page. Default = false. ^

DP_SGS

the pressure drop in bar within the steam generator system (SGS) Default = 0. ^

has_hot_tank_bypass

true if the solar field bypass valve causes the field htf to bypasses just the hot tank (and power block and auxiliary boiler) and enter the cold tank before flowing back to the field. Value is false if the bypass valve bypasses both the hot and cold tank. Default = false. ^

k_tes_loss_coeffs

the combined minor loss coefficients of the fittings and valves in the collection (including bypass) and generation loops in the TES piping to be used in the equation DP = K * U^2 * rho / 2. Defaults = {0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0} ^

L_rnr_pb

length of runner pipe in meters, for either the hot or cold lines. This length was previously shared with the other identical set of runners for the other half of the solar field, but this is no longer the case. Default = 25 m. ^

L_rnr_per_xpan

the threshold length of straight runner pipe without an expansion loop. Once this length has been reached, an expansion loop is added (without increasing the linear distance). Default = 70 m. ^

L_xpan_hdr

combined length in meters of the two perpendicular segments of a header expansion loop. This is the additional pipe length for each expansion loop. Default = 20 m ^

L_xpan_rnr

combined length in meters of the two perpendicular segments of a runner expansion loop. This is the additional pipe length for each expansion loop. Default = 20 m ^

Min_rnr_xpans

minimum number of expansion loops per single-diameter runner section. Default = 1 ^

N_hdr_per_xpan

number of collector loops per header expansion loops. Default = 2. Value = 1 means that there are expansion loops between every collector loop. ^

N_max_hdr_diams

maximum number of allowed diameters in each of the hot and cold headers. The maximum number of diameters in both the hot and cold headers is 2*N_max_hdr_diams. Default = 10. ^

northsouth_field_sep

north/south separation between subfields, in meters, defined as the shortest distance in-between SCAs in the different fields. Default = 20 m. Value = 0 means SCAs are touching. ^

offset_xpan_hdr

location of the first header expansion loop. Default = 1, which means that the first expansion loop is after the first collector loop closest to the runner. ^

sf_hdr_diams

custom inner diameters for the header piping as read from the modified output files. Utilized if custom_sf_pipe_sizes is true. Do not change the number of values (sections) as this will result in unpredictable model behavior. ^

sf_hdr_lengths

custom lengths for the header piping as read from the modified output files. Utilized if custom_sf_pipe_sizes is true. Changing the lengths does not affect the field layout. Do not change the number of values (sections) as this will result in unpredictable model behavior. ^

sf_hdr_wallthicks

custom wall thicknesses for the header piping as read from the modified output files. Utilized if custom_sf_pipe_sizes is true. Do not change the number of values (sections) as this will result in unpredictable model behavior. ^

sf_rnr_diams

custom inner diameters for the runner piping as read from the modified output files. Utilized if custom_sf_pipe_sizes is true. Do not change the number of values (sections) as this will result in unpredictable model behavior. ^

sf_rnr_lengths

custom lengths for the runner piping as read from the modified output files. Utilized if custom_sf_pipe_sizes is true. Changing the lengths does not affect the field layout. Do not change the number of values (sections) as this will result in unpredictable model behavior. ^

sf_rnr_wallthicks

custom wall thicknesses for the runner piping as read from the modified output files. Utilized if custom_sf_pipe_sizes is true. Do not change the number of values (sections) as this will result in unpredictable model behavior. ^

sgs_diams

custom inner diameters for the SGS piping as read from the modified output files. Utilized if custom_sgs_pipe_sizes is true. Do not change the number of values (sections) as this will result in unpredictable model behavior. ^

Collection Sections:

  • 0:     Solar field (SF) pump suction header to individual SF pump inlet
  • 1:     Individual SF pump discharge to SF pump discharge header
  • 2:     SF pump discharge header to collection field section headers (i.e., runners)
  • 3:     Collector field section outlet headers (i.e., runners) to expansion vessel (indirect storage) or hot thermal storage tank (direct storage)
  • 4:     Bypass branch - Collector field section outlet headers (i.e., runners) to pump suction header (indirect) or cold thermal storage tank (direct)

Generation Sections:

  • 5:     SGS pump suction header to individual SGS pump inlet (applicable only for storage in series with SF)
  • 6:     Individual SGS pump discharge to SGS pump discharge header (only for series storage)
  • 7:     SGS pump discharge header to steam generator supply header (only for series storage)
  • 8:     Steam generator supply header to inter-steam generator piping
  • 9:     Inter-steam generator piping to steam generator outlet header
  • 10:     Steam generator outlet header to SF pump suction header (indirect) or cold thermal storage tank (direct)

sgs_lengths

length of piping in the SGS collection flow loop followed by the generation flow loop [m]. These are not read from the modified output files. Defaults = {0, 90, 100, 120, 0, 0, 0, 0, 80, 120, 80}. Lengths at indices 0, 1, 5 and 6 are the summed lengths of the multiple individual pump sections. Do not change the number of values (sections) as this will result in unpredictable model behavior. ^

sgs_wallthicks

custom wall thicknesses for the SGS piping as read from the modified output files. Utilized if custom_sgs_pipe_sizes is true. Do not change the number of values (sections) as this will result in unpredictable model behavior. ^

tanks_in_parallel

true if the hot and cold storage tank branch is in parallel with the solar field (traditional case), or false if the tanks are in series with the solar field (only applicable for direct storage). Default = true. ^

T_tank_hot_inlet_min

the minimum field htf temperature that may enter the hot tank [C]. If below this temperature the bypass valve is opened and the field recirculates. Default = 400 C. ^

V_hdr_cold_max

maximum allowed velocity in the cold header at design conditions. This value can be exceeded if the minimum would also be exceeded, but only if this puts it less out of range. ^

V_hdr_cold_min

minimum allowed velocity in the cold header at design conditions. This value can be exceeded if the maximum would also be exceeded, but only if this puts it less out of range. ^

V_hdr_hot_max

maximum allowed velocity in the hot header at design conditions. This value can be exceeded if the minimum would also be exceeded, but only if this puts it less out of range. ^

V_hdr_hot_min

minimum allowed velocity in the hot header at design conditions. This value can be exceeded if the maximum would also be exceeded, but only if this puts it less out of range. ^

V_tes_des

design-point velocity for sizing the diameters of the TES piping [m/s]. Default = 1.85 m/s. ^

Outputs

pipe_header_diams

inner diameters in meters of all of the header sections in the cold and hot headers in one subfield. The first diameter is that before the first set of loops in the cold header and the last diameter is that after the last set of loops in the hot header. ^

pipe_header_expansions

number of expansions or contractions in the given header section ^

pipe_header_lengths

lengths in meters of the all of the header sections, including the added lengths of any expansion loops. The first length is that before the first set of loops in the cold header and last length is that after the last set of loops in the hot header. ^

pipe_header_mdot_dsn

mass flow rate in kg/s of the heat transfer fluid in each header section at design conditions. The first value is in the section before the first set of loops in the cold header and the last value is in the section after the last set of loops in the hot header. The mass flow for the cold header sections is the same as that entering the section, and the mass flow for the hot header sections is the same as that leaving the section. ^

pipe_header_P_dsn

gauge pressure in bar of the heat transfer fluid entering each section of the farthest header at design conditions. The first value is for the section before the first set of loops in the cold header and the last value is for the section after the last set of loops in the hot header. ^

pipe_header_T_dsn

temperature in Celsius of the heat transfer fluid entering each section of the farthest header at design conditions. The first value is for the section before the first set of loops in the cold header and the last value is for the section after the last set of loops in the hot header. ^

pipe_header_vel_dsn

velocity in m/s of the heat transfer fluid in each header section at design conditions. The first value is in the section before the first set of loops in the cold header and the last value is in the section after the last set of loops in the hot header. The velocity for the cold header sections is the same as that entering the section, and the velocity for the hot header sections is the same as that leaving the section. ^

pipe_header_wallthk

wall thickness of header pipe sections in [m] ^

pipe_loop_P_dsn

gauge pressure in bar of the heat transfer fluid entering each node in the farthest loop at design conditions. The values correspond to: ^

  • 0:     the inlet interconnect carrying twice the loop mass flow rate
  • 1:     the interconnect before the first SCA
  • 2:     the first SCA
  • 3:     the interconnect between the first and second SCA
  • 4:     the second SCA
  • ...
  • n-3:     the last SCA
  • n-2:     the interconnect after the last SCA
  • n-1:     the outlet interconnect carrying twice the loop mass flow rate

pipe_loop_T_dsn

temperature in Celsius of the heat transfer fluid entering each node in the farthest loop at design conditions. The values correspond to: ^

  • 0:     the inlet interconnect carrying twice the loop mass flow rate
  • 1:     the interconnect before the first SCA
  • 2:     the first SCA
  • 3:     the interconnect between the first and second SCA
  • 4:     the second SCA
  • ...
  • n-3:     the last SCA
  • n-2:     the interconnect after the last SCA
  • n-1:     the outlet interconnect carrying twice the loop mass flow rate

pipe_runner_diams

inner diameters in meters of the runners listed in L_runner. The first diameter is for the runner that carries half the total mass flow. Example diameters are: ^

  • 2 field sections = {x1}
  • 4 field sections = {x1, x1}
  • 6 field sections = {x1, x2}
  • 8 field sections = {x1, x1, x3}
  • 10 field sections = {x1, x4, x5}

pipe_runner_expansions

number of expansions or contractions in the given runner section ^

pipe_runner_lengths

lengths in meters of the different diameter runners that extend away from the power block in one direction. L_runner[0] is currently defaulted to 25, which is for the runner piping in and around the power block before it heads out to the field in the main runners. L_runner[0] was previously shared with the other identical set of runners for the other half of the solar field, but this is no longer the case. The runner lengths include expansion loops, except for L_runner[0]. For a given row spacing, SCA length, gap between SCAs, and number of SCA's, example values are: ^

  • 2 field sections = {L_rnr_pb}
  • 4 field sections = {L_rnr_pb, x}
  • 6 field sections = {L_rnr_pb, 2x}
  • 8 field sections = {L_rnr_pb, x, 2x}
  • 10 field sections = {L_rnr_pb, 2x, 2x}

pipe_runner_mdot_dsn

mass flow rate in kg/s of the heat transfer fluid in each runner section at design conditions. The first value is in the section in and around the power block before it heads out to the field in the main runners. The last value is in the section in and around the power block after it comes back from the field. The mass flow for the cold runner sections is the same as that entering the section, and the mass flow for the hot runner sections is the same as that leaving the section. ^

pipe_runner_P_dsn

pressure in bar of the heat transfer fluid entering each runner section at design conditions. The first value is for the section in and around the power block before it heads out to the field in the main runners. The last value is in the section in and around the power block after it comes back from the field. ^

pipe_runner_T_dsn

temperature in Celsius of the heat transfer fluid entering each runner section at design conditions. The first value is for the section in and around the power block before it heads out to the field in the main runners. The last value is in the section in and around the power block after it comes back from the field. ^

pipe_runner_vel_dsn

velocity in m/s of the heat transfer fluid in each runner section at design conditions. The first value is in the section in and around the power block before it heads out to the field in the main runners. The last value is in the section in and around the power block after it comes back from the field. The velocity for the cold runner sections is the same as that entering the section, and the velocity for the hot runner sections is the same as that leaving the section. ^

pipe_runner_wallthk

wall thickness of runner pipe sections in [m] ^

pipe_sgs_diams

SGS pipe inner diameters in [m] ^

pipe_sgs_mdot_dsn

SGS mass flow in each pipe section in [kg/s] ^

pipe_sgs_P_dsn

SGS pressure in each pipe section in [bar] ^

pipe_sgs_T_dsn

SGS temperature in each pipe section in [C] ^

pipe_sgs_vel_dsn

SGS velocity in each pipe section in [m/s] ^

pipe_sgs_wallthk

SGS wall thickness of each pipe section in [m] ^