linked-model-check

Linked Model Health Check

Audit linked files and coordination status for:

"$ARGUMENTS"

Approach

Default to a comprehensive read-only report covering:

• All RVT links (loaded, unloaded, missing, not found)
• All CAD imports/links (DWG, DXF, DGN)
• Coordinate system status (shared coordinates, survey point)
• Linked model bounding boxes (detect obvious coordinate outliers)

Script: Comprehensive linked file report (read-only)

import clr
clr.AddReference('RevitServices')
from RevitServices.Persistence import DocumentManager
clr.AddReference('RevitAPI')
from Autodesk.Revit.DB import *

import csv, os

doc  = DocumentManager.Instance.CurrentDBDocument
MM_TO_FT = 1.0 / 304.8

def ft_to_mm(ft_val):
    return round(ft_val * 304.8, 1)

try:
    report = {}

    # ── 1. RVT Links ──────────────────────────────────────────────────────────
    rvt_link_types = list(FilteredElementCollector(doc)
                          .OfClass(RevitLinkType).ToElements())
    rvt_link_instances = list(FilteredElementCollector(doc)
                              .OfClass(RevitLinkInstance).ToElements())

    rvt_report = []
    for lt in rvt_link_types:
        load_state = lt.GetLinkedFileStatus()
        path_info  = lt.GetExternalFileReference()
        path_str   = ""
        try:
            path_str = ModelPathUtils.ConvertModelPathToUserVisiblePath(
                path_info.GetAbsolutePath())
        except Exception:
            path_str = "Path unavailable"

        # Find matching instances
        instances = [li for li in rvt_link_instances
                     if li.GetTypeId() == lt.Id]

        for inst in instances:
            xform = inst.GetTransform()
            origin = xform.Origin
            link_doc = inst.GetLinkDocument()

            entry = {
                "Name":           lt.Name,
                "Status":         str(load_state),
                "Path":           path_str,
                "Instance Count": len(instances),
                "Origin X (mm)":  ft_to_mm(origin.X),
                "Origin Y (mm)":  ft_to_mm(origin.Y),
                "Origin Z (mm)":  ft_to_mm(origin.Z),
                "Is Identity":    xform.IsIdentity,
                "Linked Doc":     link_doc.Title if link_doc else "NOT LOADED",
            }

            # Coordinate warning
            if abs(origin.X) > 328 or abs(origin.Y) > 328:  # > 100m offset
                entry["WARNING"] = "Link origin > 100m from project origin — check shared coordinates"
            else:
                entry["WARNING"] = ""

            rvt_report.append(entry)

    # If no instances (type exists but not placed)
    for lt in rvt_link_types:
        instances = [li for li in rvt_link_instances if li.GetTypeId() == lt.Id]
        if not instances:
            rvt_report.append({
                "Name":     lt.Name,
                "Status":   str(lt.GetLinkedFileStatus()),
                "Path":     "Type exists but not placed as instance",
                "WARNING":  "No instance placed in model"
            })

    report["RVT Links"] = rvt_report

    # ── 2. CAD Links & Imports ────────────────────────────────────────────────
    cad_items = list(FilteredElementCollector(doc)
                     .OfClass(ImportInstance).ToElements())
    cad_report = []
    for ci in cad_items:
        try:
            cat_name = ci.Category.Name if ci.Category else "Unknown"
            is_linked = ci.IsLinked
            xform     = ci.GetTransform()
            origin    = xform.Origin

            entry = {
                "Category":      cat_name,
                "Is Linked":     is_linked,
                "Origin X (mm)": ft_to_mm(origin.X),
                "Origin Y (mm)": ft_to_mm(origin.Y),
                "Origin Z (mm)": ft_to_mm(origin.Z),
            }
            try:
                ext_ref = ci.GetExternalFileReference()
                entry["Path"] = ModelPathUtils.ConvertModelPathToUserVisiblePath(
                    ext_ref.GetAbsolutePath())
            except Exception:
                entry["Path"] = "Embedded / no path"

            cad_report.append(entry)
        except Exception:
            pass

    report["CAD Links/Imports"] = cad_report

    # ── 3. Coordinate summary ─────────────────────────────────────────────────
    # Project Base Point and Survey Point
    base_pts   = list(FilteredElementCollector(doc)
                      .OfClass(BasePoint)
                      .ToElements())
    coord_info = []
    for bp in base_pts:
        try:
            is_survey = bp.IsShared
            pos       = bp.Position
            coord_info.append({
                "Type":       "Survey Point" if is_survey else "Project Base Point",
                "X (mm)":     ft_to_mm(pos.X),
                "Y (mm)":     ft_to_mm(pos.Y),
                "Z (mm)":     ft_to_mm(pos.Z),
            })
        except Exception:
            pass

    report["Coordinate Points"] = coord_info

    # ── 4. Summary ───────────────────────────────────────────────────────────
    loaded   = sum(1 for r in rvt_report
                   if "LinkedFileStatus_Loaded" in str(r.get("Status", "")))
    unloaded = sum(1 for r in rvt_report
                   if "LinkedFileStatus_Loaded" not in str(r.get("Status", ""))
                   and r.get("Status"))
    warnings = sum(1 for r in rvt_report if r.get("WARNING"))

    report["Summary"] = {
        "Total RVT Links":   len(rvt_link_types),
        "Instances placed":  len(rvt_link_instances),
        "Loaded":            loaded,
        "Unloaded/Missing":  unloaded,
        "Coordinate Warnings": warnings,
        "CAD Items":         len(cad_items),
    }

    OUT = report

except Exception as e:
    import traceback
    OUT = "ERROR: " + str(e) + "\n" + traceback.format_exc()