Project Health Check

Get the Add-On from the Store

Installation

See the Add-On installation guide for details.

Open Project Health Check

You can open Project Health Check palette through one of the following entry points:

  • Go to Design / Model Check menu and select Project Health Check from the list.
  • Go to Window / Palettes menu and select Project Health Check from the list.

Select the desired checks to run

On the left-hand side of the palette, you can find the list of available checks. Please ensure to select the ones you wish to conduct on your project. The checks are organized into groups; changing the state of a group will apply the change to all elements within that group.

Run checks on your project

Use the buttons located at the top left corner of the palette. You have several options:

  • Run all the selected checks.
  • Run only the currently selected check from the list. When a group is selected, all checks will run within that group.
  • Clear all results from previous runs.

Available checks

  • Attributes
    • Missing Attributes in Attributes: Checks if an Attribute is referencing an other Attribute that is missing.
    • Missing Textures in Surfaces: Checks if a Surface is referencing a texture file in the Library that is missing.
    • Unclassified Attributes: Checks if a Building Material has no Classification Item assigned to it.
    • Duplicated Attributes: Finds attributes that have identical parameters and properties.
  • Properties
    • Properties that are not available for any Classification: Checks if a Property is not available for any Classification Items. These properties are not appearing in the project.
  • Placed Elements
    • Missing Attributes in Elements: Checks if a placed Element is referencing a missing Attribute.
    • Unclassified Elements: Checks if a placed Element has no Classification Item assigned to it.
    • Elements with Undefined Structural Function: Checks if a placed Element has Undefined Structural Function.
    • Elements with Undefined Position: Checks if a placed Element has Undefined Position.
    • Elements on Archicad Layer: Checks if a placed Element is on the Archicad Layer. Archicad Layer is a special Layer with no option to set visibility and other parameters, so it’s not recommended to place Elements on this Layer.
  • Default Elements
    • Missing Attributes in Default Elements: Checks if a Default Element is referencing a missing Attribute.
    • Unclassified Default Elements: Checks if a Default Element has no Classification Item assigned to it.
    • Default Elements with Undefined Structural Function: Checks if a Default Element has Undefined Structural Function.
    • Default Elements with Undefined Position: Checks if a Default Element has Undefined Position.
    • Default Elements on Archicad Layer: Checks if a Default Element is on the Archicad Layer. Archicad Layer is a special Layer with no option to set visibility and other parameters, so it’s not recommended to place Elements on this Layer.
  • Favorites
    • Missing Attributes in Favorites: Checks if a Favorite is referencing a missing Attribute.
    • Unclassified Favorites: Checks if a Favorite has no Classification Item assigned to it.
    • Favorites with Undefined Structural Function: Checks if a Favorite has Undefined Structural Function.
    • Favorites with Undefined Position: Checks if a Favorite has Undefined Position.
    • Favorites on Archicad Layer: Checks if a Favorite is on the Archicad Layer. Archicad Layer is a special Layer with no option to set visibility and other parameters, so it’s not recommended to place Elements on this Layer.
  • Views
    • Views not used on Layouts: Checks if a View is not placed on any Layouts.
    • Views not used by Publisher Sets: Checks if a Vies is not used by any Publisher Sets.
    • Unused Views: Checks if a View is not placed on any Layouts and is not used by any Publisher Sets.
  • Library
    • Unused Embedded Library Parts: Checks if an Embedded Library Part is not placed anywhere in the project.
  • Documentation
    • Dimensions with custom text: Checks if Dimension Elements have custom texts.
  • Geometry
    • Elements that are not exactly horizontal or vertical: Checks if a linear Element is almost horizontal or vertical. This usually happens by mistake.
    • Elements that has very small length: Checks if a linear Element has very small length. This usually happens by mistake.

Evaluate the results

When a check fails on a certain part of the project, it will appear in bold in the list of checks. Clicking on a check will display all of the reports on the right-hand side of the palette. The report contains all relevant information necessary to understand the problem.

You can also perform specific actions on the report to gain more context on the problem, such as selecting the problematic element or opening the corresponding settings dialog. To do this, select the report and click on the arrow icon at the end of the row. A list of available actions for the current report will appear. Additionally, you can set a default action at the top of the report list, which will execute when you double-click on a report.

Shopping Cart
Scroll to Top