Merge pull request #10685 from LipingWang/IndoorGreen_Update

Indoor living wall update
NREL · Aug 22, 2024 · a99cc59 · a99cc59 · nrel-bot-2b · Aug 22, 2024
2 parents dd562e2 + 0778549
commit a99cc59
Show file tree

Hide file tree

Showing 4 changed files with 61 additions and 368 deletions.
diff --git a/doc/input-output-reference/src/overview/group-internal-gains-people-lights-other.tex b/doc/input-output-reference/src/overview/group-internal-gains-people-lights-other.tex
@@ -2431,7 +2431,7 @@ \subsubsection{Outputs}\label{outputs-indoorlivingwall}
 \item
   Zone,Average,Indoor Living Wall Evapotranspiration Rate {[}\si{\evapotranspirationRate}{]}
 \item
-  Zone,Average,Indoor Living Wall Energy Required For Evapotranspiration Per Unit Area {[}\si{\watt\per\area}{]}
+  Zone,Average,Indoor Living Wall Energy Rate Required For Evapotranspiration Per Unit Area {[}\si{\watt\per\area}{]}
 \item
   Zone,Average,Indoor Living Wall LED Operational PPFD {[}\si{\umolperAreaperSecond}{]}
 \item
@@ -2446,7 +2446,50 @@ \subsubsection{Outputs}\label{outputs-indoorlivingwall}
   Zone,Sum,Indoor Living Wall LED Electricity Energy {[}J{]}
 \end{itemize}
 
+\paragraph{Indoor Living Wall Plant Surface Temperature {[}C{]}}\label{indoor-living-wall-plant-surface-temperature-c}
 
+This output is the plant surface temperature in C. Plant surface temperature is determined using surface heat balance of indoor living walls. 
+
+\paragraph{Indoor Living Wall Sensible Heat Gain Rate {[}W{]}}\label{indoor-living-wall-sensible-heat-gain-rate-w}
+
+This output is the sensible heat gain rate from indoor living walls in W and determined by surface heat balance. Positive sign represents heat loss from plants or heat gain to indoor space; negative sign represents heat gain to plants or heat loss from indoor space. 
+
+\paragraph{Indoor Living Wall Latent Heat Gain Rate {[}W{]}}\label{indoor-living-wall-latent-heat-gain-rate-w}
+
+This output is the latent heat gain rate from indoor living walls in W. Latent heat gain is determined based on the increase of enthalpy due to the increase of absolute humidity (or humidity ratio) from plant evapotranspiration.
+
+\paragraph{Indoor Living Wall Evapotranspiration Rate {[}\si{\evapotranspirationRate}{]}}\label{indoor-living-wall-evapotranspiration-rate}
+
+This output is evapotranspiration (ET) rate of indoor living walls in \si{\evapotranspirationRate}. The ET rate is directly calculated by ET models(Penman-Monteith model, Stanghellini model or ET model from users).
+
+\paragraph{Indoor Living Wall Energy Rate Required For Evapotranspiration Per Unit Area {[}\si{\watt\per\area}{]}}\label{indoor-living-wall-evapotranspiration-per-unit-area}
+
+This output is energy rate per unit area required for plant evapotranspiration (ET) of indoor living walls in \si{\watt\per\area}. The energy rate per unit area for ET is determined by latent heat of vaporization for total ET over time period and surface area.
+
+\paragraph{Indoor Living Wall LED Operational PPFD {[}\si{\umolperAreaperSecond}{]}}\label{indoor-living-wall-led-operational-ppfd}
+
+This output is operational photosynthetic photon flux density (PPFD) of LED light in \si{\umolperAreaperSecond}. The operational PPFD of LED light is determined based on lighting method. If lighting method is Daylight, the operational LED PPFD is zero. If lighting method is LED, the operational LED PPFD is nominal LED PPFD. If lighting method is LED-Daylight, the operational LED PPFD is calculated based on targeted PPFD and daylighting level with the consideration of nominal LED PPFD. 
+
+\paragraph{Indoor Living Wall PPFD {[}\si{\umolperAreaperSecond}{]}}\label{indoor-living-wall-ppfd}
+
+This output is the actual PPFD including LED and/or daylight for indoor living walls in \si{\umolperAreaperSecond}.
+
+\paragraph{Indoor Living Wall Vapor Pressure Deficit {[}Pa{]}}\label{indoor-living-wall-vpd-pa}
+
+This output is the vapor pressure deficit in Pa. The output represents the difference between saturated vapor pressure and vapor pressure of the moist air of current condition.
+
+\paragraph{Indoor Living Wall LED Sensible Heat Gain Rate {[}W{]}}\label{indoor-living-wall-led-sensible-heat-gain-rate-w}
+
+This output is the LED sensible heat gain rate for indoor living walls in W. The output determines convective heat gain from LED lights when LED lights are on. 
+
+\paragraph{Indoor Living Wall LED Operational Power {[}W{]}}\label{indoor-living-wall-led-operational-power-w}
+
+This output is LED operational power for indoor living walls in W. The LED operational power is determined by LED nominal power in proportion to the ratio of LED operational PPFD to LED nominal PPFD. 
+
+\paragraph{Indoor Living Wall LED Electricity Energy {[}J{]}}\label{indoor-living-wall-led-electricity-energy-j}
+
+This output is LED electricity energy for indoor living walls in J. The LED electricity energy is calculated by LED operational power multiplied by time period. 
+
 \subsection{ElectricEquipment:ITE:AirCooled}\label{electricequipmentiteaircooled}
 
 This object describes air-cooled electric information technology equipment (ITE) which has variable power consumption as a function of loading and temperature.

diff --git a/src/EnergyPlus/IndoorGreen.cc b/src/EnergyPlus/IndoorGreen.cc
@@ -381,7 +381,7 @@ namespace IndoorGreen {
                 state,
                 "Indoor Living Wall Sensible Heat Gain Rate",
                 Constant::Units::W,
-                state.dataHeatBalSurf->SurfQConvInRep(ig.SurfPtr), // positive sign: heat loss from plants; negative sign: heat gain from plants
+                state.dataHeatBalSurf->SurfQConvInRep(ig.SurfPtr), // positive sign: heat loss from plants; negative sign: heat gain to plants
                 OutputProcessor::TimeStepType::Zone,
                 OutputProcessor::StoreType::Average,
                 ig.Name);
@@ -400,7 +400,7 @@ namespace IndoorGreen {
                                 OutputProcessor::StoreType::Average,
                                 ig.Name);
             SetupOutputVariable(state,
-                                "Indoor Living Wall Energy Required For Evapotranspiration Per Unit Area",
+                                "Indoor Living Wall Energy Rate Required For Evapotranspiration Per Unit Area",
                                 Constant::Units::W_m2,
                                 ig.LambdaET,
                                 OutputProcessor::TimeStepType::Zone,
@@ -580,11 +580,14 @@ namespace IndoorGreen {
                 ZoneNewTemp = Twb;
                 ZoneNewHum = ZoneSatHum;
             }
-            HMid = Psychrometrics::PsyHFnTdbW(ZoneNewTemp, ZoneNewHum);
+            HMid = Psychrometrics::PsyHFnTdbW(ZoneNewTemp, ZonePreHum);
             ig.SensibleRate = (1 - ig.LEDRadFraction) * ig.LEDActualEleP; // convective heat gain from LED lights when LED is on; heat convection from
                                                                           // plants was considered and counted from plant surface heat balance.
             ig.LatentRate = ZoneAirVol * rhoair * (HCons - HMid) / Timestep; // unit W
-            state.dataHeatBalSurf->SurfQAdditionalHeatSourceInside(ig.SurfPtr) = -1.0 * ig.LambdaET;
+            state.dataHeatBalSurf->SurfQAdditionalHeatSourceInside(ig.SurfPtr) =
+                -1.0 * ig.LambdaET +
+                ig.LEDRadFraction * 0.9 * ig.LEDActualEleP /
+                    state.dataSurface->Surface(ig.SurfPtr).Area; // assume the energy from radiation for photosynthesis is only 10%.
         }
     }
 

diff --git a/src/Transition/SupportFiles/Report Variables 24-1-0 to 24-2-0.csv b/src/Transition/SupportFiles/Report Variables 24-1-0 to 24-2-0.csv
@@ -1,5 +1,5 @@
 24.1.0,24.2.0,Transition notes - some of these are EMS variable names
-10,10,These numbers should be the number of report variables in the following list (including deletes). Two columns/numbers.
+11,11,These numbers should be the number of report variables in the following list (including deletes). Two columns/numbers.
 Zone Windows Total Transmitted Solar Radiation Rate,Enclosure Windows Total Transmitted Solar Radiation Rate,
 Zone Exterior Windows Total Transmitted Beam Solar Radiation Rate,Enclosure Exterior Windows Total Transmitted Beam Solar Radiation Rate,
 Zone Interior Windows Total Transmitted Beam Solar Radiation Rate,Enclosure Interior Windows Total Transmitted Beam Solar Radiation Rate,
@@ -10,4 +10,5 @@ Zone Exterior Windows Total Transmitted Beam Solar Radiation Energy,Enclosure Ex
 Zone Interior Windows Total Transmitted Beam Solar Radiation Energy,Enclosure Interior Windows Total Transmitted Beam Solar Radiation Energy,
 Zone Exterior Windows Total Transmitted Diffuse Solar Radiation Energy,Enclosure Exterior Windows Total Transmitted Diffuse Solar Radiation Energy,
 Zone Interior Windows Total Transmitted Diffuse Solar Radiation Energy,Enclosure Interior Windows Total Transmitted Diffuse Solar Radiation Energy,
-old variable name,new variable name,-- add variable names (before this line) and leave off units -- <DELETE> to delete
+Indoor Living Wall Energy Required For Evapotranspiration Per Unit Area,Indoor Living Wall Energy Rate Required For Evapotranspiration Per Unit Area,
+old variable name,new variable name,-- add variable names (before this line) and leave off units -- <DELETE> to delete