Grasshopper Module

First off, for all Oasys developers, here's a handy set of tutorials to making Ladybug Components, by Mostapha Sadeghipour Roudsari. This is used as a guide for the Oasys components.

Developer wishlist:

• Automatically save userobjects and python files to github folders similar to the Ladybug_Export Ladybug component.
• Automatically detect changes to the main branch of RC_BuildingSimulator and update the BuildingPhysics, EmissionSystems and SupplySystems components.

Simulation Environment

1. Geometry definition

Currently a GH defined box with window(s)

2. Irradiation calculations with ladybug

Hourly irradiaition calculations are by far the most time consuming part of the simulation. There are two possible solutions:

1. Adapt the monthly model from EN ISO 52016-1 (previosly ISO 13790) and calculate monthly irradiation in ladybug
2. Speed up the hourly solar calculations

3. Simulation

The simulation component brings together all the inputs and runs the RC model on the hours provided.

Simulation Parameters

Parameters obtained from weatherfile/ladybug:

1. Outdoor air temperature
2. Solar irradiation

Parameters otherwise defined:

3. Initial mass temperature
4. Internal gains
5. Occupancy

4. Results visualisation and export

Testing

• Check Inputs

  • Check if incident irradiation corresponds to zone geometry
  • Check how solar gains are being calculated from incident irradiation
  • Check if Occupancy schedules and internal gains fall within a reasonable range
  • Check sensitivity of all inputs

• Check results against Python model

  • Default building parameters should match those in Python model (the Grasshopper component includes the attribute g_windows.)
  • Replicate single-hour Python unit tests on GH model
  • Run simulation in Python using inputs from GH model. Assert results equal to grasshopper outputs

• Usability

  • Come up with use cases
  • Implement in assignment workflows

Feature Wishlist

• Faster Irradiation simulation in Ladybug
• Clean output component
• Result visualisation within Rhino
• Automatic recognition and implementatoin of updates to the python code.

Python Compatibility

For maximum compatibility between the Python version and the RC tool, the classes for Building, Supply and emission systems each have their own component. When a new version of the building_physics.py, supply_system.py or emission_system.py is created, the code can be pasted in place of the old code in the corresponding Grasshopper user objects.