Skip to content

Manifold extraction (manifold_extraction)

Makes the boundary of a tagged selection of a triangle (2D) or tet (3D) mesh manifold: around each of its non-manifold vertices and edges it carves an offset of the given radius and fills it with fill_tags (ambient by default).

Tutorial · Spec source · Defaults · JSON Schema

Required

application

string · required · one of manifold_extraction

Application name must be manifold_extraction.

input

string · required

Input mesh, .msh: a tagged triangle (2D) or tet (3D) mesh. Its triangle block is tagged faces (2D: its edge block, tagged edges), its edge block in 3D feature curves, its point block input points, as tetwild, triwild and simwild write them: each carried through the carving, which only splits, and written back as the same block of the result. In 3D they are held as topological_offset holds them -- the tagged faces in their labels' envelopes, the feature curves in their tubes, the points anchored; in 2D nothing moves them and nothing holds them. Until 2026-11 they were refused.

Key options

output

string · default "out"

Output file name (without extension).

tag_selection

string · default "tag_0"

Tag selection, the boundary of which is taken to be the input surface to make manifold. An expression of tags: names, &, |, ! and parentheses.

fill_tags

list of string · default []

Tag set to fill non-manifold offsets with. [] for ambient.

Each entry: A tag.

radius_rel

float · default 0.01

Radius to offset around non manifold components, relative to bounding box diagonal.

radius

float · default -1.0

Radius to offset around non manifold components. If < 0, this is set by radius_rel

write_surface

bool · default false

Write the output surface (OBJ) after manifold extraction.

Other options

save_vtu

bool · default false

Save .vtu of output mesh

envelope

string · default ""

The envelope of a tagged mesh input: on the memory route the name of an input mesh, on the file route the path of a mesh file, relative to input_dir as the input is -- the envelope tetwild, triwild and simwild return (outputs["envelope"]) and write (<output>_envelope.msh), labelled by the tags it holds. In 3D a labelled envelope is a reference, held to as topological_offset holds one: the run throws for a label the held faces carry that it lacks, and for a held face received outside its labels' envelopes, before anything is carved; the envelopes' half-width is the offset's default, 1e-3 of the bounding box diagonal (topological_offset's envelope_size_rel), so a mesh a sender held to a wider eps is refused. It is returned with the faces the carving made added, each between a carved cell and the rest and under the labels of the regions it separates -- new geometry, its own reference (on the file route <output>_envelope.msh) -- so that a chain keeps passing the first component's input on to the components after it. Until 2026-11 it was carried unchanged in 3D too, and a later simwild refused the carved faces outside it. In 2D it is carried, returned unchanged, while the extraction builds its envelopes around the mesh it receives. Its triangles (2D: segments) stand for the input's EnvelopeSurface group, which it cannot be combined with.

Run control

input_dir

string · default ""

Directory where the input files are located. This is injected by the application and should not be set by the user.

log_file

string · default ""

Logs are not just printed on the terminal but also saved in this file.

report

string · default ""

A JSON file that stores information about the result and the method execution, e.g., runtime.

throw_on_fail

bool · default false

Throw if the output has vertices that could not be rounded (their exact positions have no float64 representation). Without it, the run logs an error and returns: on the memory route the exact positions are in the mesh's V_rational; a written .msh holds their rounding only.

Debug options

Diagnostics: slow checks and extra output files. (1)

DEBUG_output · bool · default false

Write the tet mesh as out_{}.vtu after every operation.