Question-and-Answer Resource for the Building Energy Modeling Community
Get started with the Help page
Ask Your Question

Metric Reports in Open Studio

asked 2016-02-19 10:26:28 -0500

lubun's avatar

updated 2020-07-31 08:17:32 -0500

I have entered my building using metric units, however the Open Studio reports are always Imperial. The preferences are set to metric, but it always reports imperial. I realize E+ reports are imperial all the time. How do I change the report format Running O/S 1.8.5


edit retag flag offensive close merge delete

3 Answers

Sort by » oldest newest most voted

answered 2016-02-19 10:50:00 -0500

The standard OpenStudio report is an OpenStudio Reporting measure. It doesn't have access to the GUI unit preferences, and as a result it always makes the report in IP units (this could be good feature request for user voice). The standard EnergyPlus generated html file will be in SI units, so if that contains the data you need you could use that.

Another option is to alter a copy of the reporting measure (or a sub-set of tables you care about) to always create SI reports.

edit flag offensive delete link more



Hello, Here is a link to the OpenStudio Report (SI) measure that I have modified : OpenStudio Report SI I didn't double-check everything, so, as the saying goes, "use it at your own risk"

nico's avatar nico  ( 2016-02-20 07:51:58 -0500 )edit

@nico, link is down, do you have it somewhere else?

Julien Marrec's avatar Julien Marrec  ( 2018-08-31 03:29:17 -0500 )edit

@nico Please update the link, it'd be a huge help for me, too. :D

synguyen's avatar synguyen  ( 2019-01-04 04:06:47 -0500 )edit

We need SI units!!!!!

Johnny_Lee's avatar Johnny_Lee  ( 2019-03-30 02:19:13 -0500 )edit

answered 2019-04-01 05:58:23 -0500

updated 2019-04-01 08:29:17 -0500

IGRETEC (@Julien THIRIFAYS) and EffiBEM (disclaimer: that's my company) have contributed the open source addition of SI units to the results measure and opened a Pull request a few months ago that was merged 3 days ago. So it should be available soonish on BCL.

The measure stays the same except that you will have a dropdown argument that you can toggle to report in SI or IP units.

We have tried to set up sensible units for the new SI reporting. In the SQL file generated by E+, general SI units are used, but then a conversion happens in the measure from source to IP (existing, untouched) and now SI target units. For example a water flow rate in m3/s in the SQL file will become gal/min in IP units, but m3/h in SI units, and they will have a different number of decimals in IP and SI (eg 2 decimals for GPM, 0 for m3/h) based on what numbers are expected. This is probably not perfect and further contributions by other parties are always welcome.

Note that this is done on the Ruby side, and not on the rendering (Javascript) side, so you can't switch units after the model has run.

edit flag offensive delete link more



Thanks @Julien Marrec for extending the functionality of this measure!! I'll try to post it to BCL this week, although it is possible there will be an additional update to the measure after testing for soon to be released OpenStudio 2.8.0 and EnergyPlus 9.1.0.

One caveat to your note about post simulation change. if someone is comfortable with the OpenStudio CLI there is a run argument for --postprocess_only. You do still need the run directory from the simulation to access the SQL file.

David Goldwasser's avatar David Goldwasser  ( 2019-04-01 08:28:18 -0500 )edit

The --postprocess_only run argument can actually be used like this to run new reports that were not originally requested at run-time so long as you do not need any additional tabular or time series results that were not already part of the simulation.

David Goldwasser's avatar David Goldwasser  ( 2019-04-01 08:34:39 -0500 )edit

Hello @David Goldwasser,

I had already installed the "old" OpenStudio Results measure, I tryed to update but nothing is showed in Measure Updates. How can I delete the "old" one and instaled the new one manually? Already search in OS installation directory, but I didn´t find the folder with OS results measure.

The dropdown with SI and IP units should not appear before all the Inputs options?


Btw, thanks for the SI version.

André Magro

amagro's avatar amagro  ( 2019-09-23 08:38:54 -0500 )edit

@amagro if all else fails, delete rename or delete the directory named "BCL" under your user account. Not sure why you are not seeing the update in the PAT or OS Application interface. If you need to preserve other content in the BCL directory then rename it instead of deleting it.

David Goldwasser's avatar David Goldwasser  ( 2019-09-23 16:44:54 -0500 )edit

answered 2019-10-22 14:36:18 -0500

Dan Johnson's avatar

Is there any way to display BOTH Energyplus results AND Openstudio results in IP units? If we run the "Energyplus output to IP" measure, the OS results will fail, because this measure is expecting SI units, right? If we omit this Energyplus measure and run only the OpenStudio Results measure, then we DO get IP Openstudio results, but we do not get IP Energyplus results, just the SI version. How can we get both in IP? Thanks. See related, unresolved thread from last year:

edit flag offensive delete link more


@Dan Johnson, this isn't an answer. Please move to a comment or ask a new question. Thanks!

MatthewSteen's avatar MatthewSteen  ( 2019-10-23 10:36:34 -0500 )edit

Your Answer

Please start posting anonymously - your entry will be published after you log in or create a new account.

Add Answer

Question Tools



Asked: 2016-02-19 10:26:28 -0500

Seen: 2,434 times

Last updated: Oct 22 '19