Image Simulation
/ (object)
/
Description
FIXME: Missing documentation in the specification.Required
/application (string)
/application
Description
Application name must be image_simulation.Options: ['image_simulation']
/input (list)
/input
Description
List of triangular input meshes./input/* (string)
/input/*
Description
Triangular input mesh.Optional
/operation (string)
/operation
Description
Image simulation contains multiple operations for modifying the image. Depending on the operation, more parameters might be required.Default: 'remeshing'
Options: ['remeshing', 'fill_holes_topo', 'tight_seal_topo', 'keep_lcc', 'resolve_intersections', 'replace_tags', 'tag_priority']
/output (string)
/output
Description
Output file name (without extension).Default: 'out'
/input_names (list)
/input_names
Description
List of names for the input meshes. If no names are assigned, the meshes will be named tag_0, tag_1, etc./input_names/* (string)
/input_names/*
Description
Name for one input mesh./input_transform (list)
/input_transform
Description
Transformation matrices for the inputs. Transformations are optional and don’t need to be described for all inputs./input_transform/* (list)
/input_transform/*
Description
Transformation matrix (4x4 homogeneous coordinates) for one input./input_transform/*/*
/input_transform/*/*
Description
FIXME: Missing documentation in the specification.Description
FIXME: Missing documentation in the specification./input_dir (string)
/input_dir
Description
Directory where the input files are located. This is injected by the application and should not be set by the user.Default: ''
/skip_simplify (bool)
/skip_simplify
Description
If true, input simplification will be skipped.Default: False
/use_sample_envelope (bool)
/use_sample_envelope
Description
Use sample envelope instead of exact one.Default: False
/num_threads (int)
/num_threads
Description
Number of threads used by the applicationDefault: 0
/max_iterations (int)
/max_iterations
Description
Maximum iterations before stopping.Default: 80
/eps_rel (float)
/eps_rel
Description
Envelope thickness relative to the bounding boxDefault: 0.002
/eps (float)
/eps
Description
Absolute envelope thickness. If this value is negative, the relative envelope thickness is used to compute the absolute one.Default: -1
/eps_simplify_rel (float)
/eps_simplify_rel
Description
Envelope thickness relative to the bounding box for the initial simplification.Default: 0.0002
/eps_simplify (float)
/eps_simplify
Description
Absolute envelope thickness for the initial simplification. If this value is negative, the relative envelope thickness is used to compute the absolute one.Default: -1
/length (float)
/length
Description
Absolute target edge length. If this value is negative, the relative length is used to compute the absolute one.Default: -1
/length_rel (float)
/length_rel
Description
Target edge length relative to the bounding boxDefault: 0.05
/length_region (list)
/length_region
Description
Prescribe a length for a specific region defined by tags. The length can be absolute (length) or relative (length_rel). The smallest prescibed length will be used for each region./length_region/* (object)
/length_region/*
Description
A region and its target length.Required
/length_region/*/tags (string)
/length_region/*/tags
Description
A region of tags.Optional
/length_region/*/length (float)
/length_region/*/length
Description
Absolute target edge length for the region.Default: -1
/length_region/*/length_rel (float)
/length_region/*/length_rel
Description
Relative target edge length for the region.Default: 0.05
/stop_energy (float)
/stop_energy
Description
Target energy. If all tets have an energy below this, tetwild will stop.Default: 10
/stop_at_float (bool)
/stop_at_float
Description
Stop when all vertices are in floating point precision, i.e., no more rational numbers are needed. stop_energy will be ignored when this is true.Default: False
/preserve_topology (bool)
/preserve_topology
Description
Preserve topology of input.Default: True
/w_amips (float)
/w_amips
Description
AMIPS energyDefault: 0.0001
Range: [0, 1]
/write_vtu (bool)
/write_vtu
Description
Write not just MSH but also VTU output.Default: False
/write_envelope (bool)
/write_envelope
Description
Save the envelope in the MSH output (as a separate physical group with tag ‘envelope’).Default: True
/log_file (string)
/log_file
Description
Logs are not just printed on the terminal but also saved in this file.Default: ''
/report (string)
/report
Description
A JSON file that stores information about the result and the method execution, e.g., runtime.Default: ''
/DEBUG_output (bool)
/DEBUG_output
Description
Write the mesh as debug_{}.vtu after every operation.Default: False
/DEBUG_sanity_checks (bool)
/DEBUG_sanity_checks
Description
Perform sanity checks after every operation. This can be very slow and should only be used for debugging.Default: False
/fill_holes_tags (list)
/fill_holes_tags
Description
For fill_holes_topo: list of tag values used to fill enclosed connected components (processed in order)./fill_holes_tags/* (string)
/fill_holes_tags/*
Description
An intersection of tag values to fill holes./fill_holes_threshold (float)
/fill_holes_threshold
Description
For fill_holes_topo: only fill a connected component if its area is less than this threshold. Negative value means no threshold (fill all enclosed components).Default: -1
/tight_seal_tag_sets (list)
/tight_seal_tag_sets
Description
For tight_seal_topo: list of tag sets. Each inner list defines a group of tags whose enclosed holes are filled, e.g. [[1,2],[3]]./tight_seal_tag_sets/* (list)
/tight_seal_tag_sets/*
Description
One tag set: a list of tag values that are treated as a group for hole filling./tight_seal_tag_sets/*/* (string)
/tight_seal_tag_sets/*/*
Description
An intersection of tags./tight_seal_threshold (float)
/tight_seal_threshold
Description
For tight_seal_topo: only fill a hole cluster if its total area is less than this threshold. Negative value means no threshold.Default: -1
/keep_lcc_tags (list)
/keep_lcc_tags
Description
For keep_lcc: list of tag values for which only the largest connected component is kept./keep_lcc_tags/* (string)
/keep_lcc_tags/*
Description
An intersection of tags whose smaller connected components will be removed./keep_lcc_num (int)
/keep_lcc_num
Description
Number of largest connected components that are kept. By default, only the largest one is kept.Default: 1
/resolve_intersections_tags (list)
/resolve_intersections_tags
Description
Resolve intersections between tags by filling the areas with intersections with the nearest of the intersecting tags./resolve_intersections_tags/* (string)
/resolve_intersections_tags/*
Description
An intersection of two tags/replace_tags_in (list)
/replace_tags_in
Description
Replace the tags by the output tags./replace_tags_in/* (string)
/replace_tags_in/*
Description
An intersection of tags that should be replaced./replace_tags_out (list)
/replace_tags_out
Description
The output tags (written as intersection) that should replace the input tags. For each input tag, an output tag must be provided. The order of the output tags should correspond to the order of the input tags./replace_tags_out/* (string)
/replace_tags_out/*
Description
An intersection of tags that should replace the input tags./tag_priority (list)
/tag_priority
Description
List of tags for the tag_priority operation. Tags earlier in the list have higher priority./tag_priority/* (string)
/tag_priority/*
Description
A tag value./tags_selection (string)
/tags_selection
Description
A boolean expression that defines the input selection for intent operations._ represents empty tags.
Default: '_ | !_'