s3dgraphy

What it is

s3dgraphy is the Python library that implements the Extended Matrix formal language as a property knowledge graph. It is what every EMF tool reads and writes under the hood — yEd produces the GraphML, EM Tools loads it through s3dgraphy, Heriverse consumes its JSON export.

You normally do not interact with s3dgraphy directly: EM Tools wraps it inside the Blender add-on. You will reach for the library when you want to bring EM into a different platform — Revit, 3ds Max, Unity, Unreal, a CLI batch job, a Jupyter notebook.

Installing

pip install s3dgraphy

See the GitHub repository for the API reference and the import/export utilities.

When to use it

• You are building a custom pipeline that needs to read EM graphs.
• You want CI validation of the graphs in your repository.
• You are integrating EM into a host platform that is not Blender.
• You are writing code that talks to the Heriverse JSON format directly.

Production users & integrations

PyArchInit is the first production consumer of s3dgraphy. It is an open-source QGIS plugin for archaeological data management with particular strength in 2D GIS visualization of stratigraphic data, maintained by an active community led by Luca Mandolesi.

The PyArchInit integration drove the design of the LocationNodeGroup in s3dgraphy 0.1.41 (insight from issue #5 by Enzo Cocca). Use the PyArchInit tool page and the Extended Matrix manual cookbook as a worked example of how an independent tool bridges into Extended Matrix through s3dgraphy.

Open invitation

s3dgraphy is designed to be consumed by other independent tools. Revit, Unreal Engine, Houdini, PostgreSQL/PostGIS, and similar domain-specific tools are natural candidates for similar bridges. If you maintain such a project and want to explore an integration, look at PyArchInit as a worked example or open an issue on GitHub.