Add performance support for ASHRAE205 Coils (RS0004)

design/FY2023/NFP-ASHRAE205-Coils.md

@@ -0,0 +1,74 @@
+# ASHRAE 205 Coils
+
+**Tanaya Mankad, Neal Kruis; Big Ladder Software**
+
+## Overview
+
+ASHRAE Standard 205 defines common data models and serialization formats for facility equipment performance data needed for engineering applications such as energy simulation.  The formats allow automated exchange among data sources (manufacturers), simulation models, and other engineering applications. The formats and procedures specified in the standard are developed by SPC (Standard Project Committee) 205 under ASHRAE and ANSI consensus processes. SSPC-205 membership includes equipment manufacturers, application software developers, and engineering practitioners.
+
+The initial edition of the standard was published near the beginning of 2023; an overview can be found at http://data.ashrae.org/standard205/.
+
+205 chillers (RS0001) were added to EnergyPlus in 22.2. In this NFP, we propose to add support for RS0004 (Air-to-Air Direct Expansion Refrigerant System). The current scope of this RS is limited to cooling DX coils, but future adenda will accommodate heating DX coils as well.
+
+## Implementation
+
+ASHRAE 205 coil performance will be indicated through a new object, `Coil:DX:ASHRAE205:Performance`, which will be referenceable from `Coil:Cooling:DX` object (and the future `Coil:Heating:DX` object). The current `Coil:[Cooling]:DX:CurveFit:Performance` object and the new performance object will both derive from a new base class that encapsulates common functionality and isolates the performance calculation. (Making this structural change will ease the transition to a future Coil:Heating:DX:Curvefit:Performance object, should a non-205 performance imlementation ever be desired.)
+
+Standard 205 representations are stored in either human-readable JSON or serialized CBOR (Concise Binary Object Representation) format. libtk205 (Toolkit 205) library will populate the internal EnergyPlus class data.
+
+### Calculations
+
+One of the advantages of ASHRAE Standard 205 is that available equipment operating conditions must be provided as raw performance maps in a representation. These performance maps are straightforward to arrange in a tabular format, which the libtk205 library passes to the same multi-dimensional interpolation engine ([btwxt](https://github.com/bigladder/btwxt)) which is already used in EnergyPlus to calculate performance at different operating conditions. Rather than being extracted from a regression curve, which can produce physically unrealistic results near their boundaries and can fail to capture internal inflections, equipment performance is interpolated within the closest available data to the operating point. The performance calculation will be embedded in the `simulate()` function of the DX coil class.
+
+## Testing
+
+In order to test the new `Coil:DX:ASHRAE205:Performance` object, we will create a new model based on an existing one with `Coil:Cooling:DX:Curvefit:Performance`. A new ASHRAE 205 representation file will be created using performance characteristics from the known model, using its performance curves to back-calculate the tabular parameter and lookup information required by the new representation. We will ensure results between the two files are similar, within reason.
+
+## IDD Changes and Transition
+
+We will add a new object `Coil:DX:ASHRAE205:Performance`.
+
+```
+Coil:DX:ASHRAE205:Performance,
+       \memo DX coil performance specification referencing an ASHRAE Standard 205 compliant representation
+       \memo for air-to-air direct expansion refrigerant system (Representation Specification RS0004). As
+       \memo RS0004 files are intended to support both heating and cooling performance, this object may
+       \memo referenced by the Coil:Cooling:DX and the corresponding Coil:Heating:DX object (planned for
+       \memo future addition).
+       \min-fields 2
+  A1,  \field Name
+       \required-field
+       \type alpha
+       \reference DXCoolingPerformanceNames
+       !\reference DXHeatingPerformanceNames
+  A2,  \field Representation File Name
+       \note The name of the ASHRAE 205 RS0004 (air-to-air direct expansion refrigerant system) representation file
+       \type alpha
+       \retaincase
+       \required-field
+  A3,  \field Performance Interpolation Method
+       \type choice
+       \key Linear
+       \key Cubic
+       \default Linear
+  N1,  \field Rated Total Cooling Capacity
+       \note Not yet implemented / reserved for future use. Full load cooling capacity at AHRI 210/240 "A" test conditions.
+       \note Used to scale representation data.
+       \type real
+       \units W
+       \minimum> 0.0
+       \autosizable
+       \default autosize
+  N2;  \field Rated Steady-State Heating Capacity
+       \note Not yet implemented / reserved for future use. Full load heating capacity at AHRI 210/240 "H1" test conditions.
+       \note Used to scale representation data.
+       \type real
+       \units W
+       \minimum> 0.0
+       \autosizable
+       \default autosize
+```
+
+## Documentation
+
+Much of the content above will be modified to describe the feature in "Input Output Reference", and details of the aggregation calculations in "Engineering Reference".

doc/input-output-reference/src/overview/group-coil-cooling-dx.tex

@@ -6,11 +6,11 @@ \subsection{Coil:Cooling:DX}\label{coilcoolingdx}
 \def\labelenumi{\arabic{enumi}.}
 \item Coil:Cooling:DX - Defines where the coil's evaporator and condenser sections are connected to the HVAC system through node connections to air loops or zones (if condenser section rejects heat to a zone), as well as the coil's availability.
 
-\item Coil:Cooling:DX:CurveFit:Performance - Defines how the coil operates over a range of operating conditions.
+\item Coil:Cooling:DX:CurveFit:Performance or Coil:Cooling:DX:ASHRAE205:Performance - Defines how the coil operates over a range of operating conditions.
 
-\item Coil:Cooling:DX:CurveFit:OperatingMode - Defines the rated coil characteristics (capacity, evaporator section air flow rate, etc.) and capacity control method for a given operating mode. Operating modes are generally used to describe humidity control strategies for DX cooling coil arrangements that enable enhanced dehumidification.
+\item Coil:Cooling:DX:CurveFit:OperatingMode (CurveFit only) - Defines the rated coil characteristics (capacity, evaporator section air flow rate, etc.) and capacity control method for a given operating mode. Operating modes are generally used to describe humidity control strategies for DX cooling coil arrangements that enable enhanced dehumidification.
 
-\item Coil:Cooling:DX:CurveFit:Speed - Defines DX cooling coil performance for a specific speed within a single operating mode.
+\item Coil:Cooling:DX:CurveFit:Speed  (CurveFit only) - Defines DX cooling coil performance for a specific speed within a single operating mode.
 \end{enumerate}
 Note: The Coil:Cooling:DX:CurveFit:Performance object also allows users to input 3 operating modes: Base Operating Mode, Alternative Operating Mode 1, and Alternative Operating Mode 2. When the Base Operating Mode is an only mode input, the coil performs like a regular cooling DX coil and no specific dehumidification capability. The alternative operating mode 1 is used for enhanced dehumidification. When all 3 modes are inputs, the coil performs as a subcool reheat coil. When load sensible heat ratio (SHR), defined as sensible cooling load / (sensible cooling load + latent cooling load), is greater than the SHR in the Base Operating Mode at given inlet air conditions, the coil performs in Base Operating Mode only. When the load SHR is less than the SHR in the Base Operating Mode and greater than the SHR in the Alternative Operating Mode 1 at the same given inlet air conditions, the coil performs combination of both Base Operating Mode, and Alternative Operating Mode 1. Mode ratio determines a fraction of time Alternative Operating Mode 1 operates and the rest (1 - Mode ratio) of time Base Operating Mode operates in a single time step. When the load SHR is less than the SHR in the Alternative Operating Mode 1 and greater than the SHR in the Alternative Operating Mode 2 at the same given inlet air conditions, the coil performs combination of both Base Operating Mode, and Alternative Operating Mode 2. Mode ratio determines a fraction of time Alternative Operating Mode 2 operates and (1 - Mode ratio) of time Base Operating Mode operates in a single time step.  When the load SHR is greater than the SHR in the Alternative Operating Mode 2, the coil performs as Alternative Operating Mode 2 alone.   
 
@@ -54,7 +54,7 @@ \subsubsection{Inputs}\label{inputs-01}
 
 \paragraph{Field: Performance Object Name}\label{field-performance-object-name-6-001}
 
-The name of the Coil:Cooling:DX:CurveFit:Performance object that defines this coil's performance specifications.
+The name of the Coil:Cooling:DX:CurveFit:Performance or Coil:Cooling:DX:ASHRAE205:Performance object that defines this coil's performance specifications.
 
 \paragraph{Field: Condensate Collection Water Storage Tank Name}
 
@@ -64,6 +64,33 @@ \subsubsection{Inputs}\label{inputs-01}
 
 This field is optional. It is used to describe where the coil obtains water used for evaporative cooling of its condenser. If blank or omitted, then the unit will obtain water directly from the mains. If the name of a WaterUse:Storage object is used here, then the unit will obtain its water from that tank. If a tank is specified, the unit will attempt to obtain all the water it uses from the tank. However, if the tank cannot provide all the water the condenser needs, then the unit will still operate and obtain the rest of the water it needs from the mains (referred to as StarvedWater).
 
+\subsection{Coil:Cooling:DX:ASHRAE205:Performance}\label{coilcoolingdxashrae205performance}
+
+This object defines basic unit control and ASHRAE205 representation file for one Coil:Cooling:DX object. 
+
+\subsubsection{Inputs}
+
+\paragraph{Field: Name}
+
+A unique user-assigned name for an instance of a cooling coil performance specification. Any reference to this cooling coil performance specification by a cooling coil object will use this name.
+
+\paragraph{Field: Representation File Name}
+
+The filename of the ASHRAE205 chiller representation (.json or .cbor).
+
+\paragraph{Field: Performance Interpolation Method}
+
+This alpha field specifies how performance data from the Representation File will be interpolated.
+Choices are "Linear" and "Cubic."
+
+\paragraph{Field: Rated Total Cooling Capacity}
+
+Not yet implemented / reserved for future use. Full load cooling capacity at AHRI 210/240 "A" test conditions.
+
+\paragraph{Field: Rated Steady-State Heating Capacity}
+
+Not yet implemented / reserved for future use. Full load heating capacity at AHRI 210/240 "H1" test conditions.
+
 \subsection{Coil:Cooling:DX:CurveFit:Performance}\label{coilcoolingdxcurvefitperformance}
 
 This object defines basic unit control and other characteristics for one Coil:Cooling:DX object. For that Coil:Cooling:DX object, it also references one or more operating modes, which are defined using the Coil:Cooling:DX:CurveFit:OperatingMode object.

idd/Energy+.idd.in

@@ -52325,6 +52325,44 @@ Coil:Cooling:DX:CurveFit:Speed,
        \type object-list
        \object-list UnivariateFunctions
 
+Coil:DX:ASHRAE205:Performance,
+       \memo DX coil performance specification referencing an ASHRAE Standard 205 compliant representation
+       \memo for air-to-air direct expansion refrigerant system (Representation Specification RS0004). As
+       \memo RS0004 files are intended to support both heating and cooling performance, this object may
+       \memo referenced by the Coil:Cooling:DX and the corresponding Coil:Heating:DX object (planned for
+       \memo future addition).
+       \min-fields 2
+  A1,  \field Name
+       \required-field
+       \type alpha
+       \reference DXCoolingPerformanceNames
+  A2,  \field Representation File Name
+       \note The name of the ASHRAE 205 RS0004 (air-to-air direct expansion refrigerant system) representation file
+       \type alpha
+       \retaincase
+       \required-field
+  A3,  \field Performance Interpolation Method
+       \type choice
+       \key Linear
+       \key Cubic
+       \default Linear
+  N1,  \field Rated Total Cooling Capacity
+       \note Not yet implemented / reserved for future use. Full load cooling capacity at AHRI 210/240 "A" test conditions.
+       \note Used to scale representation data.
+       \type real
+       \units W
+       \minimum> 0.0
+       \autosizable
+       \default autosize
+  N2;  \field Rated Steady-State Heating Capacity
+       \note Not yet implemented / reserved for future use. Full load heating capacity at AHRI 210/240 "H1" test conditions.
+       \note Used to scale representation data.
+       \type real
+       \units W
+       \minimum> 0.0
+       \autosizable
+       \default autosize
+
 Coil:Cooling:DX:SingleSpeed,
        \memo Direct expansion (DX) cooling coil and condensing unit (includes electric compressor
        \memo and condenser fan), single-speed. Optional inputs for moisture evaporation from wet

src/EnergyPlus/CMakeLists.txt

@@ -1,3 +1,4 @@
+
 if(WIN32)
   configure_file(energyplus.rc.in "${CMAKE_CURRENT_BINARY_DIR}/energyplus.rc")
   configure_file(energyplusapi.rc.in "${CMAKE_CURRENT_BINARY_DIR}/energyplusapi.rc")
@@ -134,6 +135,8 @@ set(SRC
     Coils/CoilCoolingDXCurveFitOperatingMode.hh
     Coils/CoilCoolingDXCurveFitPerformance.cc
     Coils/CoilCoolingDXCurveFitPerformance.hh
+    Coils/CoilCoolingDXAshrae205Performance.cc
+    Coils/CoilCoolingDXAshrae205Performance.hh
     Coils/CoilCoolingDXCurveFitSpeed.cc
     Coils/CoilCoolingDXCurveFitSpeed.hh
     CondenserLoopTowers.cc