AEC Provenance Ontology

Metadata

IRI
https://w3id.org/adiro/aec_provenance
Deprecated
Yes. Replaced by adiro_provenance, which continues its version numbering.
TTL source
https://w3id.org/adiro/aec_provenance.ttl
Documentation
https://w3id.org/adiro/ontologies/aec_provenance/
Title

AEC Provenance Ontology

Publisher

Buro Happold

Creator

Buro Happold - Machine Learning R&D

License
https://www.gnu.org/licenses/gpl-3.0.html
Version Iri
https://w3id.org/adiro/aec_provenance/1.1.0
Version Info

1.1.0

Prior Version
Description
  • Reified assertion + inference provenance + confidence for AEC drawing extraction. Domain-neutral; PROV-O-aligned.

  • Foundational, domain-neutral module for provenance. It lets any value inferred from a drawing be recorded as an assertion that carries its own source, confidence, and how it was produced, aligned to W3C PROV-O. The drawing modules import it.

Classes

Entity c

IRI http://www.w3.org/ns/prov#Entity
Is Defined By W3C Provenance Ontology
Description

Typing stub for the PROV-O term of the same name, declared locally so this module stays self-contained and the reasoning CI resolves offline. A stub is a name, not a definition: the authoritative axioms live at the source that rdfs:isDefinedBy points at. PROV-O declares prov:Entity owl:disjointWith prov:Activity, which is why the alignment below is seated carefully: a FieldAssertion is the Entity produced, an InferenceMeta is the Activity that produced it, and nothing may be both.

Super Class Of

Activity c

IRI http://www.w3.org/ns/prov#Activity
Is Defined By W3C Provenance Ontology
Description

Typing stub for the PROV-O term of the same name, declared locally so this module stays self-contained and the reasoning CI resolves offline. A stub is a name, not a definition: the authoritative axioms live at the source that rdfs:isDefinedBy points at. Disjoint with prov:Entity in PROV-O - see prov:Entity above.

Super Class Of Inference Meta c

Agent c

IRI http://www.w3.org/ns/prov#Agent
Is Defined By W3C Provenance Ontology
Description

Typing stub for the PROV-O term of the same name, declared locally so this module stays self-contained and the reasoning CI resolves offline. A stub is a name, not a definition: the authoritative axioms live at the source that rdfs:isDefinedBy points at.

In Range Of
Super Class Of Party c

Inferred Entity c

IRI https://w3id.org/adiro/aec_provenance#InferredEntity
Description

Anything ADIRO infers or extracts that carries its own provenance and confidence - the shared superclass of everything an inference/extraction step produces as a first-class, provenance-bearing individual. A field-value claim (FieldAssertion, here) is one; a spatial localisation (a BoundingBox, in aec_geometry) is another. It exists so that hasInferenceMeta and hasConfidence apply uniformly to any such product, not only to a field-value claim: a detected box is an inferred entity with its own producer and score, distinct from the confidence in the value read at that box. In PROV-O terms this is the prov:Entity an inference activity generated. The producing step can be a model or a person: a human annotation (a box drawn by hand, a field typed in) is an inference step performed by a person, recorded with inferredBy that person (an aprov:Person) and no inferredWith, and it carries a confidence only if one is given. A model's output and a person's label are told apart by who inferredBy is.

Sub Class Of Entity c
In Domain Of
Super Class Of Field Assertion c

Field Assertion c

IRI https://w3id.org/adiro/aec_provenance#FieldAssertion
Description

A single reified assertion that some source makes a value-claim about a field kind. Reifying the claim (rather than attaching the value straight to a subject) lets each printed occurrence carry its own provenance - which region asserted it (assertedBy), what produced it (hasInferenceMeta), and with what confidence (hasConfidence) - independently of the value it states. The value is a literal (hasLiteralValue) for datatype-valued fields or an entity (hasValueEntity) for object-valued fields. An assertion has a value or, when none was found, an outcome (hasOutcome); it is promoted to a direct statement on its subject only once it is Accepted (hasAcceptance), by tooling and never by reasoning. Conflicting assertions across sources are surfaced, not silently merged, and a later one that replaces an earlier says so with supersedes. A kind of InferredEntity, so it carries the shared provenance/confidence; in PROV-O terms the prov:Entity an extraction produced, which is why the PROV alignment is seated across two classes rather than all on one.

Sub Class Of Inferred Entity c
In Domain Of
In Range Of supersedes op

Inference Meta c

IRI https://w3id.org/adiro/aec_provenance#InferenceMeta
Description

Provenance metadata for an inferred or extracted assertion: what produced it (inferredBy / inferredWith), the source it was derived from (inferredFrom), and when (inferredAt). Modelled as a separate object so several assertions can share one inference record and so provenance can be added without touching the value. Analogous to DANO's DrawingElementMeta, but aligned to PROV-O: this is the prov:Activity that produced the assertion, NOT a prov:Entity. PROV-O declares those two owl:disjointWith, so the distinction is load-bearing rather than stylistic.

Sub Class Of Activity c
In Domain Of
In Range Of hasInferenceMeta op

Document (ISO 21597-1) c

IRI https://standards.iso.org/iso/21597/-1/ed-1/en/Container#Document
Is Defined By https://standards.iso.org/iso/21597/-1/ed-1/en/Container.rdf
Description

Typing stub for the ISO 21597-1 (ICDD) term Document, edition 1: an abstract reference to a document inside or outside a container. A stub is a name, not a definition: the authoritative axioms live at the source that rdfs:isDefinedBy points at.

Super Class Of Drawing File c

Party (ISO 21597-1) c

IRI https://standards.iso.org/iso/21597/-1/ed-1/en/Container#Party
Is Defined By https://standards.iso.org/iso/21597/-1/ed-1/en/Container.rdf
Description

Typing stub for the ISO 21597-1 (ICDD) term Party, edition 1: the generalisation of an organisation and a person. A stub is a name, not a definition: the authoritative axioms live at the source that rdfs:isDefinedBy points at.

Super Class Of Party c

Person (ISO 21597-1) c

IRI https://standards.iso.org/iso/21597/-1/ed-1/en/Container#Person
Is Defined By https://standards.iso.org/iso/21597/-1/ed-1/en/Container.rdf
Description

Typing stub for the ISO 21597-1 (ICDD) term Person, edition 1. A stub is a name, not a definition: the authoritative axioms live at the source that rdfs:isDefinedBy points at.

Super Class Of Person c

Organisation (ISO 21597-1) c

IRI https://standards.iso.org/iso/21597/-1/ed-1/en/Container#Organisation
Is Defined By https://standards.iso.org/iso/21597/-1/ed-1/en/Container.rdf
Description

Typing stub for the ISO 21597-1 (ICDD) term Organisation, edition 1. A stub is a name, not a definition: the authoritative axioms live at the source that rdfs:isDefinedBy points at.

Super Class Of Organisation c

Party c

IRI https://w3id.org/adiro/aec_provenance#Party
Description

A person or an organisation: whoever made, saved or is named on something. Abstract: every party is exactly a Person or an Organisation, never both and never neither (their disjoint union), as in ISO 21597-1. Software that produced a file is not a party; a PROV activity records it.

Sub Class Of
In Range Of
Super Class Of

Person c

IRI https://w3id.org/adiro/aec_provenance#Person
Description

A named individual: a person named on a drawing (the author, a checker, an approver) or who made or saved a file. Transcribed as printed, so possibly only initials. The role is expressed by the property that points to the person, not by subclassing.

Sub Class Of

Organisation c

IRI https://w3id.org/adiro/aec_provenance#Organisation
Description

A legal entity: the client, the originator, a legal owner or a responsible department named on a drawing, or the organisation that made or saved a file. Modelled as a class rather than a string so that one organisation recurring across many drawings is a single individual, which is what makes cross-drawing questions answerable.

Sub Class Of

Drawing File c

IRI https://w3id.org/adiro/aec_provenance#DrawingFile
Description

A reference to a document in which drawings are stored: not the bytes, but what identifies and locates them (name, media type, content hash, where it is stored, when and by whom it was made and last changed, how many pages it has). The content hash is its identity; the storage location is a fact that changes when the file is moved, and more than one is allowed (copies). A subclass of the ISO 21597-1 Document, which is likewise a reference.

Sub Class Of
In Domain Of
In Range Of belongsToFile op

File Page c

IRI https://w3id.org/adiro/aec_provenance#FilePage
Description

One page of one DrawingFile, counted from 1; a single-page or raster file has page 1. It holds what is true of the page itself: its number, the file it belongs to, its rotation and its display size in points. A drawing is linked to the page it is on, and a coordinate frame reads the page in one coordinate convention.

Sub Class Of Entity c
In Domain Of

Assertion Outcome c

IRI https://w3id.org/adiro/aec_provenance#AssertionOutcome
Description

What a search for a field found, when it found no value: Empty, Illegible, NotPrinted or NotFound. An assertion that has a value needs no outcome (the value is its outcome), and an assertion has a value or an outcome, never both.

In Range Of hasOutcome op

Acceptance Status c

IRI https://w3id.org/adiro/aec_provenance#AcceptanceStatus
Description

Whether an assertion was taken into the direct properties of its subject: Pending (not yet decided), Accepted or Rejected. Only an Accepted assertion that has a value is promoted by mapsToFieldProperty.

In Range Of hasAcceptance op

Object Properties

wasGeneratedBy op

IRI http://www.w3.org/ns/prov#wasGeneratedBy
Is Defined By W3C Provenance Ontology
Description

Typing stub for the PROV-O term of the same name, declared locally so this module stays self-contained and the reasoning CI resolves offline. A stub is a name, not a definition: the authoritative axioms live at the source that rdfs:isDefinedBy points at. (rdfs:domain prov:Entity, rdfs:range prov:Activity)

Super Property Of hasInferenceMeta op

wasAssociatedWith op

IRI http://www.w3.org/ns/prov#wasAssociatedWith
Is Defined By W3C Provenance Ontology
Description

Typing stub for the PROV-O term of the same name, declared locally so this module stays self-contained and the reasoning CI resolves offline. A stub is a name, not a definition: the authoritative axioms live at the source that rdfs:isDefinedBy points at. (rdfs:domain prov:Activity, rdfs:range prov:Agent)

Super Property Of inferredBy op

used op

IRI http://www.w3.org/ns/prov#used
Is Defined By W3C Provenance Ontology
Description

Typing stub for the PROV-O term of the same name, declared locally so this module stays self-contained and the reasoning CI resolves offline. A stub is a name, not a definition: the authoritative axioms live at the source that rdfs:isDefinedBy points at. (rdfs:domain prov:Activity, rdfs:range prov:Entity)

Super Property Of

assertsFieldKind op

IRI https://w3id.org/adiro/aec_provenance#assertsFieldKind
Description

The field kind (a SKOS concept in a field-kind scheme, e.g. a title-block field such as Scale or Client) that this assertion is about. Keeping the kind as a referenced concept - rather than a bespoke property per field - is what lets names/synonyms live on the concept and keeps the number of relationships small.

Domain Field Assertion c
Range Concept c

assertedBy op

IRI https://w3id.org/adiro/aec_provenance#assertedBy
Description

The source that makes this assertion - typically the drawing region it was read from (e.g. a Titleblock or a Layout). This is the provenance that lets the same field kind asserted by different regions be distinguished (e.g. a sheet's scale read from the title block versus the same sheet's scale read from a general note), which a fixed domain on a per-field property cannot express.

Domain Field Assertion c

assertedAbout op

IRI https://w3id.org/adiro/aec_provenance#assertedAbout
Description

The subject the claim is ABOUT - the thing a validated assertion is promoted onto. Distinct from assertedBy, which records where the claim was read FROM: a drawn-by name is read from a title-block region (assertedBy) but is a claim about a particular DrawingRevision (assertedAbout), and a sheet has many revisions, so the subject cannot be recovered from the region alone. Without it, mapsToFieldProperty names a property but nothing names the individual to hang it on, and promotion is not expressible. No rdfs:range is asserted: the subjects differ per field kind - Titleblock, DrawingSheet, DrawingRevision, DrawingPackage, Project - and a narrower range would entail those subjects are of a type they are not.

Domain Field Assertion c

hasValueEntity op

IRI https://w3id.org/adiro/aec_provenance#hasValueEntity
Description

For object-valued field kinds, the entity that is the asserted value - e.g. a Person or Organisation. Used instead of hasLiteralValue when the field references a thing rather than states a string, which is what makes cross-sheet questions ('everything checked by X') answerable.

Domain Field Assertion c

hasInferenceMeta op

IRI https://w3id.org/adiro/aec_provenance#hasInferenceMeta
Description

Links an inferred entity (a FieldAssertion, a BoundingBox, ...) to the InferenceMeta describing what produced it, from where, and when. Aligned to prov:wasGeneratedBy: the entity (a prov:Entity) was generated by the inference (a prov:Activity).

Sub Property Of was generated by op
Domain Inferred Entity c
Range Inference Meta c

inferredBy op

IRI https://w3id.org/adiro/aec_provenance#inferredBy
Description

The actor, organisation or software that produced this inference: a person (an aprov:Person) when a human annotated, a software agent when a model predicted. Aligned to prov:wasAssociatedWith - the agent the inference activity was associated with.

Sub Property Of was associated with op
Domain Inference Meta c
Range Agent c

inferredWith op

IRI https://w3id.org/adiro/aec_provenance#inferredWith
Description

The algorithm or model (ideally with version) used to produce this inference. Distinct from inferredBy, which names the responsible actor; inferredWith names the tool. Aligned to prov:used - the activity used this model.

Sub Property Of used op
Domain Inference Meta c

inferredFrom op

IRI https://w3id.org/adiro/aec_provenance#inferredFrom
Description

The source the value was derived from - e.g. the origin file, page or region. Aligned to prov:used - the activity used this source.

Sub Property Of used op
Domain Inference Meta c

fileCreatedBy op

IRI https://w3id.org/adiro/aec_provenance#fileCreatedBy
Description

The party that made the file in the storage system, usually whoever saved it. Not the drawing's author, which is isAuthoredBy in aec_drawing_metadata; a close match to, not the same as, Dublin Core creator and ICDD createdBy.

Domain Drawing File c
Range Party c

fileModifiedBy op

IRI https://w3id.org/adiro/aec_provenance#fileModifiedBy
Description

A party that modified the file in the storage system. More than one is allowed.

Domain Drawing File c
Range Party c

belongsToFile op

IRI https://w3id.org/adiro/aec_provenance#belongsToFile
Description

The DrawingFile that a FilePage is a page of. To go from a file to its pages, use the inverse path ^aprov:belongsToFile (ADIRO declares no named inverse properties).

Domain File Page c
Range Drawing File c

hasOutcome op

IRI https://w3id.org/adiro/aec_provenance#hasOutcome
Description

What the search for this field found, when it found no value (an AssertionOutcome). An assertion with a hasLiteralValue or a hasValueEntity has no outcome.

Domain Field Assertion c
Range Assertion Outcome c

hasAcceptance op

IRI https://w3id.org/adiro/aec_provenance#hasAcceptance
Description

Whether this assertion was taken into the direct properties of its subject (an AcceptanceStatus). An assertion with no acceptance recorded is as good as Pending.

Domain Field Assertion c
Range Acceptance Status c

acceptedBy op

IRI https://w3id.org/adiro/aec_provenance#acceptedBy
Description

The agent that accepted or rejected this assertion: a person for a review, or a software agent for a pipeline rule.

Domain Field Assertion c
Range Agent c

supersedes op

IRI https://w3id.org/adiro/aec_provenance#supersedes
Description

The earlier assertion that this one replaces about the same field of the same subject: a person's correction of a model's value, or a later value after a not-found. The earlier one stays as a record. Explicit, so a query does not depend on timestamps.

Domain Field Assertion c
Range Field Assertion c

Datatype Properties

endedAtTime dp

IRI http://www.w3.org/ns/prov#endedAtTime
Is Defined By W3C Provenance Ontology
Description

Typing stub for the PROV-O term of the same name, declared locally so this module stays self-contained and the reasoning CI resolves offline. A stub is a name, not a definition: the authoritative axioms live at the source that rdfs:isDefinedBy points at. (rdfs:domain prov:Activity, rdfs:range xsd:dateTime). ADIRO's own :inferredAt declares rdfs:range xsd:dateTime, so the precision is asserted where it belongs - on the term this suite owns.

Super Property Of inferredAt dp

hasLiteralValue dp

IRI https://w3id.org/adiro/aec_provenance#hasLiteralValue
Description

For datatype-valued field kinds, the literal value asserted, kept verbatim (not normalised, expanded or translated at extraction time).

Domain Field Assertion c
Range Literal

capturedCaption dp

IRI https://w3id.org/adiro/aec_provenance#capturedCaption
Description

The caption/label text exactly as printed on the drawing for this assertion (e.g. 'Verfasser', 'Dwg. Desc.'). Retained even when the field kind is uncertain, so the ground truth of what was on the sheet is never lost and mapping can be revisited later.

Domain Field Assertion c
Range xsd:string

hasConfidence dp

IRI https://w3id.org/adiro/aec_provenance#hasConfidence
Description

Confidence of the inference behind an inferred entity, as a decimal in [0,1]: the score a model gives, or, for a human annotation, absent (or 1 when the annotator is taken as certain). Applies to any InferredEntity - the confidence in a field-value claim (FieldAssertion) and the confidence in a detected localisation (a BoundingBox in aec_geometry) are separate values, each carried on the individual it belongs to. Carried on the individual rather than on a triple, which keeps confidence in the graph without requiring RDF-star or statement reification. The range is an OWL 2 datatype restriction on xsd:decimal with minInclusive 0 and maxInclusive 1, so the [0,1] bound is asserted rather than only described in prose. Note this cannot fire in CI today: the reasoning gate runs over the T-Box in src/ and the repository holds no instance data, so the bound becomes enforceable when an A-Box exists (GitHub issue #22).

Domain Inferred Entity c
Range

inferredAt dp

IRI https://w3id.org/adiro/aec_provenance#inferredAt
Description

The time the inference was produced. Aligned to prov:endedAtTime - when the inference activity ended.

Sub Property Of ended at time dp
Domain Inference Meta c
Range xsd:dateTime

fileName dp

IRI https://w3id.org/adiro/aec_provenance#fileName
Description

The name of the file, with its extension, as the storage system gives it.

Domain Drawing File c
Range xsd:string

mediaType dp

IRI https://w3id.org/adiro/aec_provenance#mediaType
Description

The IANA media type of the file, for example application/pdf or image/tiff.

Domain Drawing File c
Range xsd:string

contentHash dp

IRI https://w3id.org/adiro/aec_provenance#contentHash
Description

The hash of the bytes of the file, as a hexadecimal string. It identifies the content: two files with the same hash and algorithm are the same bytes, wherever they are stored, and a hash that no longer matches means an extraction was made from other bytes.

Domain Drawing File c
Range xsd:string

hashAlgorithm dp

IRI https://w3id.org/adiro/aec_provenance#hashAlgorithm
Description

The algorithm that produced the contentHash, for example sha256.

Domain Drawing File c
Range xsd:string

storageLocation dp

IRI https://w3id.org/adiro/aec_provenance#storageLocation
Description

Where a copy of the file is stored: an address in a document-management or cloud storage system, or a path as a file address. More than one is allowed, and a location changes when the file is moved; the contentHash is what stays the same.

Domain Drawing File c
Range xsd:anyURI

fileCreatedAt dp

IRI https://w3id.org/adiro/aec_provenance#fileCreatedAt
Description

When the file was created, as the storage system records it. Not the drawing's issue date (issueDate).

Domain Drawing File c
Range xsd:dateTime

fileModifiedAt dp

IRI https://w3id.org/adiro/aec_provenance#fileModifiedAt
Description

When the file was last modified, as the storage system records it.

Domain Drawing File c
Range xsd:dateTime

pageCount dp

IRI https://w3id.org/adiro/aec_provenance#pageCount
Description

The number of pages of the file: 1 for a single-page or raster file.

Domain Drawing File c
Range xsd:positiveInteger

fileSize dp

IRI https://w3id.org/adiro/aec_provenance#fileSize
Description

The size of the file in bytes.

Domain Drawing File c
Range xsd:nonNegativeInteger

pageNumber dp

IRI https://w3id.org/adiro/aec_provenance#pageNumber
Description

The number of the page within its file, counted from 1; a single-page or raster file has page 1. A page can be written as an address with the page fragment of RFC 3778 (the file's address followed by #page=3), which counts from 1 as well. A zero-based index, where a program needs one, is this number minus one.

Domain File Page c
Range xsd:positiveInteger

displayWidthPt dp

IRI https://w3id.org/adiro/aec_provenance#displayWidthPt
Description

The effective width of the page in points after the recorded page mapping (rotation and cropping); supports bounds checks on coordinates. The measured size of this page of this file, not the paper format the drawing is meant for (sheetSize).

Domain File Page c
Range xsd:decimal

displayHeightPt dp

IRI https://w3id.org/adiro/aec_provenance#displayHeightPt
Description

The effective height of the page in points after the recorded page mapping (rotation and cropping); supports bounds checks on coordinates. The measured size of this page of this file, not the paper format the drawing is meant for (sheetSize).

Domain File Page c
Range xsd:decimal

pdfRotationDeg dp

IRI https://w3id.org/adiro/aec_provenance#pdfRotationDeg
Description

The rotation recorded for the page, in degrees. The page_display_pt coordinates of a coordinate frame already include the recorded page mapping, so this is for interpretation and validation: do not apply the rotation to the coordinates again.

Domain File Page c
Range xsd:integer

acceptedAt dp

IRI https://w3id.org/adiro/aec_provenance#acceptedAt
Description

When this assertion was accepted or rejected.

Domain Field Assertion c
Range xsd:dateTime

acceptedUnder dp

IRI https://w3id.org/adiro/aec_provenance#acceptedUnder
Description

An IRI naming the versioned policy under which this assertion was accepted: a confidence-threshold rule of the pipeline, or the annotation protocol and mapping version of a ground-truth campaign. The threshold itself lives in the policy, not on each assertion, so a policy can be re-evaluated later.

Domain Field Assertion c
Range xsd:anyURI
,

Annotation Properties

expectedRange ap

IRI https://w3id.org/adiro/aec_provenance#expectedRange
Description

On a field-kind concept: the expected type of its asserted value - a datatype (e.g. xsd:string, xsd:date) for literal-valued fields, or a class (e.g. Person, Organisation) for object-valued fields. Signals whether an assertion of this kind uses hasLiteralValue or hasValueEntity.

mapsToFieldProperty ap

IRI https://w3id.org/adiro/aec_provenance#mapsToFieldProperty
Description

On a field-kind concept: the canonical ADIRO property that an accepted assertion (hasAcceptance Accepted) of this field kind, one that has a value, is promoted to (the bridge from the reified assertion to a direct statement on the subject). The subject is the assertion's assertedAbout, so a promotion is: ?a assertedAbout ?subject ; assertsFieldKind ?k . ?k mapsToFieldProperty ?p => ?subject ?p . Annotation only - the promotion is performed by tooling on acceptance, not by reasoning.

Namespaces

:
https://w3id.org/adiro/aec_provenance#
ct
https://standards.iso.org/iso/21597/-1/ed-1/en/Container#
dcat
http://www.w3.org/ns/dcat#
dcterms
http://purl.org/dc/terms/
ns1
https://w3id.org/adiro/
owl
http://www.w3.org/2002/07/owl#
prov
http://www.w3.org/ns/prov#
rdf
http://www.w3.org/1999/02/22-rdf-syntax-ns#
rdfs
http://www.w3.org/2000/01/rdf-schema#
skos
http://www.w3.org/2004/02/skos/core#
xsd
http://www.w3.org/2001/XMLSchema#

Legend

c Classes
op Object Properties
dp Datatype Properties
ap Annotation Properties

made by p y LODE 3.2.3 with the OntPub profile

Table of Contents