dsfab

Datasculptures Fabrication — a presentation-agnostic Python library that converts coloured meshes to fabricable files with verifiable provenance.

What it does

dsfab sits between "I have a coloured mesh in memory" and "I have a fabricable file on disk with verifiable provenance." It is a shared dependency used by SFS, DTS, and future portfolio tools.

• Mesh writers — PLY (per-vertex colour), OBJ (+MTL), STL, 3MF
• Constraint-fitting — fit_to_cube: scale any point set into a target cube (geometry-agnostic)
• Printability — validate_printability: watertight, manifold, winding, minimum feature size
• Colour segmentation — segment_by_scalar + render_legend_png: the coloured-STL print path
• Provenance — write_manifest: SHA-256 manifest for all inputs and outputs

Installation

pip install dsfab

Quick start

import trimesh
from pathlib import Path
import dsfab

mesh = trimesh.load("my_mesh.ply")
result = dsfab.write_mesh(mesh, Path("output.ply"), "ply")
print(f"Wrote {result.bytes} bytes, SHA-256: {result.sha256}")

Requirements

Python ≥ 3.11. Dependencies: trimesh ≥ 4.0, numpy ≥ 1.26, matplotlib ≥ 3.8.

License

MIT