The Extended Matrix code, mapped.
Extended Matrix is open source. Every piece lives on GitHub in a small set of repositories — the formal language, then the first-party tools that author and consume it, then the two sites you are reading right now. This page is the map: pick the layer you care about and follow it to the repo, manual or live site you need.
EM language
The formal language is what every tool in the framework speaks. Its definition, the palette that lets you author graphs in yEd, the source-list templates, and the canonical reference manual all live in a single repository so the language stays a single source of truth.
Extended Matrix — language spec, palette, templates
language repositoryThe single-source-of-truth repository: yEd palette files, source-list templates, and the historical record of the language. The reference manual is generated from the same source tree on Read the Docs.
What ships inside the language repo
- EM palette for yEd — Graph editor extension · tool page →
- source_list.xlsx — Bibliographic & archival source registry · tool page →
First-party tools
Each tool is a separate repository with its own release
cadence and its own RST manual hosted on
docs.extendedmatrix.org. They share a common
spine: the EM language above and the
s3dgraphy data model in the middle.
Third-party integrations (e.g. PyArchInit) are catalogued
on /ecosystem/.
-
EM Folder Tree
stableCanonical project structure
Canonical project folder tree for any Extended Matrix project — the `DosCO` document collection, sub-folders for graphs, exports, sources, and the `D.NN` document naming convention. Pencil-and-paper foundation; unzip into the project root before authoring nodes.
-
EM Tools
stableBlender add-on
Connect an Extended Matrix graph to 3D content inside Blender. Browse stratigraphic units, link proxies, drive visualisation by epoch and property, export to Heriverse and CSV.
-
s3dgraphy
stablePython library
The computational core of the EM Framework. Reads, writes, validates and converts EM graphs (GraphML / JSON), enforces the data model, and powers every other tool in the framework.
-
Heriverse
betaWeb platform
Heritage Science Metaverse — the web-based publication endpoint of the framework. Opens any EM-aware scene in a browser with paradata pop-ups, epoch switching and collaborative VR.
-
3DSC
stableSurvey pipeline (Blender)
3D Survey Collection — photogrammetry workflow management, level-of-detail handling, metadata propagation. The upstream pipeline that produces high-quality 3D models for EM Tools to annotate.
-
3DSC for Metashape
stableSurvey pipeline (Metashape)
Companion to 3DSC that runs the photogrammetric processing inside Agisoft Metashape — chunk management, alignment, mesh generation, texture baking, ready for the LOD step in 3DSC for Blender.
-
EMviq
stableWeb visualisation
Web-based 3D viewer in the EMF. The reference web viewer for EM 1.4 (paired version 1.4). From EM 1.5 onwards the project moves toward Heriverse, but EMviq remains the right choice for EM 1.4 deposits and for any project that wants a lighter-weight, single-purpose viewer.
The sites
The two public sites of the project, kept separate from the framework layer above because they are about the project rather than of it: this site is the public-facing surface, the dev site is the contributor tracker. Both are open source.
-
extendedmatrix.org
public site (this one)The site you are reading right now — landing pages, tool catalogue, version pages, community, news, projects. Built with Astro, deployed on GitHub Pages.
-
dev.extendedmatrix.org
contributor trackerThe development tracker — design proposals (DPs), architectural decisions, the 1.6 roadmap, meeting notes category for the public dev meetings.
The Golden Twelve
Two-page reference card with the twelve keyboard-shortcut
command families that cover every modelling task in
Blender for cultural heritage — proxy modelling, control-
point modelling, LOD work, semantic shapes. The shortcuts
have been stable since Blender 1.0 (1995): the skill
survives every future Blender release. Cite as
doi:10.5281/zenodo.21068528; companion paper
in submission to DAACH.
The Golden Twelve — Reference Card for 3D Cultural Heritage Modelling (v1.0)
learning · reference cardRecommended starting point for anyone walking an EM path that touches Blender. Hosted on Zenodo with a citable DOI; CC-BY-SA 4.0. Author: Emanuel Demetrescu, CNR-ISPC.
Looking for the user-facing tool pages? See Tools. Looking for third-party software that consumes the EM data model? See Ecosystem.