Files
cad-building-showcase/scripts/cad_dxf_report.py
zhengwr a6ac166049 Initial commit: cad-building-showcase skill
Agent-led CAD-drawing → 3D web showcase pipeline. Inspects CAD reports,
maps layers/floors, extracts a normalized building spec (with block-probed
glazing and audit gates), builds Blender/trimesh GLB variants, and assembles
a Three.js web viewer. Includes XREF-shell detection and a regression test.

Large inputs/outputs (work/, outputs/, source_cad/, renders) are gitignored.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-12 16:16:04 +08:00

360 lines
13 KiB
Python
Executable File

#!/usr/bin/env python3
"""Batch convert/read CAD drawings and generate a DXF inventory report."""
from __future__ import annotations
import argparse
import json
import shutil
import subprocess
import sys
from collections import Counter
from pathlib import Path
CAD_SUFFIXES = {".dwg", ".dxf"}
def parse_args() -> argparse.Namespace:
parser = argparse.ArgumentParser(description=__doc__)
parser.add_argument("--input", required=True, help="Folder containing DWG/DXF files")
parser.add_argument("--work", default="work/cad_showcase", help="Intermediate work folder")
parser.add_argument("--output", default="outputs/cad_read_report", help="Output path stem or folder")
parser.add_argument("--vendor-dir", default="work/vendor", help="Optional Python vendor dir containing ezdxf")
parser.add_argument("--no-convert", action="store_true", help="Skip DWG conversion and only read existing DXF files")
return parser.parse_args()
def import_ezdxf(vendor_dir: Path):
if vendor_dir.exists():
sys.path.insert(0, str(vendor_dir.resolve()))
try:
import ezdxf # type: ignore
from ezdxf import bbox, recover # type: ignore
except ImportError as exc:
raise SystemExit(
"Missing dependency: ezdxf. Install locally with:\n"
f" python3 -m pip install --target {vendor_dir} ezdxf"
) from exc
return ezdxf, bbox, recover
def safe_name(path: Path, used: set[str]) -> str:
stem = path.stem
candidate = f"{stem}.dxf"
index = 2
while candidate in used:
candidate = f"{stem}-{index}.dxf"
index += 1
used.add(candidate)
return candidate
def find_cad_files(input_dir: Path) -> list[Path]:
return sorted(
path for path in input_dir.rglob("*")
if path.is_file() and path.suffix.lower() in CAD_SUFFIXES
)
def run_dwg2dxf(source: Path, dest: Path) -> dict:
exe = shutil.which("dwg2dxf")
if not exe:
return {
"source": str(source),
"dest": str(dest),
"status": "missing_dwg2dxf",
"message": "Install LibreDWG or use ODA/QCAD/FreeCAD to convert DWG to DXF.",
}
dest.parent.mkdir(parents=True, exist_ok=True)
cmd = [exe, "-y", "-o", str(dest), str(source)]
proc = subprocess.run(cmd, text=True, capture_output=True)
return {
"source": str(source),
"dest": str(dest),
"status": "ok" if proc.returncode == 0 and dest.exists() else "failed",
"returncode": proc.returncode,
"stdout": proc.stdout[-2000:],
"stderr": proc.stderr[-2000:],
}
def sanitize_dxf_comments(source: Path, dest: Path) -> int:
"""Remove DXF group code 999 comment pairs that can break brittle importers."""
lines = source.read_text(errors="ignore").splitlines(keepends=True)
dest.parent.mkdir(parents=True, exist_ok=True)
cleaned: list[str] = []
removed = 0
index = 0
while index < len(lines):
if lines[index].strip() == "999":
removed += 1
index += 2
continue
cleaned.append(lines[index])
index += 1
dest.write_text("".join(cleaned), encoding="utf-8", errors="ignore")
return removed
def bbox_tuple(box) -> dict | None:
if not box or not box.has_data:
return None
extmin = box.extmin
extmax = box.extmax
return {
"min": [round(extmin.x, 3), round(extmin.y, 3), round(extmin.z, 3)],
"max": [round(extmax.x, 3), round(extmax.y, 3), round(extmax.z, 3)],
"size": [
round(extmax.x - extmin.x, 3),
round(extmax.y - extmin.y, 3),
round(extmax.z - extmin.z, 3),
],
}
def guess_unit_scale(bbox_data: dict | None, insunits: int) -> dict:
if insunits == 6:
return {"source_units": "meters", "scale_to_meters": 1.0, "confidence": "header"}
if insunits == 4:
return {"source_units": "millimeters", "scale_to_meters": 0.001, "confidence": "header"}
if not bbox_data:
return {"source_units": "unknown", "scale_to_meters": 1.0, "confidence": "none"}
sx, sy, _ = bbox_data.get("size", [0, 0, 0])
largest = max(abs(sx), abs(sy))
if largest > 1000:
return {"source_units": "millimeters", "scale_to_meters": 0.001, "confidence": "bbox_heuristic"}
return {"source_units": "meters_or_unknown", "scale_to_meters": 1.0, "confidence": "bbox_heuristic"}
def read_doc(path: Path, ezdxf, recover):
try:
return ezdxf.readfile(path), []
except ezdxf.DXFError:
doc, auditor = recover.readfile(path)
return doc, [str(error) for error in auditor.errors]
# A floor-plan sheet whose real geometry lives in unbound XREFs exports as a
# near-empty shell (a few dozen annotation entities). Modeling it silently
# produces a missing floor, so it must be flagged before extraction.
NEAR_EMPTY_ENTITY_THRESHOLD = 60
BLK_XREF_FLAGS = 4 | 8 # BLK_XREF | BLK_XREF_OVERLAY
def xref_definitions(doc) -> list[dict]:
xrefs = []
for block in doc.blocks:
try:
head = block.block
flags = int(head.dxf.get("flags", 0))
is_xref = bool(flags & BLK_XREF_FLAGS) or bool(getattr(block.block_record, "is_xref", False))
if is_xref:
xrefs.append(
{
"name": str(block.name),
"path": str(head.dxf.get("xref_path", "") or ""),
"overlay": bool(flags & 8),
}
)
except Exception:
continue
return xrefs
def file_warnings(item: dict) -> list[str]:
warnings = []
entities = item.get("modelspace_entities")
xrefs = item.get("xref_definitions", [])
if entities is None:
return warnings
if xrefs and entities < NEAR_EMPTY_ENTITY_THRESHOLD:
names = ", ".join(x["name"] for x in xrefs[:4])
warnings.append(
f"likely_xref_shell: only {entities} entities but {len(xrefs)} XREF definition(s) ({names}). "
"Real geometry lives in the external reference. Bind/insert the XREFs in CAD and re-export this DXF "
"before modeling, otherwise this sheet contributes an empty floor."
)
elif entities < NEAR_EMPTY_ENTITY_THRESHOLD:
warnings.append(
f"near_empty: only {entities} entities (annotation shell?). "
"Confirm with the user whether this sheet should contain geometry; if it is a plan, "
"the source export is incomplete (unbound XREF or wrong layout)."
)
elif xrefs:
names = ", ".join(x["name"] for x in xrefs[:4])
warnings.append(
f"has_xref_definitions: {len(xrefs)} XREF definition(s) ({names}). "
"Entities inside unbound XREFs are NOT in modelspace; verify nothing essential is referenced externally."
)
return warnings
def inspect_file(path: Path, ezdxf, bbox, recover) -> dict:
messages: list[str] = []
try:
doc, recover_messages = read_doc(path, ezdxf, recover)
messages.extend(recover_messages)
msp = doc.modelspace()
entities = list(msp)
type_counts = Counter(entity.dxftype() for entity in entities)
layer_counts = Counter(
str(entity.dxf.layer)
for entity in entities
if entity.dxf.hasattr("layer")
)
try:
geometry_bbox = bbox_tuple(bbox.extents(entities, fast=True))
except Exception as exc: # bbox can fail on unsupported proxy geometry.
geometry_bbox = None
messages.append(f"bbox failed: {exc}")
layers = []
for layer in doc.layers:
name = layer.dxf.name
layers.append(
{
"name": name,
"color": int(layer.dxf.color),
"is_off": bool(layer.is_off()),
"is_frozen": bool(layer.is_frozen()),
"entity_count": layer_counts.get(name, 0),
}
)
header = doc.header
insunits = int(header.get("$INSUNITS", 0) or 0)
result = {
"file": path.name,
"path": str(path),
"status": "ok",
"acadver": str(header.get("$ACADVER", "")),
"insunits": insunits,
"measurement": int(header.get("$MEASUREMENT", 0) or 0),
"unit_guess": guess_unit_scale(geometry_bbox, insunits),
"modelspace_entities": len(entities),
"entity_types": dict(type_counts.most_common()),
"top_layers": [
{"name": name, "entity_count": count}
for name, count in layer_counts.most_common(30)
],
"layer_count": len(layers),
"layers": sorted(layers, key=lambda item: (-item["entity_count"], item["name"])),
"bbox": geometry_bbox,
"messages": messages,
"xref_definitions": xref_definitions(doc),
}
result["warnings"] = file_warnings(result)
return result
except Exception as exc:
return {"file": path.name, "path": str(path), "status": "failed", "messages": [str(exc)]}
def markdown_report(results: list[dict], conversions: list[dict], input_dir: Path) -> str:
lines = [
"# CAD Read Report",
"",
f"Input: `{input_dir}`",
"",
]
all_warnings = [(item["file"], warning) for item in results for warning in item.get("warnings", [])]
if all_warnings:
lines.extend(["## Warnings (resolve before modeling)", ""])
for file_name, warning in all_warnings:
lines.append(f"- `{file_name}`: {warning}")
lines.append("")
lines.extend([
"## Files",
"",
"| File | Status | Entities | Layers | Size X | Size Y | Unit Guess | Main Types |",
"| --- | --- | ---: | ---: | ---: | ---: | --- | --- |",
])
for item in results:
bbox_data = item.get("bbox") or {}
size = bbox_data.get("size", ["", "", ""])
unit = item.get("unit_guess", {})
unit_text = f"{unit.get('source_units', '')} x{unit.get('scale_to_meters', '')}"
types = ", ".join(f"{k}:{v}" for k, v in list(item.get("entity_types", {}).items())[:5])
lines.append(
f"| {item['file']} | {item.get('status', '')} | {item.get('modelspace_entities', '')} | "
f"{item.get('layer_count', '')} | {size[0]} | {size[1]} | {unit_text} | {types} |"
)
if conversions:
lines.extend(["", "## DWG Conversion", ""])
for conv in conversions:
lines.append(f"- `{Path(conv['source']).name}` -> `{Path(conv['dest']).name}`: {conv['status']}")
lines.extend(["", "## Top Layers", ""])
for item in results:
lines.append(f"### {item['file']}")
for layer in item.get("top_layers", [])[:12]:
lines.append(f"- `{layer['name']}`: {layer['entity_count']}")
for message in item.get("messages", [])[:8]:
lines.append(f"- message: `{message}`")
lines.append("")
return "\n".join(lines)
def output_paths(output: Path) -> tuple[Path, Path]:
if output.suffix:
return output.with_suffix(".json"), output.with_suffix(".md")
output.mkdir(parents=True, exist_ok=True)
return output / "cad_read_report.json", output / "cad_read_report.md"
def main() -> int:
args = parse_args()
input_dir = Path(args.input)
work_dir = Path(args.work)
raw_dir = work_dir / "dxf_raw"
clean_dir = work_dir / "dxf_sanitized"
vendor_dir = Path(args.vendor_dir)
ezdxf, bbox, recover = import_ezdxf(vendor_dir)
if not input_dir.exists():
raise SystemExit(f"Input folder not found: {input_dir}")
raw_dir.mkdir(parents=True, exist_ok=True)
clean_dir.mkdir(parents=True, exist_ok=True)
used_names: set[str] = set()
conversions: list[dict] = []
raw_dxfs: list[Path] = []
for source in find_cad_files(input_dir):
dest = raw_dir / safe_name(source, used_names)
if source.suffix.lower() == ".dwg":
if args.no_convert:
continue
conversion = run_dwg2dxf(source, dest)
conversions.append(conversion)
if conversion["status"] == "ok":
raw_dxfs.append(dest)
else:
shutil.copy2(source, dest)
raw_dxfs.append(dest)
sanitized: list[Path] = []
for raw in raw_dxfs:
dest = clean_dir / raw.name
removed = sanitize_dxf_comments(raw, dest)
sanitized.append(dest)
if removed:
conversions.append({"source": str(raw), "dest": str(dest), "status": f"sanitized_{removed}_comments"})
results = [inspect_file(path, ezdxf, bbox, recover) for path in sorted(sanitized)]
json_path, md_path = output_paths(Path(args.output))
json_path.parent.mkdir(parents=True, exist_ok=True)
md_path.parent.mkdir(parents=True, exist_ok=True)
payload = {
"input": str(input_dir),
"work": str(work_dir),
"dxf_sanitized": str(clean_dir),
"conversions": conversions,
"files": results,
}
json_path.write_text(json.dumps(payload, ensure_ascii=False, indent=2), encoding="utf-8")
md_path.write_text(markdown_report(results, conversions, input_dir), encoding="utf-8")
print(json.dumps({"json": str(json_path), "markdown": str(md_path), "files": len(results)}, ensure_ascii=False))
return 0
if __name__ == "__main__":
raise SystemExit(main())