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