get_deformable_model_paramsT_get_deformable_model_paramsGetDeformableModelParamsGetDeformableModelParamsget_deformable_model_params (Operator)
Name
get_deformable_model_paramsT_get_deformable_model_paramsGetDeformableModelParamsGetDeformableModelParamsget_deformable_model_params — Auslesen der Parameter eines 3D-Formmodells.
Signatur
def get_deformable_model_params(model_id: HHandle, gen_param_name: MaybeSequence[str]) -> Sequence[Union[int, str, float]]
def get_deformable_model_params_s(model_id: HHandle, gen_param_name: MaybeSequence[str]) -> Union[int, str, float]
Beschreibung
Der Operator get_deformable_model_paramsget_deformable_model_paramsGetDeformableModelParamsGetDeformableModelParamsget_deformable_model_params erlaubt es die Parameter
eines deformierbaren Modells zu ermitteln. Die Namen der gewünschten
Parameter werden als generische Parameter in GenParamNameGenParamNameGenParamNamegenParamNamegen_param_name übergeben
und die korrespondierenden Werte in GenParamValueGenParamValueGenParamValuegenParamValuegen_param_value zurückgegeben.
Die folgenden Parameter können ermittelt werden:
- 'cam_param'"cam_param""cam_param""cam_param""cam_param":
-
Interne Parameter der Kamera, die für den kalibrierten Fall verwendet wird.
- 'cam_param_rect'"cam_param_rect""cam_param_rect""cam_param_rect""cam_param_rect":
-
Rektifizierte interne Parameter der Kamera, die für den kalibrierten Fall
verwendet wird.
- 'reference_pose'"reference_pose""reference_pose""reference_pose""reference_pose":
-
Die Referenzposition und Orientierung des kalibrierten, deformierbaren
Modells. Die zurückgelieferte Position beschreibt die Ebene in der das
Model liegt, das der Benutzer übergeben hat.
- 'model_pose'"model_pose""model_pose""model_pose""model_pose":
-
Referenzposition und Orientierung des deformierbaren Modells. Die
zurückgelieferte Position beschreibt die Position des internen verwendeten
metrischen 3D Modells, das für die Modellgenerierung verwendet wird. Die
Pose bezieht sich dabei auf den Schwerpunkt des Modells, falls der
Referenzpunkt nicht explizit mit set_deformable_model_originset_deformable_model_originSetDeformableModelOriginSetDeformableModelOriginset_deformable_model_origin
gesetzt wurde.
- 'angle_start'"angle_start""angle_start""angle_start""angle_start":
-
Der kleinste Rotationswinkel des Modells.
- 'angle_extent'"angle_extent""angle_extent""angle_extent""angle_extent":
-
Die Ausdehnung des Winkelbereichs des Modells.
- 'angle_step'"angle_step""angle_step""angle_step""angle_step":
-
Schrittweite der Winkel (Auflösung) des Modells.
- 'scale_r_min'"scale_r_min""scale_r_min""scale_r_min""scale_r_min":
-
Kleinste auftretende Skalierung des Musters in Zeilenrichtung.
- 'scale_r_max'"scale_r_max""scale_r_max""scale_r_max""scale_r_max":
-
Größte auftretende Skalierung des Musters in Zeilenrichtung.
- 'scale_r_step'"scale_r_step""scale_r_step""scale_r_step""scale_r_step":
-
Schrittweite der Skalierung (Auflösung) in Zeilenrichtung.
- 'scale_c_min'"scale_c_min""scale_c_min""scale_c_min""scale_c_min":
-
Kleinste auftretende Skalierung des Musters in Spaltenrichtung.
- 'scale_c_max'"scale_c_max""scale_c_max""scale_c_max""scale_c_max":
-
Größte auftretende Skalierung des Musters in Spaltenrichtung.
- 'scale_c_step'"scale_c_step""scale_c_step""scale_c_step""scale_c_step":
-
Schrittweite der Skalierung (Auflösung) in Spaltenrichtung.
- 'num_levels'"num_levels""num_levels""num_levels""num_levels":
-
Maximale Anzahl der Pyramidenebenen.
- 'optimization'"optimization""optimization""optimization""optimization":
-
Art der Optimierung der Modellgenerierung.
- 'min_size'"min_size""min_size""min_size""min_size":
-
Minimale Größe der Kanten eines Modells.
- 'min_contrast'"min_contrast""min_contrast""min_contrast""min_contrast":
-
Minimaler Kontrast der Objekte im Suchbild.
- 'metric'"metric""metric""metric""metric":
-
Das verwendete Ähnlichkeitsmaß.
- 'model_row'"model_row""model_row""model_row""model_row":
-
Zeilenkoordinate des Ursprungs im radial entzerrten Modellbild.
- 'model_col'"model_col""model_col""model_col""model_col":
-
Spaltenkoordinate des Ursprungs im radial entzerrten Modellbild.
- 'model_type'"model_type""model_type""model_type""model_type":
-
Die Art des Modells: 'planar_uncalib'"planar_uncalib""planar_uncalib""planar_uncalib""planar_uncalib", 'planar_calib'"planar_calib""planar_calib""planar_calib""planar_calib"
oder 'local'"local""local""local""local".
- 'created_from_xld'"created_from_xld""created_from_xld""created_from_xld""created_from_xld":
-
Wurde das Model aus XLD erzeugt oder aus einem Bild:
'created_from_xld'"created_from_xld""created_from_xld""created_from_xld""created_from_xld" oder 'created_from_image'"created_from_image""created_from_image""created_from_image""created_from_image".
- 'get_deformable_model_contours_coord_system'"get_deformable_model_contours_coord_system""get_deformable_model_contours_coord_system""get_deformable_model_contours_coord_system""get_deformable_model_contours_coord_system":
-
Koordinatensystem ('image'"image""image""image""image" oder 'world'"world""world""world""world"), in dem
die Konturen beim Aufruf des Operators
get_deformable_model_contoursget_deformable_model_contoursGetDeformableModelContoursGetDeformableModelContoursget_deformable_model_contours zurückgegeben werden.
Eine detaillierte Beschreibung der Parameter kann bei dem Operator
create_planar_uncalib_deformable_modelcreate_planar_uncalib_deformable_modelCreatePlanarUncalibDeformableModelCreatePlanarUncalibDeformableModelcreate_planar_uncalib_deformable_model und
create_planar_calib_deformable_modelcreate_planar_calib_deformable_modelCreatePlanarCalibDeformableModelCreatePlanarCalibDeformableModelcreate_planar_calib_deformable_model oder bei
get_deformable_model_contoursget_deformable_model_contoursGetDeformableModelContoursGetDeformableModelContoursget_deformable_model_contours gefunden werden.
Obwohl der Parameter ContrastContrastContrastcontrastcontrast bei der Erstellung des Modells
automatisch bestimmt werden kann, ist es nicht möglich, seinen Wert mit
dem Operator get_deformable_model_paramsget_deformable_model_paramsGetDeformableModelParamsGetDeformableModelParamsget_deformable_model_params abzufragen.
Stattdessen soll der Operator determine_deformable_model_paramsdetermine_deformable_model_paramsDetermineDeformableModelParamsDetermineDeformableModelParamsdetermine_deformable_model_params
verwendet werden, um seinen Wert abzufragen.
Es ist möglich, mehrere Parameterwerte durch einen Operatoraufruf abzufragen,
indem ein Tupel von Namen aller gewünschten Parameter in
GenParamNameGenParamNameGenParamNamegenParamNamegen_param_name übergeben wird. Als Ergebnis wird ein Tupel der
gleichen Länge in GenParamValueGenParamValueGenParamValuegenParamValuegen_param_value zurückgeliefert. Es ist zu
beachten das dies nur für Parameter möglich ist, die nur einen
Rückgabeparameter haben.
Ausführungsinformationen
- Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
- Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
- Wird ohne Parallelisierung verarbeitet.
Parameter
ModelIDModelIDModelIDmodelIDmodel_id (input_control) deformable_model → HDeformableModel, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle des Modells.
GenParamNameGenParamNameGenParamNamegenParamNamegen_param_name (input_control) attribute.name(-array) → HTupleMaybeSequence[str]HTupleHtuple (string) (string) (HString) (char*)
Namen der generischen Parameter, die für
das deformierbare Modell abgefragt werden sollen.
Default:
'angle_start'
"angle_start"
"angle_start"
"angle_start"
"angle_start"
Werteliste:
'angle_extent'"angle_extent""angle_extent""angle_extent""angle_extent", 'angle_start'"angle_start""angle_start""angle_start""angle_start", 'angle_step'"angle_step""angle_step""angle_step""angle_step", 'cam_param'"cam_param""cam_param""cam_param""cam_param", 'cam_param_rect'"cam_param_rect""cam_param_rect""cam_param_rect""cam_param_rect", 'created_from_xld'"created_from_xld""created_from_xld""created_from_xld""created_from_xld", 'get_deformable_model_contours_coord_system'"get_deformable_model_contours_coord_system""get_deformable_model_contours_coord_system""get_deformable_model_contours_coord_system""get_deformable_model_contours_coord_system", 'metric'"metric""metric""metric""metric", 'min_contrast'"min_contrast""min_contrast""min_contrast""min_contrast", 'min_size'"min_size""min_size""min_size""min_size", 'model_col'"model_col""model_col""model_col""model_col", 'model_pose'"model_pose""model_pose""model_pose""model_pose", 'model_row'"model_row""model_row""model_row""model_row", 'model_type'"model_type""model_type""model_type""model_type", 'num_levels'"num_levels""num_levels""num_levels""num_levels", 'optimization'"optimization""optimization""optimization""optimization", 'reference_pose'"reference_pose""reference_pose""reference_pose""reference_pose", 'scale_c_max'"scale_c_max""scale_c_max""scale_c_max""scale_c_max", 'scale_c_min'"scale_c_min""scale_c_min""scale_c_min""scale_c_min", 'scale_c_step'"scale_c_step""scale_c_step""scale_c_step""scale_c_step", 'scale_r_max'"scale_r_max""scale_r_max""scale_r_max""scale_r_max", 'scale_r_min'"scale_r_min""scale_r_min""scale_r_min""scale_r_min", 'scale_r_step'"scale_r_step""scale_r_step""scale_r_step""scale_r_step"
GenParamValueGenParamValueGenParamValuegenParamValuegen_param_value (output_control) attribute.name(-array) → HTupleSequence[Union[int, str, float]]HTupleHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double)
Werte der generischen Parameter.
Ergebnis
Sind die Parameterwerte korrekt, dann liefert
get_deformable_model_paramsget_deformable_model_paramsGetDeformableModelParamsGetDeformableModelParamsget_deformable_model_params den Wert 2 (
H_MSG_TRUE)
. Gegebenenfalls
wird eine Fehlerbehandlung durchgeführt.
Vorgänger
create_planar_uncalib_deformable_modelcreate_planar_uncalib_deformable_modelCreatePlanarUncalibDeformableModelCreatePlanarUncalibDeformableModelcreate_planar_uncalib_deformable_model,
create_planar_calib_deformable_modelcreate_planar_calib_deformable_modelCreatePlanarCalibDeformableModelCreatePlanarCalibDeformableModelcreate_planar_calib_deformable_model,
create_local_deformable_modelcreate_local_deformable_modelCreateLocalDeformableModelCreateLocalDeformableModelcreate_local_deformable_model
Nachfolger
find_planar_uncalib_deformable_modelfind_planar_uncalib_deformable_modelFindPlanarUncalibDeformableModelFindPlanarUncalibDeformableModelfind_planar_uncalib_deformable_model,
find_planar_calib_deformable_modelfind_planar_calib_deformable_modelFindPlanarCalibDeformableModelFindPlanarCalibDeformableModelfind_planar_calib_deformable_model
Siehe auch
set_deformable_model_paramset_deformable_model_paramSetDeformableModelParamSetDeformableModelParamset_deformable_model_param
Modul
Matching