Rhino plugin
The Rhino plugin sends your Rhino model’s types and quantities to a project in LCAbyg. The quantities are measured on the geometry. Nothing in the project changes until you have reviewed and approved the submission in LCAbyg.
The Rhino plugin is for the everyday submission of the model. If you want to send from a Grasshopper definition, for example variants or geometry that only exists in Grasshopper, use the Grasshopper components. They are in the same package and share the login.
System requirements
Section titled “System requirements”- Rhino 6, 7 or 8
- Windows. Mac is not supported.
Install the plugin
Section titled “Install the plugin”The plugin and the Grasshopper components are in one package, a .yak file, which you get from
LCAbyg. The package is not on Rhino’s public Yak server. Install it with Rhino’s package tool Yak,
giving the path to the folder the file is in. Adjust the path to your Rhino version:
"C:\Program Files\Rhino 7\System\Yak.exe" install --source=<folder with the .yak file> lcabygStart Rhino and type LCAbygPanel in the command line. The first time the plugin loads, it also
opens the LCAbyg toolbar. Rhino remembers it for next time. If you have closed it, bring it back
with LCAbygToolbar.
If Rhino is set to Danish, the plugin is in Danish, otherwise in English. If you change the language in Rhino, restart Rhino.
The toolbar
Section titled “The toolbar”| Button | What it does |
|---|---|
| Send to LCAbyg | Sends the model to the project |
| Status | Shows the project’s default version, a waiting submission from the file and the project’s result |
| CO₂ in the model | Colours the model by LCAbyg’s CO₂ figures, see the section on CO₂ in the model below |
| Open project | Opens the project in your browser. Right-click opens the results |
| Panel | Opens the LCAbyg panel with the workflow, the layers and the status |
| Account | Logs in. Right-click logs out |
| Listen for Show | Turns Show in Rhino on or off |
| Save as file (test) | Saves what the plugin would send as a .json file. Sends nothing. Use it if support asks for a file |
The LCAbyg panel
Section titled “The LCAbyg panel”The panel gathers the workflow in one place and can be docked like Rhino’s other panels. At the top are the steps Account, Project, Layers, Send and Status. A step that has not been done is in italics, and you click it to do it. Below the steps are the ▶ Send to LCAbyg button and the Layers and Status tabs.
At the bottom are the server the plugin uses, Help, Show all questions again and Log out. Help opens this guide in your browser. If there is a newer version of the plugin, it is shown at the top of the panel.
Send the model
Section titled “Send the model”- Open the panel with Panel on the toolbar.
- Account: Click Log in. LCAbyg opens in your browser and shows the account you are connecting. Click Grant access. The answer appears in Rhino’s command line once you have approved (within 5 minutes).
- Project: Click Choose, and pick a project, or create a new one with a name and optionally a template. The choice is saved in the Rhino file.
- Layers: On the Layers tab, choose which layers are included, see Choose the layers.
- Click ▶ Send to LCAbyg. The plugin checks the subscription, collects the model with progress in Rhino’s status bar and writes the report in the command line.
- Confirm the submission. The review opens in your browser.
Review and approve the submission under Models. Only your approval creates a new version.
In the confirmation you can choose Don’t ask again for this project. It only applies to the same account, and the confirmation always appears when a new submission supersedes one that has not been approved. You get it back with Show all questions again in the panel.
Send only the selected objects
Section titled “Send only the selected objects”If there are two identical buildings in the file, for example because you copied the whole building before
making corrections, select the building that should be included and click Send selected to LCAbyg in the panel,
or type LCAbygSendSelected. The objects get their layers’ settings as usual, and a selected object on a
layer without a tick under Include is not sent.
What you select is the whole submission. Everything that is not selected does not count: types and elements that only exist outside the selection appear as removed in the review, and if you approve, the quantities become the selection’s only. The confirmation therefore says how many of the model’s objects are sent, every time, and cannot be remembered. Select the whole building you want included, not just part of it.
Choose the layers
Section titled “Choose the layers”The Layers tab shows the file’s layers with the layer’s name and number of objects first, and then five choices:
- Include: Layers without a tick are not sent. A new layer in the file is included by itself.
- Measure: The column has an arrow in its header. Click the field to choose how the layer measures area: Standard, Whole surface or Outline, see Measuring per layer.
- No curves: Curves, points and text on the layer are skipped, so a helper line on an area layer does not give the layer a length. A layer with no curves is always included.
- Holes: Sends the holes in the layer’s faces as a type of their own,
<layer> (holes), so windows and doors can be measured as the hole in the wall. A layer with holes is always included. - Pcs: Each object on the layer counts as one piece, whatever its geometry. Points and text markers, which are otherwise not sent, are counted too. The layer sends no area, no volume and no length, so the construction in LCAbyg must have the unit pcs. If it is in m², m³ or m, the quantity is missing in the review. A layer with pcs is always included.
The choices are linked, and the last one chosen wins. Pcs excludes all the other choices, because the layer is not measured. Outline excludes Holes and No curves. Whole surface can be combined with both Holes and No curves.
Pick in model selects the layer of the object you point at. Show layer’s objects selects the objects on the chosen layer and zooms to them. The choice is saved in the Rhino file straight away.
Use the same layers every time. LCAbyg compares with everything sent before from the model, so types from a layer you have unticked appear in the review as removed from the model.
Status
Section titled “Status”Click Fetch status in the panel, or Status on the toolbar. You see the project’s default version, a submission from the file that is waiting for review, and the climate impact in kg CO₂e/m²/year with the limit value and whether it is met. LCAbyg calculates the default version when the status is fetched. Afterwards you can open the review or the results.
What is sent
Section titled “What is sent”| In Rhino | In LCAbyg |
|---|---|
The layer with its full path, e.g. Facade::Ydervæg | The category |
| The block definition, or the layer for loose geometry | The type, which you link to one construction in the review |
| The geometry | The quantities, measured by the rules below |
| User text (Attribute User Text) on the objects and the layer | The type’s properties, when the type has one answer |
| The render material | The type’s materials, as information in the review |
User text is only sent when the type has one value: it is on the layer (when the layer is the
type), or it is on every object in the type with the same value. If it differs or is missing on some
objects, it is not sent, and the report says which. If a user text holds a classification code, e.g.
BIMTypeCode = 21.11, it is used for the suggestions in the review.
The materials are the names of the render materials on the type’s faces, solids and meshes, also in blocks. They are shown under From the model in the review and help find a construction, but never choose one.
Rhino has no worksets, phases or classification fields, so those fields are empty.
The first time you send, the Rhino file gets a model key, which is saved in the file. A copy made with Save as has the same key and counts as the same model.
How the quantities are measured
Section titled “How the quantities are measured”Quantities are measured in metres, m² and m³. The file’s units are converted, and the model is never changed.
| Geometry | Quantities |
|---|---|
| Open surface or Brep | Area, with holes subtracted |
| Closed solid (Brep or mesh) | Volume, and area as one side: half the area of the faces parallel to the largest face |
| Curve | Length. A closed, planar curve also gives the area it encloses |
| Points, text and the like | No quantity. The object is not sent, but is counted in the report |
If the largest face of a closed solid is not planar, e.g. a cylinder, the volume is sent without an area, and the report gives a warning. Blocks are measured with their scaling.
Measuring per layer
Section titled “Measuring per layer”The table above is Standard. The Measure column on the Layers tab only changes how the area is found. The rest of the table applies on every layer.
| Measure | What is sent |
|---|---|
| Standard | As in the table |
| Whole surface | A closed solid (Brep or mesh) gives volume and the sum of the area of all faces, with the holes subtracted. Open surfaces are unchanged. Use it for columns, pipes and other solids where Standard cannot determine a side |
| Outline | Only an area, no volume and no length. If everything on the object is curves, each closed, planar curve gives the area it encloses, and any other curve gives an error. Otherwise the largest planar face is found, the parts are moved to its plane, and the area is the circumscribed rectangle around them. A block is one object, e.g. one window. If there is no planar face, it gives an error. Use it for windows and doors |
No curves skips curves, points and text on the layer and counts them in the report, also the area of closed curves. If an object has only that kind, it is not sent.
The report writes the rule next to the type, e.g. measuring rule: outline. If a quantity cannot be measured by the rule, it is empty and not 0. If the same block is on several layers with different rules, it is one type, and the report says the figures were measured differently. Put the objects in separate types.
CO₂ in the model
Section titled “CO₂ in the model”CO₂ in the model opens the panel of the same name, which colours the file’s objects by LCAbyg’s figures for the project’s default version. The model must have been sent and the submission approved.
- Choose Total CO₂ to see where the CO₂ is, or CO₂ per unit to see which types are the heavy choice. Per unit, only types with the same unit are compared.
- Click Colour the model.
The scale shows the version and the time of calculation and five classes from green to red. Under Total CO₂ the figures can be shown in kg, kg/m² or kg/m²/year. No data and Not in LCAbyg each have their own colour. Check again looks for a waiting submission, changes in LCAbyg, another default version and changes in Rhino that have not been sent.
The colours are drawn on top of the objects and are not written to the file. They disappear with Remove the colours, or when Rhino is closed. They are only shown in shaded views, and selected objects look as usual. The holes in a wall and geometry from Grasshopper are not coloured.
Show in Rhino
Section titled “Show in Rhino”- Click Listen for Show on the toolbar, or type
LCAbygListen. - Click Show in Rhino on a line in the review in LCAbyg. The objects are selected in Rhino.
Click Listen for Show again to stop. Geometry from Grasshopper has no object in the file and cannot be shown.
Commands
Section titled “Commands”Every button runs a command, which you can also type in the command line.
| Command | What |
|---|---|
LCAbygLogIn | Logs in through the browser |
LCAbygLogOut | Logs out, also for the Grasshopper components |
LCAbygPanel | Opens the LCAbyg panel |
LCAbygSend | Sends the model with the file’s project and layer choice |
LCAbygSendSelected | Sends only the selected objects, see Send only the selected objects |
LCAbygStatus | Shows the project’s status |
LCAbygOpenProject | Opens the project in the browser |
LCAbygOpenResults | Opens the results for the project’s default version |
LCAbygColor | Opens the CO₂ in the model panel |
LCAbygListen | Turns Show in Rhino on or off |
LCAbygSaveFile | Saves the submission as .json. Needs no login |
LCAbygPickLayer | Point at an object, and the panel’s layer tab selects its layer |
LCAbygToolbar | Shows the toolbar again |
What is saved in the Rhino file
Section titled “What is saved in the Rhino file”The project the file is linked to and your layer choice are saved in the Rhino file, so they are there the next time you open it. Layers are saved by their id, so renaming a layer does not change the choice.
Log out
Section titled “Log out”Click Log out in the panel, or right-click Account on the toolbar. You are also logged out of the Grasshopper components. The device is listed under Settings, Connected devices.
Click Help at the bottom of the LCAbyg panel to open this guide in your browser. It opens in the plugin’s language.
See also
Section titled “See also”- Grasshopper components
- Models: review and approval of submissions