runlength_distribution — Ermitteln der Verteilung der Sehnenlängen einer Region.
runlength_distribution(Region : : : Foreground, Background)
runlength_distribution berechnet die Verteilung
der Sehnenlängen einer Region von Vorder- und Hintergrund.
Es wird gezählt wie häufig eine bestimmte Länge auftritt.
Sehnen der Länge unendlich werden nicht gezählt.
Der Hintergrund sind also alle Hohlflächen der Region.
Es werden so viele Werte übergeben, wie die
maximale Länge von Vorder- bzw. Hintergrund vorgibt.
Die Länge der beiden Tupel ist i.A. unterschiedlich.
Der erste Eintrag der Tupel ist immer 0
(keine Sehnen der Länge 0).
Gibt es keine Zwischenräume wird bei
Background das leere Tupel übergeben.
Analog wird bei einer leeren Region bei
Foreground das leere Tupel übergeben.
Region (input_object) region → object
Zu untersuchende Region.
Foreground (output_control) integer-array → (integer)
Längenverteilung der Region (Vordergrund).
Background (output_control) integer-array → (integer)
Längenverteilung des Hintergrundes.
Sei n die Anzahl der Sehnen der Region, dann beträgt die Laufzeitkomplexität O(n).
runlength_distribution 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.
Wird mehr als eine Region übergeben, wird
eine Fehlerbehandlung durchgeführt.
Foundation