Repository navigation
Releases
ADIRO suite snapshot, 2026-11-17
First archive of the ADIRO repository on Zenodo, which gives the suite its DOI (#275). It is not a module release: each module keeps its own version, tag <module>-v<semver> and changelog.
checks 1.0.0
The data-validation shapes and the UC-01 competency queries, version 1.0.0.
Added
-
The first release of the checks (#240). Every shape file of
data-validation/, the public-release shapes included, and every recorded UC-01 competency query (CQ 1.3 to CQ 11.4, and the promotion; the integration example CQ-I 1 needs a reasoner and is not one), each in its own.rqfile, with amanifest.jsonnaming the module versions they were tested with. -
Manifest (every file, and the module versions the checks were tested with): https://w3id.org/adiro/checks/1.0.0/manifest.json
-
Shapes: https://w3id.org/adiro/checks/1.0.0/shapes/ (the release shapes under https://w3id.org/adiro/checks/1.0.0/shapes/release/)
adiro_provenance 2.2.0
MINOR release · 2.1.0 → 2.2.0 · Compare
- Documentation: https://burohappoldmachinelearning.github.io/ADIRO/ontologies/adiro_provenance/
- Ontology (latest): https://w3id.org/adiro/adiro_provenance
- This version (2.2.0): https://w3id.org/adiro/adiro_provenance/2.2.0
Changed
storageLocationmay be relative (#239): a relative reference is resolved against the root of the dataset the data belongs to, which the data does not record, and is resolved before a public release, whose check accepts only absolute addresses on its allowed hosts.Configuration's definition says again that a resolution is recorded on the coordinate frame it gives (resolutionDpi, inadiro_geometry).
Added
- The text read from a drawing (#238). New class
TextReading(anInferredEntity): the text a step read from a region, such as a title block, or from a whole page (isReadingOf), as printed and whether or not any of it was read as a field, inreadText, with the language as the literal's language tag. A reading that read nothing has an outcome instead (hasReadingOutcome, a property of its own:hasOutcomekeeps its domainFieldAssertion). New outcome valueFailed(a step that did not complete; retried), for a field assertion or a reading, with the error inerrorMessage, which a step that failed before producing anything records on itself. NewStepKind(RegionDetection,TextRecognition,FieldExtraction) withhasStepKindon a step, so a step that found nothing is still known for what it looked for. Data that lists the outcome values may meetFailed, a fifth value. - The runs of an extraction and their configuration (#237). An extraction run is a
prov:Activity; each of its steps (detecting a region, reading text, extracting fields) is anInferenceMetawith the model it used, and is part of the run throughdcterms:isPartOf. New classConfiguration(aprov:Entity) withconfigurationContent: the settings a step used (a prompt, rendering settings, size limits), kept as text whose format ADIRO does not model and with no credentials in it, recorded withprov:used; identical content should be one individual. The typing stubsdcterms:isPartOfandprov:startedAtTimeare declared, with no axioms.InferenceMeta's definition describes steps and runs.
Pull requests in this release
- #243 Release cut: adiro_provenance 2.2.0, adiro_geometry 3.1.0, adiro_drawing_metadata 7.0.1
- #245 feat(geometry): what a model saw - frames at a resolution, crops and kept images (#239)
- #244 feat(provenance): text readings, step kinds and the failed outcome; UC-01 queries over named graphs (#238, #236, #241)
- #242 Runs: an extraction run, its steps and their configuration (#237)
adiro_geometry 3.1.0
MINOR release · 3.0.0 → 3.1.0 · Compare
- Documentation: https://burohappoldmachinelearning.github.io/ADIRO/ontologies/adiro_geometry/
- Ontology (latest): https://w3id.org/adiro/adiro_geometry
- This version (3.1.0): https://w3id.org/adiro/adiro_geometry/3.1.0
Added
- What a model saw (#239). Every image of a page an extraction feeds to a model is a pixel
CoordinateFramewith its resolution, the newresolutionDpi(a decimal); a crop is a frame limited to a region, the newcoversRegion(frame →BoundingBox); a step records the frame it used withprov:used. An image that is kept is anaprov:DrawingFilelinked to its frame by the newimageOf. No crop class and no transform term: between frames there is only a uniform scale.CoordinateFrame's definition says so.
Pull requests in this release
adiro_drawing_metadata 7.0.1
PATCH release · 7.0.0 → 7.0.1 · Compare
- Documentation: https://burohappoldmachinelearning.github.io/ADIRO/ontologies/adiro_drawing_metadata/
- Ontology (latest): https://w3id.org/adiro/adiro_drawing_metadata
- This version (7.0.1): https://w3id.org/adiro/adiro_drawing_metadata/7.0.1
Changed
- The labelling annotations' definitions say they are named for their application (#216):
isComputerVisionLabelandisComputerVisionOptionalLabelserve computer-vision annotation, and another application gets its own pair. The Turtle comment block above them, which said so along with the history of their names (recorded under #141 in theaec_drawing_metadatachangelog), is removed: a#comment is not part of the graph any tool reads. Downstream consumers need no change.
Pull requests in this release
adiro_provenance 2.1.0
MINOR release · 2.0.0 → 2.1.0 · Compare
- Documentation: https://burohappoldmachinelearning.github.io/ADIRO/ontologies/adiro_provenance/
- Ontology (latest): https://w3id.org/adiro/adiro_provenance
- This version (2.1.0): https://w3id.org/adiro/adiro_provenance/2.1.0
Added
- Where a file was obtained from (#229).
sourceLocationrecords the address aDrawingFile's bytes were obtained from, such as a public archive's download address or, when it is the only origin known, an address in an organisation's own storage.storageLocationstill records where copies are kept. The origin no longer gets lost when a public file is copied into internal storage before processing.sourcePagerecords the catalogue or landing page that describes the file at its origin, which is often a more lasting address. Both take anxsd:anyURIand are related to DCAT and Dublin Core terms byskos:closeMatch(dcat:downloadURLanddcterms:source;dcat:landingPage). - A file made from another file points back to it: the PROV-O typing stub
prov:wasDerivedFromis declared, and is used between twoDrawingFiles (a format conversion, a page split out of a PDF). Only the original records asourceLocation. - Data checks in
data-validation/: a warning for a file with no recorded origin, itself or through the files it was derived from; and, for a public release only (validate_data.py --public-hosts FILE), a violation for anysourceLocation,sourcePage,storageLocationoracceptedUnderthat is not on the release's allowlist of public hosts (the release must drop it before publishing).
Changed
supersedestakes effect when the superseding assertion is accepted (#221). Its definition now says so: until then the earlier assertion stays in force, and an accepted assertion replaces every assertion it supersedes, directly or through others. A pending or rejected re-extraction no longer withdraws an accepted value. No term, domain or range changes; tooling that readssupersedesas an immediate withdrawal should follow the new rule.
Pull requests in this release
aec_provenance 1.1.0
MINOR release · 1.0.1 → 1.1.0 · Compare
- Documentation: https://burohappoldmachinelearning.github.io/ADIRO/ontologies/aec_provenance/
- Ontology (latest): https://w3id.org/adiro/aec_provenance
- This version (1.1.0): https://w3id.org/adiro/aec_provenance/1.1.0
Deprecated
- This module is deprecated, and this is its final release (#171). It is replaced by
adiro_provenance(https://w3id.org/adiro/adiro_provenance), the same module under a name without the repeated "AEC", which continues this module's version numbering: its first release is this one plus a MAJOR. Theowl:Ontologyheader saysowl:deprecated trueanddcterms:isReplacedByadiro_provenance; nothing else changes. Every release of this module, this one included, stays published at its own IRI, and its terms keep their IRIs. The new module comes with a mapping from each term to its new IRI, and a script that rewrites a graph. Downstream consumers need to move to the new module.
Added
- The outcome and the acceptance of a field assertion (#187):
AssertionOutcome(Empty,Illegible,NotPrinted,NotFound; what a search found when it found no value) withhasOutcome, andAcceptanceStatus(Pending,Accepted,Rejected) withhasAcceptance,acceptedBy,acceptedAtandacceptedUnder;supersedesbetween assertions. An assertion has a value or an outcome, never both; only an accepted assertion that has a value is promoted bymapsToFieldProperty, whose comment says so.supersedesis related toprov:wasRevisionOfbyskos:closeMatch. - The file a drawing is stored in, and its pages (#192):
DrawingFile(a reference to a document, identified by its content hash) andFilePage(one page of a file, counted from 1), with the properties that describe them (fileName,mediaType,contentHash,hashAlgorithm,storageLocation,fileCreatedAt,fileModifiedAt,fileCreatedBy,fileModifiedBy,pageCount,fileSize;belongsToFile,pageNumber,displayWidthPt,displayHeightPt,pdfRotationDeg). Both areprov:Entityand subclasses of the ISO 21597-1 (ICDD)Documentand, for the page, nothing more; each property is related to ICDD, Dublin Core terms and DCAT byskos:closeMatch, never as a subproperty. Party,PersonandOrganisation(#192), moved here fromaec_drawing_metadata(their IRIs change):Partyis abstract, the disjoint union of the other two, and aprov:Agent; each is a subclass of its ISO 21597-1 counterpart. Downstream consumers that read a person or an organisation by IRI need to adjust.- A human annotation is an inference step performed by a person (#192): the comments of
InferredEntity,inferredByandhasConfidencesay that the producing step can be a model or a person (anaprov:Person, with noinferredWith, and a confidence only if one is given). No term changes. - ISO 21597-1 typing stubs (
ct:Document,ct:Party,ct:Person,ct:Organisation, edition 1), declared locally, with noowl:imports;rdfs:isDefinedBypoints at the publishedContainer.rdf, because the namespace address itself does not answer.
Pull requests in this release
- #193 Release cut: final aec_* releases, before the rename to adiro_* (#171)
- #208 feat: deprecate the aec_* modules for their final release (#171)
- #199 fix: the ICDD stubs point at the resolvable document and the link check skips the namespace address (#197)
- #198 feat(aec_provenance): the outcome and the acceptance of a field assertion (#187)
- #194 feat: the file, the page and the agents in the ontology; a coordinate frame keeps only its convention (#192)
aec_geometry 2.0.0
MAJOR release · 1.0.1 → 2.0.0 · Compare
- Documentation: https://burohappoldmachinelearning.github.io/ADIRO/ontologies/aec_geometry/
- Ontology (latest): https://w3id.org/adiro/aec_geometry
- This version (2.0.0): https://w3id.org/adiro/aec_geometry/2.0.0
Deprecated
- This module is deprecated, and this is its final release (#171). It is replaced by
adiro_geometry(https://w3id.org/adiro/adiro_geometry), the same module under a name without the repeated "AEC", which continues this module's version numbering: its first release is this one plus a MAJOR. Theowl:Ontologyheader saysowl:deprecated trueanddcterms:isReplacedByadiro_geometry; nothing else changes. Every release of this module, this one included, stays published at its own IRI, and its terms keep their IRIs. The new module comes with a mapping from each term to its new IRI, and a script that rewrites a graph. Downstream consumers need to move to the new module.
Changed
- BREAKING: a
CoordinateFramestates only its coordinate convention (#192).pageIndex,frameArtifactRef,pdfRotationDeg,displayWidthPtanddisplayHeightPtleave it: they are facts about a page of a file, and move toaec_provenance:FilePage(the page number is counted from 1, the file is aDrawingFilewith its content hash). The frame points to its page with the newdescribesPage. A page can now have several frames (the primarypage_display_ptin points, andpxfor raster evidence) without repeating the page. Downstream consumers that read these properties from a frame need to adjust. profileRef's comment no longer lists the page extent among what a profile defines, andhasBoundingBox's says that everyMetadataContainermay have one.
Pull requests in this release
aec_facade_domain 3.0.1
PATCH release · 3.0.0 → 3.0.1 · Compare
- Documentation: https://burohappoldmachinelearning.github.io/ADIRO/ontologies/aec_facade_domain/
- Ontology (latest): https://w3id.org/adiro/aec_facade_domain
- This version (3.0.1): https://w3id.org/adiro/aec_facade_domain/3.0.1
Deprecated
- This module is deprecated, and this is its final release (#171). It is replaced by
adiro_facade_domain(https://w3id.org/adiro/adiro_facade_domain), the same module under a name without the repeated "AEC", which continues this module's version numbering: its first release is this one plus a MAJOR. Theowl:Ontologyheader saysowl:deprecated trueanddcterms:isReplacedByadiro_facade_domain; nothing else changes. Every release of this module, this one included, stays published at its own IRI, and its terms keep their IRIs. The new module comes with a mapping from each term to its new IRI, and a script that rewrites a graph. Downstream consumers need to move to the new module.
Pull requests in this release
aec_drawing_metadata 6.0.0
MAJOR release · 5.0.1 → 6.0.0 · Compare
- Documentation: https://burohappoldmachinelearning.github.io/ADIRO/ontologies/aec_drawing_metadata/
- Ontology (latest): https://w3id.org/adiro/aec_drawing_metadata
- This version (6.0.0): https://w3id.org/adiro/aec_drawing_metadata/6.0.0
Deprecated
- This module is deprecated, and this is its final release (#171). It is replaced by
adiro_drawing_metadata(https://w3id.org/adiro/adiro_drawing_metadata), the same module under a name without the repeated "AEC", which continues this module's version numbering: its first release is this one plus a MAJOR. Theowl:Ontologyheader saysowl:deprecated trueanddcterms:isReplacedByadiro_drawing_metadata; nothing else changes. Every release of this module, this one included, stays published at its own IRI, and its terms keep their IRIs. The new module comes with a mapping from each term to its new IRI, and a script that rewrites a graph. Downstream consumers need to move to the new module.
Added
isOnPage(#192): from aDrawingSheetto theaprov:FilePageit is on. One drawing can be on a page of several files and one file holds many drawings, so the page belongs to this link. The frames that read the page are reached with the inverse path^describesPage(aec_geometry).- A
MetadataContainer, aLayoutand aDrawingElementmay carry aBoundingBox(#192): an explicitmin 0restriction ongeom:hasBoundingBoxon each, inherited byTitleblock,RevisionTable,Legend,KeyPlanandNotefor the first and by every symbol and component for the last, so the region of each (which what is read from it is located by) is stated in this module and not only in the documentation; the import ofaec_geometrystays. assertsPackage(#69): from aTitleblockto theDrawingPackageit names, when it names one (a title block may or may not).belongsToPackagestays the fact that a drawing is filed in a package.assertsProject(#69): from aTitleblockto theProjectit names, a claim read off the printed region, likeassertsClient.belongsToProjectstays the fact that a drawing is filed under a project; the two can differ.assertsRevision(#69): from aRevisionTableto eachDrawingRevisionit lists, one link per row. It records which printed table a revision was read from; it does not say which revision is the latest.
Removed
- BREAKING:
appearsOnLayoutremoved (#170): it recorded the sourceLayoutof a reference expression, whichcontainsfrom that Layout already says (hasReferenceSymbolspecialises it for a marker); the layout of an expression is read with the inverse path^contains. Downstream consumers that emit or readappearsOnLayoutneed to usecontainsfrom the layout instead. - BREAKING:
PersonandOrganisationmoved toaec_provenance(#192): they are domain-neutral, and the creator of a file needs them too. Their IRIs change, and they gain a parentParty.personNameandorganisationNamestay here, with the moved classes as their domain; the ranges ofisAuthoredBy,isCheckedBy,isApprovedBy,assertsClientandassertsOriginatorfollow. Downstream consumers that read a person or an organisation by IRI need to adjust. - BREAKING:
hasCoordinateFrameremoved (#192): the frames of a drawing are reached through its page, withisOnPageand^describesPage.
Changed
issueDateapplies to aDrawingSheetor aDrawingRevision(#179): the title block's date is the drawing's, and "date authored" is the same property. Its domain widens fromDrawingRevisionto the union of the two.isAuthoredBy,isCheckedByandisApprovedByapply to aDrawingSheetor aDrawingRevision(#179): their domain widens fromDrawingRevisionto the union of the two. On a drawing it is the person the title block names; on a revision it is the person who made, checked or approved that revision, who can differ. A drawing that records no author is read as authored by its revisions' authors (a reading convention for queries and the validation shape, not an entailment). The compatibility check reads any domain change as potentially breaking (MAJOR), although a widening invalidates no existing statement.
Pull requests in this release
- #193 Release cut: final aec_* releases, before the rename to adiro_* (#171)
- #208 feat: deprecate the aec_* modules for their final release (#171)
- #200 feat(aec_drawing_metadata): remove appearsOnLayout, which duplicated contains (#170)
- #194 feat: the file, the page and the agents in the ontology; a coordinate frame keeps only its convention (#192)
- #189 feat(aec_drawing_metadata): authorship on the drawing and the revision; assertsRevision (#179, #69)