Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

PMV follow up #8561

Merged
merged 15 commits into from
Mar 1, 2021
Merged

PMV follow up #8561

Show file tree
Hide file tree
Changes from 13 commits
Commits
Show all changes
15 commits
Select commit Hold shift + click to select a range
379db08
merge
xuanluo113 Dec 6, 2020
c1edf1d
Merge branch 'develop' of https://github.com/NREL/EnergyPlus into dev…
xuanluo113 Dec 12, 2020
e2f9130
Merge branch 'develop' of https://github.com/NREL/EnergyPlus into dev…
xuanluo113 Dec 16, 2020
121120f
Merge branch 'develop' of https://github.com/NREL/EnergyPlus into dev…
xuanluo113 Jan 8, 2021
c72d3fa
merge
xuanluo113 Jan 20, 2021
684e4c7
merge
xuanluo113 Feb 19, 2021
b8b445b
Merge branch 'develop' of https://github.com/NREL/EnergyPlus into dev…
xuanluo113 Feb 20, 2021
5d7f14c
Merge branch 'develop' of https://github.com/NREL/EnergyPlus into dev…
xuanluo113 Feb 24, 2021
034c0f8
address comments
xuanluo113 Feb 24, 2021
c9f020e
address comments part 2
xuanluo113 Feb 25, 2021
d6b4472
more documents
xuanluo113 Feb 25, 2021
24267ce
cmake
xuanluo113 Feb 25, 2021
c653eb7
fix a document
xuanluo113 Feb 25, 2021
0f4ff6e
Merge branch 'develop' of https://github.com/NREL/EnergyPlus into pmv…
xuanluo113 Mar 1, 2021
55c3309
address more comments
xuanluo113 Mar 1, 2021
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion doc/engineering-reference/CMakeLists.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -533,6 +533,7 @@ set(INCLUDED_IMAGES
${PROJECT_SOURCE_DIR}/engineering-reference/media/IdealLoadsSchematic.png
${PROJECT_SOURCE_DIR}/engineering-reference/media/humidex_chart.jpg
${PROJECT_SOURCE_DIR}/engineering-reference/media/heat_index_chart.png
${PROJECT_SOURCE_DIR}/engineering-reference/media/heatemission.png)
${PROJECT_SOURCE_DIR}/engineering-reference/media/heatemission.png
${PROJECT_SOURCE_DIR}/engineering-reference/media/ankle_draft.png)

create_doc_target("engineering-reference" "EngineeringReference")
Binary file added doc/engineering-reference/media/ankle_draft.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
16 changes: 13 additions & 3 deletions ...g-reference/src/simulation-models-encyclopedic-reference-005/occupant-thermal-comfort.tex
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1165,11 +1165,11 @@ \subsubsection{Description of the model and algorithm}\label{description-of-the-

\subsection{ASHRAE 55 Elevated Air Speed Cooling Effect Model}\label{elevated-air-speed-ce-model}

ASHRAE Standard 55-2017 Section 5.3 requires that the Elevated Air Speed Comfort Zone Method be used when average air speed Va is greater than 0.10 m/s. The method provides cooling credit for elevated air velocity in the space. The method can be used to evaluate passive cooling technologies such as natural ventilation, ceiling fan, and portable fan.
ASHRAE Standard 55-2017 Section 5.3 requires that the Elevated Air Speed Comfort Zone Method be used when average air speed \(V_{a}\) is greater than 0.10 m/s. The method provides cooling credit for elevated air velocity in the space. The method can be used to evaluate passive cooling technologies such as natural ventilation, ceiling fan, and portable fan.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Very minor question. Here Va is upper case for air speed, but the other air speeds below are all lower-case v. Is that intentional?


\subsubsection{Description of the model and algorithm}\label{description-of-the-model-and-algorithm-4}

The Pierce Two-Node Standard Effective Temperature (SET) model is used to account for the cooling effect of air speeds greater than the 0.10 m/s. Specifically, for a given set of environmental and personal variables, including an elevated average air speed, an average air temperature \(t_{a}\), and a mean radiant temperature \(t_{r}\), the SET is first calculated. Then the average air speed Va is replaced by still air (0.1 m/s), and the average air temperature and radiant temperature are adjusted according to the cooling effect (CE). The CE of the elevated air speed is the value that, when subtracted equally from both the average air temperature and the mean radiant temperature, yields the same SET under still air as in the first SET calculation under elevated air speed.
The Pierce Two-Node Standard Effective Temperature (SET) model is used to account for the cooling effect of air speeds greater than the 0.10 m/s. Specifically, for a given set of environmental and personal variables, including an elevated average air speed, an average air temperature \(t_{a}\), and a mean radiant temperature \(t_{r}\), the SET is first calculated. Then the average air speed \(V_{a}\) is replaced by still air (0.1 m/s), and the average air temperature and radiant temperature are adjusted according to the cooling effect (CE). The CE of the elevated air speed is the value that, when subtracted equally from both the average air temperature and the mean radiant temperature, yields the same SET under still air as in the first SET calculation under elevated air speed.

The following is a formal description of this process. To define the CE, we assert that it satisfies the following:

Expand Down Expand Up @@ -1215,7 +1215,15 @@ \subsubsection{Description of the model and algorithm}\label{description-of-the-

Where \(v_{r}\) is the relative air velocity caused by body movement, and \(v_{ankle}\) is the air speed at 0.1 m above the floor.

This equation is only applicable for \(v_{r} < 0.2 m/s\) . And the subject’s metabolic rate and clothing level should be kept below 1.3 met and 0.7 clo, respectively. Warnings would be thrown if these conditions are not met.
This equation is only applicable for \(v_{r} < 0.2 m/s\) . And the subject’s metabolic rate and clothing level should be kept below 1.3 met and 0.7 clo, respectively. PPD at ankle draft will be set to -1.0 if if these conditions are not met.

It should be noted that the metrics only measures the predicted percentage dissatisfied on the sensation of draft. \(PPD_{AD}\) levels at various air speeds and thermal sensations are depicted in Figure~\ref{fig:ankle-draft-ppd}

\begin{figure}[hbtp]
\centering
\includegraphics[width=0.9\textwidth, height=0.9\textheight, keepaspectratio=true]{media/ankle_draft.png}
\caption{Ankle Draft PPD Levels \protect \label{fig:ankle-draft-ppd}}
\end{figure}

\subsection{References}\label{references-1-012}

Expand Down Expand Up @@ -1256,3 +1264,5 @@ \subsection{References}\label{references-1-012}
Int-Hout, D. 1990. ``Thermal Comfort Calculation / A Computer Model'', ASHRAE Trans., Vol.96, Pt 1.

ISO. 1983. ``Determination of the PMV and PPD Indices and Specification of the Conditions for Thermal Comfort'', DIS 7730, Moderate Thermal Environment, 1983.

Liu S., Schiavon S., Kabanshi A., Nazaroff W.W. 2017. \"Predicted percentage dissatisfied with ankle draft\", Indoor Air, Vol.27.
46 changes: 45 additions & 1 deletion doc/input-output-reference/src/overview/group-internal-gains-people-lights-other.tex
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -199,7 +199,35 @@ \subsubsection{Inputs}\label{inputs-025}

\paragraph{Field: Thermal Comfort Model Type (up to 7 allowed)}\label{field-thermal-comfort-model-type-up-to-7-allowed}

The final one to five fields are optional and are intended to trigger various thermal comfort models within EnergyPlus. By entering the keywords Fanger, Pierce, KSU, AdaptiveASH55, AdaptiveCEN15251, CoolingEffectASH55, and AnkleDraftASH55, the user can request the Fanger, Pierce Two-Node, Kansas State UniversityTwo-Node, the adaptive comfort models of the ASHRAE Standard 55 and CEN Standard 15251, ASHRAE Standard 55 Elevated Air Cooling Effect model, and ASHRAE Standard 55 Ankle Draft Risk model results for this particular people statement. AdaptiveASH55 is only applicable when the running average outdoor air temperature for the past 7 days is between 10.0 and 33.5C. AdaptiveCEN15251 is only applicable when the running average outdoor air temperature for the past 30 days is between 10.0 and 30.0C. Note that since up to five models may be specified, the user may opt to have EnergyPlus calculate the thermal comfort for people identified with this people statement using all five models if desired. Note that the KSU model is computationally intensive and may noticeably increase the execution time of the simulation. For descriptions of the thermal comfort calculations, see the Engineering Reference document.
The final one to five fields are optional and are intended to trigger various thermal comfort models within EnergyPlus. By entering the keywords Fanger, Pierce, KSU, AdaptiveASH55, AdaptiveCEN15251, CoolingEffectASH55, and AnkleDraftASH55, the user can request the Fanger, Pierce Two-Node, Kansas State UniversityTwo-Node, the adaptive comfort models of the ASHRAE Standard 55 and CEN Standard 15251, ASHRAE Standard 55 Elevated Air Cooling Effect model, and ASHRAE Standard 55 Ankle Draft Risk model results for this particular people statement. Detailed descriptions and requirements of the seven models as listed below.

\begin{description}
\item[Fanger]
Fanger’s Comfort model is applied to calculate related thermal comfort metrics. Fanger Model PMV, PPD, and Clothing Surface Temperature are calculated and reported as each time step. Apart from existing required fields in People object, extra fields required for this model include Surface Name/Angle Factor List Name, Work Efficiency Schedule Name, Clothing Insulation Schedule Name, and Air Velocity Schedule Name.

\item[Pierce]
The Pierce Two-Node model is applied to calculate related thermal comfort metrics. Pierce Model Effective Temperature PMV, Standard Effective Temperature PMV, Discomfort Index, Thermal Sensation Index, and Standard Effective Temperature are calculated and reported as each time step.Apart from existing required fields in People object, extra fields required for this model include Surface Name/Angle Factor List Name, Work Efficiency Schedule Name, Clothing Insulation Schedule Name, and Air Velocity Schedule Name.

\item[KSU]
The KSU Two-Node Model is applied to calculate related thermal comfort metrics. KSU Model Thermal Sensation Vote is calculated and reported as each time step. Note that the KSU model is computationally intensive and may noticeably increase the execution time of the simulation. Apart from existing required fields in People object, extra fields required for this model include Surface Name/Angle Factor List Name, Work Efficiency Schedule Name, Clothing Insulation Schedule Name, and Air Velocity Schedule Name.

\item[AdaptiveASH55]
Adaptive Comfort Model Based on ASHRAE Standard 55-2010 is applied to calculate related thermal comfort metrics. ASHRAE 55 Adaptive Model 90\% Acceptability Status, 80\% Acceptability Status, Running Average Outdoor Air Temperature, and the Adaptive Model Temperature are calculated and reported as each time step. AdaptiveASH55 is only applicable when the running average outdoor air temperature for the past 7 days is between 10.0 and 33.5C.

\item[AdaptiveCEN15251]
Adaptive Comfort Model Based on European Standard EN15251-2007 is applied to calculate related thermal comfort metrics. CEN 15251 Adaptive Model Category I/II/II Status, Running Average Outdoor Air Temperature, and the Adaptive Model Temperature are calculated and reported as each time step. AdaptiveCEN15251 is only applicable when the running average outdoor air temperature for the past 30 days is between 10.0 and 30.0C.

\item[CoolingEffectASH55]
ASHRAE 55-2017 Elevated Air Speed Cooling Effect Model is applied to calculate related thermal comfort metrics. Elevated Air Speed Cooling Effect, Cooling Effect Adjusted PMV, and Cooling Effect Adjusted PPD are calculated and reported as each time step. Apart from existing required fields in People object, extra fields required for this model include Surface Name/Angle Factor List Name, Work Efficiency Schedule Name, Clothing Insulation Schedule Name, and Air Velocity Schedule Name.

\item[AnkleDraftASH55]
ASHRAE 55-2017 Ankle Draft Risk Model is applied to calculate related thermal comfort metrics. Zone Thermal Comfort ASHRAE 55 Ankle Draft PPD is calculated and reported as each time step. Apart from existing required fields in People object, extra fields required for this model include Surface Name/Angle Factor List Name, Work Efficiency Schedule Name, Clothing Insulation Schedule Name, Air Velocity Schedule Name, and Ankle Level Air Velocity Schedule Name. Ankle draft PPD calculations are only applicable for relative air velocity is below 0.2 m/s, and the subject’s metabolic rate and clothing level should be kept below 1.3 met and 0.7 clo. PPD at ankle draft will be set to -1.0 if if these conditions are not met.

\end{description}

For descriptions of the thermal comfort calculations, see the Engineering Reference document.

Note that since up to seven models may be specified, the user may opt to have EnergyPlus calculate the thermal comfort for people identified with this people statement using all seven models if desired.


\paragraph{Field: Ankle Level Air Velocity Schedule Name}\label{field-ankle-level-air-velocity-schedule-name}
Expand Down Expand Up @@ -560,6 +588,22 @@ \subsubsection{Outputs}\label{outputs-017}

This field reports the ideal indoor operative temperature, or comfort temperature, as determined by the CEN-15251 adaptive comfort model. Category I, II, and II limits for indoor operative temperature are defined as no greater than 2, 3, and 4 degrees C from this value respectively. A value of -1 means not applicable (when running average outdoor temp is outside the range of 10.0 to 30.0C).

\paragraph{Zone Thermal Comfort ASHRAE 55 Elevated Air Speed Cooling Effect}\label{zone-thermal-comfort-ashrae55-elevated-air-speed-cooling-effect}

This field is the calculated Cooling Effect of the elevated air speed in degree celsius. It is the value that, when subtracted equally from both the average air temperature and the mean radiant temperature, yields the same SET under still air as in the first SET calculation under elevated air speed.

\paragraph{Zone Thermal Comfort ASHRAE 55 Elevated Air Speed Cooling Effect Adjusted PMV}\label{zone-thermal-comfort-ashrae55-elevated-air-speed-cooling-effect-adjusted-pmv}

This field is the \"predicted mean vote\" (PMV) calculated using the Fanger PMV model, adjusted by the ASHRAE 55 Elevated Air Speed Cooling Effect. The Cooling Effect adjusted PMV for an environment with elevated average air speed is calculated using the adjusted average air temperature, the adjusted radiant temperature, and still air (0.1 m/s).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

predicted is rendering as p̈redicted . Use the smart-quote characters (see existing entries further up): ``predicted mean vote'' (2 characters before and after). Same problem in the next two descriptions.


\paragraph{Zone Thermal Comfort ASHRAE 55 Elevated Air Speed Cooling Effect Adjusted PPD}\label{zone-thermal-comfort-ashrae55-elevated-air-speed-cooling-effect-adjusted-ppd}

This field is the \"ppredicted percentage of dissatisfied\" (PPD) calculated using the Fanger PMV-PPD model, adjusted by the ASHRAE 55 Elevated Air Speed Cooling Effect. The Cooling Effect adjusted PPD for an environment with elevated average air speed is calculated using the adjusted average air temperature, the adjusted radiant temperature, and still air (0.1 m/s).

\paragraph{Zone Thermal Comfort ASHRAE 55 Ankle Draft PPD}\label{zone-thermal-comfort-ashrae55-ankle-draft-ppd}

This field is the \"ppredicted percentage of dissatisfied\" (PPD) on draft at ankle level. It is used as the metric to evaluate the ankle draft risk as a function of PMV and air speed at the ankle level (0.1 m).

\subsubsection{Outputs}\label{outputs-1-014}

The following output variables are all based on whether the humidity ratio and the operative temperature is within the region shown in ASHRAE Standard 55-2004 in Figure 5.2.1.1. For these outputs the operative temperature is simplified to be the average of the air temperature and the mean radiant temperature. For summer, the 0.5 Clo level is used and, for winter, the 1.0 Clo level is used. The graphs below are based on the following tables which extend the ASHRAE values to zero humidity ratio.
Expand Down
19 changes: 11 additions & 8 deletions src/EnergyPlus/InternalHeatGains.cc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -867,7 +867,8 @@ namespace InternalHeatGains {
} else if (ModelWithAdditionalInputs) {
if (Item1 == 1) {
ShowSevereError(state, RoutineName + CurrentModuleObject + "=\"" + AlphaName(1) + "\", blank " + cAlphaFieldNames(9) +
" is required for this item.");
". " + cAlphaFieldNames(9) + " is required when Thermal Comfort Model Type is one of "
"\"Fanger\", \"Pierce\", \"KSU\", \"CoolingEffectASH55\" or \"AnkleDraftASH55\"" );
ErrorsFound = true;
}
}
Expand All @@ -881,7 +882,7 @@ namespace InternalHeatGains {
if (People(Loop).ClothingPtr == 0 && ModelWithAdditionalInputs) {
if (Item1 == 1) {
ShowSevereError(state, RoutineName + CurrentModuleObject + "=\"" + AlphaName(1) + "\", invalid " +
cAlphaFieldNames(12) + " entered=" + AlphaName(12));
cAlphaFieldNames(12) + " entered=\"" + AlphaName(12) + "\".");
ErrorsFound = true;
}
} else { // check min/max on schedule
Expand Down Expand Up @@ -933,7 +934,7 @@ namespace InternalHeatGains {
if (People(Loop).ClothingMethodPtr == 0) {
if (Item1 == 1) {
ShowSevereError(state, RoutineName + CurrentModuleObject + "=\"" + AlphaName(1) + "\", invalid " +
cAlphaFieldNames(11) + " entered=" + AlphaName(11));
cAlphaFieldNames(11) + " entered=\"" + AlphaName(11) + "\".");
ErrorsFound = true;
}
}
Expand All @@ -942,7 +943,7 @@ namespace InternalHeatGains {
if (People(Loop).ClothingPtr == 0) {
if (Item1 == 1) {
ShowSevereError(state, RoutineName + CurrentModuleObject + "=\"" + AlphaName(1) + "\", invalid " +
cAlphaFieldNames(12) + " entered=" + AlphaName(12));
cAlphaFieldNames(12) + " entered=\"" + AlphaName(12) + "\".");
ErrorsFound = true;
}
}
Expand All @@ -963,7 +964,7 @@ namespace InternalHeatGains {
if (People(Loop).AirVelocityPtr == 0) {
if (Item1 == 1) {
ShowSevereError(state, RoutineName + CurrentModuleObject + "=\"" + AlphaName(1) + "\", invalid " +
cAlphaFieldNames(13) + " entered=" + AlphaName(13));
cAlphaFieldNames(13) + " entered=\"" + AlphaName(13) + "\".");
ErrorsFound = true;
}
} else { // check min/max on schedule
Expand Down Expand Up @@ -995,7 +996,8 @@ namespace InternalHeatGains {
} else if (ModelWithAdditionalInputs) {
if (Item1 == 1) {
ShowSevereError(state, RoutineName + CurrentModuleObject + "=\"" + AlphaName(1) + "\", blank " + cAlphaFieldNames(13) +
" is required for this item.");
". " + cAlphaFieldNames(13) + " is required when Thermal Comfort Model Type is one of "
"\"Fanger\", \"Pierce\", \"KSU\", \"CoolingEffectASH55\" or \"AnkleDraftASH55\"");
ErrorsFound = true;
}
}
Expand All @@ -1006,14 +1008,15 @@ namespace InternalHeatGains {
if (People(Loop).AnkleAirVelocityPtr == 0) {
if (Item1 == 1) {
ShowSevereError(state, RoutineName + CurrentModuleObject + "=\"" + AlphaName(1) + "\", invalid " +
cAlphaFieldNames(indexAnkleAirVelPtr) + " entered=" + AlphaName(indexAnkleAirVelPtr));
cAlphaFieldNames(indexAnkleAirVelPtr) + " entered=\"" + AlphaName(indexAnkleAirVelPtr) + "\".");
ErrorsFound = true;
}
}
} else if (People(Loop).AnkleDraftASH55) {
if (Item1 == 1) {
ShowSevereError(state, RoutineName + CurrentModuleObject + "=\"" + AlphaName(1) + "\", blank " + cAlphaFieldNames(indexAnkleAirVelPtr) +
" is required for this item.");
". " + cAlphaFieldNames(indexAnkleAirVelPtr) + " is required when Thermal Comfort Model Type is one of "
"\"Fanger\", \"Pierce\", \"KSU\", \"CoolingEffectASH55\" or \"AnkleDraftASH55\"");
ErrorsFound = true;
}
}
Expand Down
Loading