HALCON Website / HALCON Operator-Referenz / 3D-Matching / Deformierbar Oberflächenbasiert
KlassenKlassenKlassenKlassen | | | | Operatoren

refine_deformable_surface_modelrefine_deformable_surface_modelRefineDeformableSurfaceModelrefine_deformable_surface_modelRefineDeformableSurfaceModelRefineDeformableSurfaceModel (Operator)

Name

refine_deformable_surface_modelrefine_deformable_surface_modelRefineDeformableSurfaceModelrefine_deformable_surface_modelRefineDeformableSurfaceModelRefineDeformableSurfaceModel — Verfeinern der Lage und Deformation eines deformierbaren Oberflächenmodells in einer 3D-Szene.

Signatur

refine_deformable_surface_model( : : DeformableSurfaceModel, ObjectModel3D, RelSamplingDistance, InitialDeformationObjectModel3D, GenParamName, GenParamValue : Score, DeformableSurfaceMatchingResult)

Herror refine_deformable_surface_model(const Hlong DeformableSurfaceModel, const Hlong ObjectModel3D, double RelSamplingDistance, const Hlong InitialDeformationObjectModel3D, const char* GenParamName, const char* GenParamValue, double* Score, Hlong* DeformableSurfaceMatchingResult)

Herror T_refine_deformable_surface_model(const Htuple DeformableSurfaceModel, const Htuple ObjectModel3D, const Htuple RelSamplingDistance, const Htuple InitialDeformationObjectModel3D, const Htuple GenParamName, const Htuple GenParamValue, Htuple* Score, Htuple* DeformableSurfaceMatchingResult)

Herror refine_deformable_surface_model(const HTuple& DeformableSurfaceModel, const HTuple& ObjectModel3D, const HTuple& RelSamplingDistance, const HTuple& InitialDeformationObjectModel3D, const HTuple& GenParamName, const HTuple& GenParamValue, double* Score, Hlong* DeformableSurfaceMatchingResult)

Herror refine_deformable_surface_model(const HTuple& DeformableSurfaceModel, const HTuple& ObjectModel3D, const HTuple& RelSamplingDistance, const HTuple& InitialDeformationObjectModel3D, const HTuple& GenParamName, const HTuple& GenParamValue, HTuple* Score, HTuple* DeformableSurfaceMatchingResult)

HTuple HObjectModel3D::RefineDeformableSurfaceModel(const HDeformableSurfaceModel& DeformableSurfaceModel, const HTuple& RelSamplingDistance, const HObjectModel3D& InitialDeformationObjectModel3D, const HTuple& GenParamName, const HTuple& GenParamValue, HTuple* DeformableSurfaceMatchingResult) const

HTuple HDeformableSurfaceModel::RefineDeformableSurfaceModel(const HObjectModel3D& ObjectModel3D, const HTuple& RelSamplingDistance, const HObjectModel3D& InitialDeformationObjectModel3D, const HTuple& GenParamName, const HTuple& GenParamValue, HTuple* DeformableSurfaceMatchingResult) const

HTuple HDeformableSurfaceMatchingResult::RefineDeformableSurfaceModel(const HDeformableSurfaceModel& DeformableSurfaceModel, const HObjectModel3D& ObjectModel3D, const HTuple& RelSamplingDistance, const HObjectModel3D& InitialDeformationObjectModel3D, const HTuple& GenParamName, const HTuple& GenParamValue)

void RefineDeformableSurfaceModel(const HTuple& DeformableSurfaceModel, const HTuple& ObjectModel3D, const HTuple& RelSamplingDistance, const HTuple& InitialDeformationObjectModel3D, const HTuple& GenParamName, const HTuple& GenParamValue, HTuple* Score, HTuple* DeformableSurfaceMatchingResult)

HTuple HObjectModel3D::RefineDeformableSurfaceModel(const HDeformableSurfaceModel& DeformableSurfaceModel, double RelSamplingDistance, const HObjectModel3D& InitialDeformationObjectModel3D, const HTuple& GenParamName, const HTuple& GenParamValue, HDeformableSurfaceMatchingResultArray* DeformableSurfaceMatchingResult) const

double HObjectModel3D::RefineDeformableSurfaceModel(const HDeformableSurfaceModel& DeformableSurfaceModel, double RelSamplingDistance, const HObjectModel3D& InitialDeformationObjectModel3D, const HString& GenParamName, const HString& GenParamValue, HDeformableSurfaceMatchingResult* DeformableSurfaceMatchingResult) const

double HObjectModel3D::RefineDeformableSurfaceModel(const HDeformableSurfaceModel& DeformableSurfaceModel, double RelSamplingDistance, const HObjectModel3D& InitialDeformationObjectModel3D, const char* GenParamName, const char* GenParamValue, HDeformableSurfaceMatchingResult* DeformableSurfaceMatchingResult) const

HTuple HDeformableSurfaceModel::RefineDeformableSurfaceModel(const HObjectModel3D& ObjectModel3D, double RelSamplingDistance, const HObjectModel3D& InitialDeformationObjectModel3D, const HTuple& GenParamName, const HTuple& GenParamValue, HDeformableSurfaceMatchingResultArray* DeformableSurfaceMatchingResult) const

double HDeformableSurfaceModel::RefineDeformableSurfaceModel(const HObjectModel3D& ObjectModel3D, double RelSamplingDistance, const HObjectModel3D& InitialDeformationObjectModel3D, const HString& GenParamName, const HString& GenParamValue, HDeformableSurfaceMatchingResult* DeformableSurfaceMatchingResult) const

double HDeformableSurfaceModel::RefineDeformableSurfaceModel(const HObjectModel3D& ObjectModel3D, double RelSamplingDistance, const HObjectModel3D& InitialDeformationObjectModel3D, const char* GenParamName, const char* GenParamValue, HDeformableSurfaceMatchingResult* DeformableSurfaceMatchingResult) const

static HTuple HDeformableSurfaceMatchingResult::RefineDeformableSurfaceModel(const HDeformableSurfaceModel& DeformableSurfaceModel, const HObjectModel3D& ObjectModel3D, double RelSamplingDistance, const HObjectModel3D& InitialDeformationObjectModel3D, const HTuple& GenParamName, const HTuple& GenParamValue, HDeformableSurfaceMatchingResultArray* DeformableSurfaceMatchingResult)

double HDeformableSurfaceMatchingResult::RefineDeformableSurfaceModel(const HDeformableSurfaceModel& DeformableSurfaceModel, const HObjectModel3D& ObjectModel3D, double RelSamplingDistance, const HObjectModel3D& InitialDeformationObjectModel3D, const HString& GenParamName, const HString& GenParamValue)

double HDeformableSurfaceMatchingResult::RefineDeformableSurfaceModel(const HDeformableSurfaceModel& DeformableSurfaceModel, const HObjectModel3D& ObjectModel3D, double RelSamplingDistance, const HObjectModel3D& InitialDeformationObjectModel3D, const char* GenParamName, const char* GenParamValue)

void HOperatorSetX.RefineDeformableSurfaceModel(
[in] VARIANT DeformableSurfaceModel, [in] VARIANT ObjectModel3D, [in] VARIANT RelSamplingDistance, [in] VARIANT InitialDeformationObjectModel3D, [in] VARIANT GenParamName, [in] VARIANT GenParamValue, [out] VARIANT* Score, [out] VARIANT* DeformableSurfaceMatchingResult)

VARIANT HObjectModel3DX.RefineDeformableSurfaceModel(
[in] IHDeformableSurfaceModelX* DeformableSurfaceModel, [in] double RelSamplingDistance, [in] IHObjectModel3DX* InitialDeformationObjectModel3D, [in] VARIANT GenParamName, [in] VARIANT GenParamValue, [out] IHDeformableSurfaceMatchingResultX** DeformableSurfaceMatchingResult)

VARIANT HDeformableSurfaceModelX.RefineDeformableSurfaceModel(
[in] IHObjectModel3DX* ObjectModel3D, [in] double RelSamplingDistance, [in] IHObjectModel3DX* InitialDeformationObjectModel3D, [in] VARIANT GenParamName, [in] VARIANT GenParamValue, [out] IHDeformableSurfaceMatchingResultX** DeformableSurfaceMatchingResult)

VARIANT HDeformableSurfaceMatchingResultX.RefineDeformableSurfaceModel(
[in] IHDeformableSurfaceModelX* DeformableSurfaceModel, [in] IHObjectModel3DX* ObjectModel3D, [in] double RelSamplingDistance, [in] IHObjectModel3DX* InitialDeformationObjectModel3D, [in] VARIANT GenParamName, [in] VARIANT GenParamValue)

static void HOperatorSet.RefineDeformableSurfaceModel(HTuple deformableSurfaceModel, HTuple objectModel3D, HTuple relSamplingDistance, HTuple initialDeformationObjectModel3D, HTuple genParamName, HTuple genParamValue, out HTuple score, out HTuple deformableSurfaceMatchingResult)

HTuple HObjectModel3D.RefineDeformableSurfaceModel(HDeformableSurfaceModel deformableSurfaceModel, double relSamplingDistance, HObjectModel3D initialDeformationObjectModel3D, HTuple genParamName, HTuple genParamValue, out HDeformableSurfaceMatchingResult[] deformableSurfaceMatchingResult)

double HObjectModel3D.RefineDeformableSurfaceModel(HDeformableSurfaceModel deformableSurfaceModel, double relSamplingDistance, HObjectModel3D initialDeformationObjectModel3D, string genParamName, string genParamValue, out HDeformableSurfaceMatchingResult deformableSurfaceMatchingResult)

HTuple HDeformableSurfaceModel.RefineDeformableSurfaceModel(HObjectModel3D objectModel3D, double relSamplingDistance, HObjectModel3D initialDeformationObjectModel3D, HTuple genParamName, HTuple genParamValue, out HDeformableSurfaceMatchingResult[] deformableSurfaceMatchingResult)

double HDeformableSurfaceModel.RefineDeformableSurfaceModel(HObjectModel3D objectModel3D, double relSamplingDistance, HObjectModel3D initialDeformationObjectModel3D, string genParamName, string genParamValue, out HDeformableSurfaceMatchingResult deformableSurfaceMatchingResult)

static HTuple HDeformableSurfaceMatchingResult.RefineDeformableSurfaceModel(HDeformableSurfaceModel deformableSurfaceModel, HObjectModel3D objectModel3D, double relSamplingDistance, HObjectModel3D initialDeformationObjectModel3D, HTuple genParamName, HTuple genParamValue, out HDeformableSurfaceMatchingResult[] deformableSurfaceMatchingResult)

double HDeformableSurfaceMatchingResult.RefineDeformableSurfaceModel(HDeformableSurfaceModel deformableSurfaceModel, HObjectModel3D objectModel3D, double relSamplingDistance, HObjectModel3D initialDeformationObjectModel3D, string genParamName, string genParamValue)

Beschreibung

refine_deformable_surface_modelrefine_deformable_surface_modelRefineDeformableSurfaceModelrefine_deformable_surface_modelRefineDeformableSurfaceModelRefineDeformableSurfaceModel verfeinert die in InitialDeformationObjectModel3DInitialDeformationObjectModel3DInitialDeformationObjectModel3DInitialDeformationObjectModel3DInitialDeformationObjectModel3DinitialDeformationObjectModel3D übergebene näherungsweise Lage und Deformation des deformierbaren Oberflächenmodells DeformableSurfaceModelDeformableSurfaceModelDeformableSurfaceModelDeformableSurfaceModelDeformableSurfaceModeldeformableSurfaceModel in der 3D-Szene ObjectModel3DObjectModel3DObjectModel3DObjectModel3DObjectModel3DobjectModel3D. Das deformierbare Oberflächenmodell DeformableSurfaceModelDeformableSurfaceModelDeformableSurfaceModelDeformableSurfaceModelDeformableSurfaceModeldeformableSurfaceModel muss zuvor z.B. mittels create_deformable_surface_modelcreate_deformable_surface_modelCreateDeformableSurfaceModelcreate_deformable_surface_modelCreateDeformableSurfaceModelCreateDeformableSurfaceModel erstellt worden sein. Das 3D-Objektmodell der Szene kann beispielsweise mittels read_object_model_3dread_object_model_3dReadObjectModel3dread_object_model_3dReadObjectModel3dReadObjectModel3d aus einer Datei gelesen worden sein oder mittels xyz_to_object_model_3dxyz_to_object_model_3dXyzToObjectModel3dxyz_to_object_model_3dXyzToObjectModel3dXyzToObjectModel3d erstellt worden sein.

refine_deformable_surface_modelrefine_deformable_surface_modelRefineDeformableSurfaceModelrefine_deformable_surface_modelRefineDeformableSurfaceModelRefineDeformableSurfaceModel ist nützlich wenn die Lage und Deformation eines 3D-Objekts in einer 3D-Szene ungefähr bekannt ist und lediglich verfeinert werden soll.

InitialDeformationObjectModel3DInitialDeformationObjectModel3DInitialDeformationObjectModel3DInitialDeformationObjectModel3DInitialDeformationObjectModel3DinitialDeformationObjectModel3D muss genau so viele Punkte und in der gleichen Reihenfolge enthalten wie das abgetastete Modell, welches mit get_deformable_surface_model_paramget_deformable_surface_model_paramGetDeformableSurfaceModelParamget_deformable_surface_model_paramGetDeformableSurfaceModelParamGetDeformableSurfaceModelParam abgerufen werden kann.

In ScoreScoreScoreScoreScorescore wird eine Bewertung des Ergebnisses zurückgeliefert und im Ergebnishandle DeformableSurfaceMatchingResultDeformableSurfaceMatchingResultDeformableSurfaceMatchingResultDeformableSurfaceMatchingResultDeformableSurfaceMatchingResultdeformableSurfaceMatchingResult die Lage und Deformation. Die Details des Ergebnisses, z.B. das deformierte Modell oder die Lage von Referenzpunkten, können über den Operator get_deformable_surface_matching_resultget_deformable_surface_matching_resultGetDeformableSurfaceMatchingResultget_deformable_surface_matching_resultGetDeformableSurfaceMatchingResultGetDeformableSurfaceMatchingResult abgerufen werden. Das zurückgegebene Ergebnishandle muss mittels clear_deformable_surface_matching_resultclear_deformable_surface_matching_resultClearDeformableSurfaceMatchingResultclear_deformable_surface_matching_resultClearDeformableSurfaceMatchingResultClearDeformableSurfaceMatchingResult freigegeben werden.

Die Bewertung ist zwischen 0 und 1 normalisiert und repräsentiert welcher Anteil der Oberfläche des Modells in der Szene gefunden wurde. Ein Wert von 1 bedeutet dabei ein perfektes Ergebnis, d.h. das gesamte Modell wurde gefunden.

In den Parametern GenParamNameGenParamNameGenParamNameGenParamNameGenParamNamegenParamName und GenParamValueGenParamValueGenParamValueGenParamValueGenParamValuegenParamValue können generische Parameter und deren Werte übergeben werden. Eine genauere Beschreibung der generischen sowie der übrigen Parameter findet sich in der Dokumentation zu find_deformable_surface_modelfind_deformable_surface_modelFindDeformableSurfaceModelfind_deformable_surface_modelFindDeformableSurfaceModelFindDeformableSurfaceModel.

Parallelisierung

Dieser Operator liefert ein Handle zurück. Es ist zu beachten, dass der Zustand einer Instanz dieses Handletyps durch bestimmte Operatoren geändert werden kann, obwohl das Handle als Eingabeparameter in diesen Operatoren verwendet wird.

Parameter

DeformableSurfaceModelDeformableSurfaceModelDeformableSurfaceModelDeformableSurfaceModelDeformableSurfaceModeldeformableSurfaceModel (input_control)  deformable_surface_model → HDeformableSurfaceModel, HTupleHTupleHDeformableSurfaceModel, HTupleHDeformableSurfaceModelX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Handle des deformierbaren Oberflächenmodells.

ObjectModel3DObjectModel3DObjectModel3DObjectModel3DObjectModel3DobjectModel3D (input_control)  object_model_3d → HObjectModel3D, HTupleHTupleHObjectModel3D, HTupleHObjectModel3DX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Handle des 3D-Objektmodells, welches die Szene enthält.

RelSamplingDistanceRelSamplingDistanceRelSamplingDistanceRelSamplingDistanceRelSamplingDistancerelSamplingDistance (input_control)  real → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Abtastdistanz der Szene relativ zum Durchmesser des Oberflächenmodells.

Defaultwert: 0.05

Wertevorschläge: 0.1, 0.07, 0.05, 0.04, 0.03

Restriktion: 0 < RelSamplingDistance < 1

InitialDeformationObjectModel3DInitialDeformationObjectModel3DInitialDeformationObjectModel3DInitialDeformationObjectModel3DInitialDeformationObjectModel3DinitialDeformationObjectModel3D (input_control)  object_model_3d → HObjectModel3D, HTupleHTupleHObjectModel3D, HTupleHObjectModel3DX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Initiale Lage und Deformation des Modells.

GenParamNameGenParamNameGenParamNameGenParamNameGenParamNamegenParamName (input_control)  attribute.name(-array) → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Namen der generischen Parameter.

Defaultwert: []

Werteliste: 'pose_ref_dist_threshold_rel'"pose_ref_dist_threshold_rel""pose_ref_dist_threshold_rel""pose_ref_dist_threshold_rel""pose_ref_dist_threshold_rel""pose_ref_dist_threshold_rel", 'pose_ref_num_steps'"pose_ref_num_steps""pose_ref_num_steps""pose_ref_num_steps""pose_ref_num_steps""pose_ref_num_steps", 'pose_ref_scoring_dist_abs'"pose_ref_scoring_dist_abs""pose_ref_scoring_dist_abs""pose_ref_scoring_dist_abs""pose_ref_scoring_dist_abs""pose_ref_scoring_dist_abs", 'pose_ref_scoring_dist_rel'"pose_ref_scoring_dist_rel""pose_ref_scoring_dist_rel""pose_ref_scoring_dist_rel""pose_ref_scoring_dist_rel""pose_ref_scoring_dist_rel", 'scene_normal_computation'"scene_normal_computation""scene_normal_computation""scene_normal_computation""scene_normal_computation""scene_normal_computation"

GenParamValueGenParamValueGenParamValueGenParamValueGenParamValuegenParamValue (input_control)  attribute.value(-array) → HTupleHTupleHTupleVARIANTHtuple (string / real / integer) (string / double / int / long) (HString / double / Hlong) (char* / double / Hlong) (BSTR / double / Hlong) (char* / double / Hlong)

Werte der generischen Parameter

Defaultwert: []

Wertevorschläge: 'fast'"fast""fast""fast""fast""fast", 'mls'"mls""mls""mls""mls""mls", 0, 1, 10, 25, 50, 0.05, 0.1, 0.25, 0.3, 0.05, 0.03, 0.005

ScoreScoreScoreScoreScorescore (output_control)  real(-array) → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Bewertung der verfeinerten Lage und Deformation.

DeformableSurfaceMatchingResultDeformableSurfaceMatchingResultDeformableSurfaceMatchingResultDeformableSurfaceMatchingResultDeformableSurfaceMatchingResultdeformableSurfaceMatchingResult (output_control)  deformable_surface_matching_result(-array) → HDeformableSurfaceMatchingResult, HTupleHTupleHDeformableSurfaceMatchingResult, HTupleHDeformableSurfaceMatchingResultX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Ergebnishandle der Verfeinerung.

Ergebnis

Wenn alle Parameter korrekt sind liefert refine_deformable_surface_modelrefine_deformable_surface_modelRefineDeformableSurfaceModelrefine_deformable_surface_modelRefineDeformableSurfaceModelRefineDeformableSurfaceModel den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

read_object_model_3dread_object_model_3dReadObjectModel3dread_object_model_3dReadObjectModel3dReadObjectModel3d, xyz_to_object_model_3dxyz_to_object_model_3dXyzToObjectModel3dxyz_to_object_model_3dXyzToObjectModel3dXyzToObjectModel3d, get_object_model_3d_paramsget_object_model_3d_paramsGetObjectModel3dParamsget_object_model_3d_paramsGetObjectModel3dParamsGetObjectModel3dParams, read_deformable_surface_modelread_deformable_surface_modelReadDeformableSurfaceModelread_deformable_surface_modelReadDeformableSurfaceModelReadDeformableSurfaceModel, create_deformable_surface_modelcreate_deformable_surface_modelCreateDeformableSurfaceModelcreate_deformable_surface_modelCreateDeformableSurfaceModelCreateDeformableSurfaceModel, get_deformable_surface_model_paramget_deformable_surface_model_paramGetDeformableSurfaceModelParamget_deformable_surface_model_paramGetDeformableSurfaceModelParamGetDeformableSurfaceModelParam, find_deformable_surface_modelfind_deformable_surface_modelFindDeformableSurfaceModelfind_deformable_surface_modelFindDeformableSurfaceModelFindDeformableSurfaceModel

Nachfolger

get_deformable_surface_matching_resultget_deformable_surface_matching_resultGetDeformableSurfaceMatchingResultget_deformable_surface_matching_resultGetDeformableSurfaceMatchingResultGetDeformableSurfaceMatchingResult, clear_deformable_surface_matching_resultclear_deformable_surface_matching_resultClearDeformableSurfaceMatchingResultclear_deformable_surface_matching_resultClearDeformableSurfaceMatchingResultClearDeformableSurfaceMatchingResult, clear_object_model_3dclear_object_model_3dClearObjectModel3dclear_object_model_3dClearObjectModel3dClearObjectModel3d

Alternativen

find_deformable_surface_modelfind_deformable_surface_modelFindDeformableSurfaceModelfind_deformable_surface_modelFindDeformableSurfaceModelFindDeformableSurfaceModel

Siehe auch

create_deformable_surface_modelcreate_deformable_surface_modelCreateDeformableSurfaceModelcreate_deformable_surface_modelCreateDeformableSurfaceModelCreateDeformableSurfaceModel, find_deformable_surface_modelfind_deformable_surface_modelFindDeformableSurfaceModelfind_deformable_surface_modelFindDeformableSurfaceModelFindDeformableSurfaceModel

Modul

3D Metrology

KlassenKlassenKlassenKlassen | | | | Operatoren
HALCON Operator-Referenz 12.0.2 Copyright © 1996-2016 MVTec Software GmbH