Diagnostics
The Diagnostics pane lists what is missing or wrong in a project’s setup. It reads the same project check that HVAKR runs after every calculation, and it puts each finding in the workflow step where you fix it.
When to open Diagnostics
Section titled “When to open Diagnostics”Open Diagnostics first when:
- Loads, airflows, or equipment results are missing, zero, or lower than you expect.
- A selection or report value looks wrong and you are not sure which input causes it.
- You want to check a project for missing inputs before you export reports.
A missing input often looks like a calculation problem. For example, a space type with no cooling setpoint and a coil with no target temperature both remove load from the results. Diagnostics shows both as warnings, one under Space Types and one under Equipment.
Read the findings
Section titled “Read the findings”Diagnostics shows one section for each step, in workflow order: Weather, Building, Spaces, Envelope Types, Space Types, Loads, Zones, Systems, Operating Modes, Airflows, Ventilation, and Equipment.
Each step header shows the step’s status and how many findings it has:
| Status | Meaning |
|---|---|
| Complete | The step has no errors or warnings. |
| Warning | The step calculates, but some input is incomplete. Results can be low or partial. |
| Error | An input is missing, a calculation failed, or a result is outside the expected range. |
| Blocked | A step it depends on has an error. The header names that step, for example Blocked by Building. Fix that step first. |
Each finding shows its severity, the space, zone, system, or space type it is about, and the message. Informational findings sit under Notes in each step. Select Notes to show them.
Before the first calculation finishes, the pane shows Checking project…. It never shows a step as complete before HVAKR has checked it.
Fix a finding
Section titled “Fix a finding”Select a finding to open the pane where you fix it:
| Finding is about | Opens |
|---|---|
| A space | Spaces, on the space’s level, with the space selected |
| Spaces with no space type | Spaces, with the one on the lowest level selected and that level shown |
| A space type | Space Types |
| A zone | Zones, with the zone selected |
| A system | Systems, with the system selected |
| Equipment, such as a coil | Configuration, with the unit’s system or zone selected |
| The project | The pane for the finding’s step, for example Weather or Building Data |
After you change an input, HVAKR calculates again and Diagnostics updates.
How it’s calculated
Section titled “How it’s calculated”The How it’s calculated tab shows how inputs flow through the load, airflow, and equipment calculations. Select any step to see what it uses, what it feeds, and the values for this project.
What Diagnostics does not do
Section titled “What Diagnostics does not do”Diagnostics finds setup problems that HVAKR can detect. It does not review your design, and it does not confirm that a project meets a code or standard. Review the results with the same engineering judgment you use for any calculation.
If a value still looks wrong after you clear the findings, see Troubleshooting & FAQ, or grant HVAKR Support access to the project so we can review it.