Documentation Issues - 2020a

[mitchute]

Issue overview

A collection of small documentation issues. See checkboxed comments below.

[mitchute]

Moved from #7026

• [ ] The organization of groups in the IOref does not always match the arrangement in the IDD! - Probably won't fix, ever. MJW
• [ ] The IDD group Natural Ventilation and Duct Leakage is shown in the IOref as AirflowNetwork - Will do the opposite at some point, rename the IDD group. MJW
• [x] The IDD has Water Heaters and Thermal Storage group that includes thermal storage objects but they are described in the IOref under Plant Equipment
• [x] The IDD has Zone HVAC Air Loop Terminal Units group but in the IOref it is called Air Distribution Equipment
• [x] The IDD has one group called Humdifiers and Dehumidifiers but the IOref has two separate groups called Humidifiers and another called Desiccant Dehumidifiers

[jasondegraw]

• [x] @mitchute I'd personally prefer that the IDD group "Natural Ventilation and Duct Leakage" be changed to "AirflowNetwork" rather than the other way around. Also, are IDD groups going to be around in the epJSON future?

2021.06.09 (RKS) This seems to be taken care of already.

[mitchute]

• [x] Minor typo here.

Wh/m2 should be W/m2.

[mitchute]

• [x] I/O Ref. in CentralHeatPumpSystem. Field: Control Method should be taken out of the \paragraph{} See source here.

[mitchute]

• [x] minor typo in units. See here

[mldichter]

• [x] The documentation for the Coil:Cooling:WaterToAirHeatPump:EquationFit in the 9.2 IO Ref is lacking for the performance coefficient fields. Looks like the Engineering Reference has an explanation of the Total Cooling Capacity Coefficients and Sensible Cooling Capacity Coefficients, but not the Cooling Power Consumption Coefficients.

The documentation for the Coil:Heating:WaterToAirHeatPump:EquationFit is similarly lacking in the IO Ref, but the Engineering reference discusses neither the Heating Capacity Coefficients nor Heating Power Consumption Coefficients.

I'm pretty sure these objects are from this thesis paper at this link around page 49. Can anyone confirm?

EDIT: I think I found the description of the curves in this file, which can be used for updating the IO Ref. https://github.com/NREL/EnergyPlus/blob/develop/src/EnergyPlus/WaterToAirHeatPumpSimple.cc

Real64 const Tref(283.15); // Reference Temperature for performance curves,10C [K]
CelsiustoKelvin = 273.15

ratioTDB = ((LoadSideInletDBTemp + CelsiustoKelvin) / Tref);
ratioTWB = ((LoadSideInletWBTemp + CelsiustoKelvin) / Tref);
ratioTS = ((SourceSideInletTemp + CelsiustoKelvin) / Tref);
ratioVL = (LoadSideMassFlowRate /(AirVolFlowRateRated * PsyRhoAirFnPbTdbW(StdBaroPress, LoadSideInletDBTemp, LoadSideInletHumRat, RoutineName)));
ratioVS = (SourceSideMassFlowRate) / (SimpleWatertoAirHP(HPNum).DesignWaterMassFlowRate);

Coil:Cooling:WaterToAirHeatPump:EquationFit
TotalCapCoeff1 + (ratioTWB * TotalCapCoeff2) + (ratioTS * TotalCapCoeff3) + (ratioVL * TotalCapCoeff4) + (ratioVS * TotalCapCoeff5)
SensCapCoeff1 + (ratioTDB * SensCapCoeff2) + (ratioTWB * SensCapCoeff3) + (ratioTS * SensCapCoeff4) + (ratioVL * SensCapCoeff5) + (ratioVS * SensCapCoeff6)
CoolPowerCoeff1 + (ratioTWB * CoolPowerCoeff2) + (ratioTS * CoolPowerCoeff3) + (ratioVL * CoolPowerCoeff4) + (ratioVS * CoolPowerCoeff5)

Coil:Heating:WaterToAirHeatPump:EquationFit
HeatCapCoeff1 + (ratioTDB * HeatCapCoeff2) + (ratioTS * HeatCapCoeff3) + (ratioVL * HeatCapCoeff4) + (ratioVS * HeatCapCoeff5)
HeatPowerCoeff1 + (ratioTDB * HeatPowerCoeff2) + (ratioTS * HeatPowerCoeff3) + (ratioVL * HeatPowerCoeff4) + (ratioVS * HeatPowerCoeff5)

[jmythms]

• [x] The documentation for the Coil:Cooling:WaterToAirHeatPump:EquationFit in the 9.2 IO Ref is lacking for the performance coefficient fields. Looks like the Engineering Reference has an explanation of the Total Cooling Capacity Coefficients and Sensible Cooling Capacity Coefficients, but not the Cooling Power Consumption Coefficients.

The documentation for the Coil:Heating:WaterToAirHeatPump:EquationFit is similarly lacking in the IO Ref, but the Engineering reference discusses neither the Heating Capacity Coefficients nor Heating Power Consumption Coefficients.

I'm pretty sure these objects are from this thesis paper at this link around page 49. Can anyone confirm?

EDIT: I think I found the description of the curves in this file, which can be used for updating the IO Ref. https://github.com/NREL/EnergyPlus/blob/develop/src/EnergyPlus/WaterToAirHeatPumpSimple.cc

Real64 const Tref(283.15); // Reference Temperature for performance curves,10C [K]
CelsiustoKelvin = 273.15

ratioTDB = ((LoadSideInletDBTemp + CelsiustoKelvin) / Tref);
ratioTWB = ((LoadSideInletWBTemp + CelsiustoKelvin) / Tref);
ratioTS = ((SourceSideInletTemp + CelsiustoKelvin) / Tref);
ratioVL = (LoadSideMassFlowRate /(AirVolFlowRateRated * PsyRhoAirFnPbTdbW(StdBaroPress, LoadSideInletDBTemp, LoadSideInletHumRat, RoutineName)));
ratioVS = (SourceSideMassFlowRate) / (SimpleWatertoAirHP(HPNum).DesignWaterMassFlowRate);

Coil:Cooling:WaterToAirHeatPump:EquationFit
TotalCapCoeff1 + (ratioTWB * TotalCapCoeff2) + (ratioTS * TotalCapCoeff3) + (ratioVL * TotalCapCoeff4) + (ratioVS * TotalCapCoeff5)
SensCapCoeff1 + (ratioTDB * SensCapCoeff2) + (ratioTWB * SensCapCoeff3) + (ratioTS * SensCapCoeff4) + (ratioVL * SensCapCoeff5) + (ratioVS * SensCapCoeff6)
CoolPowerCoeff1 + (ratioTWB * CoolPowerCoeff2) + (ratioTS * CoolPowerCoeff3) + (ratioVL * CoolPowerCoeff4) + (ratioVS * CoolPowerCoeff5)

Coil:Heating:WaterToAirHeatPump:EquationFit
HeatCapCoeff1 + (ratioTDB * HeatCapCoeff2) + (ratioTS * HeatCapCoeff3) + (ratioVL * HeatCapCoeff4) + (ratioVS * HeatCapCoeff5)
HeatPowerCoeff1 + (ratioTDB * HeatPowerCoeff2) + (ratioTS * HeatPowerCoeff3) + (ratioVL * HeatPowerCoeff4) + (ratioVS * HeatPowerCoeff5)

It's not very obvious, but the water-to-air heat pump cooling and heating coil equations and coefficients are explained in the engineering reference here. Updating the IO Reference with these references. Thanks @mjwitte