vector_field_length
— Berechnung der Länge der Vektoren eines Vektorfeldes.
vector_field_length(VectorField : Length : Mode : )
vector_field_length
berechnet die Länge der Vektoren des in
VectorField
übergebenen Vektorfeldes und gibt sie in
Length
zurück. vector_field_length
akzeptiert nur
Vektorfelder des semantischen Typs 'vector_field_relative'.
Mit Mode
kann die Art der Berechnung der Längen ausgewählt werden.
Für Mode
= 'length' wird die Euklidische Länge der
Vektoren berechnet.
Für Mode
= 'squared_length' wird das Quadrat der
Länge der Vektoren berechnet. Dies vermeidet intern die Berechnung
der Wurzel, was auf vielen Prozessoren eine sehr aufwendige
Operation ist, und spart somit auf diesen Prozessoren Rechenzeit. Es ist
zu beachten, dass das VectorField
in relativen Koordinaten
angegeben werden muss, wie es z.B. optical_flow_mg
liefert.
VectorField
(input_object) singlechannelimage(-array) →
object (vector_field)
Eingabevektorfeld.
Length
(output_object) singlechannelimage(-array) →
object (real)
Länge der Vektoren des Vektorfeldes.
Mode
(input_control) string →
(string)
Modus zur Berechnung der Länge der Vektoren.
Defaultwert: 'length'
Werteliste: 'length' , 'squared_length'
Sind die Parameterwerte korrekt, dann liefert
vector_field_length
den Wert 2 (H_MSG_TRUE). Das Verhalten bei leerer
Eingabe (keine Eingabebilder vorhanden) lässt sich mittels
set_system('no_object_result',<Result>)
festlegen.
Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
Foundation