roundness
— Ermitteln der Formfaktoren aus der Kontur.
roundness
untersucht den Abstand der Kontur
vom Schwerpunkt der Fläche. Im einzelnen wird der mittlere
Abstand (Distance
), die Abweichung vom mittleren
Abstand (Sigma
) und zwei daraus
abgeleitete Formmerkmale bestimmt.
Roundness
ist das Verhältnis von Mittelwert zu Standardabweichung
und Sides
gibt die Anzahl der Polygonstücke an,
falls es sich um ein regelmäßiges Polygon handelt.
In der Dokumentation zu diesem Kapitel (Regionen / Merkmale) finden
Sie ein Bild mit Regionen, die sich in ihrem mittleren Abstand, der Abweichung
vom mittleren Abstand, der Roundness
und den Sides
unterscheiden.
Die Kontur zur Berechnung der Merkmale wird in Abhängigkeit von der globalen
Nachbarschaft bestimmt (siehe set_system
).
Berechnung:
Sei p der Flächenschwerpunkt, die Punkte und F die Fläche der Kontur.
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
).
Regions
(input_object) region(-array) →
object
Zu untersuchende Region(en).
Distance
(output_control) real(-array) →
(real)
Mittlerer Abstand vom Schwerpunkt.
Zusicherung: Distance >= 0.0
Sigma
(output_control) real(-array) →
(real)
Standardabweichung von Distance
.
Zusicherung: Sigma >= 0.0
Roundness
(output_control) real(-array) →
(real)
Formfaktor für Rundheit.
Zusicherung: Roundness <= 1.0
Sides
(output_control) real(-array) →
(real)
Anzahl der Polygonseiten.
Zusicherung: Sides >= 0
Sei F die Fläche einer Region, dann beträgt die Laufzeitkomplexität im Mittel O(sqrt(F)).
roundness
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
R. Haralick, L. Shapiro „Computer and Robot Vision“ Addison-Wesley, 1992, pp. 61
Foundation