Developer Docs#

Under-the-hood documentation for developers extending volmdlr_tools.

These documents provide low-level details about internal systems and extension mechanisms. They are intended for contributors and developers building on top of the library.

Note

This section assumes familiarity with the user-facing documentation. Start with the User Guide if you’re new to the library.

Feature Classification System

Internal rule-based system for categorizing recognized features. Learn how to extend the classification rules and add new feature types.

Shape Editing Architecture

Internal architecture of the defeaturing module. Learn how to extend with new removal strategies.

Feature Reverse Engineering

Turn recognised features into parametric definitions. Profile, depth, axis, blends, face anatomy, and parent wiring.

Pattern Detection

Recover parametric grid and polar arrangements of congruent features. SVD plane fits, Kasa circle fits, lattice basis recovery, and tuning.

Euler Operators

The topological primitives (KEV / KEF / KFMV) behind blend suppression. Euler-Poincaré validity, the staged engine, and topology-vs-geometry separation.

Blend Suppression

Suppress recognized blends with local Euler-operator edits plus geometry reconstruction. Why Euler operators over global face removal, and current limits.

Topics#

  • Feature Classification - Rule registries, matchers, and confidence scoring

  • Shape Editing Architecture - Defeaturing internals, algorithms, and extension patterns

  • Feature Reverse Engineering - Parametric extraction from recognised features

  • Pattern Detection - Grid and polar pattern detection algorithms

  • Euler Operators - Topological primitives for valid-by-construction model editing

  • Blend Suppression - Euler-operator blend removal and geometry reconstruction