TessComponentLibraries_v2x
TessComponentLibraries_v2x
2
The Controls Component Library (General Descriptions) ................................................................. 3
The Green Building Component Library (General Descriptions) ...................................................... 5
The Ground Coupling Component Library (General Descriptions) ................................................... 8
The Ground Source Heat Pump Component Library (General Descriptions).................................. 12
The HVAC Component Library (General Descriptions).................................................................. 14
The Hydronics Component Library (General Descriptions) ............................................................ 20
The Loads and Structures Component Library (General Descriptions) ........................................... 24
The Optimization Component Library (General Description).......................................................... 26
The Solar Component Library (General Descriptions)..................................................................... 27
The Storage Component Library (General Descriptions)................................................................. 29
The Utility Component Library (General Descriptions)................................................................... 31
THE APPLICATIONS COMPONENT LIBRARY (GENERAL DESCRIPTIONS)
TYPE 515: HEATING AND COOLING SEASON SCHEDULER (new in version 2.0)
The Heating and Cooling Season Scheduler utility program (SeasonsScheduler.exe) and Type515 are used in conjunction
with one another to input a heating/cooling season schedule. A heating/cooling schedule denotes which portions of the year
when heating or cooling (or both) equipment may be utilized.
2
THE CONTROLS COMPONENT LIBRARY (GENERAL DESCRIPTIONS)
The controller commands a first stage control signal at low input values, a second stage control signal at lower input values,
a third stage control signal at even lower input values etc. through the nth defined level.
The user has the option to enable or disable the output control functions for levels lower than the critical control function.
For example if the model decides that the third stage signal should be ON, the user has the option of then deciding whether
stage 1 and stage 2 should be ON or OFF.
3
The controller commands a first stage control signal at high input values, a second stage control signal at higher input values,
a third stage control signal at even higher input values etc. through the nth defined level.
The user has the option to enable or disable the output control functions for levels lower than the critical control function.
For example if the model decides that the third stage signal should be ON, the user has the option of then deciding whether
stage 1 and stage 2 should be ON or OFF.
TYPE 698: FIVE STAGE ROOM THERMOSTAT EVALUATING N TEMPERATURES (new in version 2.0)
This ON/OFF differential device models a five stage room thermostat which outputs five control signals that can be used to
control an HVAC system having a three stage heating source and a two stage cooling source. This version of the model is
designed to allow the user to specify multiple temperatures to watch with the same set of set points. The controller contains
hysteresis effects and is equipped with a parameter that allows the user to set the number of controller oscillations permitted
within a single time step before the output values “stick.”
4
THE GREEN BUILDING COMPONENT LIBRARY (GENERAL DESCRIPTIONS)
The Type assumes that the array is divided into a user specified number of equal length rows and that all rows in the array are
identically sloped. Based on configuration parameters and current input values, the component outputs two different
estimates of radiation incident on the array rows. In the more conservative of the two estimates, a row that is partially shaded
from beam radiation is assumed to “see” only diffuse radiation. In the less conservative estimate, the fraction of the array
exposed to beam radiation is computed and the entire array is assumed to be exposed evenly to that reduced amount.
This model relies on linear factors relating the efficiency of the PV cells to the cell temperature and to incident solar
radiation. The cells are assumed to be operating at their maximum power point condition.
The thermal model of this collector relies on algorithms presented in Chapter 6 of “Solar Engineering of Thermal Processes”
by J.A. Duffie and W.A. Beckman.
Type 562: SIMPLE GLAZED OR UNGLAZED PHOTOVOLTAIC PANEL (new in version 2.0)
Type562 models either a glazed or unglazed photovoltaic array, basing its performance calculation on a user provided overall
array efficiency. Efficiency may be constant, variable, provided as a function of cell temperature and incident radiation in an
external file or provided for reference conditions along with coefficients that describe the effect of cell temperature and
incident radiation changes. This model is appropriate for PV arrays that are connected to a load through a maximum power
point tracking device since the efficiency of the Type562 PV is not dependent upon load voltage.
Type 563: UNGLAZED FIN-TUBE PV/T SOLAR COLLECTOR (new in version 2.0)
This component is intended to model an un-glazed solar collector that has the dual purpose of creating power from embedded
photovoltaic (PV) cells and providing heat to a fluid stream passing through tubes bonded to an absorber plate located
5
beneath the PV cells. This model relies on linear factors relating the efficiency of the PV cells to the cell temperature and to
the incident solar radiation. The cells are assumed to be operating at their maximum power point condition.
The thermal model of this collector relies on algorithms presented in Chapter 6 of “Solar Engineering of Thermal Processes”
by J.A. Duffie and W.A. Beckman.
This version of the PV/T collector may be connected to the multi-zone building model in TRNSYS so that the impact of the
collector on the building heating and cooling loads can be evaluated.
The model allows for the user to choose between two methods of handling the off-normal solar radiation effects. The model
also allows the user three options on specifying how the cell temperature and the incident solar radiation affect the PV
efficiency. The cells are assumed to be operating at their maximum power point condition, implying that the voltage and
current are not calculated by the model.
The thermal model of this collector relies on algorithms supplied in “Solar Engineering of Thermal Processes” by J.A. Duffie
and W.A. Beckman.
The model allows for the user to choose between two methods of handling the off-normal solar radiation effects. The model
also allows the user three options on specifying how the cell temperature and the incident solar radiation affect the PV
efficiency. The cells are assumed to be operating at their maximum power point condition, implying that the voltage and
current are not calculated by the model.
The thermal model of this collector relies on algorithms supplied in “Solar Engineering of Thermal Processes” by J.A. Duffie
and W.A. Beckman.
The model allows the user three options on specifying how the cell temperature, and the incident solar radiation affect the PV
efficiency. The cells are assumed to be operating at their maximum power point condition; implying that the voltage and
current are not calculated by the model.
6
The thermal model of this collector relies on algorithms supplied in “Solar Engineering of Thermal Processes” by J.A. Duffie
and W.A. Beckman.
The model allows the user three options on specifying how the cell temperature, and the incident solar radiation affect the PV
efficiency. The cells are assumed to be operating at their maximum power point condition, which implies that the voltage and
current are not calculated by the model.
The thermal model of this collector relies on algorithms supplied in “Solar Engineering of Thermal Processes” by J.A. Duffie
and W.A. Beckman.
Type 687: NATIONAL FENESTRATION RATING COUNCIL (NFRC) WINDOW (new in version 2.0)
The Type687 model calculates the amount of solar energy and illumination transmitted through a window given only the
basic information available on the National Fenestration Rating Council label of any window commercially available in the
United States. It takes, as input data the window’s solar heat gain coefficient, overall u value and visible light transmittance.
7
THE GROUND COUPLING COMPONENT LIBRARY (GENERAL DESCRIPTIONS)
This basement model is intended to be used in conjunction with Type56. If you wish to use this model in conjunction with a
simplified building model, you should use Type702 instead.
Type702: BASEMENT CONDUCTION (INTERFACES WITH ZONE AIR TEMPERATURE) (new in version 2.0)
This routine models the heat transfer from a basement (typically four walls and a floor, all made of concrete) to the soil
surrounding the five surfaces of the basement. The heat transfer is assumed to be conductive only and moisture effects are not
accounted for in the model. The model relies on a 3-dimensional finite difference model of the soil and solves the resulting
inter-dependent differential equations using a simple iterative method. The user enters the temperature of the zone air, the
thermal properties of the basement wall material, the soil properties and grid geometry, and the ambient conditions in the soil
outside of the basement (near-field). The initial soil conditions may be calculated from the Kasuda correlation [1] or read
from a user-supplied data file. The surface conditions for the near-field and far-field soil may be calculated in one of three
ways; 1) from the Kasuda correlation, 2) from an energy balance on the surface plane, 3) provided as an input to the model.
The near-field soil temperatures are affected by the heat transfer from the basement. The far-field soil temperatures are only
affected by the surface conditions (time of year) and depth.
This basement model is intended to be used in conjunction with simplified building models. If you wish to use this model in
conjunction with Type56, you should use Type701 instead. More information on this distinction is provided in section 1
below.
8
3) provided as an input to the model. The near-field soil temperatures are affected by the heat transfer from the slab. The far-
field soil temperatures are only affected by the surface conditions (time of year) and depth. The model in return calculates the
slab/ground interface temperature, which is passed back to the building model as an input.
This slab model is intended to be used in conjunction with Type56. If you wish to use this slab model in conjunction with a
simplified building model, you should use Type704 instead.
Type704: SLAB ON GRADE (INTERFACES WITH ZONE AIR TEMPERATURE) (new in version 2.0)
This routine models the heat transfer from a horizontal surface (slab) to the soil beneath the surface. The heat transfer is
assumed to be conductive only and moisture effects are not accounted for in the model. The model relies on a 3-dimensional
finite difference model of the soil and solves the resulting inter-dependent differential equations using a simple iterative
method. The user enters the temperature of the zone air above the slab, the thermal properties of the slab, the soil properties
and grid geometry, and the ambient conditions outside of the slab (near field). The initial soil conditions may be calculated
from the Kasuda correlation [1] or read from a user-supplied data file. The surface conditions for the near-field and far-field
soil may be calculated in one of three ways; 1) from the Kasuda correlation, 2) from an energy balance on the surface plane,
3) provided as an input to the model. The near-field soil temperatures are affected by the heat transfer from the slab. The far-
field soil temperatures are only affected by the surface conditions (time of year) and depth.
This radiant slab model is intended to be used with simple building models that calculate the zone air temperature and not
with detailed building models that are capable of calculating inner surface temperatures based on provided outer surface
temperatures (such as the standard TRNSYS Type 56 model). If you wish to use this radiant slab model in conjunction with
Type56, please refer to the companion model, Type703.
Type705: RADIANT SLAB WITH EMBEDDED PIPES (INTERFACES WITH TYPE56) (new in version 2.0)
This component is intended to model a radiant floor-heating slab, embedded in soil, and containing a number of fluid filled
pipes. The heat transfer within the slab and surrounding soil is assumed to be conductive only and moisture effects are not
accounted for in the model. The model relies on a three-dimensional finite difference method, solving the resulting inter-
dependent differential equations using an iterative approach. The user may define any number of pipes within the slab and
surrounding soil through a separate data file containing information about the path that the pipes follow through the slab/soil
for each pipe. The slab is assumed to be embedded in the soil and the user may define bottom and/or perimeter insulation that
extends below the slab if desired. Default numbers of maximum slab nodes, maximum pipe nodes and maximum number of
pipes are set, but may be increased by modification of the Fortran code.
This version of the radiant slab model is designed to be used in conjunction with the Type56 building model. If you wish to
use the same model in conjunction with a different building model (one that computes a zone air temperature but does not
calculate interior surface temperatures), you should use Type706 instead.
Type706: RADIANT SLAB WITH EMBEDDED PIPES (INTERFACES WITH ZONE AIR TEMPERATURE) (new
in version 2.0)
This component is intended to model a radiant floor-heating slab, embedded in soil, and containing a number of fluid filled
pipes. The heat transfer within the slab and surrounding soil is assumed to be conductive only and moisture effects are not
accounted for in the model. The model relies on a three-dimensional finite difference method, solving the resulting inter-
dependent differential equations using an iterative approach. The user may define any number of pipes within the slab and
surrounding soil through a separate data file containing information about the path that the pipes follow through the slab/soil
for each pipe. The slab is assumed to be embedded in the soil and the user may define bottom and/or perimeter insulation that
extends below the slab if desired. The slab may also be exposed to incident radiation whether from interior lights or from the
sun. Default numbers of maximum slab nodes, maximum pipe nodes and maximum number of pipes are set, but may be
increased by modification of the Fortran code.
If you wish to use this radiant slab model in conjunction with Type56, you should use Type705 instead. This version
(Type706) is designed to be used with building models that do not contain the notion of a boundary wall and compute interior
surface temperatures.
Type707: BURIED VERTICALLY CYLINDRICAL STORAGE TANK WRAPPER (new in version 2.0)
This component can be used in conjunction with most thermal storage tank models to calculate the energy exchange through
the bottom, top, and sides of a vertically cylindrical tank that is entirely buried beneath the ground surface. As inputs, the
9
model takes the U values of the tank top, bottom, and each thermal node section as well as the temperature of each tank node.
The user is also asked to define a 3 dimensional radial soil node structure. In return, Type707 computes the temperature of
each tank node / soil node boundary, passing those temperatures back to the tank model for its own loss calculations.
Type712: RADIANT SLAB WITH EMBEDDED PIPES AND NO GROUND STORAGE EFFECTS (INTERFACES
WITH TYPE 56) (new in version 2.0)
This component is intended to model a radiant floor-heating slab, embedded in soil, and containing a number of fluid filled
pipes. The heat transfer within the slab is assumed to be conductive only and moisture effects are not accounted for in the
model. The model relies on a three-dimensional finite difference method, solving the resulting inter-dependent differential
equations using an iterative approach. The user may define any number of pipes within the slab through An external data file
containing information about the path that the pipes follow through the slab for each pipe. The slab is assumed to be
embedded in the soil and the user may define bottom and/or perimeter insulation that extends below the slab if desired.
Default numbers of maximum slab nodes, maximum pipe nodes and maximum number of pipes are set, but may be increased
by modification of the Fortran code. This model differs from Type705 in that it does not extend the 3D grid into the soil that
surrounds the slab. Instead, the zone temperature communicates (through the slab) with a ground surface temperature
generated by the Kasuda [1] correlation.
This version of the radiant slab model is designed to be used in conjunction with the Type56 building model. If you wish to
use the same model in conjunction with a different building model (one that computes a zone air temperature but does not
calculate interior surface temperatures), you should use Type713 instead.
Type 713: RADIANT SLAB WITH EMBEDDED PIPES AND NO GROUND STORAGE EFFECTS (INTERFACES
WITH ZONE AIR TEMPERATURE) (new in version 2.0)
This component is intended to model a radiant floor-heating slab, embedded in soil, and containing a number of fluid filled
pipes. The heat transfer within the slab is assumed to be conductive only and moisture effects are not accounted for in the
model. The model relies on a three-dimensional finite difference method, solving the resulting inter-dependent differential
equations using an iterative approach. The user may define any number of pipes within the slab through An external data file
containing information about the path that the pipes follow through the slab for each pipe. The slab is assumed to be
embedded in soil and the user may define bottom and/or perimeter insulation that extends below the slab if desired. The slab
may also be exposed to incident radiation whether from interior lights or from the sun. Default numbers of maximum slab
nodes, maximum pipe nodes and maximum number of pipes are set, but may be increased by modification of the Fortran
code. This model differs from Type706 in that it does not extend the 3D finite element grid into the soil that surrounds the
slab. Instead, the zone temperature communicates (through the slab) with a ground surface temperature generated by the
Kasuda [1] correlation.
If you wish to use this radiant slab model in conjunction with Type56, you should use Type712 instead. This version
(Type713) is designed to be used with building models that do not contain the notion of a boundary wall and compute interior
surface temperatures.
Type714: ASHRAE METHOD FOR CALCULATING SLAB HEAT TRANSFER (new in version 2.0)
In 2001 ASHRAE Fundamentals Chapter 31, the American Society of Heating and Refrigeration Engineers proposes a
simplified method for calculating the energy transfer through a rectangular slab on grade with various insulation schemes
(back insulation, side insulation, no insulation, etc.). The same chapter extends the simplified method to calculating energy
transfer through basements. This Type should be used for slabs while Type715 is available for calculating energy transfer
through basements.
10
Type715: ASHRAE METHOD FOR CALCULATING BASEMENT HEAT TRANSFER (new in version 2.0)
In 2001 ASHRAE Fundamentals Chapter 31, the American Society of Heating and Refrigeration Engineers proposes a
simplified method for calculating the energy transfer through a rectangular aspect ratio basement with various insulation
schemes (back insulation, side insulation, no insulation, etc.). The same chapter also presents the simplified method as it
applies to calculating energy transfer through slabs. This Type should be used for basements while Type714 is available for
calculating energy transfer through slabs. Because of the methodology used, this model is not appropriate for use with
Type56 but can be used with simplified building models such as standard TRNSYS Type12, or 88, or the TESS simplified
multizone building model (Type660).
11
THE GROUND SOURCE HEAT PUMP COMPONENT LIBRARY (GENERAL DESCRIPTIONS)
The heat pump has a desuperheater attached to a secondary fluid stream. In cooling mode, the desuperheater relieves the
liquid stream of some of the burden of rejecting energy. However, in heating mode, the desuperheater requires the liquid
stream to absorb more energy than is just required for space
heating.
This model is based on user-supplied data files containing catalog data for the capacity (both total and sensible in cooling
mode), and power, based on the entering water temperature to the heat pump, the entering water flow rate and the air flow
rate. Other curve fits are used to modify the capacities and power based on off-design indoor air temperatures. Type504 takes
either air relative humidity or absolute humidity ratio as an input. It is identical to Type505 in the TESS HVAC Equipment
Library. Formerly, Type504 took air humidity ratio as an input while Type505 took air relative humidity.
This model accounts for ground seasonal temperature variations and backfilling of the trench containing the pipe. The fluid
convection, the pipe wall, and the backfilled material are all represented as a net resistance. The inner soil nodes, those in
contact with the backfill are also modeled without capacitance. The rest of the nodes within the soil are modeled as capacitors
connected by resistors in both the radial and circumferential directions.
In typical U-tube or tube in tube ground heat exchanger applications, a vertical borehole is drilled into the ground. A u-tube
or tube in tube heat exchanger is then pushed into the borehole. The top of the ground heat exchanger is typically several feet
below the surface of the ground. Finally, the borehole is filled with a fill material; either virgin soil or a grout of some type.
The model assumes that the boreholes are placed uniformly within a cylindrical storage volume of ground. There is
convective heat transfer within the pipes and conductive heat transfer to the storage volume. The temperature of the
surrounding ground is calculated from three parts; a global temperature, a local solution, and a steady-flux solution. The
global and local problems are solved with the use of an explicit finite-difference method. The steady-flux solution is obtained
analytically. The resulting temperature is then calculated using superposition methods.
This subroutine was written by the Department of Mathematical Physics at the University of Lund, Sweden, and is
considered to be the state-of-the-art in dynamic simulation of ground heat exchangers. Further information about this model
12
may be found in: Hellstrom, Goran, “Duct Ground Heat Storage Model, Manual for Computer Code,” Department of
Mathematical Physics, University of Lund, Sweden.
13
THE HVAC COMPONENT LIBRARY (GENERAL DESCRIPTIONS)
The heat pump has a desuperheater attached to a secondary fluid stream. In cooling mode, the desuperheater relieves the
liquid stream of some of the burden of rejecting energy. However, in heating mode, the desuperheater requires the liquid
stream to absorb more energy than is just required for space
heating.
This model is based on user-supplied data files containing catalog data for the capacity (both total and sensible in cooling
mode), and power, based on the entering water temperature to the heat pump, the entering water flow rate and the air flow
rate. Other curve fits are used to modify the capacities and power based on off-design indoor air temperatures. Type505 takes
either air relative humidity or absolute humidity ratio as an input. It is identical to Type504 in the TESS Ground Source Heat
Pump Library. Formerly, Type505 took air relative humidity while Type504 took air humidity ratio as an input.
TYPE 506: DIRECT EVAPORATIVE COOLER (SWAMP COOLER) (new in version 2.0)
Type506 models an evaporative cooling device for which the user supplies the inlet air conditions and the saturation
efficiency and the model calculates the outlet air conditions. The cooling process is assumed to be a constant wet bulb
temperature process meaning that air enters and exits at the same wet bulb temperature. The device is not equipped with
controls that monitor the conditions of the outlet air. When the device is ON (based on a user supplied control signal value),
Type506 cools the air as much as it can given the entering conditions and the device efficiency. If a controlled evaporative
cooling device is more appropriate to the user’s circumstances, Type507 may be used. Type507 models a similar direct
evaporative cooling device but takes a target air outlet relative humidity.
TYPE 507: CONTROLLED DIRECT EVAPORATIVE COOLING DEVICE (FOGGING DEVICE) (new in version
2.0)
Type507 models an evaporative cooling device for which the user supplies the inlet air conditions and a target air outlet
relative humidity. The outlet air dry bulb temperature is modulated given to achieve the desired outlet relative humidity. The
cooling process is assumed to be a constant wet bulb temperature process meaning that air enters and exits at the same wet
bulb temperature.
TYPE 508: COOLING COIL WITH VARIOUS CONTROL MODES (new in version 2.0)
Type508 models a cooling coil using one of four control modes. The cooling coil is modeled using a bypass approach in
which the user specifies a fraction of the air stream that bypasses the coil. The remainder of the air stream is assumed to exit
the coil at the average temperature of the fluid in the coil and at saturated conditions. The two air streams are remixed after
the coil. In its unrestrained (uncontrolled) mode of operation, the coil cools and dehumidifies the air stream as much as
possible given the inlet conditions of both the air and the fluid streams. The model is alternatively able to internally bypass
fluid around the coil so as to maintain the outlet air dry bulb temperature above a user specified minimum, to maintain the air
outlet absolute humidity ratio above a user specified minimum or to maintain the fluid outlet temperature below some user
specified maximum.
14
TYPE 643: SIMPLE FURNACE / AIR HEATER
Much like Type6 does for fluids, Type643 represents an air heating device that can be controlled either externally, or set to
automatically try and attain a set point temperature. The furnace is bound by a heating capacity and an efficiency. Thermal
losses from the furnace are based on the average air temperature. The outlet state of the air is determined by an enthalpy
based energy balance that takes pressure effects into account.
TYPE 650: HEAT EXCHANGER WITH HOT-SIDE BYPASS TO KEEP COLD-SIDE OUTLET BELOW ITS
SETPOINT
Type650 models a constant effectiveness / Cmin heat exchanger that is able to automatically bypass hot-side fluid around the
heat exchanger in order to maintain the cold-side outlet temperature below a user specified, time dependent set point. The
bypass may be enabled or disabled at any point during the simulation if desired.
TYPE 652: HEAT EXCHANGER WITH HOT-SIDE BYPASS TO KEEP COLD-SIDE OUTLET ABOVE ITS
SETPOINT
Type652 models a constant effectiveness / Cmin heat exchanger that is able to automatically bypass hot-side fluid around the
heat exchanger in order to maintain the cold-side outlet temperature above a user specified, time dependent set point. The
bypass may be enabled or disabled at any point during the simulation if desired.
TYPE 657: HEAT EXCHANGER WITH COLD-SIDE BYPASS TO KEEP HOT-SIDE OUTLET BELOW ITS
SETPOINT
Type657 models a constant effectiveness / Cmin heat exchanger that is able to automatically bypass cold-side fluid around the
heat exchanger in order to maintain the hot-side outlet temperature below a user specified, time dependent set point. The
bypass may be enabled or disabled at any point during the simulation if desired.
TYPE 659: AUXILIARY FLUID HEATER WITH PROPORTIONAL CONTROL (PROPORTIONAL BOILER)
Type659 models an external, proportionally controlled fluid heater. External proportional control (an input signal between 0
and 1) is in effect as long as a fluid set point temperature is not exceeded. If the set point is exceeded, the proportional control
is internally modified to limit the fluid outlet temperature to the set point as with Type6.
TYPE 663: ELECTRIC UNIT HEATER WITH VARIABLE SPEED FAN AND PROPORTIONAL CONTROL
Type663 models an electric unit heater whose fan speed and heating power are proportionally and externally controlled.
Proportional control indicates that both fan speed and heating power can vary between 0 and their rated values. External
control indicates that the fraction of rated capacity or speed is specified as a time dependent value by the user and is provided
to the model as an input. The heater is designed not to exceed a user specified set point temperature. If at any point in the
simulation the heater capacity and control signal would result in an outlet temperature higher than the set point, the external
control signal value will be overridden. Fan power is specified as a polynomial relating normalized mass flow rate to
normalized fan power. The user may control the extent to which the fan power results in a temperature rise in the air stream.
TYPE 664: ELECTRIC UNIT HEATER WITH VARIABLE SPEED FAN, PROPORTIONAL CONTROL, AND
DAMPER CONTROL
Type664 models an electric unit heater whose fan speed, heating power, and fraction of outdoor air are proportionally and
externally controlled. Proportional control indicates that these three variables can have any value between 0 and their rated
values. External control indicates that the fraction of rated capacity, speed, or outdoor air is specified as a time dependent
15
value by the user and is provided to the model as an input. The heater is designed not to exceed a user specified set point
temperature. If at any point in the simulation the heater capacity and control signal would result in an outlet temperature
higher than the set point, the external control signal value will be overridden. Fan power is specified as a polynomial relating
normalized mass flow rate to normalized fan power. The user may also control the extent to which the fan power results in a
temperature rise in the air stream.
TYPE 665: AIR SOURCE HEAT PUMP (SPLIT SYSTEM HEAT PUMP)
Type665 uses a manufacturer’s catalog data approach to model an air source heat pump (air flows on both the condenser and
evaporator sides of the device. The model includes mixing algorithms and damper settings so that the indoor air may be the
result of two streams from different sources (recirculation and makeup air for example. In heating mode, the device is
equipped with one of three auxiliary heater types: no auxiliary heat available, two element electric auxiliary heat, or gas fired
auxiliary heat. The model is also equipped with a capacity multiplier parameter so that the heat pump may be quickly resized
without having to resort to finding new data files.
TYPE 670: AIR HEATING COIL (KEEPS THE OUTLET AIR TEMPERATURE BELOW A USER-SPECIFIED
SETPOINT)
Type670 simulates an air heating coil with an internally controlled bypass damper that acts to maintain the outlet air
temperature above the inlet air temperature and below a user-specified set point temperature.
16
TYPE 677: DOUBLE-EFFECT HOT WATER-FIRED ABSORPTION CHILLER
Type677 uses a normalized catalog data lookup approach to model a double-effect hot-water fired absorption chiller. “Hot
Water-Fired” indicates that the energy supplied to the machine’s generator comes from a hot water stream. Because the data
files are normalized, the user may model any size chiller using a given set of data files. Example files are provided.
TYPE 699: HEAT EXCHANGER WITH COLD-SIDE BYPASS TO KEEP HOT-SIDE OUTLET ABOVE ITS
SETPOINT (new in version 2.0)
Type699 models a constant effectiveness / Cmin heat exchanger that is able to automatically bypass hot-side fluid around the
heat exchanger in order to maintain the cold-side outlet temperature above a user specified, time dependent set point. The
bypass may be enabled or disabled at any point during the simulation if desired.
TYPE 700: SIMPLE BOILER WITH EFFICIENCY INPUTS (new in version 2.0)
Type700 models a simple steam boiler. According to ASHRAE, a boiler is defined by its overall efficiency (output/input) and
by its combustion efficiency ((input energy-stack energy)/input energy). In this model, the boiler efficiency and the
combustion efficiency are supplied as inputs to the model. A version of this component also exists (Type751) in which boiler
and combustion efficiency are read as a function of entering liquid temperature and device part load ratio from an external
data file. This component (Type700) assumes that device efficiency is not a function of inlet conditions.
TYPE 751: SIMPLE BOILER WITH EFFICIENCY FROM DATA FILE (new in version 2.0)
Type751 models a simple steam boiler. According to ASHRAE, a boiler is defined by its overall efficiency (output/input) and
by its combustion efficiency ((input energy-stack energy)/input energy). In this model, the boiler efficiency and the
combustion efficiency are read from an external data file in which they are provided as a function of entering liquid
temperature and device part load ratio. A version of this component exists (Type700) in which the combustion and boiler
efficiency values are specified as inputs to the model instead of in an external data file.
18
nothing is known about the conditions of liquid entering the device. The model reports the amount of energy removed from
the air stream and (if both temperature and humidity are controlled) the amount of reheat energy required to bring the
temperature back up to the desired level after meeting the humidity requirement.
TYPE 753: HEATING COIL WITH VARIOUS CONTROL MODES (new in version 2.0)
Type753 models a heating coil using one of three control modes. The heating coil is modeled using a bypass approach in
which the user specifies a fraction of the air stream that bypasses the coil. The remainder of the air stream is assumed to exit
the coil at the average temperature of the fluid in the coil. The air stream passing through the coil is then remixed with the air
stream that bypassed the coil. In its unrestrained (uncontrolled) mode of operation, the coil heats the air stream as much as
possible given the inlet conditions of both the air and the fluid streams. The model is alternatively able to internally bypass
air around the coil so as to maintain the outlet air dry bulb temperature above a user specified minimum, or to maintain the
fluid outlet temperature above a user specified minimum.
TYPE 755: AIR TO AIR SENSIBLE HEAT EXCHANGER (new in version 2.0)
Type755 uses an effectiveness – minimum capacitance approach to model an air to air heat exchanger that transfers only
sensible energy. If moisture transfer as well as sensible energy transfer between the exhaust and fresh air streams is
important, Type667 (an air to air heat recovery device) uses similar principals to this model but also accounts for moisture
transfer between the air streams.
TYPE 756: RESIDENTIAL COOLING COIL (AIR CONDITIONER) WITH UNIFIED DATA FORMAT (new in
version 2.0)
Type756 models a residential cooling coil, more commonly known as a residential air conditioner. It relies on catalog data
provided in an external text file to determine coil performance. An example data file and information on data file format are
provided. This component is functionally identical to the Type651 residential cooling coil except that Type651 requires a
different data file format. Depending upon the source of data, this component or Type651 may be the more appropriate
version.
19
THE HYDRONICS COMPONENT LIBRARY (GENERAL DESCRIPTIONS)
20
control signal, the power drawn by the fan at a given flow rate can be any polynomial expression of the control signal. As
with most pumps and fans in TRNSYS, Type662 takes mass flow rate as an input but ignores the value except in order to
perform mass balance checks. Type662 sets the downstream flow rate based on its rated flow rate parameters and the current
value of its control signal inputs.
TYPE 695: VARIABLE SPEED PUMP, CONTROL SIGNAL INPUT, POWER CALCULATED FROM HEAD AND
DESIRED FLOW RATE (new in version 2.0)
Type695 models a pump that sets its outlet mass flow rate equal to a user specified maximum mass flow rate multiplied by a
control signal that can vary between a value of 0 and 1. By insuring that the control signal only ever has a value of 0 or 1
(never anything in between) Type695 can equally well be used to model a constant speed pump. Like most pumps and fans in
TRNSYS, Type695 ignores the inlet mass flow rate of liquid and sets the downstream flow. The pump’s power draw is
calculated based upon a user specified polynomial. Pump starting and stopping characteristics are not modeled.
TYPE 709: PIPE (U VALUE CALCULATED FROM PHYSICAL CHARACTERISTICS) (new in version 2.0)
Very much like standard TRNSYS Type31, this component models the thermal behavior of fluid flow in a pipe or duct using
variable size segments of fluid. Entering fluid shifts the position of existing segments. The mass of the new segment is equal
to the flow rate multiplied by the simulation time step. The new segment's temperature is that of the incoming fluid. The
outlet of this pipe is a collection of the elements that are “pushed” out by the inlet flow. This so-called “plug-flow” model
does not consider mixing or conduction between adjacent elements. A maximum of 25 segments are allowed in the pipe.
When the maximum is reached, the two adjacent segments with the closest temperatures are combined to make a single
segment. Where Type709 differs from Type31 is that instead of asking the user to provide an overall UA value for the pipe
and its insulation, the user is here asked to provide the physical characteristics of the pipe material, fluid and insulation
material.
It should also be noted that the documentation for Type709 is taken largely verbatim from the documentation of Type31.
TYPE 740: CONSTANT SPEED PUMP, CONTROL SIGNAL INPUT, POWER CALCULATED FROM
PRESSURE DROP AND PUMP EFFICIENCY (new in version 2.0)
Type740 models a single (constant) speed pump that is able to maintain a constant fluid outlet mass flow rate. The pump’s
power draw is calculated from pressure rise, motor efficiency and fluid characteristics. Pump starting and stopping
characteristics are not modeled. As with most pumps and fans in TRNSYS, Type740 takes mass flow rate as an input but
ignores the value except in order to perform mass balance checks. Type740 sets the downstream flow rate based on its rated
flow rate parameter and the current value of its control signal input.
TYPE 741: VARIABLE SPEED PUMP, CONTROL SIGNAL INPUT, POWER CALCULATED FROM PRESSURE
RISE AND PUMP EFFICIENCY (new in version 2.0)
Type741 models a variable speed pump that is able to produce any mass flow rate between zero and its rated flow rate. The
pump’s power draw is calculated from pressure rise, motor efficiency and fluid characteristics. Pump starting and stopping
characteristics are not modeled. As with most pumps and fans in TRNSYS, Type741 takes mass flow rate as an input but
ignores the value except in order to perform mass balance checks. Type741 sets the downstream flow rate based on its rated
flow rate parameter and the current value of its control signal input.
TYPE 742: VARIABLE OR CONSTANT SPEED PUMP, MASS FLOW RATE INPUT, POWER CALCULATED
FROM PRESSURE RISE AND PUMP EFFICIENCY (new in version 2.0)
Type742 models a pump that sets its fluid outlet mass flow rate equal to the user specified inlet mass flow rate. Because mass
flow rate is an input (as opposed to a parameter), Type742 can equally well be used to model a constant or a variable speed
pump. Unlike most pumps and fans in TRNSYS, Type742 passes the inlet mass flow rate through to its output. Type742 sets
the downstream flow but does not take either a maximum allowable flow rate or a control signal. The pump’s power draw is
calculated from pressure rise, motor efficiency, fluid flow rate and fluid characteristics. Pump starting and stopping
characteristics are not modeled.
21
TYPE 743: VARIABLE OR CONSTANT SPEED PUMP, MASS FLOW RATE INPUT, POWER CALCULATED
FROM POWER CURVE POLYNOMIAL (new in version 2.0)
Type743 models a pump that sets its outlet mass flow rate equal to a user specified inlet mass flow rate. Because mass flow
rate is an input (as opposed to a parameter), Type743 can equally well be used to model a constant or a variable speed pump.
Unlike most pumps and fans in TRNSYS, Type743 passes the inlet mass flow rate of fluid through to its output. Type743
sets the downstream flow but does not take a control signal. The pump’s power draw is calculated based upon a user
specified polynomial. Pump starting and stopping characteristics are not modeled.
TYPE 744: VARIABLE OR CONSTANT SPEED FAN, MASS FLOW RATE INPUT, POWER CALCULATED
FROM POWER CURVE POLYNOMIAL (new in version 2.0)
Type744 models a fan that sets its outlet mass flow rate equal to a user specified inlet mass flow rate. Because mass flow rate
is an input (as opposed to a parameter), Type744 can equally well be used to model a constant or a variable speed fan. Unlike
most pumps and fans in TRNSYS, Type744 passes the inlet mass flow rate of air through to its output. Type744 sets the
downstream flow but does not take a control signal. The fan’s power draw is calculated based upon a user specified
polynomial. Fan starting and stopping characteristics are not modeled.
TYPE 745: VARIABLE SPEED PUMP, MASS FLOW RATE CALCULATED FROM AVAILABLE POWER,
POWER DRAWN CALCULATED FROM MOTOR EFFICIENCY AND PRESSURE RISE (new in version 2.0)
Type745 models a pump that sets its outlet mass flow rate based upon user specified available power. It calculates the power
drawn by the pump based on motor efficiency and pump pressure rise. Like most pumps and fans in TRNSYS, Type745
takes the inlet mass flow rate of fluid as an input but does not necessarily pass the value through to its output. Type745 sets
the downstream flow. Because of the power input, this pump model is particularly useful for direct drive applications in
which a pump is directly connected to an intermittent power source.
TYPE 746: VARIABLE SPEED PUMP, MASS FLOW RATE CALCULATED FROM AVAILABLE POWER,
POWER DRAWN CALCULATED FROM POWER CURVE (new in version 2.0)
Type746 models a pump that sets its outlet mass flow rate based upon user specified available power. It then calculates the
power drawn by the pump using a power curve. Like most pumps and fans in TRNSYS, Type746 takes the inlet mass flow
rate of fluid as an input but does not necessarily pass the value through to its output. Type746 sets the downstream flow.
Because of the power input, this pump model is particularly useful for direct drive applications in which a pump is directly
connected to an intermittent power source.
TYPE 747: CONSTANT SPEED PUMP, MASS FLOW RATE CALCULATED FROM MATCHING SYSTEM
CURVE AND HEAD CURVE (new in version 2.0)
Type747 models a pump whose outlet mass flow rate is based upon a user supplied ON/OFF signal and the intersection point
between a user specified system head curve (polynomial) and a user specified pump head curve (external data file). Like most
pumps and fans in TRNSYS, Type747 takes the inlet mass flow rate of fluid as an input but does not necessarily pass the
value through to its output. Type747 sets the downstream flow based solely upon the pump / system curve intersection point.
TYPE 748: VARIABLE SPEED PUMP, DESIRED MASS FLOW RATE INPUT, MATCH SYSTEM CURVE AND
HEAD CURVE (new in version 2.0)
Type748 models a pump whose outlet mass flow rate is based upon a user supplied ON/OFF signal, a user specified desired
mass flow rate and the intersection point between a user specified system head curve (polynomial) and a series of user
specified pump head curve for various pump speeds (external data file). Like most pumps and fans in TRNSYS, Type748
takes the inlet mass flow rate of fluid as an input but does not necessarily pass the value through to its output. Type748 sets
the downstream flow based solely upon the pump / system curve intersection point.
TYPE 749: VARIABLE SPEED PUMP, POWER INPUT, MATCH SYSTEM CURVE AND HEAD CURVE (new in
version 2.0)
Type749 models a pump whose outlet mass flow rate is based upon a user specified amount of available power and the
intersection point between a user specified system head curve (polynomial) and a series of user specified pump head curve
for various pump speeds (external data file). Like most pumps and fans in TRNSYS, Type749 takes the inlet mass flow rate
22
of fluid as an input but does not necessarily pass the value through to its output. Type749 sets the downstream flow based
solely upon the pump / system curve intersection point.
TYPE 750: VARIABLE SPEED PUMP, FRACTION OF RATED SPEED INPUT, MATCH SYSTEM CURVE AND
HEAD CURVE (new in version 2.0)
Type750 models a variable speed pump whose flow rate is calculated based on the intersection of the pump curve and the
system curve. The user must specify coefficients of the system curve polynomial (head pressure versus flow rate) and must
provide an external data file containing the pump curve (head versus flow rate) at several values of the rotational speed.
Type750 will attempt to find a flow rate that provides the same system head and pump head given the provided fraction of
rated rotational speed. Like most pumps and fans in TRNSYS, Type750 takes the inlet mass flow rate of fluid as an input but
does not necessarily pass the value through to its output. Type750 sets the downstream flow based solely upon the pump /
system curve intersection point.
23
THE LOADS AND STRUCTURES COMPONENT LIBRARY (GENERAL DESCRIPTIONS)
In the second mode, the temperature and humidity are ideally controlled inside the model to maintain user specified set
points. The model then outputs the energies that were required to maintain these set points. This method of control is often
termed energy rate control. See the discussion on energy rate control in the main TRNSYS manual for more details about
this topic.
Type687: NATIONAL FENESTRATION RATING COUNCIL (NFRC) WINDOW (new in version 2.0)
The Type687 model calculates the amount of solar energy and illumination transmitted through a window given only the
basic information available on the National Fenestration Rating Council label of any window commercially available in the
United States.
24
Type693: LOAD IMPOSED ON AN AIR STREAM (new in version 2.0)
Often in simulating an HVAC system, the heating and cooling loads on the building have already been determined, either by
measurement or through the use of another simulation program. This component allows for there to be an interaction between
such precalculated loads and the HVAC system by imposing them upon air flowing through a duct.
Type759: LUMPED CAPACITANCE MULTIZONE BUILDING WITH NO CONTROLS (new in version 2.0)
This subroutine models the temperature and humidity level of a simple building zone subject to infiltration effects, ventilation
effects, skin losses, internal heat and mass gains, and conductive and convective exchanges with adjacent zones. The model
uses two differential equations to solve for the heat and mass balances at each time step. The zone temperature and humidity
are controlled externally through the conditioning of a ventilation flow stream.
25
THE OPTIMIZATION COMPONENT LIBRARY (GENERAL DESCRIPTION)
26
THE SOLAR COMPONENT LIBRARY (GENERAL DESCRIPTIONS)
TYPE 537: FLAT PLATE SOLAR COLLECTOR WITH A VARIABLE SPEED PUMP TO MAINTAIN A
DESIRED OUTLET TEMPERATURE
Type537 models a standard flat plate, quadratic efficiency solar collector based on theoretical equations developed in Solar
Engineering of Thermal Processes. The flat plate collector is assumed to incorporate a variable speed pump and a control
system that adjusts the flow rate of fluid through the collector to maintain a user desired outlet temperature. The model is
equipped with minimum and maximum flow rates for the pump; if the calculated values of these parameters are exceeded, the
temperature of fluid exiting the collector will not be equal to the user requested temperature.
TYPE 539: FLAT PLATE COLLECTOR WITH CAPACITANCE, VS PUMP AND EFF = f (TIN)
This component models a flat plate solar collector which considers capacitance effects and includes an option for a variable
speed pump to keep the outlet temperature at a user-defined value if possible. The collector performance equation is based on
the difference between inlet fluid temperature and ambient temperature.
TYPE 540: FLAT PLATE COLLECTOR WITH CAPACITANCE, VS PUMP AND EFF = f (TAVE)
This component models a flat plate solar collector which considers capacitance effects and includes an option for a variable
speed pump to keep the outlet temperature at a user-defined value if possible. The collector performance equation is based on
the difference between average collector plate temperature and ambient temperature.
27
coefficient for solar collector models that take top loss coefficients as an input (as is the case with the TESS Integral
Collector Storage (ICS) models). The energy balance methodology of this component was developed at the National
Renewable Energy Laboratory.
TYPE 550: TUBULAR INTEGRAL COLLECTOR STORAGE (ICS) SYSTEM (new in version 2.0)
This component is intended to model an integral collector storage system; a solar collector design where the collector and
storage sections of a typical solar domestic hot water system are combined into one unit. The model is intended to be applied
to ICS systems that store fluid in several tubes that are connected in series and placed within a collector enclosure.
TYPE 553: UNGLAZED FLAT PLATE COLLECTOR (EFFICIENCY COEFFICIENT METHOD) (new in version
2.0)
This component models an unglazed flat plate solar collector where the collector efficiency coefficients are known. This
model relies on algorithms supplied by the solar collector text: Solar Engineering of Thermal Processes by Duffie and
Beckman.
TYPE 559: THEORETICAL UNGLAZED FLAT PLATE COLLECTOR (new in version 2.0)
This component models an unglazed flat plate solar collector where the collector efficiency coefficients are calculated from
theoretical models. This model relies on algorithms supplied by the solar collector text: Solar Engineering of Thermal
Processes by Duffie and Beckman.
TYPE 564: THEORETICAL FIN / TUBE SOLAR COLLECTOR (POOL HEATER) (new in version 2.0)
This component models a tube-fin solar collector based on algorithms presented by Duffie and Beckman in chapter 6 of their
book Solar Engineering of Thermal Processes.
TYPE 565: THEORETICAL SERPENTINE TUBE SOLAR COLLECTOR (new in version 2.0)
This component models a serpentine tube-fin solar collector based on algorithms presented by Duffie and Beckman in
chapter 6 of their book Solar Engineering of Thermal Processes.
28
THE STORAGE COMPONENT LIBRARY (GENERAL DESCRIPTIONS)
TYPE 531: RECTANGULAR STORAGE TANK WITH OPTIONAL IMMERSED HEAT EXCHANGERS (new in
version 2.0)
This subroutine models a rectangular cross section fluid-filled, constant volume storage tank with immersed heat exchangers
as shown in Figure 1 below. The fluid in the storage tank interacts with the fluid in the heat exchangers (through heat transfer
with the immersed heat exchangers), with the environment (through thermal losses from the top, bottom and edges) and with
up to two flow streams that pass into and out of the storage tank. The tank is divided into isothermal temperature nodes (to
model stratification observed in storage tanks) where the user controls the degree of stratification through the specification of
the number of “nodes”. Each constant-volume node is assumed to be isothermal and interacts thermally with the nodes above
and below through several mechanisms; fluid conduction between nodes, and through fluid movement (either forced
movement from inlet flow streams or natural destratification mixing due to temperature inversions in the tank). The user has
the ability to specify one of four different immersed heat exchanger types (or no HX if desired); horizontal tube bank, vertical
tube bank, serpentine tube, or coiled tube. Auxiliary heat may be provided to each isothermal node individually; through the
use if INPUTs to the model. The model also considers temperature-dependent fluid properties for either pure water, an
ethylene glycol and water solution, or a propylene glycol and water solution for both the tank and heat exchanger fluids.
TYPE 532: SPHERICAL STORAGE TANK WITH OPTIONAL IMMERSED HEAT EXCHANGERS (new in
version 2.0)
This subroutine models a spherical fluid-filled, constant volume storage tank with immersed heat exchangers as shown in
Figure 1 below. The fluid in the storage tank interacts with the fluid in the heat exchangers (through heat transfer with the
immersed heat exchangers), with the environment (through thermal losses from the top, bottom and edges) and with up to
two flow streams that pass into and out of the storage tank. The tank is divided into isothermal temperature nodes (to model
stratification observed in storage tanks) where the user controls the degree of stratification through the specification of the
number of “nodes.” Each constant-volume node is assumed to be isothermal and interacts thermally with the nodes above and
below through several mechanisms; fluid conduction between nodes, and through fluid movement (either forced movement
from inlet flow streams or natural destratification mixing due to temperature inversions in the tank). The user has the ability
to specify one of four different immersed heat exchanger types (or no HX if desired); horizontal tube bank, vertical tube
bank, serpentine tube, or coiled tube. Auxiliary heat may be provided to each isothermal node individually; through the use if
INPUTs to the model. The model also considers temperature-dependent fluid properties for either pure water, an ethylene
glycol and water solution, or a propylene glycol and water solution for both the tank and heat exchanger fluids.
TYPE 533: HORIZONTALLY CYLINDRICAL STORAGE TANK WITH OPTIONAL IMMERSED HEAT
EXCHANGERS (new in version 2.0)
This subroutine models a fluid-filled, constant volume storage tank with immersed heat exchangers. This component models
a cylindrical tank with a horizontal configuration as shown in Figure 1 below. The fluid in the storage tank interacts with the
fluid in the heat exchangers (through heat transfer with the immersed heat exchangers), with the environment (through
thermal losses from the left end, right end and edges) and with up to two flow streams that pass into and out of the storage
tank. The tank is divided into isothermal temperature nodes (to model stratification observed in storage tanks) where the user
controls the degree of stratification through the specification of the number of “nodes”. Each constant-volume node is
assumed to be isothermal and interacts thermally with the nodes above and below through several mechanisms; fluid
conduction between nodes, and through fluid movement (either forced movement from inlet flow streams or natural
destratification mixing due to temperature inversions in the tank). The user has the ability to specify one of four different
immersed heat exchanger types (or no HX if desired); horizontal tube bank, vertical tube bank, serpentine tube, or coiled
tube. Auxiliary heat may be provided to each isothermal node individually; through the use if INPUTs to the model. The
29
model also considers temperature-dependent fluid properties for either pure water, an ethylene glycol and water solution, or a
propylene glycol and water solution for both the tank and heat exchanger fluids.
TYPE 534: VERTICALLY CYLINDRICAL STORAGE TANK WITH OPTIONAL IMMERSED HEAT
EXCHANGERS (new in version 2.0)
This subroutine models a fluid-filled, constant volume storage tank with immersed heat exchangers. This component models
a cylindrical tank with a vertical configuration as shown in Figure 1 below. The fluid in the storage tank interacts with the
fluid in the heat exchangers (through heat transfer with the immersed heat exchangers), with the environment (through
thermal losses from the top, bottom and edges) and with up to two flow streams that pass into and out of the storage tank.
The tank is divided into isothermal temperature nodes (to model stratification observed in storage tanks) where the user
controls the degree of stratification through the specification of the number of “nodes”. Each constant-volume node is
assumed to be isothermal and interacts thermally with the nodes above and below through several mechanisms; fluid
conduction between nodes, and through fluid movement (either forced movement from inlet flow streams or natural
destratification mixing due to temperature inversions in the tank). The user has the ability to specify one of four different
immersed heat exchanger types (or no HX if desired); horizontal tube bank, vertical tube bank, serpentine tube, or coiled
tube. Auxiliary heat may be provided to each isothermal node individually; through the use if INPUTs to the model. The
model also considers temperature-dependent fluid properties for either pure water, an ethylene glycol and water solution, or a
propylene glycol and water solution for both the tank and heat exchanger fluids.
30
THE UTILITY COMPONENT LIBRARY (GENERAL DESCRIPTIONS)
31
TYPE 578: RANDOM NUMBER GENERATOR DRAWN FROM NORMAL DISTRIBUTION
This model generates a random number drawn from a normal distribution based on user-supplied values of an initial seed,
mean and standard deviation.
32