[Equest-users] E: User Expression for Infiltration Neutral Zone Height

Nicholas Caton Nicholas.Caton at se.com
Tue Mar 17 09:45:12 PDT 2020

Great question Melissa!

For clarity - your screen snip and description leads me to believed we're discussing the following DOE-2 Default expression - let me know if that's off:
[cid:image003.png at 01D5FC51.7CEC5030]
This switch statement checks the local input for the Infiltration Method (INF-METHOD, "Crack" per the above example), and then will return "n/a" in the interface if anything is selected other than case 2, which happens to be "Crack."  As a fun aside, there are many cases in the doe-2 defaults and with custom expressions by my peers where there are no notes in place to help someone figure out what each case is intended to be.  A strategy I will often employ to "reverse engineer in place" involves modifying such an expression like this:
[cid:image005.png at 01D5FC51.7CEC5030]
After these edits, you can toggle the thing being referenced in the first line of the switch statement (INF-METHOD in this case) to observe the outcome in the same view.  For efficiency I'd typically keep a copy of the original expression on the side to paste back in later.

As for your actual question... I would think the expression through in a few steps.  The answer to your question will vary based on how the model was constructed (spefically whether FLOORs are used, so I'm presenting a series of observations to lead me to the right spot for a model which happens to be generated using the latest DD wizards.

First, let's assert what we're looking for out of this expression.  You've already done this for us, but for immediate reference:

((Parent("Z")-0)+Local("Height")/2)*-1+(BH/2 - BG)

BH = Building Height
BG = Total of Below Grade FL to FL Height

I would just approach this from left to right.  First up is to figure out which inputs to reference to determine the absolute (from ground level) height of the SPACE.  You  have already nailed it descriptively as "Parent("Z")," but not everybody's model will land there as the correct answer, and I'd like to answer for those in the classroom who aren't yet able to intuit stuff like this, so let's show how we determine that:

  *   We're working on an expression for infiltration, which is categorically a SPACE input.  We'll therefore start our search for inputs of interest with the local SPACE.  Skimming the inputs available for a 2nd story space in my wizard dummy model, I observe the local Z input is zero (same case for all of my spaces), so that input can't be used to derive the absolute height (Z) of the space...

[cid:image010.png at 01D5FC51.7CEC5030]

  *   I do however observe a floor-to-ceiling height which may come in handy later.  Aside: I have seen models where the local SPACE Z inputs reflect absolute height relative to the ground, but I don't think you'll encounter that with any models borne from eQuest wizards in recent years.
  *   So, we go one level up in the component tree, to investigate the parent FLOOR:

[cid:image011.png at 01D5FC51.7CEC5030]

  *   The Floor Z value (highlighted yellow) is verifiably the absolute height we are looking for.  I've also highlighted values in blue for the floor to floor and floor to ceiling heights, which with wizard-borne models are used to automate the SPACE height and vertical SURFACE height inputs for every component underneath the floor in the Component Tree (by default, until you override with manual inputs).  One or both of those may be of interest down the line.
  *   For building the expression, we need to know exactly what these inputs look like in the INP file.  There are a few ways to verify this (including looking directly at the INP), but I will typically first right click the input field and observe either the reference manual entry or "View Default/Range..." in the context menu:

[cid:image012.png at 01D5FC51.7CEC5030]

  *   Considering exact capitalization/spelling are important, I'm jotting down the 3 inputs of interest can be expressed from a child SPACE as
     *   #P("Z")
     *   #P("FLOOR-HEIGHT")
     *   #P("SPACE-HEIGHT")
  *   So, back at my space, I can firstly test the above inputs to make sure they produce the expected numbers and not error (they do)
[cid:image013.png at 01D5FC51.7CEC5030]

  *   Then, I can construct some math to work out the absolute height of the middle of the conditioned space

[cid:image014.png at 01D5FC51.7CEC5030]

  *   The rest of the expression you have there is looking to express this elevation in relation to a neutral pressure level (NPL) = BH/2 - BG.  While the NPL should be a constant for within any given building/model, I don't think it's possible to automate that math from within a SPACE expression short of developing and utilizing global parameters containing values for BH & BG.  Very much a procedural possibility, but outside the realm of what most users would handle on a regular basis.  I would advise just doing the (simple) math on the side, and plan to manually punch the NPL into your custom expression with every project:
[cid:image015.png at 01D5FC51.7CEC5030]

  *   Note I'm being deliberate here in ensuring centerlines above the NPL are expressed as a negative distance, whereas centerlines below the NPL will express as positive, in line with the associated reference manual entry for NEUTRAL-ZONE-HT:

[cid:image016.png at 01D5FC51.7CEC5030]

  *   If you wish to retain the behavior of the original switch statement (displaying as 'n/a' when anything other than "Crack" is selected, you could patch your math into the associated switch case like this:

[cid:image017.png at 01D5FC51.7CEC5030]

That pretty much wraps it up, though I should address that while I didn't use #P("FLOOR-HEIGHT") for this example, that may actually be the value some would want to use depending on the context.  If your conditioned space volume is pretty well exposed to infiltration/exfiltration from the full floor to floor exposure, as is generally the case when glazing extends above a drop ceiling line, and arguably in many more cases where the ceiling plenum isn't really isolated much from the conditioned volume or return air path, then you might really consider substituting the FLOOR-HEIGHT to bump the centerline of the local space up a bit.

I'd also mention to be mindful about applying an expression like this everywhere in a model... I haven't done enough stack effect modeling personally to make a recommendation, but you might consider/investigate whether the simulated infiltration volumes are accurate in aggregate when applying something like this to core spaces (that do not feature perimeter exposures).


[cid:image018.jpg at 01D5FC51.7CEC5030]
Nick Caton, P.E., BEMP
  Senior Energy Engineer
  Energy and Sustainability Services
  Energy Performance Contracting

913 . 564 . 6361
785 . 410 . 3317
nicholas.caton at se.com<mailto:nicholas.caton at se.com>
15200 Santa Fe Trail Drive
Suite 204
Lenexa, KS 66219

[cid:image006.png at 01D5FC46.F1E69B30]

From: Equest-users <equest-users-bounces at lists.onebuilding.org> On Behalf Of Melissa Crowe via Equest-users
Sent: Tuesday, March 17, 2020 9:13 AM
To: equest-users at lists.onebuilding.org
Subject: [Equest-users] User Expression for Infiltration Neutral Zone Height

[External email: Use caution with links and attachments]


Hi All

Help please, I am struggling with User Expression that calculates the Neutral Zone Height for high rise infiltration. It's something like:

((Parent("Z")-0)+Local("Height")/2)*-1+(BH/2 - BG)

BH = Building Height
BG = Total of Below Grade FL to FL Height

Also the default expression includes  a switch statement.  I don't thin I need a switch statement, so how is it formatted?

[cid:image007.png at 01D5FC46.F1E69B30]

Thank you

[cid:image008.png at 01D5FC46.F1E69B30]
Melissa Crowe, LEED AP, BEMP
Senior Mechanical/Energy Engineer

[cid:image009.jpg at 01D5FC46.F1E69B30]

Boston Office
161 Worcester Road
Suite 305
Framingham, MA 01701
508-647-9200 ext. 1225
Follow us on Facebook<https://eur02.safelinks.protection.outlook.com/?url=http%3A%2F%2Fwww.facebook.com%2Fhome.php%23!%2Fpages%2FCMTA-Consulting-Engineers%2F173253492360&data=02%7C01%7CNicholas.Caton%40se.com%7C02d16b8d79e64fce68eb08d7ca7d6541%7C6e51e1adc54b4b39b5980ffe9ae68fef%7C0%7C0%7C637200512232937197&sdata=vAPAiS2NYRx1QXAze1f2qh%2B5kZP2GFl2TEKHLAELl1M%3D&reserved=0>, Twitter<https://eur02.safelinks.protection.outlook.com/?url=https%3A%2F%2Ftwitter.com%2FCMTAEngineers&data=02%7C01%7CNicholas.Caton%40se.com%7C02d16b8d79e64fce68eb08d7ca7d6541%7C6e51e1adc54b4b39b5980ffe9ae68fef%7C0%7C0%7C637200512232937197&sdata=e6KuP475zz7qa1hwoXMjsDbGYac%2FHIqoz3JMGgvum6U%3D&reserved=0> and LinkedIn<https://eur02.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwww.linkedin.com%2Fcompany%2Fcmta-inc.%3Ftrk%3Dbiz-companies-cym&data=02%7C01%7CNicholas.Caton%40se.com%7C02d16b8d79e64fce68eb08d7ca7d6541%7C6e51e1adc54b4b39b5980ffe9ae68fef%7C0%7C0%7C637200512232947193&sdata=Q%2Bql8%2FbeMS6gwQRoLbXuDseBh6QsIO%2BWDlExq1D8NEI%3D&reserved=0>

We've moved!  Our new location is noted above - please update your records.
Look for an invitation to our Open House event to showcase the new space in the coming months.

This email has been scanned by the Symantec Email Security.cloud service.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.onebuilding.org/pipermail/equest-users-onebuilding.org/attachments/20200317/8fc8cefc/attachment.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image006.png
Type: image/png
Size: 8477 bytes
Desc: image006.png
URL: <http://lists.onebuilding.org/pipermail/equest-users-onebuilding.org/attachments/20200317/8fc8cefc/attachment.png>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image007.png
Type: image/png
Size: 10024 bytes
Desc: image007.png
URL: <http://lists.onebuilding.org/pipermail/equest-users-onebuilding.org/attachments/20200317/8fc8cefc/attachment-0001.png>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image008.png
Type: image/png
Size: 36344 bytes
Desc: image008.png
URL: <http://lists.onebuilding.org/pipermail/equest-users-onebuilding.org/attachments/20200317/8fc8cefc/attachment-0002.png>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image009.jpg
Type: image/jpeg
Size: 2311 bytes
Desc: image009.jpg
URL: <http://lists.onebuilding.org/pipermail/equest-users-onebuilding.org/attachments/20200317/8fc8cefc/attachment.jpg>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image003.png
Type: image/png
Size: 61751 bytes
Desc: image003.png
URL: <http://lists.onebuilding.org/pipermail/equest-users-onebuilding.org/attachments/20200317/8fc8cefc/attachment-0003.png>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image005.png
Type: image/png
Size: 55479 bytes
Desc: image005.png
URL: <http://lists.onebuilding.org/pipermail/equest-users-onebuilding.org/attachments/20200317/8fc8cefc/attachment-0004.png>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image010.png
Type: image/png
Size: 90799 bytes
Desc: image010.png
URL: <http://lists.onebuilding.org/pipermail/equest-users-onebuilding.org/attachments/20200317/8fc8cefc/attachment-0005.png>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image011.png
Type: image/png
Size: 69871 bytes
Desc: image011.png
URL: <http://lists.onebuilding.org/pipermail/equest-users-onebuilding.org/attachments/20200317/8fc8cefc/attachment-0006.png>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image012.png
Type: image/png
Size: 53749 bytes
Desc: image012.png
URL: <http://lists.onebuilding.org/pipermail/equest-users-onebuilding.org/attachments/20200317/8fc8cefc/attachment-0007.png>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image013.png
Type: image/png
Size: 34355 bytes
Desc: image013.png
URL: <http://lists.onebuilding.org/pipermail/equest-users-onebuilding.org/attachments/20200317/8fc8cefc/attachment-0008.png>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image014.png
Type: image/png
Size: 35087 bytes
Desc: image014.png
URL: <http://lists.onebuilding.org/pipermail/equest-users-onebuilding.org/attachments/20200317/8fc8cefc/attachment-0009.png>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image015.png
Type: image/png
Size: 42657 bytes
Desc: image015.png
URL: <http://lists.onebuilding.org/pipermail/equest-users-onebuilding.org/attachments/20200317/8fc8cefc/attachment-0010.png>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image016.png
Type: image/png
Size: 16997 bytes
Desc: image016.png
URL: <http://lists.onebuilding.org/pipermail/equest-users-onebuilding.org/attachments/20200317/8fc8cefc/attachment-0011.png>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image017.png
Type: image/png
Size: 18250 bytes
Desc: image017.png
URL: <http://lists.onebuilding.org/pipermail/equest-users-onebuilding.org/attachments/20200317/8fc8cefc/attachment-0012.png>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image018.jpg
Type: image/jpeg
Size: 1793 bytes
Desc: image018.jpg
URL: <http://lists.onebuilding.org/pipermail/equest-users-onebuilding.org/attachments/20200317/8fc8cefc/attachment-0001.jpg>

More information about the Equest-users mailing list