Skip to content

BEMGen 1.7.0

Choose a tag to compare

@Chengxuan-Li Chengxuan-Li released this 30 Oct 07:26
· 6 commits to main since this release

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

What's new

  • Schedule Draw uses the atlas schedule generator 4.0.0. Schedule Draw in 1 Program now runs atlas-schedules 4.0.0, which carries atlas release 2.2.0 with it.
    • Install it separately: download atlas_schedules-4.0.0-py3-none-any.whl and SHA256SUMS.txt from the atlas release atlas-schedules-v4.0.0, check the file with sha256sum -c SHA256SUMS.txt --ignore-missing, and run python -m venv <folder> and <folder>\Scripts\python -m pip install atlas_schedules-4.0.0-py3-none-any.whl (Python 3.11 or later). An environment with 3.0.0 is upgraded with pip install --upgrade and the same wheel.
    • Its Generator JSON input now takes the generation.json of the program's folder in atlas release 2.2.0 (v2.2.0/<family>/<template>/<type>/generation.json in atlas-release-2.2.0.zip of the atlas release v2.2.0), in place of the earlier generator.json.
    • Its setting is version 2.0.0: "schema_version": "2.0.0", the generator version 4.0.0 and bundle schema 4.0.0, and no view. The program JSON's own version (filled or source) chooses the values the generator draws from.
    • The draw records the atlas release it read and that release's manifest checksum.
  • Atlas release 2.2.0. Program JSON and Construction JSON read the exports of atlas release 2.2.0. Exports of releases 2.0.0 and 2.1.0 remain valid; the contracts did not change, and later releases of the same program JSON contract are read too.

Changes that affect existing definitions

  • Definitions saved with 1.6.0 open with their saved values.
  • Drawing again with a 1.6.0 definition: replace its generator.json with the release 2.2.0 generation.json and its setting with a 2.0.0 setting. A 1.0.0 setting or a generator.json is refused with a message that says what to give instead.
  • Drawn schedules: a program JSON drawn with 1.6.0 still reads. Drawing it again gives the same schedules wherever the atlas's checks show generator 4.0.0 equal to 3.0.0, for example the DOE Ref medium office of the example. The atlas found 263 of 266 sampled cases equal; the other 3 are hotel corridor compositions, which Schedule Draw does not draw. The atlas's 90.1 apartment-building common-area programs now carry their heat fractions, so their draws can differ.
  • The example definitions have been rebuilt with 1.7.0; schedule-draw.gh holds the release 2.2.0 generation.json and a 2.0.0 setting.

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.7.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.7.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.7.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/