civil-damage-ontology 0.1.0

Ontology-first civil infrastructure damage vocabulary, rule engine, validation tables, and export tooling.

civil-damage-ontology

civil-damage-ontology is a PyPI-oriented Python package for ontology-side civil infrastructure damage modeling. It manages a controlled vocabulary, compatibility rules, observability rules, validated ontology tables, target projection, and hard-negative metadata.

It does:

• ontology vocabulary management
• compatibility and observability validation
• validation table generation
• valid target projection
• hard-negative metadata management
• CSV / Parquet / pandas export
• CLI workflows for non-programmatic use

It does not:

• retrieve or download images
• search external data pools
• auto-label or segment imagery
• train models
• split datasets for ML workflows

The package boundary is intentional: downstream packages consume exported ontology artifacts.

Install

python -m pip install civil-damage-ontology

For local development:

python -m venv .venv
source .venv/bin/activate
python -m pip install -e .[dev]

Quick Example

import civil_damage_ontology as cdo

repo = cdo.load_repository()
validation = cdo.build_validation_table(repo.vocab, repo.rules)

print(cdo.is_valid("bridge", "deck", "reinforced_concrete", "longitudinal_crack"))
print(cdo.explain_validation("bridge", "girder", "steel", "pothole"))
print(validation.summary())

CLI Example

cdo validate
cdo build-validation-table --output validation.csv
cdo build-valid-targets --output valid_targets.parquet

Architecture Summary

• src/civil_damage_ontology/defaults: packaged default YAML ontology resources
• models: typed pydantic records and repositories
• io: resource loading and export helpers
• validation: repository integrity checks and explanation helpers
• engine: rule evaluation, projection, querying, and hard-negative management
• analytics: summaries, coverage, and graph export
• cli: typer command entry point

Docs

• Installation
• Quickstart
• Ontology Model
• Config Reference
• API Reference
• CLI Reference
• Release Guide

Versioning

The package follows semantic versioning. The initial release line is 0.x while the schema and default ontology continue to mature.