Crate openbim_loin 

openbim-loin — ISO 7817-3 / EN 17412-3 Level of Information Need.

What this is

A machine-readable statement of how much information is required about which objects, for a given purpose, at a given milestone, between a given pair of actors: geometric detail, alphanumeric properties, and documentation.

EN 17412-1 defines the concepts in prose; part 3 is the exchange format. Only part 3 is implementable, and it is what this crate targets.

Relationship to ISO 23387

The LOIN schema imports the ISO 23387 namespace for its property vocabulary. This crate therefore uses and re-exports openbim-dt contracts for GUIDs, multilingual text, references, concept inheritance, and embedded property, quantity, group, document, template, unit, and dimension content.

🚨 The namespace is not final

The draft schema carries, in a comment on line 2:

Final LOIN Namespace will be specified after the review process

and declares https://iso.org/2024/LOIN, while an earlier draft declared https://iso.org/2022/LOIN. Namespace migration is therefore a first-class concern here, not an afterthought: reading must accept known historical namespaces, and writing must target one explicitly rather than defaulting to whatever was parsed.

Status

The DT-backed domain boundary is implemented. XML reading, writing, namespace migration, and ISO schema validation are not yet implemented.

The ISO XSD is not vendored. Both the ISO/CEN originals and the public committee drafts are unlicensed for redistribution, and the schema is a moving target; it is referenced out of tree instead.

Re-exports

pub use openbim_dt as dt;

Structs

Actor

LOIN ActorType, using DT identity and multilingual text.

AlphanumericalInformation

Anonymous LOIN alphanumerical-information content using imported DT types.

DatumRegistryReference

LOIN datum-registry reference using DT text and reference types.

Detail

LOIN geometry detail with an optional DT dictionary reference.

DocumentFormat

LOIN FormatType using DT multilingual text and references.

Documentation

LOIN DocumentationType, whose identity attribute is DT-owned.

GeometricalInformation

LOIN geometrical-information identity using the imported DT GUID attribute.

InformationDeliveryMilestone

LOIN InformationDeliveryMilestoneType.

Prerequisites

LOIN prerequisites; all referenced identities are DT-owned GUID contracts.

Purpose

LOIN PurposeType; its identity, text, and references are DT-owned contracts.

RequiredDocument

LOIN RequiredDocumentType.

Specification

Root LOIN specification contract.

SpecificationPerObjectType

One LOIN requirement per object type; its base and imported content are DT-owned.

ThresholdDimension

LOIN threshold dimension importing DT unit and text contracts.

Constants

KNOWN_NAMESPACES

Namespaces this crate recognises as LOIN, newest first.

NAMESPACE_2022

The namespace declared by the earlier EN 17412-3 committee draft (2022).

NAMESPACE_2024

The namespace declared by the ISO 7817-3 draft schema (2024).

Functions

is_known_namespace

Whether a namespace URI is a LOIN namespace this crate knows.