Skip to content

Adiro Provenance 2.1.0

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.

  • IRI: https://w3id.org/adiro/adiro_provenance
  • Versioned IRI: https://w3id.org/adiro/adiro_provenance/2.1.0

Interactive view

Dependencies

Arrows point from an ontology to the ontologies it imports; the current ontology is highlighted.

%%{init: {"themeCSS": ".base .nodeLabel,.base .nodeLabel p,.base text,.base tspan{fill:#9ecbff !important;color:#9ecbff !important}.current .nodeLabel,.current .nodeLabel p,.current text,.current tspan{fill:#16305f !important;color:#16305f !important}"} }%%
graph BT
    adiro_provenance["Adiro Provenance"]
    adiro_geometry["Adiro Geometry"]
    adiro_drawing_metadata["Adiro Drawing Metadata"]
    adiro_common_symbols["Adiro Common Symbols"]
    adiro_domain_common["Adiro Domain Common"]
    adiro_facade_domain["Adiro Facade Domain"]
    adiro_geometry --> adiro_provenance
    adiro_drawing_metadata --> adiro_geometry
    adiro_drawing_metadata --> adiro_provenance
    adiro_common_symbols --> adiro_drawing_metadata
    adiro_domain_common --> adiro_drawing_metadata
    adiro_facade_domain --> adiro_domain_common
    adiro_facade_domain --> adiro_drawing_metadata
    click adiro_provenance "../../adiro_provenance/" "Adiro Provenance reference page"
    click adiro_geometry "../../adiro_geometry/" "Adiro Geometry reference page"
    click adiro_drawing_metadata "../../adiro_drawing_metadata/" "Adiro Drawing Metadata reference page"
    click adiro_common_symbols "../../adiro_common_symbols/" "Adiro Common Symbols reference page"
    click adiro_domain_common "../../adiro_domain_common/" "Adiro Domain Common reference page"
    click adiro_facade_domain "../../adiro_facade_domain/" "Adiro Facade Domain reference page"
    classDef base fill:#16305f,stroke:#0e2247,stroke-width:2px,color:#9ecbff;
    class adiro_geometry,adiro_drawing_metadata,adiro_common_symbols,adiro_domain_common,adiro_facade_domain base;
    classDef current fill:#f58a1f,stroke:#16305f,stroke-width:3px,color:#16305f;
    class adiro_provenance current;

Classes

Acceptance Status

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.

Activity

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.

  • IRI: http://www.w3.org/ns/prov#Activity

Agent

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.

  • IRI: http://www.w3.org/ns/prov#Agent

Assertion Outcome

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.

Document (ISO 21597-1)

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.

  • IRI: https://standards.iso.org/iso/21597/-1/ed-1/en/Container#Document

Drawing File

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 was obtained from, 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), while the source location is where the file came from. A subclass of the ISO 21597-1 Document, which is likewise a reference.

Entity

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.

  • IRI: http://www.w3.org/ns/prov#Entity

Field Assertion

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.

  • IRI: https://w3id.org/adiro/adiro_provenance#FieldAssertion
  • Sub class of: Inferred Entity

File Page

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.

  • IRI: https://w3id.org/adiro/adiro_provenance#FilePage
  • Sub class of: Entity

Inference Meta

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.

  • IRI: https://w3id.org/adiro/adiro_provenance#InferenceMeta
  • Sub class of: Activity

Inferred Entity

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 adiro_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.

  • IRI: https://w3id.org/adiro/adiro_provenance#InferredEntity
  • Sub class of: Entity

Organisation

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.

Organisation (ISO 21597-1)

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.

  • IRI: https://standards.iso.org/iso/21597/-1/ed-1/en/Container#Organisation

Party

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.

Party (ISO 21597-1)

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.

  • IRI: https://standards.iso.org/iso/21597/-1/ed-1/en/Container#Party

Person

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.

Person (ISO 21597-1)

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.

  • IRI: https://standards.iso.org/iso/21597/-1/ed-1/en/Container#Person

Object Properties

acceptedBy

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

assertedAbout

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.

  • IRI: https://w3id.org/adiro/adiro_provenance#assertedAbout
  • Domain: Field Assertion

assertedBy

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.

  • IRI: https://w3id.org/adiro/adiro_provenance#assertedBy
  • Domain: Field Assertion

assertsFieldKind

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.

  • IRI: https://w3id.org/adiro/adiro_provenance#assertsFieldKind
  • Domain: Field Assertion
  • Range: skos:Concept

belongsToFile

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).

fileCreatedBy

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

  • IRI: https://w3id.org/adiro/adiro_provenance#fileCreatedBy
  • Domain: Drawing File
  • Range: Party

fileModifiedBy

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

  • IRI: https://w3id.org/adiro/adiro_provenance#fileModifiedBy
  • Domain: Drawing File
  • Range: Party

hasAcceptance

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.

hasInferenceMeta

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).

hasOutcome

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.

hasValueEntity

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.

  • IRI: https://w3id.org/adiro/adiro_provenance#hasValueEntity
  • Domain: Field Assertion

inferredBy

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.

inferredFrom

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

  • IRI: https://w3id.org/adiro/adiro_provenance#inferredFrom
  • Sub property of: used
  • Domain: Inference Meta

inferredWith

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.

  • IRI: https://w3id.org/adiro/adiro_provenance#inferredWith
  • Sub property of: used
  • Domain: Inference Meta

supersedes

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. It takes effect when this assertion is accepted: until then the earlier one stays in force, and an accepted assertion replaces every one it supersedes, directly or through others. The earlier one stays as a record. Explicit, so a query does not depend on timestamps.

used

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)

  • IRI: http://www.w3.org/ns/prov#used

wasAssociatedWith

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)

  • IRI: http://www.w3.org/ns/prov#wasAssociatedWith

wasDerivedFrom

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:Entity). ADIRO uses it between two DrawingFiles: a file made from another one (a format conversion, a page split out of a PDF) was derived from it, and only the original records a sourceLocation.

  • IRI: http://www.w3.org/ns/prov#wasDerivedFrom

wasGeneratedBy

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)

  • IRI: http://www.w3.org/ns/prov#wasGeneratedBy

Datatype Properties

acceptedAt

When this assertion was accepted or rejected.

  • IRI: https://w3id.org/adiro/adiro_provenance#acceptedAt
  • Domain: Field Assertion
  • Range: xsd:dateTime

acceptedUnder

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.

  • IRI: https://w3id.org/adiro/adiro_provenance#acceptedUnder
  • Domain: Field Assertion
  • Range: xsd:anyURI

capturedCaption

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.

  • IRI: https://w3id.org/adiro/adiro_provenance#capturedCaption
  • Domain: Field Assertion
  • Range: xsd:string

contentHash

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.

  • IRI: https://w3id.org/adiro/adiro_provenance#contentHash
  • Domain: Drawing File
  • Range: xsd:string

displayHeightPt

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).

  • IRI: https://w3id.org/adiro/adiro_provenance#displayHeightPt
  • Domain: File Page
  • Range: xsd:decimal

displayWidthPt

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).

  • IRI: https://w3id.org/adiro/adiro_provenance#displayWidthPt
  • Domain: File Page
  • Range: xsd:decimal

endedAtTime

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.

  • IRI: http://www.w3.org/ns/prov#endedAtTime

fileCreatedAt

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

  • IRI: https://w3id.org/adiro/adiro_provenance#fileCreatedAt
  • Domain: Drawing File
  • Range: xsd:dateTime

fileModifiedAt

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

  • IRI: https://w3id.org/adiro/adiro_provenance#fileModifiedAt
  • Domain: Drawing File
  • Range: xsd:dateTime

fileName

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

  • IRI: https://w3id.org/adiro/adiro_provenance#fileName
  • Domain: Drawing File
  • Range: xsd:string

fileSize

The size of the file in bytes.

  • IRI: https://w3id.org/adiro/adiro_provenance#fileSize
  • Domain: Drawing File
  • Range: xsd:nonNegativeInteger

hasConfidence

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 adiro_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).

  • IRI: https://w3id.org/adiro/adiro_provenance#hasConfidence
  • Domain: Inferred Entity
  • Range: anonymous class

hashAlgorithm

The algorithm that produced the contentHash, for example sha256.

  • IRI: https://w3id.org/adiro/adiro_provenance#hashAlgorithm
  • Domain: Drawing File
  • Range: xsd:string

hasLiteralValue

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

  • IRI: https://w3id.org/adiro/adiro_provenance#hasLiteralValue
  • Domain: Field Assertion
  • Range: rdfs:Literal

inferredAt

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

  • IRI: https://w3id.org/adiro/adiro_provenance#inferredAt
  • Sub property of: endedAtTime
  • Domain: Inference Meta
  • Range: xsd:dateTime

mediaType

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

  • IRI: https://w3id.org/adiro/adiro_provenance#mediaType
  • Domain: Drawing File
  • Range: xsd:string

pageCount

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

  • IRI: https://w3id.org/adiro/adiro_provenance#pageCount
  • Domain: Drawing File
  • Range: xsd:positiveInteger

pageNumber

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.

  • IRI: https://w3id.org/adiro/adiro_provenance#pageNumber
  • Domain: File Page
  • Range: xsd:positiveInteger

pdfRotationDeg

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.

  • IRI: https://w3id.org/adiro/adiro_provenance#pdfRotationDeg
  • Domain: File Page
  • Range: xsd:integer

sourceLocation

Where the file was obtained from: the address its bytes were fetched from, such as a public archive's download address, or the address in an organisation's own storage when that is the only known origin. Unlike storageLocation, it does not change when copies are moved. A file made from another file (converted, split into pages) records its origin through prov:wasDerivedFrom to that file, not a sourceLocation of its own.

  • IRI: https://w3id.org/adiro/adiro_provenance#sourceLocation
  • Domain: Drawing File
  • Range: xsd:anyURI

sourcePage

The page at the file's origin that describes it, such as a catalogue record or a landing page, which is often a more lasting address than the file's own sourceLocation.

  • IRI: https://w3id.org/adiro/adiro_provenance#sourcePage
  • Domain: Drawing File
  • Range: xsd:anyURI

storageLocation

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.

  • IRI: https://w3id.org/adiro/adiro_provenance#storageLocation
  • Domain: Drawing File
  • Range: xsd:anyURI

Annotation Properties

expectedRange

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.

  • IRI: https://w3id.org/adiro/adiro_provenance#expectedRange

mapsToFieldProperty

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.

  • IRI: https://w3id.org/adiro/adiro_provenance#mapsToFieldProperty

Named Individuals

Accepted

Taken in, by a pipeline rule (a confidence threshold, named by acceptedUnder) or by a person. An accepted assertion that has a value is promoted to a direct property.

Empty

The field is printed on the drawing but holds no value (a blank cell). The ground-truth observation status 'empty'.

Illegible

The field is printed on the drawing but cannot be read. The ground-truth observation status 'illegible'.

Not found

A model searched where the field is expected and matched nothing. Not confirmed: the field may be missing from the drawing or merely missed, so it is retried or reviewed; it says nothing yet about the drawing.

Not printed

The drawing does not print the field at all, confirmed by a person (a reviewer or a ground-truth label). The ground-truth observation status 'absent'. For a field every drawing must have, such as the author, this is a defect of the drawing and not of the extraction.

Pending

Not yet accepted or rejected: the assertion is the extraction's record and its value is not yet a direct property.

Rejected

Decided against: the assertion stays as a record but is not promoted.