orientation_region
— Ermitteln Orientierung einer Region.
orientation_region
berechnet die Orientierung (Phi
)
der Region. Das Verfahren basiert auf dem Winkel der mit
elliptic_axis
bestimmt wird. Es wird jedoch zusätzlich der
Punkt auf dem Rand mit maximalem Abstand zum Schwerpunkt der Region
bestimmt. Ist dessen Spaltenkoordinate im gedrehten System kleiner als
die Spaltenkoordinate des Schwerpunkts so wird
zu dem Winkel hinzugezählt.
In der Dokumentation zu diesem Kapitel (Regionen / Merkmale) finden Sie ein Bild mit Regionen, die sich in ihrer Orientierung unterscheiden.
Wird mehr als eine Region übergeben, dann werden die Ergebnisse in Tupeln abgespeichert, wobei der Index eines Wertes in dem Tupel dem Index einer Region in der Eingabe entspricht.
Bei leerer Region haben alle Parameter den Wert 0.0, soweit kein
anderes Verhalten eingestellt wurde
(siehe set_system('no_object_result',<Result>)
).
Regions
(input_object) region(-array) →
object
Zu untersuchende Region(en).
Phi
(output_control) angle.rad(-array) →
(real)
Orientierung der Region (Bogenmaß).
Zusicherung: - pi <= Phi && Phi < pi
Sei F die Fläche einer Region, dann beträgt die Laufzeitkomplexität im Mittel O(sqrt(F)).
orientation_region
liefert den Wert 2 (H_MSG_TRUE), falls die Eingabe nicht
leer ist. Das Verhalten bei leerer Eingabe (keine Eingaberegionen vorhanden)
lässt sich mittels set_system('no_object_result',<Result>)
festlegen. Das Verhalten bei einer leeren Region (Region ist die leere Menge)
wird mit set_system('empty_region_result',<Result>)
bestimmt.
Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
threshold
,
regiongrowing
,
connection
elliptic_axis
,
smallest_rectangle2
moments_region_2nd
,
line_orientation
Foundation