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.