1. Grasshopper plugin

Intro

Grasshopper plugin is the main target software of Morpho. Here you can find all the info you need to become familiar with the tool within Grasshopper.

---

Toolbar

The toolbar is divided in different subcategory:

• 0 || Geometry: components to translate Rhino/Grasshopper geometry <> Morpho geometry.
• 1 || Settings: components to set an envimet project and other main parts of an INX model, such as the location and the grid.
• 2 || Entity: components to create the envimet objects that populate an INX model, such as buildings and plants
• 3 || IO: components to write INX model, write simulation files and read binary results.
• 4 || Simulation: components to set the option of the simulation files like the building indoor temperature or the soil temperature to use during the simulation
• 5 || Util: a series of utilities like a component that runs Envimet Spaces to debug the model or a component to decompose XML materials of envimet.

Logic of modeling

Morpho uses its geometries and its algorithm of ray intersections. It means that every Rhino or Grasshopper geometry needs to be translated first. This is also the reason why there is a specific subcategory for it - 0 || Geometry.
GEOMETRY + PROPERTIES = ENTITY
There are two main geometry objects in Morpho: inx_point and inx_facegroup:

• Point is used with "morpho_plant3d" and "morpho_receptor"
• Facegroup is used with "morpho_building", "morpho_soil", "morpho_plant2d", "morpho_source" and "morpho_terrain" Because everything is related to a grid in envimet every entity component as "inx_grid" as a mandatory input.

Geometry mapping

Morpho entity	Rhino geometry type	Morpho geometry type	Notes
Building	Solid brep or solid mesh	Facegroup	Keep it simple and clean the geometry as much as possible. Simple volumes
Soil	Flat brep or surface or flat mesh	Facegroup	The direction of the rhino geometry must be -Z. If you have many faces for a facegroup try to simplify the input geometry or split it in many parts to speed up the calculation
Plant 2D	Flat brep or surface or flat mesh	Facegroup	The direction of the rhino geometry must be -Z. The height of the plant depends only by envimet DB
Plant 3D	Point	Point
Receptor	Point	Point
Source	Flat brep or surface or flat mesh	Facegroup	The direction of the rhino geometry must be -Z. Surface sources only for now.
Terrain	open Brep or mesh	Facegroup	If you have many faces for a facegroup try to simplify the input geometry or split it in many parts to speed up the calculation

All geometries except the terrain must be on the World XY Plane. It is the principle of the modeling on envimet. Envimet will automatically project the entities on the terrain during the simulation.

If your model is detailed (3D) and there are terrain entities it is possible to select two different methods of projection:

1. Follow terrain: each voxel of the building is shifted following the terrain's voxels - common behavior of Envimet Spaces.
2. Mean value: the buildings are moved up without changing its geometries.