Skip to content

README.md

Latest commit

 

History

History
327 lines (287 loc) · 12.6 KB

README.md

File metadata and controls

327 lines (287 loc) · 12.6 KB

ZPE-Diagram

Package Install

Installable package: python3.11 -m pip install zpe-diagram. Current release: 0.1.0 on PyPI. Source: Zer0pa/ZPE-Diagram.

python3.11 -m pip install zpe-diagram

For full install, smoke, source, and developer commands, click here.

00 · ZPE-DIAGRAM · GRAPH-STRUCTURE RESEARCH-READY · PYPI CONNECTED

Encoding the Grammar of Diagrams

Bounded structural diagram codec · ZPE-Diagram · PyPI zpe-diagram v0.1.0 · github.com/Zer0pa/ZPE-Diagram

Most diagram exports flatten a structured drawing into a picture. Six declared synthetic SVGs round-trip through ZPE-Diagram as explicit graph state — geometry, color, stroke width, and draw order all exact. Three out-of-scope probes — fills, dashed strokes, palette escapes — are refused at the door instead of silently approximated. This is not compression and not a general SVG renderer. It is a bounded codec that keeps the rules that make a diagram readable as a diagram.
ZPE-Diagram approved scientific square mechanics diagram showing structure base, style fiber, and stroke order mechanics.
Scope: bounded synthetic SVG grammar. Structure, style, and order round-trip; general SVG rendering is outside scope.
01 · THE GAP LOST IN EXPORT

A diagram exported as an image loses the grammar that made it a diagram.
02 · MARKETS WEDGE MAP
Diagramming software $1.9B
Graphic design software $85.5B
Technical documentation tooling $4.8B
Standards-body technical drawing $0.8B
Document archival software $7.3B
Diagramming and adjacent archival categories · the wedge is line-based technical drawings, not the whole graphic design market.
03 · VALUE OF MARKET
$1.9B 2030
Diagramming software by 2030; ZPE-Diagram keeps line-based drawings readable as drawings after export.
04 · INSIGHT

A diagram's grammar is the draw order, not the pixels.
05.1 · CURRENT TECH PIXELS ONLY

Standard diagram exports preserve appearance, not intent. The file shows lines in roughly the right place while losing the structural roles, the connection types, and the order in which a person actually built the drawing.
05.2 · OUR TECH KEEP THE GRAMMAR

ZPE-Diagram keeps the grammar. On six declared synthetic line-based SVGs, geometry, a frozen eight-color palette, quantized stroke width, and draw order all round-trip exactly. Three out-of-scope probes — fills, dashed strokes, palette escapes — are rejected at encode time rather than silently coerced into something they are not.
05.3 · BENCHMARKS VALIDATION
Cases6SVGs
Structure1.000exact
Style1.000exact
Order1.000exact
structure 1.000
style 1.000
reject 3 / 3
Source: bounded_style_validation.json · 6/6 in-scope at 1.000 · 3/3 out-of-scope refused.
06 · MEASUREMENT BOUNDED VALIDATION

Six in-scope cases verified; three out-of-scope probes refused at encode.
06.1 · BOUNDED VALIDATION SYNTHETIC SVG FIXTURES
Structure 1.000
Style (color + stroke) 1.000
Draw order 1.000
Out-of-scope reject 3 / 3
Six declared synthetic SVGs (triangle ×2, square, parallel bars ×2, T-mixed) plus three reject probes (fill, dash, palette escape). Source: validation/results/bounded_style_validation.json. No comparator codec evaluated.
07 · KEY METRICS BOUNDED STRUCTURAL CODEC
07.1 · STRUCTURAL FIDELITY
6/ 6
Synthetic cases · structure, style, draw-order all exact
07.2 · OUT-OF-SCOPE REJECT
3/ 3
Probes refused · fill · dash · palette escape
07.3 · RELEASE
v0.1.0
PyPI connected · zpe-diagram 0.1.0
07.4 · CHECKED PACKET
VERIFIED
Public validation packet · bounded synthetic scope
07.5 · COMPRESSION CLAIM
none
Not a compression codec · structure preserved, not file size
08 · DETERMINISM COMMITTED FIXTURES

Committed fixtures. Same bounded metrics.
08.1 · WHAT DETERMINISTIC MEANS FIXTURES + REJECTS

Grammar here means something precise: the rules that make a drawing readable as a diagram rather than a pile of lines. Geometry encodes where elements sit. Style encodes how connections differ. Draw order encodes the sequence in which a person placed them. ZPE-Diagram keeps all three axes on committed fixtures and replays them byte-for-byte. On the bounded surface of six declared synthetic SVGs, structural, style, and draw-order fidelity each measure 1.000 — and the three out-of-scope probes never enter the packet.
08.2 · THE FIDELITY GAP
Honest Blocker ·

No fill encode path. No dash encode path. No arbitrary SVG coverage. No compression claim. The current evidence is six synthetic fixtures plus three out-of-scope rejects. Real-world corpus closure, the is_diagram_header() boundary profile, and stroke-width normalization beyond the synthetic packet all remain open work.
09

DIAGRAMS WITH A RECEIPT.
09.1 · THE AMBITION

The ambition is to make exported diagrams behave like the structured objects their authors meant them to be: archivable, comparable, searchable by structure rather than by pixel. A docs team, a standards committee, or an engineering archive should be able to trust that the drawing they store is the drawing they later retrieve.
09.2 · WHAT WORKS NOW

Working today, on six declared synthetic SVGs: geometry, style, and draw order survive encoding exactly.
09.3 · WHAT'S STILL OPEN

Still open: public corpora, header-boundary profile, and stroke-width handling outside the synthetic packet.
09.4 · DOCS · NEAR-TERM (12–24 MO)
Docs teams keep diagram meaning
A documentation team that exports a system diagram no longer ships a flat picture. The export carries node positions, line roles, and draw order, so the next writer can update the diagram instead of redrawing it from scratch.
09.5 · PIPELINES · NEAR-TERM (12–24 MO)
Pipelines refuse the wrong input
An archival pipeline that ingests diagrams now receives either a clean bounded object or a clear refusal. The operations team stops debugging silent visual corruption later and starts seeing rejection reasons at the moment of ingest.
09.6 · STANDARDS · MID-TERM (24–48 MO)
Standards bodies archive structure, not screenshots
ISO, IEEE, and ANSI technical drawing submissions can travel as structural objects with geometry, color, and draw order intact. A standards committee can compare two revisions of a wiring diagram or process flow without arguing about which export tool rendered it.
09.7 · DIFFS · MID-TERM (24–48 MO)
Diagram review moves off pixel overlays
Two versions of an architecture diagram become a structural diff: which boxes moved, which lines changed role, which elements were reordered. Reviewers stop squinting at overlaid screenshots and start reading change lists they can talk about in meetings.
09.8 · PROVENANCE · PARADIGM (48 MO+)
Drawings acquire chain-of-custody
A technical drawing in a regulatory submission, an engineering archive, or a patent filing can be proven identical or different across decades. Drawings stop being images and become governed structural objects that survive the people, vendors, and tools that produced them.

Install / Developer Commands Detailed

Package Install

Installable package: python3.11 -m pip install zpe-diagram. Current release: 0.1.0 on PyPI. Source: Zer0pa/ZPE-Diagram.

python3.11 -m pip install zpe-diagram

Import smoke:

python3.11 - <<'PY'
import importlib.metadata as md
import zpe_diagram

print("zpe-diagram", md.version("zpe-diagram"))
PY

Install success only proves package acquisition/import. Product scope, stale PyPI state, platform limits, and blockers remain in the front-door sections below.

Quick Start

python3 -m venv .venv
. .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -e ".[dev]"
python proofs/artifacts/reproduce_validation.py
python -m pytest tests/test_style_authority.py