Skip to content

BEMGen 1.4.0

Choose a tag to compare

@Chengxuan-Li Chengxuan-Li released this 16 Oct 06:54
· 12 commits to main since this release

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

What's new

  • Construction JSON. A new component in 1 Program, Construction JSON (CJson), reads the text of a whole-building construction set of the Energy Archetype Atlas into a Construction Set. The set holds one layered construction per envelope role, the window's glazing and any solar multiplier, the internal-mass data, and the infiltration. A set for a single dwelling is refused. A detailed set is read but not converted; connect the whole-building set of the same context instead.
  • Constructions in Convert2IDF. Two inputs are appended to Convert2IDF:
    • Construction (Cons) takes the set and is used instead of Envelope. Connect one, not both.
    • Fill From Example (Fill, default false) lets a role the set lacks take the Example envelope's construction, with a warning. When it is false, such a role is an error. The ground always takes the Example's construction, with a remark.
  • Internal mass balanced against the set. With a set, the heat capacity that the building's own walls and slabs do not represent is added as furnishing, wall, and floor mass. The IDF header lists the balance.

Changes that affect existing definitions

  • Definitions saved with 1.3.0 open as they were, with Construction unset and Fill From Example false.
  • IDF files of Single Zone Building and Single Zone per Floor Type buildings change, with any envelope. A slab inside a zone that spans storeys is now written as internal mass of twice its area at half its thickness, so its heat capacity counts once. Before, it counted twice.
  • The example definitions have been rebuilt with 1.4.0.

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.4.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.4.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.4.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/ (see Getting started, and What's new at https://energy-atlas.github.io/BEMGen-docs/user/whats-new/).