elemental-ingest 0.2.0

Extract structural RC models from IFC files into the elemental-engine JSON contract.

elemental-ingest

Extract structural reinforced-concrete models from IFC files into the elemental-engine JSON contract.

Status

v0.1.0-mvp — Phase-1 IFC ingest complete. DXF / DWG / PDF support and LLM-assisted classification deferred to Phase-2+.

Install

uv tool install elemental-ingest

Or from source:

git clone https://github.com/trancer1987/elemental-ingest
cd elemental-ingest
uv sync
uv run elemental-ingest --help

Quick start

CLI

elemental-ingest extract --input model.ifc --output project.json --verbose
elemental-ingest validate project.json
elemental-ingest schema | jq '.properties'

Library

from pathlib import Path
from elemental_ingest import IfcExtractor, ExtractionOptions

extractor = IfcExtractor(ExtractionOptions(
    include_rebar=True,
    min_classify_confidence=0.5,
    provenance_log=Path("project.provenance.jsonl"),
))
result = extractor.extract_to_file(
    Path("model.ifc"),
    Path("project.json"),
)
print(f"{result.stats.n_elements} elements, {result.stats.n_bars} bars")
print(f"errors: {result.stats.n_errors}, warnings: {result.stats.n_warnings}")

What it does

Subsystem	What it produces
IFC reader	Opens any IFC file, detects units, exposes spatial structure
Classifier	Tier 1 IFC type -> Tier 2 Pset -> Tier 3 geometric heuristic
Geometry	Parametric ExtrudedProfile primary, mesh fallback
Rebar	Bars + meshes with 3-tier host resolution
Provenance	Issue codes (E001-E301, W001) + JSONL sidecar
API + CLI	IfcExtractor orchestrator + extract/validate/schema commands

Architecture

See docs/architecture.md for the subsystem overview.

Schema regeneration

Schema is mastered in the Rust elemental-engine workspace. To regenerate Pydantic models after a Rust-side change:

ELEMENTAL_ENGINE_PATH=../elemental-engine python scripts/regen_schema.py

CI checks for schema drift on every PR.

Development

uv sync --dev
uv run pytest                          # all tests
uv run pytest -m corpus                # opt-in corpus smoke
uv run ruff check .
uv run ruff format .
uv run mypy src/

License

Apache-2.0. See LICENSE and NOTICE.