Skip to content

find_symmetries_object_model_3dfind_symmetries_object_model_3dFindSymmetriesObjectModel3dFindSymmetriesObjectModel3dfind_symmetries_object_model_3dT_find_symmetries_object_model_3d🔗

Short description🔗

find_symmetries_object_model_3dfind_symmetries_object_model_3dFindSymmetriesObjectModel3dFindSymmetriesObjectModel3dfind_symmetries_object_model_3dT_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.

Signature🔗

find_symmetries_object_model_3d( object_model_3d ObjectModel3D, string GenParamName, string GenParamValue, out dict SymmetryInfo )find_symmetries_object_model_3d( : : ObjectModel3D, GenParamName, GenParamValue : SymmetryInfo )void FindSymmetriesObjectModel3d( const HTuple& ObjectModel3D, const HTuple& GenParamName, const HTuple& GenParamValue, HTuple* SymmetryInfo )static void HOperatorSet.FindSymmetriesObjectModel3d( HTuple objectModel3D, HTuple genParamName, HTuple genParamValue, out HTuple symmetryInfo )def find_symmetries_object_model_3d( object_model_3d: MaybeSequence[HHandle], gen_param_name: MaybeSequence[str], gen_param_value: MaybeSequence[Union[str, float, int]] ) -> Sequence[HHandle]

def find_symmetries_object_model_3d_s( object_model_3d: MaybeSequence[HHandle], gen_param_name: MaybeSequence[str], gen_param_value: MaybeSequence[Union[str, float, int]] ) -> HHandleHerror T_find_symmetries_object_model_3d( const Htuple ObjectModel3D, const Htuple GenParamName, const Htuple GenParamValue, Htuple* SymmetryInfo )

static HDictArray HObjectModel3D::FindSymmetriesObjectModel3d( const HObjectModel3DArray& ObjectModel3D, const HTuple& GenParamName, const HTuple& GenParamValue )

HDict HObjectModel3D::FindSymmetriesObjectModel3d( const HString& GenParamName, const HString& GenParamValue ) const

HDict HObjectModel3D::FindSymmetriesObjectModel3d( const char* GenParamName, const char* GenParamValue ) const

HDict HObjectModel3D::FindSymmetriesObjectModel3d( const wchar_t* GenParamName, const wchar_t* GenParamValue ) const (Windows only)

static HDict[] HObjectModel3D.FindSymmetriesObjectModel3d( HObjectModel3D[] objectModel3D, HTuple genParamName, HTuple genParamValue )

HDict HObjectModel3D.FindSymmetriesObjectModel3d( string genParamName, string genParamValue )

Description🔗

find_symmetries_object_model_3dFindSymmetriesObjectModel3d analyzes an ObjectModel3DobjectModel3Dobject_model_3d with parameterizable precision.

The generic parameter pair GenParamNamegenParamNamegen_param_name and GenParamValuegenParamValuegen_param_value is used to set additional parameters for the analysis. GenParamNamegenParamNamegen_param_name contains the tuple of parameter names that shall be set and GenParamValuegenParamValuegen_param_value contains the corresponding values. The following values are possible for GenParamNamegenParamNamegen_param_name:

  • 'max_n_gon'"max_n_gon": The maximum number of symmetrical poses that can be found in one plane of rotation before classifying the symmetry as continuous.

    Suggested values: 1515, 2525

    Default: 2121

    Restriction: 22 < 'max_n_gon'"max_n_gon"

If the ObjectModel3DobjectModel3Dobject_model_3d 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.

  • 'symmetry_type'"symmetry_type": This key is always present after successful execution of find_symmetries_object_model_3dFindSymmetriesObjectModel3d. The possible values stored under this key are:

  • 'discrete_poses'"discrete_poses": If 'symmetry_type'"symmetry_type" is 'discrete'"discrete": a tuple of poses that the the ObjectModel3DobjectModel3Dobject_model_3d is invariant to.

  • 'symmetry_center'"symmetry_center": The point inside the ObjectModel3DobjectModel3Dobject_model_3d that is invariant to all symmetrical poses. This key is always present after successful execution of find_symmetries_object_model_3dFindSymmetriesObjectModel3d.

  • 'symmetry_axis'"symmetry_axis": If 'symmetry_type'"symmetry_type" is 'cone'"cone" or 'cylinder'"cylinder", the direction of the 3D line describing the symmetry.

Execution information🔗

Execution information
  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).

  • Multithreading scope: global (may be called from any thread).

  • Automatically parallelized on internal data level.

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.

Parameters🔗

ObjectModel3DobjectModel3Dobject_model_3d (input_control) object_model_3d(-array) → (handle)(handle)HTuple (HHandle)HObjectModel3D, HTuple (IntPtr)MaybeSequence[HHandle]Htuple (handle)

Handle of the ObjectModel3DobjectModel3Dobject_model_3d to be analyzed.

GenParamNamegenParamNamegen_param_name (input_control) string(-array) → (string)(string)HTuple (HString)HTuple (string)MaybeSequence[str]Htuple (char*)

Names of the generic parameters to be set.

Default: [][]
List of values: 'max_n_gon'"max_n_gon"

GenParamValuegenParamValuegen_param_value (input_control) string(-array) → (string / real / integer)(string / real / integer)HTuple (HString / double / Hlong)HTuple (string / double / int / long)MaybeSequence[Union[str, float, int]]Htuple (char* / double / Hlong)

Values of the generic parameters to be set.

Default: [][]
Suggested values: 2121

SymmetryInfosymmetryInfosymmetry_info (output_control) dict(-array) → (handle)(handle)HTuple (HHandle)HDict, HTuple (IntPtr)Sequence[HHandle]Htuple (handle)

Handle of the dictionary containing the symmetry information.

Example🔗

(HDevelop)


* 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)

Result🔗

find_symmetries_object_model_3dFindSymmetriesObjectModel3d returns the described dictionary if all parameters are correct. If necessary, an exception is raised.

Combinations with other operators🔗

Combinations

Possible predecessors

read_object_model_3dReadObjectModel3d

Possible successors

create_deep_matching_3dCreateDeepMatching3d, set_surface_model_paramSetSurfaceModelParam

Module🔗

3D Metrology