Skip to content

Latest commit

 

History

History
77 lines (52 loc) · 2.19 KB

README.md

File metadata and controls

77 lines (52 loc) · 2.19 KB

OpenStudio ModelArticulation

Library and measures for OpenStudio Model Articulation.

Installation

Add this line to your application's Gemfile:

gem 'openstudio-model-articulation'

And then execute:

$ bundle

Or install it yourself as:

$ gem install 'openstudio-model-articulation'

Tests

To run the tests similar to how Jenkins run:

bundle install

bundle exec rake
bundle exec rake openstudio:list_measures
bundle exec rake openstudio:update_measures
bundle exec rake openstudio:test_with_openstudio

To run the tests the same way Jenkins run:

docker run -it -v $(pwd):/var/simdata/openstudio -u root -e "LANG=en_US.UTF-8" nrel/openstudio:3.0.0-beta-ruby-slim bash

# inside the container
gem install bundler -v '~> 2.1'
bundle update

# Run all the tests
bundle exec rake openstudio:test_with_openstudio

# or a sinlge measure's test, e.g.,
/usr/local/openstudio-3.0.0-beta/bin/openstudio-3.0.0-beta --verbose --bundle '/var/simdata/openstudio/Gemfile' --bundle_path '/var/simdata/openstudio/.bundle/install/' measure -r '/var/simdata/openstudio/lib/measures/radiance_measure/'

Compatibility Matrix

OpenStudio Model Articulation Gem OpenStudio Ruby
0.5.0 3.3 2.7
0.4.0 - 0.4.2 3.2 2.7
0.3.0 - 0.3.1 3.1 2.5
0.2.0 - 0.2.1 3.0 2.5
0.1.1 and below 2.9 and below 2.2.4

Contributing

Please review the OpenStudio Contribution Policy if you would like to contribute code to this gem.

TODO

  • Move articulation measures from openstudio-measures
  • Move articulation measure lib files to openstudio-extension lib
  • Update measures to correct naming conventions

Releasing

  • Update CHANGELOG.md
  • Run rake rubocop:auto_correct
  • Update version in /lib/openstudio/model_articulation/version.rb
  • Create PR to master, after tests and reviews complete, then merge
  • Locally - from the master branch, run rake release
  • On GitHub, go to the releases page and update the latest release tag. Name it “Version x.y.z” and copy the CHANGELOG entry into the description box.