Skip to content

Releases

ADIRO suite snapshot, 2026-11-17

Choose a tag to compare

@alelom alelom released this 17 Nov 16:36
b08fc4e

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

Choose a tag to compare

@alelom alelom released this 29 Oct 16:20
5a465a0

The data-validation shapes and the UC-01 competency queries, version 1.0.0.

Added

adiro_provenance 2.2.0

Choose a tag to compare

@adiro-bot adiro-bot released this 29 Oct 16:17
c7460bf

MINOR release · 2.1.0 → 2.2.0 · Compare

Changed

  • storageLocation may 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, in adiro_geometry).

Added

  • The text read from a drawing (#238). New class TextReading (an InferredEntity): 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, in readText, with the language as the literal's language tag. A reading that read nothing has an outcome instead (hasReadingOutcome, a property of its own: hasOutcome keeps its domain FieldAssertion). New outcome value Failed (a step that did not complete; retried), for a field assertion or a reading, with the error in errorMessage, which a step that failed before producing anything records on itself. New StepKind (RegionDetection, TextRecognition, FieldExtraction) with hasStepKind on a step, so a step that found nothing is still known for what it looked for. Data that lists the outcome values may meet Failed, 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 an InferenceMeta with the model it used, and is part of the run through dcterms:isPartOf. New class Configuration (a prov:Entity) with configurationContent: 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 with prov:used; identical content should be one individual. The typing stubs dcterms:isPartOf and prov:startedAtTime are 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

Choose a tag to compare

@adiro-bot adiro-bot released this 29 Oct 16:17
c7460bf

MINOR release · 3.0.0 → 3.1.0 · Compare

Added

  • What a model saw (#239). Every image of a page an extraction feeds to a model is a pixel CoordinateFrame with its resolution, the new resolutionDpi (a decimal); a crop is a frame limited to a region, the new coversRegion (frame → BoundingBox); a step records the frame it used with prov:used. An image that is kept is an aprov:DrawingFile linked to its frame by the new imageOf. 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

  • #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)

adiro_drawing_metadata 7.0.1

Choose a tag to compare

@adiro-bot adiro-bot released this 29 Oct 16:17
c7460bf

PATCH release · 7.0.0 → 7.0.1 · Compare

Changed

  • The labelling annotations' definitions say they are named for their application (#216): isComputerVisionLabel and isComputerVisionOptionalLabel serve 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 the aec_drawing_metadata changelog), is removed: a # comment is not part of the graph any tool reads. Downstream consumers need no change.

Pull requests in this release

  • #243 Release cut: adiro_provenance 2.2.0, adiro_geometry 3.1.0, adiro_drawing_metadata 7.0.1
  • #247 chore: remove a Turtle comment block, make the archived-image check blocking (#216, #156)

adiro_provenance 2.1.0

Choose a tag to compare

@adiro-bot adiro-bot released this 27 Oct 18:14
aa39308

MINOR release · 2.0.0 → 2.1.0 · Compare

Added

  • Where a file was obtained from (#229). sourceLocation records the address a DrawingFile'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. storageLocation still records where copies are kept. The origin no longer gets lost when a public file is copied into internal storage before processing. sourcePage records the catalogue or landing page that describes the file at its origin, which is often a more lasting address. Both take an xsd:anyURI and are related to DCAT and Dublin Core terms by skos:closeMatch (dcat:downloadURL and dcterms:source; dcat:landingPage).
  • A file made from another file points back to it: the PROV-O typing stub prov:wasDerivedFrom is declared, and is used between two DrawingFiles (a format conversion, a page split out of a PDF). Only the original records a sourceLocation.
  • 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 any sourceLocation, sourcePage, storageLocation or acceptedUnder that is not on the release's allowlist of public hosts (the release must drop it before publishing).

Changed

  • supersedes takes 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 reads supersedes as an immediate withdrawal should follow the new rule.

Pull requests in this release

  • #234 Release cut: adiro_provenance 2.1.0
  • #227 feat(provenance): supersession takes effect when the superseding assertion is accepted (#221)
  • #230 Record where a drawing file was obtained from (sourceLocation) (#229)

aec_provenance 1.1.0

Choose a tag to compare

@adiro-bot adiro-bot released this 21 Oct 08:49
03ea906

MINOR release · 1.0.1 → 1.1.0 · Compare

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. The owl:Ontology header says owl:deprecated true and dcterms:isReplacedBy adiro_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) with hasOutcome, and AcceptanceStatus (Pending, Accepted, Rejected) with hasAcceptance, acceptedBy, acceptedAt and acceptedUnder; supersedes between assertions. An assertion has a value or an outcome, never both; only an accepted assertion that has a value is promoted by mapsToFieldProperty, whose comment says so. supersedes is related to prov:wasRevisionOf by skos:closeMatch.
  • The file a drawing is stored in, and its pages (#192): DrawingFile (a reference to a document, identified by its content hash) and FilePage (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 are prov:Entity and subclasses of the ISO 21597-1 (ICDD) Document and, for the page, nothing more; each property is related to ICDD, Dublin Core terms and DCAT by skos:closeMatch, never as a subproperty.
  • Party, Person and Organisation (#192), moved here from aec_drawing_metadata (their IRIs change): Party is abstract, the disjoint union of the other two, and a prov: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, inferredBy and hasConfidence say that the producing step can be a model or a person (an aprov:Person, with no inferredWith, 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 no owl:imports; rdfs:isDefinedBy points at the published Container.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

Choose a tag to compare

@adiro-bot adiro-bot released this 21 Oct 08:49
03ea906

MAJOR release · 1.0.1 → 2.0.0 · Compare

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. The owl:Ontology header says owl:deprecated true and dcterms:isReplacedBy adiro_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 CoordinateFrame states only its coordinate convention (#192). pageIndex, frameArtifactRef, pdfRotationDeg, displayWidthPt and displayHeightPt leave it: they are facts about a page of a file, and move to aec_provenance:FilePage (the page number is counted from 1, the file is a DrawingFile with its content hash). The frame points to its page with the new describesPage. A page can now have several frames (the primary page_display_pt in points, and px for 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, and hasBoundingBox's says that every MetadataContainer may have one.

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)
  • #194 feat: the file, the page and the agents in the ontology; a coordinate frame keeps only its convention (#192)

aec_facade_domain 3.0.1

Choose a tag to compare

@adiro-bot adiro-bot released this 21 Oct 08:49
03ea906

PATCH release · 3.0.0 → 3.0.1 · Compare

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. The owl:Ontology header says owl:deprecated true and dcterms:isReplacedBy adiro_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

  • #193 Release cut: final aec_* releases, before the rename to adiro_* (#171)
  • #208 feat: deprecate the aec_* modules for their final release (#171)

aec_drawing_metadata 6.0.0

Choose a tag to compare

@adiro-bot adiro-bot released this 21 Oct 08:49
03ea906

MAJOR release · 5.0.1 → 6.0.0 · Compare

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. The owl:Ontology header says owl:deprecated true and dcterms:isReplacedBy adiro_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 a DrawingSheet to the aprov:FilePage it 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, a Layout and a DrawingElement may carry a BoundingBox (#192): an explicit min 0 restriction on geom:hasBoundingBox on each, inherited by Titleblock, RevisionTable, Legend, KeyPlan and Note for 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 of aec_geometry stays.
  • assertsPackage (#69): from a Titleblock to the DrawingPackage it names, when it names one (a title block may or may not). belongsToPackage stays the fact that a drawing is filed in a package.
  • assertsProject (#69): from a Titleblock to the Project it names, a claim read off the printed region, like assertsClient. belongsToProject stays the fact that a drawing is filed under a project; the two can differ.
  • assertsRevision (#69): from a RevisionTable to each DrawingRevision it 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: appearsOnLayout removed (#170): it recorded the source Layout of a reference expression, which contains from that Layout already says (hasReferenceSymbol specialises it for a marker); the layout of an expression is read with the inverse path ^contains. Downstream consumers that emit or read appearsOnLayout need to use contains from the layout instead.
  • BREAKING: Person and Organisation moved to aec_provenance (#192): they are domain-neutral, and the creator of a file needs them too. Their IRIs change, and they gain a parent Party. personName and organisationName stay here, with the moved classes as their domain; the ranges of isAuthoredBy, isCheckedBy, isApprovedBy, assertsClient and assertsOriginator follow. Downstream consumers that read a person or an organisation by IRI need to adjust.
  • BREAKING: hasCoordinateFrame removed (#192): the frames of a drawing are reached through its page, with isOnPage and ^describesPage.

Changed

  • issueDate applies to a DrawingSheet or a DrawingRevision (#179): the title block's date is the drawing's, and "date authored" is the same property. Its domain widens from DrawingRevision to the union of the two.
  • isAuthoredBy, isCheckedBy and isApprovedBy apply to a DrawingSheet or a DrawingRevision (#179): their domain widens from DrawingRevision to 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)