compactness — Ermitteln des Formfaktors für die Kompaktheit einer Region.
compactness(Regions : : : Compactness)
compactness berechnet die Kompaktheit der Eingaberegionen.
Sei L die Länge der Kontur (siehe
contlength) und F die Fläche der Region, dann ist der
Formfaktor C definiert als:
C = max(1,C')
Der Formfaktor C ist bei einem Kreis gleich 1. Ist die Region langgestreckt
oder hat sie Hohlflächen, dann ist C größer als 1.
compactness spricht auf den Verlauf der Kontur (Rauhigkeit)
und auf Hohlflächen an. Der Wert von C wird auf größer als 1 beschränkt,
weil die Pixel-Fläche einer Region nur eine Approximation der Fläche eines
echten Kreises sein kann. Dieser Approximationsfehler ist umso größer,
je kleiner die Region ist.
In der Dokumentation zu diesem Kapitel (Regionen / Merkmale) finden Sie ein Bild mit Regionen, die sich in ihrer Kompaktheit unterscheiden.
Bei einer leeren Region liefert compactness den Wert 0, soweit
kein anderes Verhalten festgelegt wurde (siehe set_system).
Wird mehr als eine Region übergeben, dann werden die Zahlenwerte des
Formfaktors in einem Tupel abgespeichert, wobei die Position eines Wertes
in dem Tupel der Position der Region im Eingabetupel entspricht.
Regions (input_object) region(-array) → object
Zu untersuchende Region(en).
Compactness (output_control) real(-array) → (real)
Kompaktheit der Eingaberegion(en).
Zusicherung: Compactness >= 1.0 || Compactness == 0
compactness 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
contlength,
area_center,
select_shape
Foundation