Moving from aec_* to adiro_*¶
The six ADIRO modules were called aec_provenance, aec_geometry, aec_drawing_metadata, aec_common_symbols,
aec_domain_common and aec_facade_domain. They are now adiro_provenance, adiro_geometry, adiro_drawing_metadata,
adiro_common_symbols, adiro_domain_common and adiro_facade_domain
(#171): "AEC" is already the A of ADIRO.
What changed¶
Only the names. Each adiro_* module holds the terms, definitions and axioms of the final release of its aec_*
predecessor, under new IRIs:
| What | Before | After |
|---|---|---|
| Ontology | https://w3id.org/adiro/aec_geometry |
https://w3id.org/adiro/adiro_geometry |
| Term | https://w3id.org/adiro/aec_geometry#BoundingBox |
https://w3id.org/adiro/adiro_geometry#BoundingBox |
| Example image | https://w3id.org/adiro/aec_drawing_metadata/exampleImage/Titleblock_01.png |
https://w3id.org/adiro/adiro_drawing_metadata/exampleImage/Titleblock_01.png |
| Release | https://w3id.org/adiro/aec_geometry/2.0.0 |
unchanged: a release keeps its IRI |
The version numbering continues: the first release of each adiro_* module is the final aec_* release plus a MAJOR
(aec_drawing_metadata 6.0.0 is followed by adiro_drawing_metadata 7.0.0).
What stays¶
Every aec_* release stays published at its own IRI, with its documentation page, its Turtle file and its example
images. The final release of each says owl:deprecated true and dcterms:isReplacedBy the new module, and each new
module says dcterms:replaces the old one and names every old release with owl:priorVersion. Data that pins a release
(for example with dcterms:conformsTo <https://w3id.org/adiro/aec_geometry/2.0.0>) keeps resolving.
How to move¶
- The mapping.
migration/aec_to_adiro.ttlstates, for each old ontology and term,<old> dcterms:isReplacedBy <new>. - A graph.
uv run python scripts/migrate_aec_to_adiro.py rewrite data.ttlwritesdata.adiro.ttl, with every old ontology, term and image IRI replaced and the IRIs of releases left as they are. Turtle, N-Triples, RDF/XML, JSON-LD, TriG and N-Quads are read by their extension. - Any other text.
uv run python scripts/migrate_aec_to_adiro.py links export.jsondoes the same in a list of links, a JSON or CSV export or code, and leaves the rest of the text as it is. - Tools that read the labelling annotations (
isComputerVisionLabel,isComputerVisionOptionalLabel,exampleImage) read them in theadiro_drawing_metadatanamespace from now on, and the class IRIs they build labels from are theadiro_*ones.
Data written against an aec_* release older than the final one may use terms that the final release moved or
removed; the changelogs of the old modules list those changes, and the rewrite does not cover them.