We are going to delve into “User Expressions”. This is a topic that scares many an eQUEST user, so let me be clear, you can very easily complete an eQUEST model without “User Expressions”. They are optional, but they can be very helpful.
A User Expression, also called a User Input Expression, is an input that is dependent on another input. This is very powerful because it allows interdependence of inputs, and allows dynamic modeling. To really explain a user expression, let’s start out with a simple example.
Let’s say we wish to place one window on each wall in our simulation. It’s common that a band of glass will be based on the length of the wall. Let’s say that for most walls, we want a 5 foot band of glass, starting 3 feet off the ground that starts and stops 1 foot from each end of the wall.
Since a window is a child of a wall, eQUEST can create the window based on known wall data. To do this, set up your window like this:
Then right click the field for width and select Edit/View User Expression:
Then Enter: #p("WIDTH")-2
Voila! You will see the value for window width in Magenta, indicating that it comes from a user expression.
How does this User Expression work?
This User input expression translates to “Window width = Parent (#p) WIDTH minus 2. Since the #p or parent of a window is the wall, the result is a window width that is 2 feet less than the wall.
Why does this user expression save time?
The reason this user input expression can save a lot of time is because the walls are usually all completed by the time you reach detailed mode, but the windows need some fine tuning. Manually entering each window requires the user to find each wall value (often a decimal), subtract 2, and then repeat this for a number of windows.
Instead, one can enter a user expression for window width and bypass the hand calculation (of the window width).
Why does this save time?
As we all know, the lighting power density can change frequently. If we had setup all of our office spaces with this user expression, then it is very easy to change all of them later by simply changing the global parameter.
Alternatively, if you are performing energy conservation measures via parametric runs, the global parameter(s) can be varied in the parametric run, saving countless amounts of time. We have an example of this in here in our eQUEST course
These two examples are just the tip of the iceberg. User expressions allow the use of mathematical operators, and even programmatic language like “if/else”. Really good eQUEST users have made some incredibly clever user input expressions. For instance, some users have developed a system that changes the lighting power density based on patterns found in the space name. Such a user expression is very complicated, and not a good place to start (and maybe you will never need this complexity).
The downside to user expressions is that they require a detailed knowledge of DOE2 code and also require a bit of coding ability. Sometimes the best user expressions are ones that someone else wrote!
Interested in more? We are gauging interest on this topic and have quite the collection of user expressions, but they need to be put into context.
If interested, please sign up for our eQUEST Hacks list here:
Bob Fassbender graduated from the University of Wisconsin - Madison with a degree in Chemical-Engineering. Following graduation, he spent 3 years working as a Marketing Engineer for Trane C.D.S. In the C.D.S. group, Bob developed and supported design and analysis software, primarily TRACE 700™. In addition to his development work, Bob also traveled around the country as a TRACE 700™ and System Analyzer™ instructor. Bob is also an experienced user with eQUEST energy modeling software. Today, Bob continues training and energy modeling as a LEED accredited professional (with a focus on LEED EA credit 1).
Energy-Models.com is a site for energy modelers, building simulators, architects, and engineers who want learn the basics, to advanced concepts of energy modeling. We've got online training courses and tutorials for eQUEST, Trane TRACE 700, OpenStudio, and LEED for energy modeling. All our energy modeling courses are video based. What better way to learn energy modeling software than screen-casts of exactly how things are done?
Copyright © 2010-2013 CosmoLogic LLC. TRACE 700 and eQUEST are ™ of Trane Inc. and James J. Hirsch respectively. Energy-Models.com is built in San Francisco, CA and Slinger, WI USA.