find_symmetries_object_model_3d — find_symmetries_object_model_3d detects symmetries of a 3D model with
parameterizable accuracy and return them in form of a dictionary.
find_symmetries_object_model_3d( : : ObjectModel3D, GenParamName, GenParamValue : SymmetryInfo)
find_symmetries_object_model_3d analyzes an
ObjectModel3D with parameterizable precision.
The generic parameter pair GenParamName and GenParamValue
is used to set additional parameters for the analysis.
GenParamName contains the tuple of parameter names that shall be
set and GenParamValue contains the corresponding values.
The following values are possible for GenParamName:
The maximum number of symmetrical poses that can be found in one plane of rotation before classifying the symmetry as continuous.
Suggested values: 15, 25
Default: 21
Restriction: 2 < 'max_n_gon'
If the ObjectModel3D handle is valid and triangles or polygons
are present, a dictionary describing the found symmetric properties
of the model is returned. After successful execution, the dictionary
contains a selection of the following entries.
This key is always present
after successful execution of
find_symmetries_object_model_3d. The possible values
stored under this key are:
No symmetries were found
for the given ObjectModel3D.
A set of discrete symmetries was found.
The ObjectModel3D has the
symmetry class of a cone, being rotationally invariant around
a 3D line.
The ObjectModel3D has the
symmetry class of a cylinder, being rotationally invariant around a 3D
line additionally to a flip around the center of symmetry perpendicular
to the line.
The ObjectModel3D has the
symmetry class of a sphere.
If 'symmetry_type' is
'discrete': a tuple of poses that the the
ObjectModel3D is invariant to.
The point inside the ObjectModel3D that is invariant to all
symmetrical poses. This key is always present after successful execution of
find_symmetries_object_model_3d.
If 'symmetry_type' is 'cone' or 'cylinder', the direction of the 3D line describing the symmetry.
This operator returns a handle. Note that the state of an instance of this handle type may be changed by specific operators even though the handle is used as an input parameter by those operators.
ObjectModel3D (input_control) object_model_3d(-array) → (handle)
Handle of the ObjectModel3D to be analyzed.
GenParamName (input_control) string(-array) → (string)
Names of the generic parameters to be set.
Default: []
List of values: 'max_n_gon'
GenParamValue (input_control) string(-array) → (string / real / integer)
Values of the generic parameters to be set.
Default: []
Suggested values: 21
SymmetryInfo (output_control) dict(-array) → (handle)
Handle of the dictionary containing the symmetry information.
* Example on how to use find_symmetries_object_model_3d to analyze the symmetry of an object_model_3d.
read_object_model_3d ('tile_spacer', 'm', [], [], ObjectModel3D, Status)
find_symmetries_object_model_3d (ObjectModel3D, [], [], SymmetryInfo)
find_symmetries_object_model_3d returns the described dictionary
if all parameters are correct. If necessary, an exception is raised.
create_deep_matching_3d,
set_surface_model_param
3D Metrology