tbd 3.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 98d362f684c1cac670390347814a0fe5ed620cc86600b3207358de313a2d77b7
+  data.tar.gz: 11e5e5c8e290e5e41b58d758c7e1eaad18b07bae293799085be4708098140775
+SHA512:
+  metadata.gz: 8d7232262c4a483107cd3d8b44e9588fe1dedd867e93496ad589ced425ea48cc770b6b14870346a1d04fce47f97f7d933c804694851fca2eda0ee862011c974a
+  data.tar.gz: 922835ea4c1d3860b9d7a97df935f0a9a4d25e9561317c34564ca0dbfabbd612b8ca57b2acff99983b0c116381fcfe9a4369af3494ab00696afa838338d9c3b8

data/.gitattributes

@@ -0,0 +1,3 @@
+* text=auto
+*.rb text
+text eol=lf

data/.github/workflows/pull_request.yml

@@ -0,0 +1,72 @@
+name: Pull Request CI
+
+on:
+  pull_request:
+    branches:
+      - master
+
+jobs:
+  test_300x:
+    runs-on: ubuntu-20.04
+    steps:
+    - name: Check out repository
+      uses: actions/checkout@v2
+    - name: Run Tests
+      run: |
+        echo $(pwd)
+        echo $(ls)
+        docker pull nrel/openstudio:3.0.0
+        docker run --name test --rm -d -t -v $(pwd):/work -w /work nrel/openstudio:3.0.0
+        docker exec -t test pwd
+        docker exec -t test ls
+        docker exec -t test bundle update
+        docker exec -t test bundle exec rake
+        docker kill test
+  test_321x:
+    runs-on: ubuntu-20.04
+    steps:
+    - name: Check out repository
+      uses: actions/checkout@v2
+    - name: Run Tests
+      run: |
+        echo $(pwd)
+        echo $(ls)
+        docker pull nrel/openstudio:3.2.1
+        docker run --name test --rm -d -t -v $(pwd):/work -w /work nrel/openstudio:3.2.1
+        docker exec -t test pwd
+        docker exec -t test ls
+        docker exec -t test bundle update
+        docker exec -t test bundle exec rake
+        docker kill test
+  test_330x:
+    runs-on: ubuntu-20.04
+    steps:
+    - name: Check out repository
+      uses: actions/checkout@v2
+    - name: Run Tests
+      run: |
+        echo $(pwd)
+        echo $(ls)
+        docker pull nrel/openstudio:3.3.0
+        docker run --name test --rm -d -t -v $(pwd):/work -w /work nrel/openstudio:3.3.0
+        docker exec -t test pwd
+        docker exec -t test ls
+        docker exec -t test bundle update
+        docker exec -t test bundle exec rake
+        docker kill test
+  test_340x:
+    runs-on: ubuntu-20.04
+    steps:
+    - name: Check out repository
+      uses: actions/checkout@v2
+    - name: Run Tests
+      run: |
+        echo $(pwd)
+        echo $(ls)
+        docker pull nrel/openstudio:3.4.0
+        docker run --name test --rm -d -t -v $(pwd):/work -w /work nrel/openstudio:3.4.0
+        docker exec -t test pwd
+        docker exec -t test ls
+        docker exec -t test bundle update
+        docker exec -t test bundle exec rake
+        docker kill test

data/.gitignore

@@ -0,0 +1,23 @@
+/Gemfile.lock
+/.ruby-version
+.rspec_status
+/.bundle/
+/pkg
+
+.yardoc/
+_yardoc/
+doc/
+rdoc
+
+/spec/files/osms/out/*
+/spec/files/measures/*
+/spec/files/ua/*
+/json/*out.json
+
+/lib/measures/test_results/*
+/lib/measures/*/tests/output
+/lib/measures/test_results
+
+runner.conf
+
+*.DS_Store

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/Gemfile

@@ -0,0 +1,3 @@
+source "https://rubygems.org"
+
+gemspec

data/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020-2022 Denis Bourgeois & Dan Macumber
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,154 @@
+# Thermal Bridging & Derating (TBD)  
+
+An [OpenStudio Measure](https://nrel.github.io/OpenStudio-user-documentation/reference/measure_writing_guide/) that first autodetects _major_ thermal bridges (like balconies, parapets and corners) in an OpenStudio model (.osm), and then _derates_ outside-facing, opaque surface constructions (walls, roofs and exposed floors). It interacts with the [OpenStudio SDK](https://openstudio-sdk-documentation.s3.amazonaws.com/index.html) and relies on AutomaticMagic's [Topolys](https://github.com/automaticmagic/topolys) gem, as well as rd2's [OSut](https://rubygems.org/gems/osut/versions/0.2.7) gem.
+
+## Guide & Downloads
+
+Building professionals and energy modellers are encouraged to first consult the online [Guide](https://rd2.github.io/tbd/) - it provides an overview of the underlying theory, references, suggested OpenStudio workflows, etc. Users can download the latest _TBD_ version directly from the Guide itself, or under [releases](https://github.com/rd2/tbd/releases), or via NREL's [BCL](https://bcl.nrel.gov) (search for "bridging" or "rd2").
+
+Questions can be posted on [UnmetHours](https://unmethours.com) - a very useful online resource for OpenStudio users.
+
+TBD can also be deployed as a Ruby gem, by adding:  
+
+```
+gem "tbd", git: "https://github.com/rd2/tbd", branch: "master"
+```  
+
+... in a v2.1 [bundled](https://bundler.io) _Measure_ development environment "Gemfile" (or instead as a _gemspec_ dependency), and then run:  
+
+```
+bundle install (or 'bundle update')
+```
+
+## New Features  
+
+Upcoming enhancements are in the works. Bugs or new feature requests for _TBD_ should be submitted [here](https://github.com/rd2/tbd/issues), while those more closely linked to _Topolys_ or _OSut_ should be submitted [here](https://github.com/automaticmagic/topolys/issues) or [here](https://github.com/rd2/osut/issues), respectively.
+
+## Development
+
+The installation and testing instructions in this section are for developers interested in exploring/tweaking a cloned/forked version of the source code. In an effort to _lighten_ TBD as a Ruby gem, only the most basic tests are deployed in this repository. More detailed tests are housed in a dedicated TBD [testing](https://github.com/rd2/tbd_tests) repo.
+
+TBD is systematically tested against updated OpenStudio versions (since v3.0.0). The following instructions refer to OpenStudio v3.4.0 (requiring Ruby v2.7.2), strictly as an example. Adapt the instructions for more recent versions - see OpenStudio's [compatibility matrix](https://github.com/NREL/OpenStudio/wiki/OpenStudio-SDK-Version-Compatibility-Matrix).
+
+### Windows Installation
+
+Install Ruby using the [RubyInstaller](https://rubyinstaller.org/downloads/archives/) for [Ruby 2.7.2 (x64)](https://github.com/oneclick/rubyinstaller2/releases/tag/RubyInstaller-2.7.2-1/rubyinstaller-2.7.2-1-x64.exe).
+
+From the command line, check that the ruby installation returns the correct Ruby version:
+```
+ruby -v
+```
+
+Install bundler:
+```
+gem install bundler -v 2.1
+```
+
+Install the OpenStudio SDK [3.4.0](https://github.com/NREL/OpenStudio/releases/tag/v3.4.0), or the OpenStudio Application [1.4.0](https://github.com/openstudiocoalition/OpenStudioApplication/releases/tag/v1.4.0).
+
+Create a new file ```C:\Ruby27-x64\lib\ruby\site_ruby\openstudio.rb``` (path may be different depending on the environment), and edit it so it _points_ to your new OpenStudio installation:
+
+```
+require 'C:\openstudio-3.4.0\Ruby\openstudio.rb'
+```
+
+Verify your OpenStudio and Ruby configuration:
+```
+ruby -e "require 'openstudio'" -e "puts OpenStudio::Model::Model.new"
+```
+
+`git clone` the TBD repo, then run basic tests to ensure the measure operates properly (see end of this README).
+
+
+### MacOS Installation
+
+MacOS already comes with Ruby, but likely not the right Ruby version for the desired OpenStudio measure development [environment](https://github.com/NREL/OpenStudio/wiki/OpenStudio-SDK-Version-Compatibility-Matrix). Instructions here show how to install Ruby v2.7.2 alongside MacOS's own Ruby version. Although no longer officially supported, instructions for an OpenStudio v2.9.1 setup is described [here](https://github.com/rd2/tbd/blob/master/v291_MacOS.md).
+
+From a Terminal, install [Homebrew](https://brew.sh/index) - nice for package distribution and management. Using Homebrew, install _rbenv_ (which allows users to manage multiple Ruby versions) and finally Ruby:
+
+```
+brew install rbenv
+rbenv init
+rbenv install 2.7.2
+```
+Install [bundler](https://bundler.io), great for managing Ruby gems and dependencies:
+
+```
+gem install bundler -v 2.1
+```
+
+In the Terminal, check the Ruby version:
+
+```
+ruby -v
+```
+
+... should still report the current Ruby version used by MacOS. To ensure the right version is used for developing OpenStudio Measures, instruct _rbenv_ to switch Ruby version _locally_ within a user’s chosen directory (e.g. "sandbox340"):
+
+```
+mkdir ~/Documents/sandbox340
+cd ~/Documents/sandbox340
+rbenv local 2.7.2
+ruby -v
+```
+… should report the desired _local_ Ruby version, to be used by default for anything under the "sandbox340" directory tree. To ensure both Ruby versions are operational and safe, run the following checkup twice - once from a user’s home (or ~/), then from within e.g., "sandbox340":
+
+```
+cd ~/
+ruby -ropen-uri -e 'eval URI.open("https://git.io/vQhWq").read'
+cd ~/Documents/sandbox340
+ruby -ropen-uri -e 'eval URI.open("https://git.io/vQhWq").read'
+```
+
+If successful, one should get a ```Hooray!``` from both Ruby versions confirming valid communication with [Rubygems](https://rubygems.org/).
+
+Install the OpenStudio SDK [3.4.0](https://github.com/NREL/OpenStudio/releases/tag/v3.4.0), or the OpenStudio Application [1.4.0](https://github.com/openstudiocoalition/OpenStudioApplication/releases/tag/v1.4.0).
+
+Create a new file ```~/.rbenv/versions/2.7.2/lib/ruby/site_ruby/openstudio.rb```  (path may be different depending on the environment), and edit it so it _points_ to your new OpenStudio installation:
+
+```
+require '/Applications/OpenStudio-3.4.0/Ruby/openstudio.rb'
+```
+
+Verify your local OpenStudio and Ruby configuration:
+
+```
+cd ~/Documents/sandbox340
+ruby -e "require 'openstudio'" -e "puts OpenStudio::Model::Model.new"
+```
+
+Install the latest version of _git_ (e.g. through Homebrew), then ```git clone``` the TBD repo, e.g. under "sandbox340". Run the basic tests below to ensure the measure operates as expected.
+
+
+## Complete list of test commands
+
+Run the following (basic) tests from TBD's root repository:
+```
+bundle update (or 'bundle install')
+bundle exec rake libraries
+bundle exec rake
+```
+
+## Run tests using Docker - _optional_
+
+Install [Docker](https://docs.docker.com/desktop/#download-and-install).
+
+Pull the OpenStudio v3.4.0 Docker image:
+```
+docker pull nrel/openstudio:3.4.0
+```
+
+In the root repository:
+```
+docker run --name test --rm -d -t -v ${PWD}:/work -w /work nrel/openstudio:3.4.0
+docker exec -t test bundle update
+docker exec -t test bundle exec rake
+docker kill test
+```
+
+## Support
+
+_Merci !_ to the following organizations
+
+[![](https://github.com/rd2/tbd/blob/master/sponsors/quebec.png)](https://transitionenergetique.gouv.qc.ca)
+[![](https://github.com/rd2/tbd/blob/master/sponsors/canada.png)](https://nrc.canada.ca/en/research-development/research-collaboration/research-centres/construction-research-centre)

data/Rakefile

@@ -0,0 +1,60 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec) do |t|
+    t.rspec_opts = '--exclude-pattern \'spec/**/*suite_spec.rb\''
+end
+
+task default: :spec
+
+desc "Update Library Files"
+task :libraries do
+  puts "Updating Library Files"
+
+  require "fileutils"
+
+  libs = ["topolys", "osut", "oslg", "tbd"]
+  lib_files = {}
+
+  $LOAD_PATH.each do |load_path|
+    libs.each do |l|
+      if load_path.include?(l)
+        lib_files[l] = Dir.glob(File.join(load_path, "#{l}/*.rb"))
+
+        unless l == "topolys"
+          lib_files[l].delete_if { |f| f.include?("version.rb") }
+        end
+
+        puts "#{l} lib files:"
+        lib_files[l].each { |lf| puts "... #{lf}" }
+        puts
+      end
+    end
+  end
+
+  dirs = Dir.glob(File.join(__dir__, "lib/measures/*"))
+
+  dirs.each do |dir|
+    lib_files.each do |l, files|
+      files.each { |file| FileUtils.cp(file, "#{dir}/resources/.") }
+    end
+  end
+end
+
+desc "Update Measure"
+task :measure do
+  puts "Updating Measure"
+
+  require "openstudio"
+  require "open3"
+
+  cli = OpenStudio.getOpenStudioCLI
+  command = "#{cli} measure -t './lib/measures'"
+  puts command
+  out, err, ps = Open3.capture3({"BUNDLE_GEMFILE"=>nil}, command)
+  raise "Failed to update measures\n\n#{out}\n\n#{err}" unless ps.success?
+end
+task :measure => [:libraries]
+
+# default spec test depends on updating measure and library files
+task :spec => [:measure]

data/json/midrise.json

@@ -0,0 +1,64 @@
+{
+  "schema": "https://github.com/rd2/tbd/blob/master/tbd.schema.json",
+  "description": "sorting out multiple story PSI sets (midrise)",
+  "psis": [{
+      "id": "compliant",
+      "rimjoist": 0.3,
+      "parapet": 0.325,
+      "fenestration": 0.35,
+      "corner": 0.45,
+      "balcony": 0.5,
+      "party": 0.5,
+      "grade": 0.45
+    },
+    {
+      "id": "Building Story 1",
+      "rimjoist": 0.501,
+      "parapet": 0.511,
+      "fenestration": 0.521,
+      "cornerconcave": 0.531,
+      "cornerconvex": 0.541,
+      "balcony": 0.551,
+      "party": 0.561,
+      "grade": 0.571
+    },
+    {
+      "id": "Building Story 2",
+      "rimjoist": 0.401,
+      "parapet": 0.411,
+      "fenestration": 0.421,
+      "cornerconcave": 0.431,
+      "cornerconvex": 0.441,
+      "balcony": 0.451,
+      "party": 0.461,
+      "grade": 0.471
+    },
+    {
+      "id": "Building Story 3",
+      "rimjoist": 0.301,
+      "parapet": 0.311,
+      "fenestration": 0.321,
+      "cornerconcave": 0.331,
+      "cornerconvex": 0.341,
+      "balcony": 0.351,
+      "party": 0.361,
+      "grade": 0.371
+    }
+  ],
+  "building": {
+    "psi": "compliant"
+  },
+  "stories": [{
+      "id": "Building Story 1",
+      "psi": "Building Story 1"
+    },
+    {
+      "id": "Building Story 2",
+      "psi": "Building Story 2"
+    },
+    {
+      "id": "Building Story 3",
+      "psi": "Building Story 3"
+    }
+  ]
+}

data/json/tbd_5ZoneNoHVAC.json

@@ -0,0 +1,19 @@
+{
+  "schema": "https://github.com/rd2/tbd/blob/master/tbd.schema.json",
+  "description": "testing TBD JSON for 5ZoneNoHVAC",
+  "psis": [
+    {
+      "id": "outstanding",
+      "rimjoist": 0.09,
+      "parapet": 0.09,
+      "fenestration": 0.09,
+      "corner": 0.09,
+      "balcony": 0.09,
+      "party": 0.09,
+      "grade": 0.09
+    }
+  ],
+  "building": {
+    "psi": "outstanding"
+  }
+}

data/json/tbd_5ZoneNoHVAC_btap.json

@@ -0,0 +1,91 @@
+{
+  "schema": "https://github.com/rd2/tbd/blob/master/tbd.schema.json",
+  "description": "testing TBD JSON for 5ZoneNoHVAC",
+  "psis": [
+    {
+      "id": "BTAP-ExteriorWall-Mass-6 good",
+      "rimjoist": 0.02,
+      "parapet": 0.23,
+      "fenestration": 0.078,
+      "corner": 0.09,
+      "balcony": 0.2,
+      "party": 0.2,
+      "grade": 0.32,
+      "joint": 0.1,
+      "transition": 0.0
+    },
+    {
+      "id": "BTAP-ExteriorWall-Mass-2 good",
+      "rimjoist": 0.01,
+      "parapet": 0.23,
+      "fenestration": 0.078,
+      "corner": 0.09,
+      "balcony": 0.2,
+      "party": 0.2,
+      "grade": 0.32,
+      "joint": 0.1,
+      "transition": 0.0
+    },
+    {
+      "id": "BTAP-ExteriorWall-Metal-1 good",
+      "rimjoist": 0.03,
+      "parapet": 0.35,
+      "fenestration": 0.078,
+      "corner": 0.07,
+      "balcony": 0.2,
+      "party": 0.2,
+      "grade": 0.5,
+      "joint": 0.1,
+      "transition": 0.0
+    },
+    {
+      "id": "BTAP-ExteriorWall-WoodFramed-5 good",
+      "rimjoist": 0.03,
+      "parapet": 0.05,
+      "fenestration": 0.078,
+      "corner": 0.04,
+      "balcony": 0.2,
+      "party": 0.2,
+      "grade": 0.09,
+      "joint": 0.1,
+      "transition": 0.0
+    },
+    {
+      "id": "BTAP-ExteriorWall-SteelFramed-1 good",
+      "rimjoist": 0.09,
+      "parapet": 0.35,
+      "fenestration": 0.078,
+      "corner": 0.09,
+      "balcony": 0.2,
+      "party": 0.2,
+      "grade": 0.47,
+      "joint": 0.1,
+      "transition": 0.0
+    }
+  ],
+  "spacetypes": [
+    {
+      "id": "Warehouse - fine",
+      "psi": "BTAP-ExteriorWall-Mass-6 good"
+    },
+    {
+      "id": "Audience - auditorium",
+      "psi": "BTAP-ExteriorWall-Mass-2 good"
+    },
+    {
+      "id": "Workshop space",
+      "psi": "BTAP-ExteriorWall-Metal-1 good"
+    },
+    {
+      "id": "Office - enclosed",
+      "psi": "BTAP-ExteriorWall-WoodFramed-5 good"
+    },
+    {
+      "id": "Sales area",
+      "psi": "BTAP-ExteriorWall-SteelFramed-1 good"
+    }
+  ],
+  "building": {
+    "psi": "BTAP-ExteriorWall-Mass-2 good"
+  }
+}

data/json/tbd_seb_n2.json

@@ -0,0 +1,41 @@
+{
+  "schema": "https://github.com/rd2/tbd/blob/master/tbd.schema.json",
+  "description": "testing JSON surface KHI entries",
+  "psis": [{
+      "id": "good",
+      "parapet": 0.5,
+      "party": 0.9
+    },
+    {
+      "id": "compliant",
+      "rimjoist": 0.3,
+      "parapet": 0.325,
+      "fenestration": 0.35,
+      "corner": 0.45,
+      "balcony": 0.5,
+      "party": 0.5,
+      "grade": 0.45
+    }
+  ],
+  "khis": [{
+      "id": "column",
+      "point": 0.5
+    },
+    {
+      "id": "support",
+      "point": 0.5
+    }
+  ],
+  "surfaces": [{
+    "id": "Entryway  Wall 5",
+    "khis": [{
+        "id": "column",
+        "count": 3
+      },
+      {
+        "id": "support",
+        "count": 4
+      }
+    ]
+  }]
+}

data/json/tbd_seb_n4.json

@@ -0,0 +1,57 @@
+{
+  "schema": "https://github.com/rd2/tbd/blob/master/tbd.schema.json",
+  "description": "testing TBD JSON for seb.osm",
+  "psis": [{
+      "id": "bad",
+      "fenestration": 1.1
+    },
+    {
+      "id": "good",
+      "parapet": 0.5,
+      "rimjoist": 0.9
+    },
+    {
+      "id": "compliant",
+      "rimjoist": 0.3,
+      "parapet": 0.325,
+      "fenestration": 0.35,
+      "corner": 0.45,
+      "balcony": 0.5,
+      "party": 0.5,
+      "grade": 0.45
+    }
+  ],
+  "khis": [{
+      "id": "column",
+      "point": 0.0
+    },
+    {
+      "id": "support",
+      "point": 0.0
+    }
+  ],
+  "building": {
+    "psi": "(non thermal bridging)"
+  },
+  "surfaces": [{
+    "id": "Entryway  Wall 5",
+    "khis": [{
+        "id": "column",
+        "count": 3
+      },
+      {
+        "id": "support",
+        "count": 4
+      }
+    ],
+    "psi": "(non thermal bridging)"
+  }],
+  "edges": [{
+    "psi": "bad",
+    "type": "fenestration",
+    "surfaces": [
+      "Entryway  Wall 5",
+      "Sub Surface 8"
+    ]
+  }]
+}

data/json/tbd_warehouse10.json

@@ -0,0 +1,24 @@
+{
+  "schema": "https://github.com/rd2/tbd/blob/master/tbd.schema.json",
+  "description": "test_warehouse.osm with custom subsurface U-factors",
+  "khis": [{
+    "id": "OK",
+    "point": 0.8
+  }],
+  "surfaces": [{
+    "id": "Fine Storage Front Wall",
+    "khis": [{
+      "id": "OK",
+      "count": 2
+    }]
+  }],
+  "subsurfaces": [{
+      "id": "Office Front Wall Window 1",
+      "usi": 4.0
+    },
+    {
+      "id": "Office Front Wall Window2",
+      "usi": 3.5
+    }
+  ]
+}