Recent Releases of OpenStudio
OpenStudio - OpenStudio v1.6.0
These release notes describe version 1.6.0 of the OpenStudio software
suite developed by the National Renewable Energy Laboratory (NREL),
Buildings and Thermal Systems, Commercial Buildings Research Group,
Tools Development Section, and associated collaborators. The notes are
organized into the following sections:
- Where to Find OpenStudio Documentation
- Installation Notes
- Overview
- New Features
- Known Issues
Where to Find OpenStudio Documentation
- OpenStudio release documentation, including these release notes,
tutorials, and other user documentation, is available at
https://www.openstudio.net/. - C++ API documentation is available at
https://s3.amazonaws.com/openstudio-sdk-documentation/index.html. - Measure development documentation is available at
http://nrel.github.io/OpenStudio-user-documentation/measures/measure_writing_guide/.
Installation Notes
OpenStudio is supported on Windows 7 – 8.1, OS X 10.9 – 10.10, and
64-bit Ubuntu 14.04.
OpenStudio 1.6.0 supports EnergyPlus Release 8.2.0 Update 1, which is
now bundled with the OpenStudio installer. It is no longer necessary to
download and install EnergyPlus separately, however a standalone
EnergyPlus installer for this build is available at
https://github.com/NREL/EnergyPlus/releases/tag/v8.2.0-Update-1.2.
Other builds of EnergyPlus 8.2 are not supported by OpenStudio 1.6.0.
Installation Steps
- The OpenStudio SketchUp Plug-in requires SketchUp
2015 (not available for Linux). The
OpenStudio SketchUp Plug-in does not support older versions of
SketchUp SketchUp 2015 is available in 32 and 64 bit versions, the
32 bit version of OpenStudio on Windows will only work with the 32
bit version of SketchUp 2015 and the 64 bit version of OpenStudio
will only work with the 64 bit version of SketchUp 2015. - Download and install
OpenStudio. - Setup a Building Component Library (BCL) account to access online
building components and measures. View instructions on how to setup
your account and configure the key in
OpenStudio.
Optional Installation Steps
- For Radiance integration, download and install
Radiance.
Overview
This version of OpenStudio works with EnergyPlus 8.2.0 Update 1. Other
builds of EnergyPlus 8.2 are not supported by OpenStudio 1.6.0.
EnergyPlus is now bundled with the OpenStudio installer, it is no longer
necessary to download and install EnergyPlus separately.
OpenStudio SketchUp plug-in updated to work with SketchUp 2015.
SketchUp 2015 is available in 32 and 64 bit versions, the 32 bit version
of OpenStudio on Windows will only work with the 32 bit version of
SketchUp 2015 and the 64 bit version of OpenStudio will only work with
the 64 bit version of SketchUp 2015.
Addition of standards specific properties to material and construction
objects. These fields are completely optional but will be translated to
SDD format if they are populated in the OpenStudio Application. A
template file, CECTemplate.osm, contains a set of materials populated
with CEC Title24 2013 information. This file is installed with
OpenStudio and may be loaded as a library in the OpenStudio Application
for easy inclusion in your model.
The model object TimeDependantValuation was removed.
The BCL OnDemandGenerator class was removed. OnDemandGenerator
functionality was also removed from the BCL.
OpenStudio SketchUp Plug-in 1.6.0
- No changes.
OpenStudio Application 1.6.0
- Addition of standards specific properties to material and
construction objects.
OpenStudio ParametricAnalysisTool 1.6.0
- No changes.
OpenStudio ResultsViewer 1.6.0
- Updated to support EnergyPlus 8.2.0.
OpenStudio Ruby Bindings 1.6.0
- No changes.
OpenStudio C# Bindings 1.6.0
- No changes.
OpenStudio Python Bindings 1.6.0
- No changes.
- Python bindings are not packaged with OpenStudio. To use them see
our developer page for
guidance on building OpenStudio.
OpenStudio JavaScript V8 Bindings 1.6.0
- No changes.
- JavaScript bindings are not packaged with OpenStudio. To use them
see our developer page for
guidance on building OpenStudio.
OpenStudio Java Bindings 1.6.0
- No changes.
- Java bindings are not packaged with OpenStudio. To use them see our
developer page for
guidance on building OpenStudio.
OpenStudio RunManager
- The RunManager application has been deprecated in favor of the
OpenStudio and ParametricAnalysisTool applications. The RunManager
library will remain available.
Bug Fixes
- The OpenStudio SketchUp plug-in handled orphan objects
inconsistently, now these are simply not drawn. [issue
#1224] - SaveAs in SketchUp plugin corrupts measures in model. [issue
#754] - Cloud functionality fails on reporting measures. [issue
#824] - BCL measure may look like they are broken even though they work.
[issue #1254] - Copy measure does not work. [issue
#1274] - Cannot use Material Roof Vegetation in Construction. [issue
#1317] - PIU fans do not night cycle properly. [issue
#1343] - OA Controller will not schedule off. [issue
#1344]
Known Issues
The following are issues known at the time of publication of these
release notes. Please contact [email protected] if you require
further assistance.
Known Issues Common to All Platforms
OpenStudio SketchUp Plug-In
- If you use copy multiple on group-level OpenStudio objects, you will
get one extra copy. The extra group is created by the first
copy-and-paste operation and is not removed when the copy multiple
occurs. To address this, after you perform a copy multiple procedure
on groups or spaces, press delete. The objects you need to delete
should already be selected. If you are copying loose surfaces such
as windows, there are no problems, as SketchUp will merge equivalent
surfaces. [issue
#28] - Using SketchUp’s undo operation on OpenStudio model elements may
produce unexpected results. [issues
#54 and
#150] - SKP and OSM link is not maintained when files are relocated.
However, you can manually re-establish that link. When opening a
SketchUp file, launch SketchUp and then open the SketchUp file. If
that doesn’t work you can also directly load the OSM file, bypassing
the SKP file. [issue
#409] - It is possible for the OpenStudio plug-in to conflict with other
SketchUp plug-ins. If you suspect this is a problem, try testing
with other plug-ins disabled, or contact [email protected] for
assistance. [issue
#26] - Using “Intersect” in the surface matching dialog can result in a
crash or unexpected results. This is more common with models that
were imported from other CAD formats at some point in the workflow.
It is a good idea to save prior to using this to avoid any loss of
data. This is related to an underlying SketchUp bug. [issue
#168] - “Project Loose Geometry” can crash SketchUp. It is a good idea to
save prior to using this to avoid any loss of data. [issue
#484] - Adjacent stacked spaces in same zones may result in incorrect area
and likely loads as well. [issue
#561] - Using AutoSave in SketchUp can overwrite changes made in OS app if
the file is open in both locations. [issue
#899]
If your OpenStudio model causes a crash of SketchUp or has unexpected
behavior, please forward it to [email protected] with a detailed
description of the problem along with the steps that produced the issue.
Please also include the directory that has the same name as the OSM
file. You can attach it as a zip file.
OpenStudio Application
- EnergyPlus 8.2 no longer provides simulation output to standard
output during simulation. [issue #1359] - Similar thermostats assigned in the SketchUp Plug-in are shared
across thermal zones in the OpenStudio application. Changing or
turning off one will do the same to others. [issue
#123] - The view does not always refresh correctly when you delete a
material from a construction. If you still see a material after
clicking the “x”, switch away from and back to the object to refresh
the view. [issue
#196] - OS App Schedule Editor allows entering values outside of type
limits. [issue
#531] - All drop zones under Water Use Equipment Definitions doesn't enforce
schedule types. [issue
#532] - Some HVAC components in OpenStudio are missing from the HVAC Library
(e.g. Fan:OnOff). [issue
#599] - Several objects in OpenStudio appear to accept erroneous input
values, but seems like it is just displaying the erroneous value and
not storing it. [issue
#656] - Attempting to autosize a WaterHeater will result in an error. [issue
#669] - Entering an invalid date on the Utility Bills subtab crashes
OpenStudio. [issue
#739] - To enable set point schedule drop zones on the Thermal Zones tab,
you need to first turn on the thermostat. - The Site / Utility Rates subtab in the workflow is marked as “coming
soon,” and will be completed in an upcoming release of OpenStudio. - The default reporting measures used for the results tab show results
in IP units, and do not react to changes in the user’s unit
preferences. That will be addressed in future versions of
OpenStudio. The measure can be altered to show SI units instead. - It is not possible to choose or define a refrigeration case (or
walkin) re-stocking schedule in the “Grid” view or the “Layout”
view; the drop down list is blank. [issue
#966] - Report web views may load slower than they use to with the update to
Qt5. [issue
#1211] - With larger models, GridView’s performance may slow. Performance
improvements are currently being implemented and will be available
soon in a minor release.
OpenStudio ParametricAnalysisTool
- NOTE: when using cloud service, please make sure to stop the cloud
using the cloud button in PAT when your simulation session is done,
and after you have downloaded all of the detailed results you want.
You are also strongly encouraged to go to the AWS Management Console
to confirm that all instances are terminated. If they are not
terminated, you will need to manually terminate them from the
console. Refer to the OpenStudio
documentation for details about running
simulations on the cloud. - EnergyPlus 8.2 no longer provides simulation output to standard
output during simulation. [issue #1359] - Daylighting control object variables can’t be requested in the
output variables tab. [issue
#355] - Adding a design alternative using measure groups will remove any
design alternatives made from external files. However, you can add a
design alternative made from external files without losing design
alternatives made from measure groups. [issue
#369] - Always Run measures are applied to externally constructed design
alternatives. This may result in unexpected results or errors.
[issue #369] - Windows users may experience problems when starting cloud resources
through PAT due to a bug in net-ssh,
https://github.com/net-ssh/net-ssh/issues/180. If the user has
the pageant.exe program running, killing that program through the
task manager may resolve the issue.
OpenStudio ResultsViewer
- Alias changes do not update in table view until the data are read in
again. [issue #25] - Re-arranged column order doesn't stick on next launch. [issue
#30]
OpenStudio RunManager
- EnergyPlus ForwardTranslator errors do not appear in the RunManager
GUI elements. [issue
#181]
OpenStudio Platform, Including SWIG Bindings
- IdfObject::getQuantity and IdfObject::setQuantity functionality is
not comprehensive. The quantity getters and setters for fields whose
units are “BasedOnField AX” are not expected to work at the
IdfObject level, but are to be handled only for OS: prefixed objects
by the specific interfaces of classes derived from ModelObject. - The default naming scheme of WorkspaceObject (base class for
ModelObject, etc.) sometimes results in undesired name clashes when
transferring objects between models, including in the EnergyPlus
translators. Therefore, some objects may be unexpectedly renamed or
copied. - OpenStudio::Model::ComponentVector objects may be inaccessible from
the Ruby bindings. [issue
#239] - If schedule type limits fields are not set properly, OS will not
give error but also will not hook up affected schedules. [issue
#967] - There is no default construction for adiabatic surfaces. [issue
#974] - Cloning a building disconnects spaces from thermal zones. [issue
#980] - The simulation fails if ground preprocessor boundary conditions are
used. [issue
#1127]
Known Issues Specific to OS X
- The SketchUp Plug-in toolbar tooltips do not work correctly on OS X
if you have made your toolbars horizontal. The tooltips never show
on OS X in the status bar. The button state may also be incorrect.
This is a bug in SketchUp versus the plug-in. [issue
#45]
Issue Statistics Since Previous Release
- 66 new issues were filed since the 1.5.0 release of OpenStudio (not
including opened pull requests). - 56 issues were closed since the 1.5.0 release of OpenStudio (not
including closed pull requests).
Consumption - Buildings and Heating
- C++
Published by axelstudios over 10 years ago

OpenStudio - OpenStudio v1.5.5
Consumption - Buildings and Heating
- C++
Published by axelstudios over 10 years ago

OpenStudio - OpenStudio v1.5.4
Consumption - Buildings and Heating
- C++
Published by axelstudios over 10 years ago

OpenStudio - OpenStudio v1.5.3
Consumption - Buildings and Heating
- C++
Published by axelstudios over 10 years ago

OpenStudio - OpenStudio v1.5.2
Consumption - Buildings and Heating
- C++
Published by axelstudios over 10 years ago

OpenStudio - OpenStudio v1.5.1
Consumption - Buildings and Heating
- C++
Published by axelstudios over 10 years ago

OpenStudio - OpenStudio v1.5.0
These release notes describe version 1.5.0 of the OpenStudio software suite developed by the National Renewable Energy Laboratory (NREL), Buildings and Thermal Systems, Commercial Buildings Research Group, Tools Development Section, and associated collaborators. The notes are organized into the following sections:
- Where to Find OpenStudio Documentation
- Installation Notes
- Overview
- New Features
- Known Issues
Where to Find OpenStudio Documentation
- OpenStudio release documentation, including these release notes, tutorials, and other user documentation, is available at http://openstudio.nrel.gov/documentation.
- C++ API documentation is available at http://openstudio.nrel.gov/sdk-documentation.
- Measure development documentation is available at https://github.com/NREL/OpenStudio/wiki/Measure-Writing-Guide.
- OpenStudio Life Cycle Costing Examples are available at http://openstudio.nrel.gov/openstudio-life-cycle-examples.
Installation Notes
OpenStudio is supported on Windows 7 – 8.1, OS X 10.9, and 64-bit Ubuntu 14.04.
OpenStudio 1.5.0 supports EnergyPlus Release 8.1.
Installation Steps
- Download and install EnergyPlus 8.1.
- Download EnergyPlus 8.1. Create an account and login if you don't already have one.
- OpenStudio will work with 32 or 64bit EnergyPlus installers.
- The OpenStudio SketchUp Plug-in requires Sketchup 2014 (not available for Linux). Older versions are not supported.
- Create an OpenStudio account, then download and install OpenStudio.
- Setup a Building Component Library (BCL) account to access online building components and measures. View instructions on how to setup your account and configure the key in OpenStudio.
Optional Installation Steps
- For Radiance integration, download and install Radiance.
Overview
This OpenStudio 1.5.0 release updates many OpenStudio dependencies. The biggest of these is an upgrade from Ruby 1.8 to Ruby 2.0. This update allows OpenStudio to leverage upon the improvements available in Ruby 2.0, and provides compatibility with SketchUp 2014. However, this update also means that OpenStudio will no longer be compatible with SketchUp 2013 or SketchUp 8. C++ developers will notice upgrades to Qt 5 and Boost 1.55, as well as the inclusion of C++11 features in OpenStudio source code.
OpenStudio for OS X is now built with the 10.9 SDK for Ruby 2.0 support, making Mavericks the primary Apple platform, and Ubuntu 12 support has been removed in favor of Ubuntu 14.04 LTS. Windows platform support remains the same, with Windows 7 – 8.1 compatibility.
This OpenStudio 1.5.0 release also includes several improvements to measures. Reporting measures can now request output variables from EnergyPlus to ensure that they have the data they need to create plots or make reports. Additionally, units and descriptions can now be added to measure arguments.
The OpenStudio C++ SDK documentation has been significantly improved, which includes a search feature and links between all Doxygen directories. Updated C++ and Ruby coding standards can be found on the GitHub wiki.
Other notable improvements:
- Previously available for Refrigeration Walk Ins and Refrigeration Cases, GridView (a grid-style interface providing detailed component views) has now been applied to the Space Types tab, as well as the Thermal Zones tab. These GridView-enabled tabs now allow practitioners to view and modify numerous Space Types (or Thermal Zones) and their objects, simultaneously.
- Multiple performance improvements and bug fixes.
New Features
OpenStudio Platform 1.5.0
-
HVAC objects added from the OpenStudio HVAC roadmap:
Changeover Bypass Unitary System- AirLoopHVAC:UnitaryHeatCool:VAVChangeoverBypass
- AirTerminal:SingleDuct:VAV:HeatAndCool:NoReheat
- AirTerminal:SingleDuct:VAV:HeatAndCool:Reheat
Supply air to Four Pipe Fan Coil Terminal from DOAS
- AirTerminal:SingleDuct:InletSideMixer
Series PIU Terminal
- AirTerminal:SingleDuct:SeriesPIU:Reheat
Four Pipe Induction Terminal
- AirTerminal:SingleDuct:ConstantVolume:FourPipeInduction
High Temperature Radiant Heater (Gas or Electric)
- ZoneHVAC:HighTemperatureRadiant
Two Speed Cooling Tower
- CoolingTower:TwoSpeed
Electric Steam Humidifier and assorted Humidity Setpoint Control Types
- Humidifier:Steam:Electric
- SetpointManager:SingleZone:Humidity:Minimum
- SetpointManager:MultiZone:MinimumHumidity:Average
- SetpointManager:MultiZone:Humidity:Minimum
Indirect Evaporative Cooler
- EvaporativeCooler:Indirect:ResearchSpecial
Dual Setpoint Control – allows temp to float between heating and cooling setpoints
- Useful for GSHP loops
- SetpointManager:Scheduled:DualSetpoint
Outdoor Air Pretreat Control – allows you to specify OA pretreat controls
- SetpointManager:OutdoorAirPretreat
Multi-Stage Unitary System – Available in back end (via Measures) but not in GUI yet
- AirLoopHVAC:UnitaryHeatPump:AirToAir:MultiSpeed
- Coil:Cooling:DX:MultiSpeed
- Coil:Heating:Gas:MultiStage
- ZoneControl:Thermostat:StagedDualSetpoint
-
Improved general performance, stability, and usability.
OpenStudio SketchUp Plug-in 1.5.0
- No changes.
OpenStudio Application 1.5.0
- GridView has now been applied to the Space Types tab, as well as the Thermal Zones tab.
- Improved general performance, stability, and usability.
OpenStudio ParametricAnalysisTool 1.5.0
- Improved general performance, stability, and usability.
OpenStudio ResultsViewer 1.5.0
- No changes.
OpenStudio Ruby Bindings 1.5.0
- No changes.
OpenStudio C# Bindings 1.5.0
- No changes.
OpenStudio Python Bindings 1.5.0
- No changes.
- Python bindings are not packaged with OpenStudio. To use them see our developer page for guidance on building OpenStudio.
OpenStudio JavaScript V8 Bindings 1.5.0
- No changes.
- JavaScript bindings are not packaged with OpenStudio. To use them see our developer page for guidance on building OpenStudio.
OpenStudio Java Bindings 1.5.0
- No changes.
- Java bindings are not packaged with OpenStudio. To use them see our developer page for guidance on building OpenStudio.
OpenStudio RunManager
- The RunManager application has been deprecated in favor of the OpenStudio and ParametricAnalysisTool applications. The RunManager library will remain available.
Known Issues
The following are issues known at the time of publication of these release notes. Please contact [email protected] if you require further assistance.
Known Issues Common to All Platforms
OpenStudio SketchUp Plug-in
- If you use copy multiple on group-level OpenStudio objects, you will get one extra copy. The extra group is created by the first copy-and-paste operation and is not removed when the copy multiple occurs. To address this, after you perform a copy multiple procedure on groups or spaces, press delete. The objects you need to delete should already be selected. If you are copying loose surfaces such as windows, there are no problems, as SketchUp will merge equivalent surfaces. [issue #28]
- Using SketchUp's undo operation on OpenStudio model elements may produce unexpected results. [issues #54 and #150]
- SKP and OSM link is not maintained when files are relocated. However, you can manually re-establish that link. When opening a SketchUp file, launch SketchUp and then open the SketchUp file. If that doesn't work you can also directly load the OSM file, bypassing the SKP file. [issue #409]
- It is possible for the OpenStudio plug-in to conflict with other SketchUp plug-ins. If you suspect this is a problem, try testing with other plug-ins disabled, or contact [email protected] for assistance. [issue #26]
- Using "Intersect" in the surface matching dialog can result in a crash or unexpected results. This is more common with models that were imported from other CAD formats at some point in the workflow. It is a good idea to save prior to using this to avoid any loss of data. This is related to an underlying SketchUp bug. [issue #168]
- "Project Loose Geometry" can crash SketchUp. It is a good idea to save prior to using this to avoid any loss of data. [issue #484]
- Adjacent stacked spaces in same zones may result in incorrect area and likely loads as well. [issue #561]
- SaveAs in SketchUp corrupts measures in model. To avoid this, only add measures into model after work in SketchUp is done. [issue #754]
- Using AutoSave in SketchUp can overwrite changes made in OS app if the file is open in both locations. [issue #899]
If your OpenStudio model crashes SketchUp or has unexpected behavior please forward it to [email protected] with a description of the problem. Please also include the directory that has the same name as the OSM file. You can attach it as a zip file.
OpenStudio Application
- Similar thermostats assigned in the SketchUp Plug-in are shared across thermal zones in the OpenStudio application. Changing or turning off one will do the same to others. [issue #123]
- The view does not always refresh correctly when you delete a material from a construction. If you still see a material after clicking the "x", switch away from and back to the object to refresh the view. [issue #196]
- OS App Schedule Editor allows entering values outside of type limits. [issue #531]
- All drop zones under Water Use Equipment Definitions doesn't enforce schedule types. [issue #532]
- Removing CoilHeatingWater objects can result in orphaned hot water coils. [issue #594]
- Some HVAC components in OpenStudio are missing from the HVAC Library (e.g. Fan:OnOff). [issue #599]
- Several objects in OpenStudio appear to accept erroneous input values, but seems like it is just displaying the erroneous value and not storing it. [issue #656]
- Attempting to autosize a WaterHeater will result in an error. [issue #669]
- Entering an invalid date on the Utility Bills subtab crashes OpenStudio. [issue #739]
- To enable set point schedule drop zones on the Thermal Zones tab, you need to first turn on the thermostat.
- The Site / Utility Rates subtab in the workflow is marked as "coming soon," and will be completed in an upcoming release of OpenStudio.
- The default reporting measures used for the results tab show results in IP units, and do not react to changes in the user's unit preferences. That will be addressed in future versions of OpenStudio. The measure can be altered to show SI units instead.
- It is not possible to choose or define a refrigeration case (or walkin) re-stocking schedule in the "Grid" view or the "Layout" view; the drop down list is blank. [issue #966]
- Report web views may load slower than they use to with the update to Qt5. [issue #1211]
- With larger models, GridView's performance may slow. Performance improvements are currently being implemented and will be available soon in a minor release.
OpenStudio ParametricAnalysisTool
- NOTE: Cloud functionality is temporarily disabled. This issue is planned to be resolved shortly.
- NOTE: when using cloud service please make sure to stop the cloud using the cloud button in PAT when your simulation session is done, and after you have downloaded all of the detailed results you want. You are also strongly encouraged to go to the AWS Management Console to confirm that all instances are terminated. If they are not terminated, you will need to manually terminate them from the console. We have a sticky post on our forum with best practices for cloud simulation in OpenStudio.
- Daylighting control object variables can't be requested in the output variables tab. [issue #355]
- Adding a design alternative using measure groups will remove any design alternatives made from external files. However, you can add a design alternative made from external files without losing design alternatives made from measure groups. [issue #369]
- Always Run measures are applied to externally constructed design alternatives. This may result in unexpected results or errors. [issue #369]
OpenStudio ResultsViewer
- Alias changes do not update in table view until the data are read in again. [issue #25]
- Re-arranged column order doesn't stick next launch. [issue #30]
OpenStudio RunManager
- EnergyPlus ForwardTranslator errors do not appear in the RunManager GUI elements. [issue #181]
OpenStudio Platform, Including SWIG Bindings
- IdfObject::getQuantity and IdfObject::setQuantity functionality is not comprehensive. The quantity getters and setters for fields whose units are "BasedOnField AX" are not expected to work at the IdfObject level, but are to be handled only for OS: prefixed objects by the specific interfaces of classes derived from ModelObject.
- The default naming scheme of WorkspaceObject (base class for ModelObject, etc.) sometimes results in undesired name clashes when transferring objects between models, including in the EnergyPlus translators. Therefore, some objects may be unexpectedly renamed or copied.
- OpenStudio::Model::ComponentVector objects may be inaccessible from the Ruby bindings. [issue #239]
- If schedule type limits fields are not set properly, OS will not give error but also will not hook up affected schedules. [issue #967]
- There is no default construction for adiabatic surfaces. [issue #974]
- Cloning a building disconnects spaces from thermal zones. [issue #980]
- The simulation fails if ground preprocessor boundary conditions are used. [issue #1127]
Known Issues Specific to OS X
- The SketchUp Plug-in toolbar tooltips do not work correctly on OS X if you have made your toolbars horizontal. The tooltips never show on OS X in the status bar. The button state may also be incorrect. This is a bug in SketchUp versus the plug-in. [issue #45]
Bug Analytics Since Previous Release
- 63 new issues were filed since the 1.4.0 release of OpenStudio (not including opened pull requests).
- 33 issues were closed since the 1.4.0 release of OpenStudio (not including closed pull requests).
Consumption - Buildings and Heating
- C++
Published by axelstudios over 10 years ago

OpenStudio - OpenStudio v1.4.3
Consumption - Buildings and Heating
- C++
Published by axelstudios over 10 years ago

OpenStudio - OpenStudio v1.4.2
Consumption - Buildings and Heating
- C++
Published by axelstudios over 10 years ago

OpenStudio - OpenStudio v1.4.0v2
Consumption - Buildings and Heating
- C++
Published by axelstudios over 10 years ago

OpenStudio - OpenStudio v1.4.1
Consumption - Buildings and Heating
- C++
Published by axelstudios over 10 years ago

OpenStudio - OpenStudio v1.4.0
These release notes describe version 1.4.0 of the OpenStudio software suite developed by the National Renewable Energy Laboratory (NREL), Buildings and Thermal Systems, Commercial Buildings Research Group, Tools Development Section, and associated collaborators. The notes are organized into the following sections:
- Where to Find OpenStudio Documentation
- Installation Notes
- Overview
- New Features
- Known Issues
Where to Find OpenStudio Documentation
- OpenStudio release documentation, including these release notes, tutorials, and other user documentation, is available at http://openstudio.nrel.gov/documentation.
- C++ API documentation is available at http://openstudio.nrel.gov/sdk-documentation.
- Measure development documentation is available at https://github.com/NREL/OpenStudio/wiki/Measure-Writing-Guide.
- OpenStudio Life Cycle Costing Examples are available at http://openstudio.nrel.gov/openstudio-life-cycle-examples.
Installation Notes
OpenStudio is supported on Windows 7 – 8.1, OS X 10.8 – 10.9, and Ubuntu 12.04.
OpenStudio 1.4.0 supports EnergyPlus Release 8.1.
Installation Steps
- Download and install EnergyPlus 8.1.
- Download EnergyPlus 8.1. Create an account and login if you don't already have one.
- OpenStudio will work with 32 or 64bit EnergyPlus installers.
- The OpenStudio SketchUp Plug-in requires Sketchup 8.0 or SketchUp 2013 (not available for Linux). SketchUp 2014 is not supported.
- Create an OpenStudio account, then download and install OpenStudio.
- Setup a Building Component Library (BCL) account to access online building components and measures. View instructions on how to setup your account and configure the key in OpenStudio.
Optional Installation Steps
- For Radiance integration, download and install Radiance.
- If you plan to use the OpenStudio SDK Ruby bindings via command prompt on Windows, download and extract ruby.zip to C:\Ruby (or other desired location), and add C:\Ruby\bin to the PATH environment variable.
Overview
This OpenStudio 1.4.0 release is the first major release compatible with EnergyPlus 8.1. OpenStudio 1.4.0 is also the last release to be built on Ruby 1.8. Therefore, this is the last release for which the OpenStudio SketchUp Plug-in will be compatible with SketchUp 8 and SketchUp 2013. The OpenStudio SketchUp Plug-in will only be compatible with SketchUp 2014 and above in future releases of OpenStudio. The most significant new feature in OpenStudio 1.4.0 is the ability to apply measures directly to the current model in the OpenStudio Application. This exciting new feature enables new workflows based around OpenStudio measures and gives immediate feedback on the application of measures.
Other notable improvements:
- ASHRAE 90.1 2007 and 2010 internal loads and constructions have been added to the OpenStudio templates.
- PAT now exports a spreadsheet format compatible with the OpenStudio-analysis-spreadsheet project for running large parametric analyses using cloud resources.
- Improvements to the CONTAM translator and to EPW File parsing were contributed by partners at the Consortium for Building Energy Innovation.
- New ZoneControlHumidistat and AirLoopHVACUnitarySystem objects as well as multiple performance improvements were contributed by partners at Oak Ridge National Laboratory.
- Radiance support has been improved to search for NREL Radiance packages, (https://github.com/NREL/Radiance/releases), and to prefer those over any other Radiance installation.
- New experimental Java bindings are available on request.
- Multiple performance improvements and bug fixes.
New Features
OpenStudio Platform 1.4.0
- New ZoneControlHumidistat and AirLoopHVACUnitarySystem model objects – Contributed by Oak Ridge National Laboratory. See the OpenStudio Contributors page.
- Improvements to the CONTAM translator and to EPW File parsing were contributed by partners at the Consortium for Building Energy Innovation. See the OpenStudio Contributors page.
- Other HVAC objects added from the OpenStudio HVAC roadmap.
- Improved general performance, stability, and usability.
OpenStudio SketchUp Plug-in 1.4.0
- ASHRAE 90.1 2007 and 2010 internal loads and constructions have been added to the OpenStudio templates.
OpenStudio Application 1.4.0
- New feature allows users to apply measures directly to the current model.
- ASHRAE 90.1 2007 and 2010 internal loads and constructions have been added to the OpenStudio templates.
- Improved general performance, stability, and usability.
OpenStudio ParametricAnalysisTool 1.4.0
- PAT now exports a spreadsheet format compatible with the OpenStudio-analysis-spreadsheet project for running large parametric analyses using cloud resources.
- Improved general performance, stability, and usability.
OpenStudio RunManager 1.4.0
- No changes.
OpenStudio ResultsViewer 1.4.0
- No changes.
OpenStudio Ruby Bindings 1.4.0
- Performance improvements.
OpenStudio C# Bindings 1.4.0
- New methods for casting between OpenStudio model object types.
- Performance improvements.
OpenStudio Python Bindings 1.4.0
- Performance improvements.
- Python bindings are not packaged with OpenStudio. To use them see our developer page for guidance on building OpenStudio.
OpenStudio JavaScript V8 Bindings 1.4.0
- No changes.
- JavaScript bindings are not packaged with OpenStudio. To use them see our developer page for guidance on building OpenStudio.
OpenStudio Java Bindings 1.4.0
- New experimental Java bindings are available on request.
- Java bindings are not packaged with OpenStudio. To use them see our developer page for guidance on building OpenStudio.
Known Issues
The following are issues known at the time of publication of these release notes. Please contact [email protected] if you require further assistance.
Known Issues Common to All Platforms
OpenStudio SketchUp Plug-in
- If you use copy multiple on group-level OpenStudio objects, you will get one extra copy. The extra group is created by the first copy-and-paste operation and is not removed when the copy multiple occurs. To address this, after you perform a copy multiple procedure on groups or spaces, press delete. The objects you need to delete should already be selected. If you are copying loose surfaces such as windows, there are no problems, as SketchUp will merge equivalent surfaces. [issue #28]
- Using SketchUp's undo operation on OpenStudio model elements may produce unexpected results. [issues #54 and #150]
- SKP and OSM link is not maintained when files are relocated. However, you can manually re-establish that link. When opening a SketchUp file, launch SketchUp and then open the SketchUp file. If that doesn't work you can also directly load the OSM file, bypassing the SKP file. [issue #409]
- It is possible for the OpenStudio plug-in to conflict with other SketchUp plug-ins. If you suspect this is a problem, try testing with other plug-ins disabled, or contact [email protected] for assistance. [issue #26]
- Using "Intersect" in the surface matching dialog can result in a crash or unexpected results. This is more common with models that were imported from other CAD formats at some point in the workflow. It is a good idea to save prior to using this to avoid any loss of data. This is related to an underlying SketchUp bug. [issue #168]
- "Project Loose Geometry" can crash SketchUp. It is a good idea to save prior to using this to avoid any loss of data. [issue #484]
- Adjacent stacked spaces in same zones may result in incorrect area and likely loads as well. [issue #561]
- SaveAs in SketchUp corrupts measures in model. To avoid this, only add measures into model after work in SketchUp is done. [issue #754]
- Using AutoSave in SketchUp can overwrite changes made in OS app if the file is open in both locations. [issue #899]
If your OpenStudio model crashes SketchUp or has unexpected behavior please forward it to [email protected] with a description of the problem. Please also include the directory that has the same name as the OSM file. You can attach it as a zip file.
OpenStudio Application
- Similar thermostats assigned in the SketchUp Plug-in are shared across thermal zones in the OpenStudio application. Changing or turning off one will do the same to others. [issue #123]
- The view does not always refresh correctly when you delete a material from a construction. If you still see a material after clicking the "x", switch away from and back to the object to refresh the view. [issue #196]
- Some pull-down lists in simulation settings don't work. [issue #496]
- OS App Schedule Editor allows entering values outside of type limits. [issue #531]
- All drop zones under Water Use Equipment Definitions doesn't enforce schedule types. [issue #532]
- Removing CoilHeatingWater objects can result in orphaned hot water coils. [issue #594]
- Some HVAC components in OpenStudio are missing from the HVAC Library (e.g. Fan:OnOff). [issue #599]
- Several objects in OpenStudio appear to accept erroneous input values, but seems like it is just displaying the erroneous value and not storing it. [issue #656]
- Attempting to autosize a WaterHeater will result in an error. [issue #669]
- Entering an invalid date on the Utility Bills subtab crashes OpenStudio. [issue #739]
- To enable set point schedule drop zones on the Thermal Zones tab, you need to first turn on the thermostat.
- The Site / Utility Rates subtab in the workflow is marked as "coming soon," and will be completed in an upcoming release of OpenStudio.
- The default reporting measures used for the results tab show results in IP units, and do not react to changes in the user's unit preferences. That will be addressed in future versions of OpenStudio. The measure can be altered to show SI units instead.
- It is not possible to choose or define a refrigeration case (or walkin) re-stocking schedule in the "Grid" view or the "Layout" view; the drop down list is blank. [issue #966]
- IDF import brings in but does not hook up design spec outdoor air. [issue #971]
OpenStudio ParametricAnalysisTool
- NOTE: when using cloud service please make sure to stop the cloud using the cloud button in PAT when your simulation session is done, and after you have downloaded all of the detailed results you want. You are also strongly encouraged to go to the AWS Management Console to confirm that all instances are terminated. If they are not terminated, you will need to manually terminate them from the console. We have a sticky post on our forum with best practices for cloud simulation in OpenStudio.
- Daylighting control object variables can't be requested in the output variables tab. [issue #355]
- Adding a design alternative using measure groups will remove any design alternatives made from external files. However, you can add a design alternative made from external files without losing design alternatives made from measure groups. [issue #369]
- Always Run measures are applied to externally constructed design alternatives. This may result in unexpected results or errors. [issue #369]
OpenStudio ResultsViewer
- Alias changes do not update in table view until the data are read in again. [issue #25]
- Re-arranged column order doesn't stick next launch. [issue #30]
OpenStudio RunManager
- EnergyPlus ForwardTranslator errors do not appear in the RunManager GUI elements. [issue #181]
OpenStudio Platform, Including SWIG Bindings
- IdfObject::getQuantity and IdfObject::setQuantity functionality is not comprehensive. The quantity getters and setters for fields whose units are "BasedOnField AX" are not expected to work at the IdfObject level, but are to be handled only for OS: prefixed objects by the specific interfaces of classes derived from ModelObject.
- The default naming scheme of WorkspaceObject (base class for ModelObject, etc.) sometimes results in undesired name clashes when transferring objects between models, including in the EnergyPlus translators. Therefore, some objects may be unexpectedly renamed or copied.
- OpenStudio::Model::ComponentVector objects may be inaccessible from the Ruby bindings. [issue #239]
- If schedule type limits fields are not set properly, OS will not give error but also will not hook up affected schedules. [issue #967]
- There is no default construction for adiabatic surfaces. [issue #974]
- Cloning a building disconnects spaces from thermal zones. [issue #980]
Known Issues Specific to OS X
- The SketchUp Plug-in toolbar tooltips do not work correctly on OS X if you have made your toolbars horizontal. The tooltips never show on OS X in the status bar. The button state may also be incorrect. This is a bug in SketchUp versus the plug-in. [issue #45]
- OpenStudio 1.4 does not support SketchUp 2014 on Mac. This will be addressed in the next release after switching to Ruby 2.0.
Bug Analytics Since Previous Release
- 78 new issues were filed since the 1.3.0 release of OpenStudio (not including opened pull requests).
- 67 issues were closed since the 1.3.0 release of OpenStudio (not including closed pull requests).
Consumption - Buildings and Heating
- C++
Published by axelstudios almost 11 years ago

OpenStudio - OpenStudio v1.3.5
Consumption - Buildings and Heating
- C++
Published by axelstudios almost 11 years ago

OpenStudio - OpenStudio v1.3.4
Consumption - Buildings and Heating
- C++
Published by axelstudios almost 11 years ago

OpenStudio - OpenStudio v1.3.3
Consumption - Buildings and Heating
- C++
Published by axelstudios almost 11 years ago

OpenStudio - OpenStudio v1.3.2
Consumption - Buildings and Heating
- C++
Published by axelstudios about 11 years ago

OpenStudio - OpenStudio v1.3.1
Consumption - Buildings and Heating
- C++
Published by axelstudios about 11 years ago

OpenStudio - OpenStudio v1.3.0
These release notes describe version 1.3.0 of the OpenStudio software suite developed by the National Renewable Energy Laboratory (NREL), Buildings and Thermal Systems, Commercial Buildings Research Group, Tools Development Section, and associated collaborators. The notes are organized into the following sections:
- Where to Find OpenStudio Documentation
- Installation Notes
- Overview
- New Features
- Known Issues
Where to Find OpenStudio Documentation
- OpenStudio release documentation, including these release notes, tutorials, and other user documentation, is available at http://openstudio.nrel.gov/documentation.
- C++ API documentation is available at http://openstudio.nrel.gov/sdk-documentation.
- Measure writing documentation is available at http://openstudio.nrel.gov/openstudio-measure-writing-guide
- OpenStudio Life Cycle Costing Examples are available at http://openstudio.nrel.gov/openstudio-life-cycle-examples
Installation Notes
OpenStudio is supported on Windows XP – 8.1, OS X 10.8 – 10.9, and Ubuntu 12.04.
OpenStudio Version 1.3.0 supports EnergyPlus Release 8.0.
Installation Steps
- Download and install EnergyPlus 8.0.
- Download EnergyPlus 8.0. Create an account and login if you don’t already have one.
- OpenStudio will work with 32 or 64bit EnergyPlus installers.
- The OpenStudio SketchUp Plug-in requires Sketchup 8.0 or SketchUp 2013 (not available for Linux). SketchUp 2014 is supported for Windows, but not yet for Mac.
- Create an OpenStudio account, then download and install OpenStudio.
- Setup a Building Component Library (BCL) account to access online building components and measures. View instructions on how to setup your account and configure the key in OpenStudio.
Optional Installation Steps
- For Radiance integration, download and install Radiance.
- If you plan to use the OpenStudio SDK Ruby bindings via command prompt on Windows, download and extract ruby.zip to C:\Ruby (or other desired location), and add C:\Ruby\bin to the PATH environment variable.
Overview
Development for OpenStudio 1.3.0 has two main focuses.
- Development continuation of the refrigeration interface and addition of new refrigeration model objects. This resulted in a new detailed component grid-view of refrigeration systems. The development was carried out with requirements gathering and guidance from practitioners. The new refrigeration objects include contributions from Oak Ridge National Laboratory.
- Enhancements of model objects and methods in support of a collection of Energy Conservation Measures. ECMs were developed to model the recommendations from both the ASHRAE 50% Advanced Energy Design Guide for K-12 Schools, and the ASHRAE 50% Advanced Energy Design Guide for Small to Medium Offices. The ECMs are posted to the Building Component Library (BCL) in conjunction with this OpenStudio release. In addition, ECM supporting material is included with the OpenStudio installer. This includes:
- A new multi-space type office template.
- New objects to map constructions and space types to their intended uses.
- New fenestration methods to describe view and daylight fenestration and skylights.
New Features
OpenStudio Platform 1.3.0
- Improved Standards Data Dictionary (SDD) translation for the California Energy Commission’s CBECC tool.
- Added model objects needed for refrigeration systems – Contributed by Oak Ridge National Laboratory.
See the OpenStudio’s Contributors page. - Added HVAC objects from the OpenStudio’s HVAC roadmap.
- Added climate zone tags to the model. This is in support of measures that need to know what climate zone the model is in.
- Added tags to constructions to indicate both the intended surface type and the standards construction type. This is in support of measures that need to know if a construction represents a steel framed or mass wall.
- Added tags to space types to indicate what building type it is intended for, and what specific space type to map it to. This is in support of measure that will apply to only certain types of spaces.
- Added tags to the building object to indicate what building type this model represents. This is also in support of measures that have different behaviors depending upon the building type.
- Created a new multi-space type Office Template to replace the whole building small, medium and large office templates. This allows measures to be applied to specific space types within and office building. It also gives the modeler more control over the ratio of various space types in their model.
- Added new methods to create and apply skylight grids to roofs.
- Added new methods to apply view and daylight glazing in conjunction with exterior shading and interior light shelves.
OpenStudio SketchUp Plug-in 1.3.0
- Updated templates to use the new tags added for constructions and space types. Also, updated infiltration to be on a per exterior wall area vs. air changes per hour.
- Continued to develop experimental user script to import OpenStudio spaces as standard SketchUp groups and to merge SketchUp groups back to OSM files.
OpenStudio Application 1.3.0
- Added customizable pull down menus for standards related tags for climate zones, constructions, space types, and building types. These menus show up in the site, constructions, space types, and facility tabs.
- Updated refrigeration systems in the GUI to support walkin cases.
- Added a detailed component based interface for refrigeration systems interface including cascading systems. A grid style interface has also been added to view multiple refrigerated cases and walkins all in a single view.
- Added support for Variable Refrigerant Flow (VRF) systems.
- Added support for zone exhaust fans.
- Added support for supply and return plenums.
OpenStudio ParametricAnalysisTool 1.3.0
- Improved general performance, stability, and usability.
OpenStudio RunManager 1.3.0
- No changes.
OpenStudio ResultsViewer 1.3.0
- No changes.
OpenStudio Ruby Bindings 1.3.0
- No changes.
OpenStudio C# Bindings 1.3.0
- No changes.
OpenStudio Python Bindings 1.3.0
- No changes.
- Python bindings are not packaged with OpenStudio. To use them see our developer page for guidance on building OpenStudio.
OpenStudio JavaScript V8 Bindings 1.3.0
- No changes.
- JavaScript bindings are not packaged with OpenStudio. To use them see our developer page for guidance on building OpenStudio.
Known Issues
The following are issues known at the time of publication of these release notes. Please contact [email protected] if you require further assistance.
Known Issues Common to All Platforms
OpenStudio SketchUp Plug-in
- If you use copy multiple on group-level OpenStudio objects, you will get one extra copy. The extra group is created by the first copy-and-paste operation and is not removed when the copy multiple occurs. To address this, after you perform a copy multiple procedure on groups or spaces, press delete. The objects you need to delete should already be selected. If you are copying loose surfaces such as windows, there are no problems, as SketchUp will merge equivalent surfaces. [issue #28]
- Using SketchUp's undo operation on OpenStudio model elements may produce unexpected results. [issues #54 and #150]
- SKP and OSM link is not maintained when files are relocated. You can manually re-establish that link. When opening a SketchUp file Launch SketchUp and then Open the SketchUp file. If that doesn't work you can also directly load the OSM file, bypassing the SKP file. [issue #409]
- It is possible for the OpenStudio Plug-in to conflict with other SketchUp plug-ins. If you suspect this is a problem, try testing with other plug-ins disabled, or contact [email protected] for assistance. [issue #26]
- Using "Intersect" in the surface matching dialog can result in a crash or unexpected result. This is more common with models that were imported from other CAD formats at some point in the workflow. It is a good idea to save prior to using this to avoid any loss of data. This is related to an underlying SketchUp bug. [issue #168]
- "Project Loose Geometry" can crash SketchUp. It is a good idea to save prior to using this to avoid any loss of data. [issue #484]
- Adjacent stacked spaces in same zones may result in incorrect area and likely loads as well. [issue #561]
- SaveAs in SketchUp corrupts measures in model. To avoid this, only add measures into model after work in SketchUp is done. [issue #754]
- Using AutoSave in SketchUp can overwrite changes made in OS app if the file is open in both locations. [issue #899]
If your OpenStudio model crashes SketchUp or has unexpected behavior please forward it to [email protected] with a description of the problem. Please also include the directory that has the same name as the OSM file. You can attach it as a zip file.
OpenStudio Application
- Similar thermostats assigned in the SketchUp Plug-in are shared across thermal zones in the OpenStudio application. Changing or turning off one will do the same to others. [issue #123]
- The view does not always refresh correctly when you delete a material from a construction. If you still see a material after clicking the “x”, switch away from and back to the object to refresh the view. [issue #196]
- Some pull-down lists in simulation settings don't work. [issue #496]
- OS App Schedule Editor lets me enter values outside of type limits. [issue #531]
- All drop zones under Water Use Equipment Definitions doesn't enforce schedule types. [issue #532]
- Removing CoilHeatingWater objects can result in orphaned hot water coils. [issue #594]
- Some HVAC components in OpenStudio are missing from the HVAC Library (e.g. Fan:OnOff). [issue #599]
- Many objects in OpenStudio still appear to accept bad input values, but seems like it is just displaying the bad value and not storing it. [issue #656]
- Attempting to autosize a WaterHeater will result in an error. [issue #669]
- Entering an invalid date on the Utility Bills subtab crashes OpenStudio. [issue #739]
- RefrigeratedCaseAndWalkinListName field showing in inspector when it should not. [issue #946]
- OpenStudio App will crash if you create a new “Glazing Group Thermochromic Windows Material”. [issue #949]
- To enable set point schedule drop zones on the Thermal Zones tab, you need to first turn on the thermostat.
- The Site / Utility Rates subtab in the workflow are marked as “coming soon,” and will be completed in an upcoming release of OpenStudio.
- The default reporting measures used for the results tab show results in IP units, and do not react to changes in the user’s unit preferences. That will be addressed in future versions of OpenStudio. The measure can be altered to show SI units instead.
- The OSM to Radiance translation doesn’t support solar diffusing. This affects materials that have a switch in the GUI for “Solar Diffusing” when you use radiance for daylighting calculations.
OpenStudio ParametricAnalysisTool
- NOTE: when using cloud service please make sure to stop the cloud using the cloud button in PAT when your simulation session is done, and after you have downloaded all of the detailed results you want. You can then go the AWS Management Console to confirm the instances are terminated. If they are not terminated, you can manually terminate them from the console. We have a sticky post on our forum with best practices for cloud simulation in OpenStudio.
- PAT won't prevent you from loading OSM files that are from a newer version of OpenStudio than you have installed, but the analysis won't run. [issue #330]
- Daylighting control object variables can't be requested in the output variables tab. [issue #355]
- Adding a design alternative using measure groups will remove any design alternatives made from external files. You can however add a design alternative made from external files without losing design alternatives made from measure groups. [issue #369]
- Always Run measures are applied to externally constructed design alternatives. This may result in unexpected results or errors. [issue #369]
- If a measure causes a ruby error, the error details won’t show in PAT, and you may see a failed job without an indication of which task it failed on. [issue #939]
- PAT can crash in certain cases when a measure instance is removed from tab 1 but its arguments still shows up in the inspector. [issue #941]
OpenStudio ResultsViewer
- Alias changes do not update in table view until the data are read in again. [issue #25]
- Re-arranged column order doesn't stick next launch. [issue #30]
OpenStudio RunManager
- EnergyPlus ForwardTranslator errors do not appear in the RunManager GUI elements. [issue #181]
OpenStudio Platform, Including SWIG Bindings
- IdfObject::getQuantity and IdfObject::setQuantity functionality is almost, but not completely, comprehensive. The quantity getters and setters for fields whose units are "BasedOnField AX" are not expected to work at the IdfObject level, but are to be handled only for OS: prefixed objects by the specific interfaces of classes derived from ModelObject.
- The default naming scheme of WorkspaceObject (base class for ModelObject, etc.) sometimes results in undesired name clashes when transferring objects between models, including in the EnergyPlus translators. Therefore, some objects may be unexpectedly renamed or copied.
- OpenStudio::Model::ComponentVector objects may be inaccessible from the Ruby bindings. [issue #239]
Known Issues Specific to OS X
- To Install OpenStudio 1.0 and greater correctly on OS X you need to first uninstall earlier versions of OpenStudio. [issue #365]
- The SketchUp Plug-in toolbar tooltips do not work correctly on OS X if you have made your toolbars horizontal. The tooltips never show on OS X in the status bar. The button state may also be incorrect. This is a bug in SketchUp versus the plug-in. [issue #45]
- OpenStudio 1.3.0 doesn’t support SketchUp 2014 on Mac. This will be addressed in a future release.
Bug Analytics Since Previous Release
- 117 new issues were filed since the 1.2.0 release of OpenStudio (not including closed pull requests).
- 46 issues were closed since the 1.2.0 release of OpenStudio (not including closed pull requests).
Consumption - Buildings and Heating
- C++
Published by axelstudios about 11 years ago

OpenStudio - OpenStudio v1.2.5
Consumption - Buildings and Heating
- C++
Published by axelstudios about 11 years ago

OpenStudio - OpenStudio v1.2.4
Consumption - Buildings and Heating
- C++
Published by axelstudios about 11 years ago

OpenStudio - OpenStudio v1.2.3
Consumption - Buildings and Heating
- C++
Published by axelstudios about 11 years ago

OpenStudio - OpenStudio v1.2.2
Consumption - Buildings and Heating
- C++
Published by axelstudios over 11 years ago

OpenStudio - OpenStudio v1.2.1
Consumption - Buildings and Heating
- C++
Published by axelstudios over 11 years ago

OpenStudio - OpenStudio v1.2.0
These release notes describe version 1.2.0 of the OpenStudio software suite developed by the National Renewable Energy Laboratory (NREL), Buildings and Thermal Systems, Commercial Buildings Research Group, Tools Development Section, and associated collaborators. The notes are organized into the following sections:
- Where to Find OpenStudio Documentation
- Installation Notes
- Overview
- New Features
- Known Issues
Where to Find OpenStudio Documentation
- OpenStudio release documentation, including these release notes, tutorials, and other user documentation, is available at http://openstudio.nrel.gov/documentation.
- C++ API documentation is available at http://openstudio.nrel.gov/sdk-documentation.
- Measure writing documentation is available at http://openstudio.nrel.gov/openstudio-measure-writing-guide
- OpenStudio Life Cycle Costing Examples are available at http://openstudio.nrel.gov/openstudio-life-cycle-examples
Installation Notes
OpenStudio is supported on Windows XP – 8.1, OS X 10.8 – 10.9, and Ubuntu 12.04.
Installation Steps
- Download and install EnergyPlus 8.0.
- Download EnergyPlus 8.0. Create an account and login if you don’t already have one.
- OpenStudio will work with 32 or 64bit EnergyPlus installers.
- The OpenStudio SketchUp Plug-in requires Sketchup 8.0 or SketchUp 2013 (not available for Linux).
- Create an OpenStudio account, then download and install OpenStudio.
- Setup a Building Component Library (BCL) account to access online building components and measures. View instructions on how to setup your account and configure the key in OpenStudio.
Optional Installation Steps
- For Radiance integration, download and install Radiance.
- If you plan to use the OpenStudio SDK Ruby bindings via command prompt on Windows, download and extract ruby.zip to C:\Ruby (or other desired location), and add C:\Ruby\bin to the PATH environment variable.
Overview
OpenStudio 1.2.0 implements entirely new results visualization. Modelers and developers can create custom reporting measures that show up directly in the OpenStudio application’s results tab. These reporting measures can be shared on the Building Component Library and downloaded directly into the OpenStudio application. This release also features a number of important contributions from external collaborators:
- Oak Ridge National Laboratory added back-end functionality for the modeling of refrigeration systems.
- Penn State University added translation to CONTAM input files.
- Argonne National Laboratory implemented a fast CEN/ISO monthly building energy model calculation.
Also, several new HVAC objects were added, and the initial refrigeration GUI was created within the OpenStudio application’s HVAC systems tab.
New Features
OpenStudio Platform 1.2.0
- Implementation of a fast CEN/ISO monthly building energy model calculation – Contributed by Argonne National Laboratory. See the OpenStudio’s Contributors page.
- Translation of OpenStudio Model to CONTAM input file – Contributed by Penn State University. See the OpenStudio’s Contributors page.
- New methods for intersection of adjacent surfaces.
- Improved Standards Data Dictionary (SDD) translation for the California Energy Commission’s CBECC tool.
- Addition of model objects needed for refrigeration systems – Contributed by Oak Ridge National Laboratory. See the OpenStudio’s Contributors page.
- Added HVAC objects from the OpenStudio’s HVAC roadmap.
OpenStudio SketchUp Plug-in 1.2.0
- Improved general performance, stability, and usability.
- Continued to develop experimental user script to convert SketchUp groups to OpenStudio spaces.
OpenStudio Application 1.2.0
- Added user-customizable plotting in reporting measures. Reporting measures, introduced in a previous version, have access to the OpenStudio model, the IDF file, and the resulting EnergyPlus SQL results. If a reporting measure creates an html file it will be viewable via a pull-down menu in the OpenStudio application results tab. The two examples that come with OpenStudio use the D3 library to create graphs. More reporting measures will be added to the BCL and accessible directly within the OpenStudio application.
- Added refrigeration systems to the HVAC Systems tab. This work will continue to develop in our next release.
OpenStudio ParametricAnalysisTool 1.2.0
- Improved general performance, stability, and usability.
OpenStudio RunManager 1.2.0
- No changes.
OpenStudio ResultsViewer 1.2.0
- No changes.
OpenStudio Ruby Bindings 1.2.0
- No changes.
OpenStudio C# Bindings 1.2.0
- No changes.
OpenStudio Python Bindings 1.2.0
- No changes.
- Python bindings are not packaged with OpenStudio. To use them see our developer page for guidance on building OpenStudio.
OpenStudio JavaScript V8 Bindings 1.2.0
- No changes.
- JavaScript bindings are not packaged with OpenStudio. To use them see our developer page for guidance on building OpenStudio.
Known Issues
The following are issues known at the time of publication of these release notes. Please contact [email protected] if you require further assistance.
Known Issues Common to All Platforms
OpenStudio SketchUp Plug-in
- If you use copy multiple on group-level OpenStudio objects, you will get one extra copy. The extra group is created by the first copy-and-paste operation and is not removed when the copy multiple occurs. To address this, after you perform a copy multiple procedure on groups or spaces, press delete. The objects you need to delete should already be selected. If you are copying loose surfaces such as windows, there are no problems, as SketchUp will merge equivalent surfaces. [issue #28]
- Using SketchUp's undo operation on OpenStudio model elements may produce unexpected results. [issues #54 and #150]
- SKP and OSM link is not maintained when files are relocated. You can manually re-establish that link. When opening a SketchUp file Launch SketchUp and then Open the SketchUp file. If that doesn't work you can also directly load the OSM file, bypassing the SKP file. [issue #409]
- It is possible for the OpenStudio Plug-in to conflict with other SketchUp plug-ins. If you suspect this is a problem, try testing with other plug-ins disabled, or contact [email protected] for assistance. [issue #26]
- Using "Intersect" in the surface matching dialog can result in a crash or unexpected result. This is more common with models that were imported from other CAD formats at some point in the workflow. It is a good idea to save prior to using this to avoid any loss of data. This is related to an underlying SketchUp bug. [issue #168]
- "Project Loose Geometry" can crash SketchUp. It is a good idea to save prior to using this to avoid any loss of data. [issue #484]
- Adjacent stacked spaces in same zones may result in incorrect area and likely loads as well. [issue #561]
If your OpenStudio model crashes SketchUp or has unexpected behavior please forward it to [email protected] with a description of the problem. Please also include the directory that has the same name as the OSM file. You can attach it as a zip file.
OpenStudio Application
- The Annual CV (RMSE) and NMBE numbers in Calibration report do not change color if they fail Calibration method (FEMP vs. ASHRAE) limits. [issue #740]
- Similar thermostats assigned in the SketchUp Plug-in are shared across thermal zones in the OpenStudio application. Changing or turning off one will do the same to others. [issue #123]
- The view does not always refresh correctly when you delete a material from a construction. If you still see a material after clicking the “x”, switch away from and back to the object to refresh the view. [issue #196]
- Some pull-down lists in simulation settings don't work. [issue #496]
- OS App Schedule Editor lets me enter values outside of type limits. [issue #531]
- All drop zones under Water Use Equipment Definitions doesn't enforce schedule types. [issue #532]
- Removing CoilHeatingWater objects can result in orphaned hot water coils. [issue #594]
- Some HVAC components in OpenStudio are missing from the HVAC Library (e.g. Fan:OnOff). [issue #599]
- Many objects in OpenStudio still appear to accept bad input values, but seems like it is just displaying the bad value and not storing it. [issue #656]
- Attempting to autosize a WaterHeater will result in an error. [issue #669]
- Entering an invalid date on the Utility Bills subtab crashes OpenStudio. [issue #739]
- To enable set point schedule drop zones on the Thermal Zones tab, you need to first turn on the thermostat.
- The Site / Utility Rates subtab the workflow are marked as “coming soon,” and will be completed in an upcoming release of OpenStudio.
- The default reporting measures used for the results tab show results in IP units, and do not react to changes in the user’s unit preferences. That will be addressed in future versions of OpenStudio. The measure can be altered to show SI units instead.
- Due to the change in the results tab in OpenStudio 1.2.0, if you open an OSM model made with an earlier version of OpenStudio, you will have to re-run the simulation to see results within the OpenStudio application. The previous results still exist without a re-urn if you just want access to the standard EnergyPlus output.
- The HVAC library shows a “Refrigeration Walkin” object, but the GUI doesn’t support it yet. It doesn’t let you drop it into the model. “Refrigeration Case” does work.
OpenStudio ParametricAnalysisTool
- NOTE: when using cloud service please make sure to stop the cloud using the cloud button in PAT when your simulation session is done, and after you have downloaded all of the detailed results you want. You can then go the AWS Management Console to confirm the instances are terminated. If they are not terminated, you can manually terminate them from the console. We have a sticky post on our forum with best practices for cloud simulation in OpenStudio.
- PAT won't prevent you from loading OSM files that are from a newer version of OpenStudio than you have installed, but the analysis won't run. [issue #330]
- Daylighting control object variables can't be requested in the output variables tab. [issue #355]
- Adding a design alternative using measure groups will remove any design alternatives made from external files. You can however add a design alternative made from external files without losing design alternatives made from measure groups. [issue #369]
- Always Run measures are applied to externally constructed design alternatives. This may result in unexpected results or errors. [issue #369]
OpenStudio ResultsViewer
- Alias changes do not update in table view until the data are read in again. [issue #25]
- Re-arranged column order doesn't stick next launch. [issue #30]
OpenStudio RunManager
- EnergyPlus ForwardTranslator errors do not appear in the RunManager GUI elements. [issue #181]
OpenStudio Platform, Including SWIG Bindings
- IdfObject::getQuantity and IdfObject::setQuantity functionality is almost, but not completely, comprehensive. The quantity getters and setters for fields whose units are "BasedOnField AX" are not expected to work at the IdfObject level, but are to be handled only for OS: prefixed objects by the specific interfaces of classes derived from ModelObject.
- The default naming scheme of WorkspaceObject (base class for ModelObject, etc.) sometimes results in undesired name clashes when transferring objects between models, including in the EnergyPlus translators. Therefore, some objects may be unexpectedly renamed or copied.
- OpenStudio::Model::ComponentVector objects may be inaccessible from the Ruby bindings. [issue #239]
Known Issues Specific to OS X
- To Install OpenStudio 1.0 and greater correctly on OS X you need to first uninstall earlier versions of OpenStudio. [issue #365]
- The SketchUp Plug-in toolbar tooltips do not work correctly on OS X if you have made your toolbars horizontal. The tooltips never show on OS X in the status bar. The button state may also be incorrect. This is a bug in SketchUp versus the plug-in. [issue #45]
Bug Analytics Since Previous Release
- 60 new issues were filed since the 1.1.0 release of OpenStudio (not including closed pull requests).
- 35 issues were closed since the 1.1.0 release of OpenStudio (not including closed pull requests).
Consumption - Buildings and Heating
- C++
Published by axelstudios over 11 years ago

OpenStudio - OpenStudio v1.1.3
Consumption - Buildings and Heating
- C++
Published by axelstudios over 11 years ago

OpenStudio - OpenStudio v1.1.2
Consumption - Buildings and Heating
- C++
Published by axelstudios over 11 years ago

OpenStudio - OpenStudio v1.1.1
Consumption - Buildings and Heating
- C++
Published by axelstudios over 11 years ago

OpenStudio - OpenStudio v1.1.0
These release notes describe version 1.1.0 of the OpenStudio software suite developed by the National Renewable Energy Laboratory (NREL), Buildings and Thermal Systems, Commercial Buildings Research Group, Tools Development Section, and associated collaborators. The notes are organized into the following sections:
- Where to Find OpenStudio Documentation
- Installation Notes
- Overview
- New Features
- Known Issues
Where to Find OpenStudio Documentation
- OpenStudio release documentation, including these release notes, tutorials, and other user documentation, is available at http://openstudio.nrel.gov/documentation.
- C++ API documentation is available at http://openstudio.nrel.gov/sdk-documentation.
- Measure writing documentation is available at http://openstudio.nrel.gov/openstudio-measure-writing-guide
- OpenStudio Life Cycle Costing Examples are available at http://openstudio.nrel.gov/openstudio-life-cycle-examples
Installation Notes
OpenStudio is supported on Windows XP – 8.1, OS X 10.7 – 10.8, and Ubuntu 12.04.
Installation Steps
- Download and install EnergyPlus 8.0.
- Download EnergyPlus 8.0. Create an account and login if you don’t already have one.
- OpenStudio will work with 32 or 64bit EnergyPlus installers.
- The OpenStudio SketchUp Plug-in requires Sketchup 8.0 or SketchUp 2013 (not available for Linux).
- Create an OpenStudio account, then download and install OpenStudio.
- Setup a Building Component Library (BCL) account to access online building components and measures. View instructions on how to setup your account and configure the key in OpenStudio.
Optional Installation Steps
- For Radiance integration, download and install Radiance.
- If you plan to use the OpenStudio SDK Ruby bindings via command prompt on Windows, download and extract ruby.zip to C:\Ruby (or other desired location), and add C:\Ruby\bin to the PATH environment variable.
Overview
OpenStudio 1.1.0 adds support for manual calibration of simulation results from monthly utility data. A new reporting measure type was introduced that has access to input data and simulation results that can be used to create custom reports and to perform automated quality control checks. Another major new feature is simulation using cloud computing resources through Amazon EC2. Users first set up an account with Amazon and link it to OpenStudio. The ParametricAnalysisTool (PAT) can then be used to run simulations locally or on Amazon EC2. This feature is still under active development to improve process connection and performance, and users are strongly urged to carefully review all disclaimer text and provided EC2 monitor web links in the cloud configuration dialogs. This version of OpenStudio also adds support for EnergyPlus 8.0 along with a number of new HVAC components.
New Features
OpenStudio Platform 1.1.0
- Added support for EnergyPlus 8.0.
- Added a new calibration feature that compares monthly utility data to simulation results. Users should use an actual meteorological year (AMY) weather file for best results.
- Added support for reporting measures that can process model inputs and simulation outputs as part of a workflow.
- Added back-end support for parallel simulation using Vagrant and Amazon EC2 instances. This feature is still under active development to improve performance and stability of distributed computing resources. Simulations in PAT may still be run locally as well.
OpenStudio SketchUp Plug-in 1.1.0
- Improved general performance, stability, and usability.
- Added shading controls for sub-surfaces.
- Added experimental user script to convert SketchUp groups to OpenStudio spaces.
OpenStudio Application 1.1.0
- Improved general performance, stability, and usability.
- Added Utility Bills Sub-tab in support of new calibration feature.
- New HVAC Components (Contributed by Oak Ridge National Laboratory)
- GroundHeatExchangerVertical - Enables support for ground source heat pumps EvaporativeFluidCoolerSingleSpeed.
- AirTerminalSingleDuctVAVNoReheat
- AirTerminalSingleDuctConstantVolumeReheat
- New HVAC Components (Contributed by Group 14)
- In-slab radiant heating/cooling, including water and electric resistance.
- Chilled beams, both passive and active.
- Simplified measures library to show OpenStudio, EnergyPlus, and new Reporting measures side by side.
- Added calibration view to Results tab to view utility data side by side with simulation results.
OpenStudio ParametricAnalysisTool 1.1.0
- Simplified measures library to show OpenStudio, EnergyPlus, and new Reporting measures side by side.
- Added several additional Energy Conservation Measures to the Building Component Library, accessible through PAT and the OpenStudio application.
- Added Cloud Settings, Cloud Monitor, and a diagnostic dialog in support of simulations using the Amazon EC2 cloud computing service. Once the user creates an Amazon account and links to it from OpenStudio, OpenStudio can provision and distribute simulations across a user-selected number of EC2 instances.
- The Run tab was redesigned in support of simulations using cloud computing services. This includes a number of new interface elements and characteristics described below.
- A cloud status button to display and alter the cloud state.
- Design alternatives can now be selected and deselected for simulation. This can be accomplished by clicking on them individually, or by using the “Select All” and “Clear Selection” buttons. Previously there was no selection mechanism, and all design alternatives had to be run.
- When a cloud instance is running, there is a new column to choose which design alternatives’ detailed simulation results should be downloaded upon completion. You can select these individually or select all, being mindful that simulation results can be quite large.
- There is similar functionality to individually or globally clear simulation results.
- A button to download the highlighted design alternatives’ detailed simulation results was added to the Results tab.
OpenStudio RunManager 1.1.0
- No changes.
OpenStudio ResultsViewer 1.1.0
- No changes.
OpenStudio Ruby Bindings 1.1.0
- No changes.
OpenStudio C# Bindings 1.1.0
- No changes.
OpenStudio Python Bindings 1.1.0
- No changes.
- Python bindings are not packaged with OpenStudio. To use them see our developer page for guidance on building OpenStudio.
OpenStudio JavaScript V8 Bindings 1.1.0
- No changes.
- JavaScript bindings are not packaged with OpenStudio. To use them see our developer page for guidance on building OpenStudio.
Known Issues
The following are issues known at the time of publication of these release notes. Please contact [email protected] if you require further assistance.
Known Issues Common to All Platforms
OpenStudio SketchUp Plug-in
- If you use copy multiple on group-level OpenStudio objects, you will get one extra copy. The extra group is created by the first copy-and-paste operation and is not removed when the copy multiple occurs. To address this, after you perform a copy multiple procedure on groups or spaces, press delete. The objects you need to delete should already be selected. If you are copying loose surfaces such as windows, there are no problems, as SketchUp will merge equivalent surfaces. [issue #28]
- Using SketchUp's undo operation on OpenStudio model elements may produce unexpected results. [issues #54 and #150]
- SKP and OSM link is not maintained when files are relocated. You can manually re-establish that link. When opening a SketchUp file Launch SketchUp and then Open the SketchUp file. If that doesn't work you can also directly load the OSM file, bypassing the SKP file. [issue #409]
- It is possible for the OpenStudio Plug-in to conflict with other SketchUp plug-ins. If you suspect this is a problem, try testing with other plug-ins disabled, or contact [email protected] for assistance. [issue #26]
- Importing Constructions and Import Schedules from the OpenStudio SketchUp Plug-in are broken, but you can load an OSM file as library in the OpenStudio application and then selectively drag specific objects into your model. [issue #201]
- Using "Intersect" in the surface matching dialog can result in a crash or unexpected result. This is more common with models that were imported from other CAD formats at some point in the workflow. It is a good idea to save prior to using this to avoid any loss of data. This is related to an underlying SketchUp bug. [issue #168]
- "Project Loose Geometry" can crash SketchUp. It is a good idea to save prior to using this to avoid any loss of data. [issue #484]
- If your OpenStudio model crashes SketchUp or has unexpected behavior please forward it to [email protected] with a description of the problem. Please also include the directory that has the same name as the OSM file. You can attach it as a zip file.
OpenStudio Application
- When going to the Site / Utility Bills subtab after setting up the prerequisite objects you will see an object that can't be edited. That isn't a real object. To add your first object switch away from the "Electric Utility Bill" category at the left, and then click the green "+" to create a new object. [issue #577]
- The Site / Utility Rates subtab the workflow are marked as "coming soon," and will be completed in an upcoming release of OpenStudio.
- To enable set point schedule drop zones on the Thermal Zones tab, you need to first turn on the thermostat.
- Using the mouse scroll wheel while hovering over graphics in the Results Summary tab will unintentionally zoom them in and out. [issue #84]
- Similar thermostats assigned in the SketchUp Plug-in are shared across thermal zones in the OpenStudio application. Changing or turning off one will do the same to others. [issue #123]
- The view does not always refresh correctly when you delete a material from a construction. If you still see a material after clicking the "x", switch away from and back to the object to refresh the view. [issue #196]
- Not all of the schedules required to make a valid People object can be assigned in the application. [issue #107]
OpenStudio ParametricAnalysisTool
- If you plan to run an analysis using the cloud make sure to first run the baseline model locally. This will assure that at simulation results relative to the baseline show up on the results Tab. This is related to a bug in the order in which jobs are run on the cloud.
- As mentioned elsewhere, when using cloud service please make sure to stop the cloud using the cloud button in PAT when your simulation session is done, and after you have downloaded all of the detailed results you want. Then also go the AWS Management Console to confirm the instances are terminated. If they are not terminated, you can manually terminate them from the console.
- PAT won't prevent you from loading OSM files that are from a newer version of OpenStudio than you have installed, but the analysis won't run. [issue #330]
- Daylighting control object variables can't be requested in the output variables tab. [issue #355]
- The results tab may not be legible on a 1024x768 screen. [issue #359]
- Adding a design alternative using measure groups will remove any design alternatives made from external files. You can however add a design alternative made from external files without losing design alternatives made from measure groups. [issue #369]
- Always Run measures are applied to externally constructed design alternatives. This may result in unexpected results or errors. [issue #369]
- The run and cloud buttons may appear unresponsive after you click on them, particularly with very large projects. Please give them time, it may take a minute or two for the status to update.
OpenStudio ResultsViewer
- Alias changes do not update in table view until the data are read in again. [issue #25]
- Re-arranged column order doesn't stick next launch. [issue #30]
OpenStudio RunManager
- EnergyPlus ForwardTranslator errors do not appear in the RunManager GUI elements. [issue #181]
OpenStudio Platform, Including SWIG Bindings
- IdfObject::getQuantity and IdfObject::setQuantity functionality is almost, but not completely, comprehensive. The quantity getters and setters for fields whose units are "BasedOnField AX" are not expected to work at the IdfObject level, but are to be handled only for OS: prefixed objects by the specific interfaces of classes derived from ModelObject.
- The default naming scheme of WorkspaceObject (base class for ModelObject, etc.) sometimes results in undesired name clashes when transferring objects between models, including in the EnergyPlus translators. Therefore, some objects may be unexpectedly renamed or copied.
- OpenStudio::Model::ComponentVector objects may be inaccessible from the Ruby bindings. [issue #239]
Known Issues Specific to OS X
- To Install OpenStudio 1.1.0 correctly on OS X you need to first uninstall earlier versions of OpenStudio. [issue #510]
- The SketchUp Plug-in toolbar tooltips do not work correctly on OS X if you have made your toolbars horizontal. The tooltips never show on OS X in the status bar. The button state may also be incorrect. This is a bug in SketchUp versus the plug-in. [issue #45]
Bug Analytics Since Previous Release
- 93 new issues were filed since the 1.0.0 release of OpenStudio.
- 127 issues were closed since the 1.0.0 release of OpenStudio.
Consumption - Buildings and Heating
- C++
Published by axelstudios over 11 years ago

OpenStudio - OpenStudio v1.0.7
Consumption - Buildings and Heating
- C++
Published by axelstudios over 11 years ago

OpenStudio - OpenStudio v1.0.6
Consumption - Buildings and Heating
- C++
Published by axelstudios over 11 years ago

OpenStudio - OpenStudio v1.0.5
Consumption - Buildings and Heating
- C++
Published by axelstudios over 11 years ago

OpenStudio - OpenStudio v1.0.4
Consumption - Buildings and Heating
- C++
Published by axelstudios over 11 years ago

OpenStudio - OpenStudio v1.0.3
Consumption - Buildings and Heating
- C++
Published by axelstudios over 11 years ago

OpenStudio - OpenStudio v1.0.2
Consumption - Buildings and Heating
- C++
Published by axelstudios almost 12 years ago

OpenStudio - OpenStudio v1.0.1
Consumption - Buildings and Heating
- C++
Published by axelstudios almost 12 years ago

OpenStudio - OpenStudio v1.0.0
These release notes describe a particular version of the OpenStudio software suite developed by the National Renewable Energy Laboratory (NREL), Electricity, Resources, and Building Systems Integration Center (ERBSIC), Commercial Buildings Research Group, Tools Development Section, and associated collaborators. The notes are organized into the following sections:
- Where to Find OpenStudio Documentation
- Installation Notes
- Overview
- New Features
- Known Issues
Where to Find OpenStudio Documentation
- OpenStudio release documentation, including these release notes, tutorials, and other user documentation is available at http://openstudio.nrel.gov/documentation.
- C++ API documentation is available at http://openstudio.nrel.gov/sdk-documentation.
- Measure writing documentation is available at http://openstudio.nrel.gov/openstudio-measure-writing-guide
- OpenStudio Life Cycle Costing Examples document is available at http://openstudio.nrel.gov/openstudio-life-cycle-examples
Installation Notes
OpenStudio is supported on Windows XP – 7, OS X 10.7 – 10.8, and Ubuntu 12.04.
Installation Steps
- Download and install EnergyPlus 7.2. The main EnergyPlus page takes you to EnergyPlus 8. Follow the steps below to download EnergyPlus 7.2
- Create an EnergyPlus account if you don't have one and then login.
- After you log in you can click the link to access the page to "Download Older Versions of Energy Plus".
- Choose the appropriate version of EnergyPlus 7.2 for your computer. Download and follow the instructions. OpenStudio will work with 32 or 64bit EnergyPlus installers.
- The OpenStudio SketchUp Plug-in requires Sketchup 8.0 or SketchUp 2013 (not available for Linux).
- Create an OpenStudio account, then download and install OpenStudio.
- Setup a Building Component Library (BCL) account to access online building components and measures. View instructions on how to setup your account and configure the key in OpenStudio.
Optional Installation Steps
- For Radiance integration, download and install Radiance.
- If you plan to use the OpenStudio SDK Ruby bindings via command prompt on Windows, download and extract ruby.zip to C:\Ruby (or other desired location), and add C:\Ruby\bin to the PATH environment variable.
- Install the DAKOTA algorithm library as described on the developer pages if you plan to run large-scale analyses with the Ruby bindings.
- Download and install the 32-bit OpenSSL libraries if you will be running simulations remotely through an SSH connection on Windows.
Overview
OpenStudio 1.0.0 adds life cycle cost objects to OpenStudio models and to energy conservation measures used in the Parametric Analysis Tool (PAT). In addition to being able to evaluate design alternatives based on energy use, users can now look at total life cycle costs, first year capital costs, annual utility savings, and simple payback. A new HVAC control view lets users set the operation time, night cycle operation, supply air temperature, economizer, and demand controlled ventilation for air loops. A major new category of HVAC equipment has been added with the introduction of an air to air heat recovery model, which can be used to model a variety of sensible and latent heat recovery devices.
New Features
OpenStudio Platform 1.0.0
- Added new model object LifeCycleCost for capturing capital and operating costs associated with building components and measures.
- Improved EnergyPlus IDF import and export. EnergyPlus export is now more repeatable and import is more stable.
- Improved consistency in the handling of multipliers throughout the OpenStudio model API.
- Suppressed erroneous log messages.
- All applications now catch thrown exceptions and report the error to the user before exiting or relaunching.
- BCL measures can now be updated to the latest version through the BCL dialog.
- Added and improved filesystem integration on Windows, Linux, and OS X, including imporoved installers.
OpenStudio SketchUp Plug-in 1.0.0
- Improved general performance and stability.
- Added OpenStudio SketchUp plug-in support for SketchUp 2013 (Pro and Make).
- Simplified plug-in user interface.
- gbXML import now handles files with malformed surfaces.
- Added "Export RPX File" for integration with the ASHRAE Radiant Performance Explorer human comfort tool. This can be found under "OpenStudio User Scripts / Reports".
- Improved default profiles on Ruleset Schedules.
OpenStudio Application 1.0.0
- Improved general performance, stability, and usability.
- Added a new "Controls" subtab for air loops in the "HVAC Systems" tab. This allows the user to set the HVAC operation schedules, night cycle, supply air temperature, economizer, and demand controlled ventilation.
- A major new category of HVAC equipment has been added with the introduction of an air to air heat recovery model, which can be used to model a variety of sensible and latent heat recovery devices.
- New HVAC Components
- Water-to-air heat pumps
- Water and electric baseboard heaters
- Demand controlled ventilation
- Night cycling
- Air-to-air energy recovery
- Constant volume pumps
- Outdoor air based reset control strategy for air and water loops
- Unit heaters
- Replaced "Scripts" tab with "Measures" Tab that is consistent with the Parametric Analysis Tool.
- Measures added to a model in this tab will be brought into the Parametric Analysis Tool if the model is chosen as a baseline.
OpenStudio ParametricAnalysisTool 1.0.0
- Measures are now downloaded from the Building Component Library instead of being included in the installer. Users can download new measures as they are posted, and get updates to existing measures without having to install an update to OpenStudio.
- If a new measure makes use of features added in a later version of OpenStudio then you will have to update OpenStudio if you want to use that particular measure.
- Updated measures now include inputs to support new life cycle analysis object in OpenStudio. Measures can add life cycle objects or manipulate objects that already exist. The following are some common inputs introduced, although specific inputs will vary from measure to measure.
- Material and Installation Cost
- Years Until Costs Start (number of years left until due to be replaced)
- Demolition Cost Occur During Initial Construction (true/false)
- Expected Life
- O&M Costs
- O&M Frequency
- Added "Always Run Measures" that operate on the baseline model as well as each design alternative.
- These measures can run at various stages defined by where the user places them relative to the measure groups in the project.
- Some measures added to the Building Component Library that were designed to be used as "Always Run Measures" are under "Economics -> Life Cycle Cost Analysis". Many of these add life cycle costs to objects in the model.
- Added new columns to the "Reports" tab to show First Year Capital Cost, Annual Utility Cost, Simple Payback, and Total Life Cycle Cost.
OpenStudio RunManager 1.0.0
- No changes.
OpenStudio ResultsViewer 1.0.0
- No changes.
OpenStudio Ruby Bindings 1.0.0
- No changes.
OpenStudio C# Bindings 1.0.0
- No changes.
OpenStudio Python Bindings 1.0.0
- Added experimental bindings.
OpenStudio JavaScript V8 Bindings 1.0.0
- Added experimental bindings.
Known Issues
The following are issues known at the time of publication of these release notes. Please contact [email protected] if you require further assistance.
Known Issues Common to All Platforms
OpenStudio SketchUp Plug-in
- If you use copy multiple on group-level OpenStudio objects, you will get one extra copy. The extra group is created by the first copy-and-paste operation and is not removed when the copy multiple occurs. To address this, after you perform a copy multiple procedure on groups or spaces, press delete. The objects you need to delete should already be selected. If you are copying loose surfaces such as windows, there are no problems, as SketchUp will merge equivalent surfaces. [bug 36]
- Using SketchUp's undo operation on OpenStudio model elements may produce unexpected results. [bugs 438 and 797]
- SKP and OSM link is not maintained when files are relocated. You can manually re-establish that link. When opening a SketchUp file Launch SketchUp and then Open the SketchUp file. If that doesn't work you can also directly load the OSM file, bypassing the SKP file. [bug 61]
- It is possible for the OpenStudio Plug-in to conflict with other SketchUp plug-ins. If you suspect this is a problem, try testing with other plug-ins disabled, or contact [email protected] for assistance. [bug 24]
- Importing Constructions and Import Schedules from the OpenStudio SketchUp Plug-in are broken, but you can load an OSM file as library in the OpenStudio application and then selectively drag specific objects into your model. [bug 930]
- Using "Intersect" in the surface matching dialog can result in a crash or unexpected result. This is more common with models that were imported from other CAD formats at some point in the workflow. It is a good idea to save prior to using this to avoid any loss of data. This is related to an underlying SketchUp bug. [bugs 856 and 1220]
- "Project Loose Geometry" can crash SketchUp. It is a good idea to save prior to using this to avoid any loss of data. [bug 1221]
- If your OpenStudio model crashes SketchUp or has unexpected behavior please forward it to [email protected] with a description of the problem. Please also include the directory that has the same name as the OSM file. You can attach it as a zip file. [bug 1231]
OpenStudio Application
- The Site / Utility Rates subtab the workflow are marked as "coming soon," and will be completed in an upcoming release of OpenStudio.
- To enable set point schedule drop zones on the Thermal Zones tab, you need to first turn on the thermostat.
- Using the mouse scroll wheel while hovering over graphics in the Results Summary tab will unintentially zoom them in and out. [bug 574]
- Similar thermostats assigned in the SketchUp Plug-in are shared across thermal zones in the OpenStudio application. Changing or turning off one will do the same to others. [bug 722]
- The view does not always refresh correctly when you delete a material from a construction. If you still see a material after clicking the "x", switch away from and back to the object to refresh the view. [bug 925]
- Not all of the schedules required to make a valid People object can be assigned in the application. [bug 664]
- The 3-phase daylighting simulation method is currently inoperable due to a fundamental change in the way the lighting calculation points are passed to Radiance, and will be updated in an upcoming release of OpenStudio. [bug 943]
OpenStudio ParametricAnalysisTool
- PAT won't prevent you from loading OSM files that are from a newer version of OpenStudio than you have installed, but the analysis won't run. [bug 1240]
- Daylighting control object variables can't be requested in the output variables tab. [bug 1290]
- The results tab may not be legible on a 1024x768 screen. [bug 1295]
- Adding a design alternative using measure groups will remove any design alternatives made from external files. You can however add a design alternative made from external files without losing design alternatives made from measure groups. [bug 1236]
- Always Run measures are applied to externally constructed design alternatives. This may result in unexpected results or errors.
- Measures specified within externally constructed design alternative models are not applied.
OpenStudio ResultsViewer
- Alias changes do not update in table view until the data are read in again. [bug 7]
- Data sets are expected to start on January 1 or later, and end on December 12 or earlier. Run periods cannot wrap around the end or beginning of the year. [bug 78]
- Table view column rearrangements are not preserved. [bug 34]
OpenStudio RunManager
- EnergyPlus ForwardTranslator errors do not appear in the RunManager GUI elements. [bug 897]
OpenStudio Platform, Including SWIG Bindings
- IdfObject::getQuantity and IdfObject::setQuantity functionality is almost, but not completely, comprehensive. The quantity getters and setters for fields whose units are "BasedOnField AX" are not expected to work at the IdfObject level, but are to be handled only for OS: prefixed objects by the specific interfaces of classes derived from ModelObject.
- The default naming scheme of WorkspaceObject (base class for ModelObject, etc.) sometimes results in undesired name clashes when transferring objects between models, including in the EnergyPlus translators. Therefore, some objects may be unexpectedly renamed or copied.
- OpenStudio::Model::ComponentVector objects may be inaccessible from the Ruby bindings. [bug 1005]
Known Issues Specific to OS X
- To Install OpenStudio 1.0 correctly on OS X you need to first uninstall earlier versions of OpenStudio. [bug 1303]
- At this time, we are unable to provide simple installation instructions for DAKOTA on OS X. We are working with the DAKOTA team to be able to provide this sometime in 2013. [bug 437]
- The SketchUp Plug-in toolbar tooltips do not work correctly on OS X if you have made your toolbars horizontal. The tooltips never show on OS X in the status bar. The button state may also be incorrect. This is a bug in SketchUp versus the plug-in. [bug 375]
Bug Analytics Since Previous Release
- 89 new bugs were filed since the 0.9.0 release of OpenStudio.
- 51 bugs were closed since the 0.9.0 release of OpenStudio.
Consumption - Buildings and Heating
- C++
Published by axelstudios almost 12 years ago
