Origlyph Engineering Platform
Project Identity
- Name: Origlyph
- Current status: Seventh public alpha — deterministic CAD, datum, tolerance-analysis, audit, and governed-acceptance engineering foundation with interactive desktop GUI, persisted project model, tolerance workspace, and allocation plan editor with explicit validation workflow
- Package version:
0.4.0a7
- Current release/tag:
v0.4.0-alpha.7
Purpose
Origlyph is an engineering platform intended for:
- CAD data ingestion and geometry interrogation
- datum/reference definition workflows
- GD&T assistance
- deterministic tolerance analysis
- dimensional-chain / tolerance-stack analysis
- assembly geometry reasoning
- deterministic engineering decisions with traceable evidence
- audit, replay, change-impact, and governed engineering workflows
- future explainable AI assistance
These are product goals. Only the capabilities listed under
What Is Currently Implemented exist today;
everything else is roadmap, not implementation.
Current Development Status
v0.4.0-alpha.7 completes the tolerance workspace productization arc (Stages 17A–17E-3),
adding specification-aware analysis, PASS/FAIL decision evaluation, sensitivity
inspection, budget inspection, workspace v3 allocation plan contract and persistence,
allocation validation controller/session, and the interactive Allocation Plan editor
with explicit Validate Allocation workflow.
The current release includes:
- deterministic geometry foundations
- CAD identity and neutral-model contracts
- concrete ASCII/binary STL import
- source-to-neutral provenance
- CAD-to-datum candidate bridging
- explicit datum/reference binding
- explicit PRIMARY / SECONDARY / TERTIARY role assignment
DatumReferenceFrame construction- advisory candidate evaluation
- executable STL datum CLI workflow
- interactive Tkinter desktop GUI
- deterministic 1D worst-case tolerance analysis
- statistical RSS analysis
- covariance-aware statistical analysis
- sensitivity analysis
- tolerance budgeting
- allocation validation
- worst-case allocation reconciliation
- statistical allocation reconciliation
- deterministic tolerance decision evaluation
- deterministic decision evidence and explanation
- deterministic report and integrity validation
- deterministic audit package and replay manifest
- audit package comparison
- deterministic change-impact assessment
- deterministic change disposition
- approval-readiness evaluation
- governed acceptance handoff
- external acceptance-record validation
- acceptance-record verification envelope
- final governed acceptance closure manifest
- deterministic persisted project model v1 (save/load with tamper-evident project identity)
- interactive 1D tolerance workspace (worst-case and RSS statistical analysis) with deterministic result persistence
- specification-aware PASS/FAIL tolerance decision evaluation
- sensitivity inspection (per-contributor impact and share)
- budget inspection (worst-case; per-contributor span and budget utilization)
- workspace v3 allocation plan contract (authoritative persistence, project-identity integration)
- allocation validation via Stage 15 engine (fail-closed, explicit-only action)
- interactive Allocation Plan editor with Apply Allocation Plan and Validate Allocation workflow
The tolerance and governed-acceptance pipeline has been architecture-audited for
determinism, canonical serialization, fail-closed behaviour, identity integrity,
immutability, trust-boundary correctness, public API consistency, and regression
coverage.
This release remains alpha. It does not claim production certification,
ASME/ISO compliance, authenticated human authority, digital-signature validation,
legal acceptance, or validated manufacturing acceptance.
What Is Currently Implemented
Geometry Foundation
Point3D, Vector3D, Line3D, Plane3D — immutable, validated value objects in canonical millimetre coordinates- bounded planar faces (
BoundedPlanarFace) — ordered, coplanar vertex cycles with derived plane / area / centroid / perimeter
- coordinate frames — orthonormal, right-handed
- rigid transforms — translation, rotation, composition, inverse
- distances, angles, projections, and closest-point operations
- computational floating-point tolerance policy for numerical robustness
The computational floating-point policy is explicitly not an engineering
tolerance and must never be used to mask an engineering-relevant deviation.
CAD Foundation
- identity separation for source documents, source entities, neutral entities, and the domain:
SourceDocumentIdentitySourceEntityIdentityNeutralEntityIdentityDomainIdentitySourceUnitSystem
NeutralModel with duplicate rejection and deterministic entity orderingSourceToNeutralMapping — exact, duplicate-safe source↔neutral mappingNeutralModel.reverse_lookup — model-scoped, exact, fail-closed source identity resolution- deterministic provenance carried on imported entities
- fail-closed warning / unsupported-content handling:
CadWarningUnsupportedContent
CadImporter protocol- concrete
StlImporter
This is the beginning of the README. Read the rest at the original. Read the full README ↗
