Releases: NREL/OpenStudio
v2.7.2-update_measure_tester1
Update gem to test measure tester
OpenStudio v2.7.1
Updating to standards 0.2.7
OpenStudio v2.7.0
OpenStudio Version 2.7.0
Release Notes – 10/12/2018
These release notes describe version 2.7.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
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://openstudio-sdk-documentation.s3.amazonaws.com/index.html.
- Measure development documentation is available at http://nrel.github.io/OpenStudio-user-documentation/reference/measure_writing_guide/.
Installation Notes
OpenStudio is supported on Windows 7 – Windows 10, OS X 10.10 – 10.11, and 64-bit Ubuntu 14.04.
OpenStudio 2.7.0 supports EnergyPlus Release 9.0, which is bundled with the OpenStudio installer. It is no longer necessary to download and install EnergyPlus separately. Other builds of EnergyPlus are not supported by OpenStudio 2.7.0.
OpenStudio 2.7.0 supports Radiance 5.0.a.12, which is bundled with the OpenStudio installer; users no longer must install Radiance separately, and OpenStudio will use the included Radiance version regardless of any other versions that may be installed on the system. Other builds of Radiance are not supported by OpenStudio 2.7.0.
Installation Steps
- The OpenStudio SketchUp Plug-in requires SketchUp 2017 (not available for Linux). The OpenStudio SketchUp Plug-in does not support older versions of SketchUp.
- If the OpenStudio Plug-in does not automatically load in SketchUp, open the Window->Preferences->Extensions window in SketchUp and enable the OpenStudio plug-in if it is listed.
- Download and install OpenStudio. Select components for installation.
- 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.
For help with common installation problems please visit, http://nrel.github.io/OpenStudio-user-documentation/help/troubleshooting/.
Overview
An important announcement related to future development of the OpenStudio Application is available at: https://www.openstudio.net/new-future-for-openstudio-application. Please read this announcement carefully to understand changes coming for the OpenStudio Application over future releases. Please send any questions, comments, or concerns to [email protected] and we will try our best to address them.
OpenStudio SDK:
The 2.7.0 release updates OpenStudio to use EnergyPlus 9.0. This update includes several new features, performance improvements, and bug fixes. This release also includes two new command line switches for the OpenStudio Command Line Interface (CLI): --bundle and --bundle_path. These switches allow the OpenStudio CLI to use a pre-made bundle of Ruby gems, allowing more control over gems used by measures. Geometry import and merge functionality was enhanced from gbXML, IDF, and OSM sources. Users can import and merge geometry from these file types with their existing OpenStudio Models. The OpenStudio API was extended to support multiple AirloopHVAC objects per ThermalZone. New model objects were added for ExternalFile and ScheduleFile allowing CSV files to be used for schedule input. There is a known issue (#3297) with ScheduleFile objects created using Apply Measure Now. The ElectricLoadCenterTransformer object was also added to allow modeling of electrical transformers. Many bugs were addressed in this release. Notably, several issues with forward translation of EMS programs were resolved. Serious issues related to SetpointManagers and other HVAC equipment introduced into the C# bindings as of OpenStudio 2.6.0 were resolved.
2.7.0 API Changes:
- The class AirTerminalSingleDuctUncontrolled was renamed to AirTerminalSingleDuctConstantVolumeNoReheat for consistency with EnergyPlus, a back port was added to the Ruby bindings to preserve compatibility with the old name AirTerminalSingleDuctUncontrolled.
- The methods constantMinimumAirFlowFraction and fixedMinimumAirFlowRate of AirTerminalSingleDuctVAVReheat now return an optional double rather than a double.
OpenStudio Server:
OpenStudio Server has been updated to address several important issues:
The OpenStudio Server was updated to run datapoints via the OpenStudio Command Line Interface rather than Workflow Gem. This update includes use of the new --bundle and --bundle_path command line switches allowing OpenStudio gems (bundle) to be customized independent of OpenStudio Server bundle. Analysis Initialize and Finalize Scripts can be run for Resque-based environments (ie not on local PAT). Datapoint Initialize and Finalize Scripts have been restructured and can be run on Resque-based environments.
OpenStudio Standards:
OpenStudio Standards underwent a major HVAC system code refactor with updates to the DOE and DEER Prototypes.
- Adds optimum start
- Adds door and attic infiltration to DOE prototypes
- Adds skylight frames
- Fixes construction sets for attics and soffits
- Disables ERV SAT outlet control
- Updates motorized OA damper control to skip loop if a schedule other than AlwaysOn is set for min OA
- Changes SEER and EER to COP conversion formulas
- Changes UnitHeaters to be normal (as opposed to small) fans
- Adds vestibule control for unit heaters
- Condenses geometry and HVAC JSON files for DOE prototypes to avoid duplication
- Updates water heater skin loss coefficients
- Adds water heater to zone (instead of assuming 70F air)
- Other minor changes to hard-coded DOE prototype assumptions
- Fixes to DOE and DEER prototype geometries
- Moves HVAC inference and size categorization to the standards spreadsheet
- Adds fans as a database in standards spreadsheet
- HVAC system methods now use keyword arguments and assume defaults, with component constructors (coils, fans, boilers) moved to their own modules
- Adds several NZE systems, including:
- VRF
- DOAS
- DOAS with DCV controls
- Name HVAC objects, including naming nodes to be more descriptive
- Aligns design system, coil, loop, and setpoint manager temperatures where appropriate
- General bug fixes to HVAC systems
- Set acoustical tile ceiling construction for models with plenum zones (DOE MediumOffice, DOE LargeOffice, and most DEER models)
- Adds infiltration to 'DOE Ref 1980-2004' and 'DOE Ref Pre-1980' plenums
Issue Statistics Since Previous Release
- 39 new issues were filed since the 2.6.0 release of OpenStudio (not including opened pull requests).
- 73 issues were closed since the 2.6.0 release of OpenStudio (not including closed pull requests).
OpenStudio v2.6.1
Merge branch '2_6_1_branch' of https://github.com/NREL/OpenStudio int…
OpenStudio v2.6.0
OpenStudio Version 2.6.0
Release Notes – 6/30/2018
These release notes describe version 2.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
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://openstudio-sdk-documentation.s3.amazonaws.com/index.html.
- Measure development documentation is available at http://nrel.github.io/OpenStudio-user-documentation/reference/measure_writing_guide/.
Installation Notes
OpenStudio is supported on Windows 7 – Windows 10, OS X 10.10 – 10.11, and 64-bit Ubuntu 14.04.
OpenStudio 2.6.0 supports EnergyPlus Release 8.9.0, which is bundled with the OpenStudio installer. It is no longer necessary to download and install EnergyPlus separately. Other builds of EnergyPlus are not supported by OpenStudio 2.6.0.
OpenStudio 2.6.0 supports Radiance 5.0.a.12, which is bundled with the OpenStudio installer; users no longer must install Radiance separately, and OpenStudio will use the included Radiance version regardless of any other versions that may be installed on the system. Other builds of Radiance are not supported by OpenStudio 2.6.0.
Installation Steps
- The OpenStudio SketchUp Plug-in requires SketchUp 2017 (not available for Linux). The OpenStudio SketchUp Plug-in does not support older versions of SketchUp.
- If the OpenStudio Plug-in does not automatically load in SketchUp, open the Window->Preferences->Extensions window in SketchUp and enable the OpenStudio plug-in if it is listed.
- Download and install OpenStudio. Select components for installation.
- 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.
For help with common installation problems please visit, http://nrel.github.io/OpenStudio-user-documentation/help/troubleshooting/.
Overview
OpenStudio SDK:
The 2.6.0 release of OpenStudio includes new features to help write better measures! The new measure templates have been updated to create a license and README.mb.erb for each new measure. When a measure is updated, the README.mb.erb is configured with information from the measure to create a README.md file which is the perfect place to document your measure. You can reference images or other content your measure’s docs/ folder from the README.md file to make your documentation really stand out. Additionally, a new option has been added to the OpenStudio CLI which runs the tests for all measures in a directory and saves a dashboard with results: openstudio measure -r /dir/to/measures/. This dashboard quickly shows all passing/failing tests as well as provide input on Ruby style using Rubocop. Code coverage will be added to the measure testing dashboard in a future release.
The following new model objects have been added to the OpenStudio SDK:
- GeneratorPVWatts
- ElectricLoadCenterInverterPVWatts
- PlantComponentUserDefined
- AirTerminalSingleDuctConstantVolumeFourPipeBeam
- CoilCoolingFourPipeBeam
- CoilHeatingFourPipeBeam
EMS Sensor and Actuator have been expanded to include SpaceLoads arguments. This will allow for correct EMS actuators on SpaceLoads that end up in ZoneLists in E+. The next release will expand on this capability.
OpenStudio Server:
OpenStudio Server has been updated to address several important issues:
- Fix cursor deleted with accessing /analyses//analysis_data
- Set version of mongo and redis for docker deploys
- Backend for Docker deployment now used Resque with Redis instead of delayed jobs.
- Large Uploads to Server (i.e. lots of weather files) seem to Timeout
OpenStudio Standards:
OpenStudio Standards has the following updates:
- Added additional DEER prototypes, including multifamily
- Added service hot water to DEER prototypes
- General bug fixes for DEER prototypes
Issue Statistics Since Previous Release
- 48 new issues were filed since the 2.5.0 release of OpenStudio (not including opened pull requests).
- 15 issues were closed since the 2.5.0 release of OpenStudio (not including closed pull requests).
OpenStudio v2.5.2
Get test results to show up when running from CLI
OpenStudio v2.5.1
Merge pull request #3112 from NREL/ems-enhancements resolve EMS Sensor issue 3102
OpenStudio v2.5.0
OpenStudio Version 2.5.0
Release Notes – 3/30/2018
These release notes describe version 2.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
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://openstudio-sdk-documentation.s3.amazonaws.com/index.html.
- Measure development documentation is available at http://nrel.github.io/OpenStudio-user-documentation/reference/measure_writing_guide/.
Installation Notes
OpenStudio is supported on Windows 7 – Windows 10, OS X 10.10 – 10.11, and 64-bit Ubuntu 14.04.
OpenStudio 2.5.0 supports EnergyPlus Release 8.9.0, which is bundled with the OpenStudio installer. It is no longer necessary to download and install EnergyPlus separately. Other builds of EnergyPlus are not supported by OpenStudio 2.5.0.
OpenStudio 2.5.0 supports Radiance 5.0.a.12, which is bundled with the OpenStudio installer; users no longer have to install Radiance separately, and OpenStudio will use the included Radiance version regardless of any other versions that may be installed on the system. Other builds of Radiance are not supported by OpenStudio 2.5.0.
Installation Steps
- The OpenStudio SketchUp Plug-in requires SketchUp 2017 (not available for Linux). The OpenStudio SketchUp Plug-in does not support older versions of SketchUp.
- Download and install OpenStudio. Select components for installation.
- 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.
For help with common installation problems please visit, http://nrel.github.io/OpenStudio-user-documentation/help/troubleshooting/.
Overview
OpenStudio SDK
OpenStudio now includes the generic AdditionalProperties object that can be used to apply user-defined properties to objects in the OSM. These properties do not directly change the model in any way nor are they forward-translated to EnergyPlus. Rather they can be used by measures to apply logic.
OpenStudio also now includes the Kiva foundation heat transfer calculation tool, a two-dimensional finite difference approach for determining convective heat gains and temperatures for foundation surfaces.
All Energy Management System (EMS) actuators and sensors are now available in the OpenStudio SDK through the methods emsActuatorNames() and emsInternalVariables().
ExteriorFuelEquipment, ExteriorWaterEquipment, and their associated definition objects (ExteriorFuelEquipmentDefinition, ExteriorWaterEquipmentDefinition) have been added to OpenStudio. All exterior equipment, including the existing ExteriorLights (and ExteriorLightsDefinition) now have the same parent classes: ExteriorLoadInstance and ExteriorLoadDefinition.
Preliminary support for the EnergyPlus AirflowNetwork feature is now provided in OpenStudio. Envelope leakage and core elements of distribution networks are supported. Changes are expected to support ongoing enhancements of the AirflowNetwork model (e.g. multiple air loops).
OpenStudio Server
OpenStudio Server has been updated addressing several issues with simulations not completing or running indefinitely.
OpenStudio Standards
Added initial support for the CA DEER Prototype buildings. Refactored codebase to make the addition of new standards easier and more isolated from other code. Added support for additional HVAC systems that can be used for model articulation.
EnergyPlus
Openstudio now incorporates EnergyPlus Release 8.9, which provides new capabilities, and numerous bug fixes.
Known Issues
-
Radiance Daylighting Measure - The Radiance Daylighting Measure is incompatible with EnergyPlus 8.9 (writing results will cause a segfault); we are working on a fix.
-
EnergyPlus no longer allows non-unique names, and while OpenStudio provides unique names for most objects, it does not for objects that do not belong to a reference group. Future OpenStudio SDK changes will ensure that all objects belong to a reference group.
Issue Statistics Since Previous Release
- 120 new issues were filed since the 2.4.0 release of OpenStudio (not including opened pull requests).
- 205 issues were closed since the 2.4.0 release of OpenStudio (not including closed pull requests).
OpenStudio v2.4.3
Changing forward translation option back to Average for backwards com…
v2.4.2
Update PAT SHA