docs / capabilities / Mesh to editable B-rep features

Mesh to editable B-rep features

mesh_to_features takes an STL, OBJ, or 3MF of a mostly prismatic mechanical part and emits an editable .kcad.ts script. The script builds kernelCAD B-rep features such as extrusions, revolves, holes, pockets, and constant-radius fillets; this is not direct recovery of arbitrary analytic or NURBS surfaces from a scan.

The tool checks the input mesh, segments planar and cylindrical regions, fits profiles, evaluates the emitted script, and compares the result with the source mesh. Its report includes volume IoU, maximum and RMS surface deviation, a faithful, approximate, or failed verdict, thresholds, refinement passes, and unmatched regions. Each value is for the supplied mesh; there is no single deviation number that applies to every input.

The current path targets mostly prismatic parts. Freeform surfaces, tilted planes, and side bosses can be returned as unmatched regions instead of being silently omitted. Variable-radius blends and chamfers are reported rather than forced. The input mesh is not modified.

An analytic mesh-to-primitive fitter with a separate measured fit contract is not part of this source snapshot. Do not treat the editable feature reconstruction as a general mesh-to-exact-B-rep converter.