1. Incorrectly Categorized Objects
(User) How does cove.tool differentiate Wall Area (e.g. South façade wall) and Envelope Area (South façade envelope)? Although the True-North-facing façade in Rhino Grasshopper is facing upwards, for some reason, cove.tool is understanding it the opposite way when I check the exported values inside cove.tool's geometry page. 

(Response) The cove.tool grasshopper plugin uses a property-tag front-face/ back-face of each plane to determine the cardinal orientation of each surface. For Example: a surface's area will be filtered into the category of the direction that its front-face is facing (FYI, this is the same tag/property is used to apply materials on surface). If area categories look incorrect, check your project for inverse-facing surfaces.  

  • To check, use the back-face settings in "Properties>Rhino Options>View>Display Mode>Shaded - Backface Settings" to set a 'single color for all the backfaces' (see image below). Surfaces facing the wrong direction [outwards] will appear in the backface color. 
  • To correct orientation,  surfaces can be flipped in Rhino with the command "Flip" (second image). 

Once all your objects have been correctly orientated,  try the grasshopper script again and your surface areas should fall into the correct cove.tool geometry category.

2. Geometry not appearing in cove.tool
(User)  I've logged into my cove.tool account in grasshopper, but after setting building height for one of the buildings, it did not refresh as the tutorial showed, same goes for the roof area and floor area? why isn't it loading into cove.tool?

(Response) In order to export your geometry to the correct project you need to connect the Rhinoceros file to the correct cove.tool project with the 'Project Selector' slider. Once you have added both your username and password, the 'Project List' panel in Step 2 will populate with all the projects in your cove.tool account (names will show in order to creation, i.e. most recent project should appear at the bottom). Next,  link your Rhinoceros File to the your cove.tool project by setting the 'Project Selector' slider to select the project's number as it appears in the Project List (see below). 

Users can also check which project their grasshopper script has been connected to, by looking at the ID# in the panel following the Project Slider and comparing it to the project ID# seen in the URL address of their cove.tool project (Example below)

3. Single Red/Orange Box
(User) I added the walls [and/or windows] to the surfaces box as shown in the tutorial, then a box turned red [or orange], what does that mean?

(Response)  One red and/or orange box is a common sight in grasshopper. As long as the error does not spread beyond the second row, you can continue exporting. These colors in grasshopper are used to identify when the command is struggling with processing the inflow/outflow of information. In this case, the error was likely caused by a non-single surface object, or highly complex surface plane falling into the geometry selection. A single error in the script will not halt the geometry data from exporting or cause an incorrect area export, so users can ignore the error and continue with their export. If a user would like to attempt to remove the error, then they can repeat the geometry selection step and make sure the selection only contains single surface objects that cannot be exploded further.

4. Multiple Red/Orange Boxes
(User)  I added the walls after clearing the surfaces box's previous value and saw multiple red/oranges boxes. What does the red mean and orange mean?

(Response) Before anything else, try to reconnect your geometry again. Grasshopper can sometimes see certain bugs that are easily resolved by repeating steps twice to work properly. If it still doesn't work, then the error may be caused by the kinds of surfaces you are exporting. The cove.tool plugin can only collect area geometry from single surface objects. A grouped, polysurface, mesh, and/or linked surface object would be rejected and might prompt multiple errors in the script. Users are recommended to check out step 3 of the Rhino/Grasshopper section in the plugin handbook to fix this issue. As a quick summary, explode/convert all envelope objects to single surface planes. Also depending on how much use and ware this file has had, it might be best to start again with a new grasshopper file and repeating the steps. While being a powerful platform, Grasshopper can sometimes be temperamental. A new script can be downloaded from Food4Rhino.com/app/covetool.

Did this answer your question?