Skip to content

BEMGen 1.8.0

Choose a tag to compare

View all tags
@Chengxuan-Li Chengxuan-Li released this 30 Oct 22:42
· 6 commits to main since this release
v1.8.0
d449072

BEMGen 1.8.0 is a Grasshopper plugin for Rhino 8 that builds building energy models at several levels of detail.

What's new

  • Programs from the atlas site. BEMGen can now take its programs from the Energy Archetype Atlas site (https://energy-atlas.github.io/archetype-atlas/). The network is used only after you click in one of the windows below. Every solve reads only the definition, so stored programs solve offline.
    • Program JSON: Get from Atlas… opens a window with the atlas site. On a program's page, Use this program downloads its program JSON (filled by default, or source), checks it against the site, and stores it in the component.
    • Program JSON: Edit JSON… opens a window to paste or edit the program JSON text. OK checks the text before it is stored.
    • Each DOE … Programs component: Get from Atlas… opens a window with five atlas families: DOE Ref pre-1980, DOE Ref 1980–2004, 90.1-2007, 90.1-2013, and 90.1-2019. Each family shows how many of the prototype's program keys it covers. OK stores every key's atlas program in place of the illustrative presets. The window-to-wall ratios stay those of the DOE reference building. Clear returns to the illustrative presets.
      • New optional inputs Climate Zone, Year, Holidays, and Context apply to a stored atlas map.
      • A new output, JSON, gives each key's program text.
      • The 90.1 families split or rename up to four space types, so a few keys have no program there. Such a key is named in an error, and Presets leaves its position empty, so you can complete the map with DOE Program Map.
    • Schedule Draw: Get from Atlas… stores the generation.json of the atlas folder of the program in Program JSON. The atlas has no generation.json for its detailed office folders, so programs of the DOE small, medium, and large office cannot be drawn yet. The window says so.
  • New example: doe-atlas-map.gh, the DOE medium office with the atlas's 90.1-2007 programs stored in DOE Medium Office Programs. It solves without a network.

Changes that affect existing definitions

  • Definitions saved with 1.7.0 open with their saved values. The DOE Programs components get the four new inputs, unset, and the JSON output, and solve as before.
  • Program checksum: the checksum in Program JSON's Source is now that of the text with LF line endings. A definition whose stored text had CR LF line endings gets a new Source checksum once.
  • The example definitions have been rebuilt with 1.8.0.
  • Windows only: the atlas windows use WebView2.

Install

Close Rhino first. Install BEMGen in one way only, because two copies of BEMGen.gha register the components twice.

  • Yak package: drag bemgen-1.8.0-rh8_19-win.yak onto a running Rhino 8.19 (or later) window, then restart Rhino.
  • Zip:
    1. Open the properties of bemgen-1.8.0-rh8-win.zip and tick Unblock.
    2. Unpack it and copy the BEMGen folder into %APPDATA%\Grasshopper\Libraries\, so the plugin is at %APPDATA%\Grasshopper\Libraries\BEMGen\BEMGen.gha. If an earlier version is there, replace the whole folder.
    3. Restart Rhino.
  • Examples: bemgen-1.8.0-examples.zip holds the example definitions.
  • Checksums: SHA256SUMS.txt lists the SHA-256 checksum of each of the three files.

Documentation: https://energy-atlas.github.io/BEMGen-docs/

Assets 6
Loading