MEP — Mechanical System is well connected

What does this rule do?

This rule checks whether Mechanical Systems are fully connected.

The check is performed using the Revit system property isWellConnected, which indicates whether all elements in the system are properly connected.

---

What the rule checks

The rule analyzes Mechanical Systems and validates their connectivity.

Specifically, the rule checks:

• whether the element is a Mechanical System
• whether the property isWellConnected is available
• whether the value of isWellConnected is true

The rule fails when:

• isWellConnected = false

The rule passes when:

• isWellConnected = true

---

Scope of the check

This rule applies to:

• Mechanical Systems
• system-level elements in Revit

---

Why this rule exists

Well-connected systems are essential for reliable MEP models.

Disconnected or partially connected systems can result in:

• incorrect system behavior and analysis results
• unreliable quantities and calculations
• issues in coordination and data exchange

By enforcing that systems are fully connected, the model remains consistent, analyzable, and suitable for downstream use.

---

{
  "Id": "5b766638-9c45-4387-bf54-94a6ccbccf2a",
  "Filter": {
    "Type": "queryFilter",
    "Properties": [
      {
        "Name": "Query",
        "Value": "$[$.type=\"MechanicalSystem\"]",
        "Type": null
      }
    ],
    "SubFilters": []
  },
  "Validation": {
    "Type": "validation",
    "Name": "isWellConnected",
    "ErrorMessage": "#### Issue\n\nThis **Mechanical System** is not fully connected.\n\nThe Revit system property `isWellConnected` has the value:\n\n- Current value: `{ActualValue}`\n\nThis means that not all mechanical components within the system are properly connected via valid connectors.\n\n#### Solution\n\n1. Select the Mechanical System in Revit  \n2. Verify that all connected elements are properly connected via connectors  \n3. Fix any broken or incorrect connections  \n4. Confirm that `isWellConnected = true`\n\n#### Explanation\n\nA Mechanical System that is not well connected can lead to:\n\n- unreliable flow and system analysis results  \n- incorrect system classification  \n- inaccurate quantities and reporting  \n- issues during IFC export and model coordination  \n\nEnsuring that systems are fully connected is a **best practice** for MEP models and improves overall data reliability.\n\nSee also:  \nhttps://help.daqs.io/DAQS/MEPSystems/MechanicalSystem/",
    "Properties": [
      {
        "Name": "valueToValidate",
        "Value": {
          "Type": "querySelector",
          "Properties": [
            {
              "Name": "query",
              "Value": "values.isWellConnected",
              "Type": "bool"
            }
          ]
        }
      },
      {
        "Name": "Validator",
        "Value": {
          "Type": "value",
          "Properties": [
            {
              "Name": "value",
              "Value": "bool:Is",
              "Type": "bool"
            }
          ]
        }
      },
      {
        "Name": "expectedValue",
        "Value": {
          "Type": "staticValueSelector",
          "Properties": [
            {
              "Name": "value",
              "Value": "true",
              "Type": "bool"
            }
          ]
        }
      }
    ],
    "SubValidations": []
  },
  "Details": {
    "Name": "Mechanical System is well connected",
    "Impact": 2,
    "Priority": 2,
    "Tags": [
      "MEP"
    ],
    "Description": "## What does this rule do?\n\nThis rule checks whether **Mechanical Systems** are fully connected.\n\nThe check is performed using the Revit system property **`isWellConnected`**, which indicates whether all elements in the system are properly connected.\n\n---\n\n## What the rule checks\n\nThe rule analyzes **Mechanical Systems** and validates their connectivity.\n\nSpecifically, the rule checks:\n\n- whether the element is a **Mechanical System**  \n- whether the property **`isWellConnected`** is available  \n- whether the value of `isWellConnected` is **true**\n\nThe rule fails when:\n\n- `isWellConnected = false`\n\nThe rule passes when:\n\n- `isWellConnected = true`\n\n---\n\n## Scope of the check\n\nThis rule applies to:\n\n- **Mechanical Systems**\n- system-level elements in Revit\n\n---\n\n## Why this rule exists\n\nWell-connected systems are essential for reliable MEP models.\n\nDisconnected or partially connected systems can result in:\n\n- incorrect system behavior and analysis results  \n- unreliable quantities and calculations  \n- issues in coordination and data exchange  \n\nBy enforcing that systems are fully connected, the model remains **consistent, analyzable, and suitable for downstream use**.",
    "HelpUrl": "https://help.daqs.io/DAQS/MEPSystems/MechanicalSystem/?nav=false",
    "TimeToSolve": 60,
    "AllDisciplines": false,
    "Disciplines": [
      "0B97F964-EDD8-4563-9EED-FBEC183CFFFC",
      "991A466B-4418-41A0-B308-BFBF69B4666F"
    ]
  },
  "Metadata": [
    {
      "Label": "SystemType",
      "Selector": {
        "Type": "querySelector",
        "Properties": [
          {
            "Name": "query",
            "Value": "values.systemType",
            "Type": null
          }
        ]
      }
    }
  ]
}