set_structured_light_model_paramT_set_structured_light_model_paramSetStructuredLightModelParamSetStructuredLightModelParamset_structured_light_model_param (Operator)

Name

set_structured_light_model_paramT_set_structured_light_model_paramSetStructuredLightModelParamSetStructuredLightModelParamset_structured_light_model_param — Setzen von Parametern eines Modells für strukturiertes Licht.

Signatur

Beschreibung

Der Operator set_structured_light_model_paramset_structured_light_model_paramSetStructuredLightModelParamSetStructuredLightModelParamSetStructuredLightModelParamset_structured_light_model_param wird verwendet, um die Parameter eines Modells für strukturiertes Licht StructuredLightModelStructuredLightModelStructuredLightModelStructuredLightModelstructuredLightModelstructured_light_model zu manipulieren. Die aktuellen Parametereinstellungen können mit dem Operator get_structured_light_model_paramget_structured_light_model_paramGetStructuredLightModelParamGetStructuredLightModelParamGetStructuredLightModelParamget_structured_light_model_param abgefragt werden.

Das Konzept des strukturierten Lichts sowie die unterstützen Anwendungsbereiche werden in der Einleitung des Kapitels Inspektion / Strukturiertes Licht beschrieben.

Allgemeine Parameter:

'persistence'"persistence""persistence""persistence""persistence""persistence":

Aktiviert (GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value='true'"true""true""true""true""true") oder deaktiviert (GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value='false'"false""false""false""false""false") den Modus 'persistence'"persistence""persistence""persistence""persistence""persistence" des Modells für strukturiertes Licht. Im Persistenz-Modus speichert das Modell Zwischenergebnisse der Dekodierung, welche später mit get_structured_light_objectget_structured_light_objectGetStructuredLightObjectGetStructuredLightObjectGetStructuredLightObjectget_structured_light_object inspiziert werden können.

Es ist zu beachten, dass das Modell in diesem Modus signifikanten Speicherplatz benötigen könnte. Deswegen empfehlen wir, den Persistenz-Modus nur während der Einrichtung oder zur Fehlerbehebung zu aktivieren.

Wird der Wert von 'persistence'"persistence""persistence""persistence""persistence""persistence" verändert, werden alle Ergebnisse des Modells gelöscht.

Werte: 'true'"true""true""true""true""true", 'false'"false""false""false""false""false", 1, 0

Defaultwert: 'false'"false""false""false""false""false"

Parameter, die das Erscheinungsbild der Muster-Bilder beeinflussen:

'pattern_width'"pattern_width""pattern_width""pattern_width""pattern_width""pattern_width":

Setzt die Breite der Muster-Bilder, welche durch den Aufruf von gen_structured_light_patterngen_structured_light_patternGenStructuredLightPatternGenStructuredLightPatternGenStructuredLightPatterngen_structured_light_pattern erzeugt werden. Normalerweise sollte 'pattern_width'"pattern_width""pattern_width""pattern_width""pattern_width""pattern_width" der Breite des Monitors entsprechen, der zur Anzeige der Muster-Bilder verwendet wird.

Der Wert von 'pattern_width'"pattern_width""pattern_width""pattern_width""pattern_width""pattern_width" muss größer als 'min_stripe_width'"min_stripe_width""min_stripe_width""min_stripe_width""min_stripe_width""min_stripe_width"/2 sein. Für den Fall, dass 'pattern_type'"pattern_type""pattern_type""pattern_type""pattern_type""pattern_type" auf 'single_stripe'"single_stripe""single_stripe""single_stripe""single_stripe""single_stripe" gesetzt ist, muss 'pattern_width'"pattern_width""pattern_width""pattern_width""pattern_width""pattern_width" zusätzlich größer als 'single_stripe_width'"single_stripe_width""single_stripe_width""single_stripe_width""single_stripe_width""single_stripe_width"/2 sein.

Wird der Wert von 'pattern_width'"pattern_width""pattern_width""pattern_width""pattern_width""pattern_width" verändert, ist das Modell nicht mehr dekodierbar und alle möglicherweise verfügbaren Ergebnisse werden gelöscht. Deshalb muss gen_structured_light_patterngen_structured_light_patternGenStructuredLightPatternGenStructuredLightPatternGenStructuredLightPatterngen_structured_light_pattern aufgerufen werden, bevor das Modell mit decode_structured_light_patterndecode_structured_light_patternDecodeStructuredLightPatternDecodeStructuredLightPatternDecodeStructuredLightPatterndecode_structured_light_pattern dekodiert wird.

Werte: Ganze Zahlen größer oder gleich 1

Defaultwert: 1024

'pattern_height'"pattern_height""pattern_height""pattern_height""pattern_height""pattern_height":

Setzt die Höhe der Muster-Bilder, welche durch den Aufruf von gen_structured_light_patterngen_structured_light_patternGenStructuredLightPatternGenStructuredLightPatternGenStructuredLightPatterngen_structured_light_pattern erzeugt werden. Normalerweise sollte 'pattern_height'"pattern_height""pattern_height""pattern_height""pattern_height""pattern_height" der Höhe des Monitors entsprechen, der zur Anzeige der Muster-Bilder verwendet wird.

Der Wert von 'pattern_height'"pattern_height""pattern_height""pattern_height""pattern_height""pattern_height" muss größer als 'min_stripe_width'"min_stripe_width""min_stripe_width""min_stripe_width""min_stripe_width""min_stripe_width"/2 sein. Für den Fall, dass 'pattern_type'"pattern_type""pattern_type""pattern_type""pattern_type""pattern_type" auf 'single_stripe'"single_stripe""single_stripe""single_stripe""single_stripe""single_stripe" gesetzt ist, muss 'pattern_height'"pattern_height""pattern_height""pattern_height""pattern_height""pattern_height" zusätzlich größer als 'single_stripe_width'"single_stripe_width""single_stripe_width""single_stripe_width""single_stripe_width""single_stripe_width"/2 sein.

Wird der Wert von 'pattern_height'"pattern_height""pattern_height""pattern_height""pattern_height""pattern_height" verändert, ist das Modell nicht mehr dekodierbar und alle möglicherweise verfügbaren Ergebnisse werden gelöscht. Deshalb muss gen_structured_light_patterngen_structured_light_patternGenStructuredLightPatternGenStructuredLightPatternGenStructuredLightPatterngen_structured_light_pattern aufgerufen werden, bevor das Modell mit decode_structured_light_patterndecode_structured_light_patternDecodeStructuredLightPatternDecodeStructuredLightPatternDecodeStructuredLightPatterndecode_structured_light_pattern dekodiert wird.

Werte: Ganze Zahlen größer oder gleich 1

Defaultwert: 1024

'min_stripe_width'"min_stripe_width""min_stripe_width""min_stripe_width""min_stripe_width""min_stripe_width":

Setzt die Breite (in Pixeln) des schmalsten Streifens der Muster Bilder, welche durch den Aufruf von gen_structured_light_patterngen_structured_light_patternGenStructuredLightPatternGenStructuredLightPatternGenStructuredLightPatterngen_structured_light_pattern erzeugt werden.

Der Wert von 'min_stripe_width'"min_stripe_width""min_stripe_width""min_stripe_width""min_stripe_width""min_stripe_width" muss eine Zweierpotenz sein. Außerdem muss 'min_stripe_width'"min_stripe_width""min_stripe_width""min_stripe_width""min_stripe_width""min_stripe_width" kleiner oder gleich dem Minimum der Parameter 'pattern_width'"pattern_width""pattern_width""pattern_width""pattern_width""pattern_width" und 'pattern_height'"pattern_height""pattern_height""pattern_height""pattern_height""pattern_height" sein, nachdem beide bis zur nächsten Zweierpotenz aufgerundet wurden. Für den Fall, dass 'pattern_type'"pattern_type""pattern_type""pattern_type""pattern_type""pattern_type" auf 'single_stripe'"single_stripe""single_stripe""single_stripe""single_stripe""single_stripe" gesetzt ist, muss 'min_stripe_width'"min_stripe_width""min_stripe_width""min_stripe_width""min_stripe_width""min_stripe_width" zusätzlich kleiner oder gleich 'single_stripe_width'"single_stripe_width""single_stripe_width""single_stripe_width""single_stripe_width""single_stripe_width" sein.

Wird der Wert von 'min_stripe_width'"min_stripe_width""min_stripe_width""min_stripe_width""min_stripe_width""min_stripe_width" verändert, ist das Modell nicht mehr dekodierbar und alle möglicherweise verfügbaren Ergebnisse werden gelöscht. Deshalb muss gen_structured_light_patterngen_structured_light_patternGenStructuredLightPatternGenStructuredLightPatternGenStructuredLightPatterngen_structured_light_pattern aufgerufen werden, bevor das Modell mit decode_structured_light_patterndecode_structured_light_patternDecodeStructuredLightPatternDecodeStructuredLightPatternDecodeStructuredLightPatterndecode_structured_light_pattern dekodiert wird.

Werte: Ganzzahlige Zweierpotenzen größer oder gleich 4

Defaultwert: 32

'normalization'"normalization""normalization""normalization""normalization""normalization":

Setzt den Modus der Normalisierung des Modells für strukturiertes Licht. Wenn der Parameter 'normalization'"normalization""normalization""normalization""normalization""normalization" auf 'global'"global""global""global""global""global" gesetzt ist, generiert gen_structured_light_patterngen_structured_light_patternGenStructuredLightPatternGenStructuredLightPatternGenStructuredLightPatterngen_structured_light_pattern zwei zusätzliche Muster-Bilder bestehend aus einem weißen und einem schwarzen Bild. Diese Bilder werden dann während der Dekodierung verwendet, um die eigentliche Muster Region zu ermitteln. Wird stattdessen der Wert 'inverted_pattern'"inverted_pattern""inverted_pattern""inverted_pattern""inverted_pattern""inverted_pattern" gewählt, wird jedes Gray-Code-Bild zusätzlich invertiert und die Muster Region wird, unter Verwendung der Gray-Code-Bilder und ihrer invertierten Version, iterativ segmentiert.

Wird der Wert von 'normalization'"normalization""normalization""normalization""normalization""normalization" verändert, ist das Modell nicht mehr dekodierbar und alle möglicherweise verfügbaren Ergebnisse werden gelöscht. Deshalb muss gen_structured_light_patterngen_structured_light_patternGenStructuredLightPatternGenStructuredLightPatternGenStructuredLightPatterngen_structured_light_pattern aufgerufen werden, bevor das Modell mit decode_structured_light_patterndecode_structured_light_patternDecodeStructuredLightPatternDecodeStructuredLightPatternDecodeStructuredLightPatterndecode_structured_light_pattern dekodiert wird.

Werte: 'global'"global""global""global""global""global", 'inverted_pattern'"inverted_pattern""inverted_pattern""inverted_pattern""inverted_pattern""inverted_pattern"

Defaultwert: 'global'"global""global""global""global""global"

'pattern_orientation'"pattern_orientation""pattern_orientation""pattern_orientation""pattern_orientation""pattern_orientation":

Setzt die Orientierung der Muster-Bilder, welche durch den Aufruf von gen_structured_light_patterngen_structured_light_patternGenStructuredLightPatternGenStructuredLightPatternGenStructuredLightPatterngen_structured_light_pattern erzeugt werden. Wenn der Parameter 'pattern_orientation'"pattern_orientation""pattern_orientation""pattern_orientation""pattern_orientation""pattern_orientation" auf 'both'"both""both""both""both""both" gesetzt ist, werden Muster Bilder mit vertikalen Streifen sowie Muster-Bilder mit horizontalen Streifen erzeugt. Bei 'vertical'"vertical""vertical""vertical""vertical""vertical" bestehen die Muster-Bilder nur aus vertikalen Streifen, wohingegen bei 'horizontal'"horizontal""horizontal""horizontal""horizontal""horizontal" nur horizontale Streifen generiert werden.

Wird der Wert von 'pattern_orientation'"pattern_orientation""pattern_orientation""pattern_orientation""pattern_orientation""pattern_orientation" verändert, ist das Modell nicht mehr dekodierbar und alle möglicherweise verfügbaren Ergebnisse werden gelöscht. Deshalb muss gen_structured_light_patterngen_structured_light_patternGenStructuredLightPatternGenStructuredLightPatternGenStructuredLightPatterngen_structured_light_pattern aufgerufen werden, bevor das Modell mit decode_structured_light_patterndecode_structured_light_patternDecodeStructuredLightPatternDecodeStructuredLightPatternDecodeStructuredLightPatterndecode_structured_light_pattern dekodiert wird.

Werte: 'both'"both""both""both""both""both", 'vertical'"vertical""vertical""vertical""vertical""vertical", 'horizontal'"horizontal""horizontal""horizontal""horizontal""horizontal"

Defaultwert: 'both'"both""both""both""both""both"

'pattern_type'"pattern_type""pattern_type""pattern_type""pattern_type""pattern_type":

Setzt den Typ der Muster-Bilder, welche durch den Aufruf von gen_structured_light_patterngen_structured_light_patternGenStructuredLightPatternGenStructuredLightPatternGenStructuredLightPatterngen_structured_light_pattern erzeugt werden.

'pattern_type'	Erzeugte Bilder
'gray_code'"gray_code""gray_code""gray_code""gray_code""gray_code"	Gray-Code-Bilder
'gray_code_and_phase_shift'"gray_code_and_phase_shift""gray_code_and_phase_shift""gray_code_and_phase_shift""gray_code_and_phase_shift""gray_code_and_phase_shift"	Gray-Code-Bilder und Phasenbilder
'single_stripe'"single_stripe""single_stripe""single_stripe""single_stripe""single_stripe"	Einzelstreifen-Bilder, Gray-Code-Bilder und Phasenbilder

Normalerweise liefert der Typ 'gray_code_and_phase_shift'"gray_code_and_phase_shift""gray_code_and_phase_shift""gray_code_and_phase_shift""gray_code_and_phase_shift""gray_code_and_phase_shift" präzisere Ergebnisse, da die Kombination aus Gray-Code-Bildern und Phasenbildern sub-pixel genaue Koordinaten liefert. Der Typ 'single_stripe'"single_stripe""single_stripe""single_stripe""single_stripe""single_stripe" erhöht die Robustheit im Fall von partiell spiegelnden Oberflächen.

Wird 'pattern_type'"pattern_type""pattern_type""pattern_type""pattern_type""pattern_type" verändert, ist das Modell nicht mehr dekodierbar und alle möglicherweise verfügbaren Ergebnisse werden gelöscht. Deshalb muss gen_structured_light_patterngen_structured_light_patternGenStructuredLightPatternGenStructuredLightPatternGenStructuredLightPatterngen_structured_light_pattern aufgerufen werden, bevor das Modell mit decode_structured_light_patterndecode_structured_light_patternDecodeStructuredLightPatternDecodeStructuredLightPatternDecodeStructuredLightPatterndecode_structured_light_pattern dekodiert wird.

Werte: 'gray_code_and_phase_shift'"gray_code_and_phase_shift""gray_code_and_phase_shift""gray_code_and_phase_shift""gray_code_and_phase_shift""gray_code_and_phase_shift", 'gray_code'"gray_code""gray_code""gray_code""gray_code""gray_code", 'single_stripe'"single_stripe""single_stripe""single_stripe""single_stripe""single_stripe"

Defaultwert: 'gray_code_and_phase_shift'"gray_code_and_phase_shift""gray_code_and_phase_shift""gray_code_and_phase_shift""gray_code_and_phase_shift""gray_code_and_phase_shift"

'single_stripe_width'"single_stripe_width""single_stripe_width""single_stripe_width""single_stripe_width""single_stripe_width":

Legt die Breite (in Pixeln) des Einzelstreifens fest, welcher durch den Aufruf von gen_structured_light_patterngen_structured_light_patternGenStructuredLightPatternGenStructuredLightPatternGenStructuredLightPatterngen_structured_light_pattern mit dem 'pattern_type'"pattern_type""pattern_type""pattern_type""pattern_type""pattern_type" 'single_stripe'"single_stripe""single_stripe""single_stripe""single_stripe""single_stripe" generiert wird.

Der Wert muss von 'single_stripe_width'"single_stripe_width""single_stripe_width""single_stripe_width""single_stripe_width""single_stripe_width" muss eine Zweierpotenz sein und muss größer oder gleich 'min_stripe_width'"min_stripe_width""min_stripe_width""min_stripe_width""min_stripe_width""min_stripe_width" sein. Außerdem muss 'single_stripe_width'"single_stripe_width""single_stripe_width""single_stripe_width""single_stripe_width""single_stripe_width" kleiner oder gleich dem Minimum der Parameter 'pattern_width'"pattern_width""pattern_width""pattern_width""pattern_width""pattern_width" und 'pattern_height'"pattern_height""pattern_height""pattern_height""pattern_height""pattern_height" sein, nachdem beide bis zur nächsten Zweierpotenz aufgerundet wurden.

Beachten Sie, dass der Parameter 'single_stripe_width'"single_stripe_width""single_stripe_width""single_stripe_width""single_stripe_width""single_stripe_width" nur gesetzt werden kann, wenn 'pattern_type'"pattern_type""pattern_type""pattern_type""pattern_type""pattern_type" der Wert 'single_stripe'"single_stripe""single_stripe""single_stripe""single_stripe""single_stripe" zugewiesen wurde. Wird 'pattern_type'"pattern_type""pattern_type""pattern_type""pattern_type""pattern_type" in 'single_stripe'"single_stripe""single_stripe""single_stripe""single_stripe""single_stripe" geändert, wird 'single_stripe_width'"single_stripe_width""single_stripe_width""single_stripe_width""single_stripe_width""single_stripe_width" auf eine Zweierpotenz ungefähr in der Mitte zwischen 'min_stripe_width'"min_stripe_width""min_stripe_width""min_stripe_width""min_stripe_width""min_stripe_width" und dem Minimum von 'pattern_width'"pattern_width""pattern_width""pattern_width""pattern_width""pattern_width" und 'pattern_height'"pattern_height""pattern_height""pattern_height""pattern_height""pattern_height" gesetzt.

Wird 'single_stripe_width'"single_stripe_width""single_stripe_width""single_stripe_width""single_stripe_width""single_stripe_width" verändert, ist das Modell nicht mehr dekodierbar und alle möglicherweise verfügbaren Ergebnisse werden gelöscht. Daher muss gen_structured_light_patterngen_structured_light_patternGenStructuredLightPatternGenStructuredLightPatternGenStructuredLightPatterngen_structured_light_pattern aufgerufen werden, bevor das Modell mit decode_structured_light_patterndecode_structured_light_patternDecodeStructuredLightPatternDecodeStructuredLightPatternDecodeStructuredLightPatterndecode_structured_light_pattern dekodiert wird.

Values: Ganzzahlige Zweierpotenzen größer oder gleich 4

Default: Zweierpotenz ungefähr in der Mitte zwischen dem aktuell gesetzten Wert 'min_stripe_width'"min_stripe_width""min_stripe_width""min_stripe_width""min_stripe_width""min_stripe_width" und 'pattern_width'"pattern_width""pattern_width""pattern_width""pattern_width""pattern_width", 'pattern_height'"pattern_height""pattern_height""pattern_height""pattern_height""pattern_height"

Parameter, welche die Segmentierung der Muster Region beeinflussen:

'min_gray_difference'"min_gray_difference""min_gray_difference""min_gray_difference""min_gray_difference""min_gray_difference":

Setzt die kleinste Grauwertdifferenz für die Gray-Code-Bilder. Dieser Wert wird innerhalb des Operators decode_structured_light_patterndecode_structured_light_patternDecodeStructuredLightPatternDecodeStructuredLightPatternDecodeStructuredLightPatterndecode_structured_light_pattern verwendet, um binarisierte Bilder zu ermitteln. Dadurch wird für jeden Pixel des Kamerabildes die Grauwertdifferenz zwischen belichtetem und unbelichtetem Fall berechnet. Wenn die Grauwertdifferenz eines Pixels kleiner als 'min_gray_difference'"min_gray_difference""min_gray_difference""min_gray_difference""min_gray_difference""min_gray_difference" ist, wird der Pixel von der Domäne der binarisierten Bilder (siehe get_structured_light_objectget_structured_light_objectGetStructuredLightObjectGetStructuredLightObjectGetStructuredLightObjectget_structured_light_object) ausgeschlossen und somit auch von weiteren Berechnungen.

Wenn 'min_gray_difference'"min_gray_difference""min_gray_difference""min_gray_difference""min_gray_difference""min_gray_difference" auf 0 gesetzt wird, ist die segmentierte Region identisch zur Eingaberegion der Kamerabilder, mit dem einzigen Unterschied, dass Pixel mit einem Dekodierergebnis außerhalb der Muster-Bilder ausgeschlossen werden.

Werte: Ganze Zahlen großer oder gleich 0

Defaultwert: 30

Parameter, die das Defektbild beeinflussen:

'derivative_sigma'"derivative_sigma""derivative_sigma""derivative_sigma""derivative_sigma""derivative_sigma":

Setzt das Sigma der Gaußfunktion (d.h. das Ausmaß der Glättung) zur Faltung der Korrespondenzbilder, um das Defektbild zu berechnen.

Werte: Gleitkommazahlen oder ganze Zahlen größer oder gleich 0.01

Defaultwert: 2

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.

Dieser Operator modifiziert den Zustand des folgenden Eingabeparameters:

• StructuredLightModelStructuredLightModelStructuredLightModelStructuredLightModelstructuredLightModelstructured_light_model

Während der Ausführung dieses Operators muss der Zugriff auf den Wert dieses Parameters synchronisiert werden, wenn er über mehrere Threads hinweg verwendet wird.

Parameter

Beispiel (HDevelop)

* Create the model
create_structured_light_model ('deflectometry', StructuredLightModel)
* Set the size of the monitor
set_structured_light_model_param (StructuredLightModel, \
                                  'pattern_width', 1600)
set_structured_light_model_param (StructuredLightModel, \
                                  'pattern_height', 1200)
* Set the smallest width of the stripes in the pattern
set_structured_light_model_param (StructuredLightModel, \
                                  'min_stripe_width', 8)
* Generate the patterns to project
gen_structured_light_pattern (PatternImages, StructuredLightModel)
* Set the expected black/white contrast in the region of interest
set_structured_light_model_param (StructuredLightModel, \
                                  'min_gray_difference', 70)
* Decode the camera images
decode_structured_light_pattern (CameraImages, StructuredLightModel)
* Get the computed correspondences and defects
get_structured_light_object (CorrespondenceImages, StructuredLightModel, \
                             'correspondence_image')
set_structured_light_model_param (StructuredLightModel, 'derivative_sigma', \
                                  Sigma)
get_structured_light_object (DefectImage, StructuredLightModel, \
                             'defect_image')

Ergebnis

Der Operator set_structured_light_model_paramset_structured_light_model_paramSetStructuredLightModelParamSetStructuredLightModelParamSetStructuredLightModelParamset_structured_light_model_param gibt 2 (H_MSG_TRUE) zurück, sofern alle Parameter korrekt sind. Andernfalls wird eine Fehlerbehandlung ausgelöst.

Vorgänger

create_structured_light_modelcreate_structured_light_modelCreateStructuredLightModelCreateStructuredLightModelCreateStructuredLightModelcreate_structured_light_model

Siehe auch

get_structured_light_model_paramget_structured_light_model_paramGetStructuredLightModelParamGetStructuredLightModelParamGetStructuredLightModelParamget_structured_light_model_param

Modul

3D Metrology