Skip to content

BEMGen 1.2.0

Choose a tag to compare

View all tags
@Chengxuan-Li Chengxuan-Li released this 09 Oct 07:49
· 18 commits to main since this release
v1.2.0
c72c001

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

What's new

  • Program JSON (panel 1 Program) is a new component that turns the text of a program JSON 2.0.0 file from the Energy Archetype Atlas into a program preset.
    • It reads the defaulted export only, checks it against the program JSON schema and the contract's rules, and expands every schedule hour by hour on a Year (default 2007) and its Holidays.
    • WWR (default 0.4) and optional inputs for the name, space type, loads, heating and cooling, and the occupants complete or override the JSON.
    • Its outputs record where every value came from: the source, the atlas's assumptions, your overrides, and what was left out (shared services and design-day rules).
    • The new example program-json-office.gh uses the atlas's Medium Office program as the office of an Office Plate.
  • Programs hold more. New inputs are added at the end of the components, so earlier inputs are unchanged:
    • Load: the basis PerDwellingUnit, an End Use that tells loads of one type apart, the heat fractions of lighting and equipment, and the target and inlet temperatures of hot water.
    • Program Preset and every built-in preset: Heating On and Cooling On, so a space can be only heated or only cooled. Program Preset also takes the occupants' Activity, People Radiant, and People Sensible.
    • Schedule: the kind Activity (W per person).
    • Mix Programs and every zone merge combine all of these. Per-dwelling loads merge by dwelling count.
    • The defaults are the values BEMGen used before, so the built-in presets give the same results as in 1.1.0.
  • Converters:
    • Convert2BEM has nine new outputs, 22 to 30: load end uses, heat fractions, dwelling units, activity, people radiant and sensible fractions, hot-water target and inlet temperatures, and the calendar.
    • Convert2IDF writes the heat fractions, people settings, and water temperatures, uses a single heating or cooling thermostat for a zone with one side, and takes the run period's year from the calendar. Without a calendar the year is 2007, instead of 2018; both start on a Monday, so the schedules fall on the same weekdays.

Changes that affect existing definitions

  • Definitions saved with 1.1.0 open as they were, with their values and wires; the new inputs take their defaults.
  • Definitions saved with 1.0.2 or earlier still lose the infiltration values of their presets when they open, as described for 1.1.0.
  • The example definitions have been rebuilt with 1.2.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.2.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.2.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.2.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/).

Assets 6
Loading