find_neighbors
— Suchen von direkten Nachbarn.
find_neighbors(Regions1, Regions2 : : MaxDistance : RegionIndex1, RegionIndex2)
find_neighbors
bestimmt benachbarte Regionen. Regions1
und Regions2
enthalten dabei die zu testenden Regionen.
Regions1
kann dabei auf drei verschiedene Arten besetzt werden:
Regions1
ist leer:
In diesem Fall werden alle Regionen in Regions2
permutativ auf Nachbarschaft getestet.
Regions1
besteht aus einer Region:
Die Regionen von Regions1
werden mit allen Regionen in
Regions2
verglichen.
Regions1
besteht aus gleich vielen Regionen wie
Regions2
:
Hier werden jeweils die Regionen an n-ter Position
in Regions1
und Regions2
auf die
Nachbarschaftsbeziehung untersucht.
find_neighbors
verwendet die Chessboard-Norm bei der
Berechnung des Abstandes. Der maximale Abstand wird mit
MaxDistance
angegeben.
Zueinander benachbarte Regionen stehen an n-ter Position in
RegionIndex1
und RegionIndex2
, d.h.
Region mit Index RegionIndex1
[n] aus Regions1
ist
benachbart zur Region mit Index RegionIndex2
[n] aus
Regions2
.
Verdeckte Regionen werden nicht gefunden!
Regions1
(input_object) region(-array) →
object
Ausgangsregionen.
Regions2
(input_object) region(-array) →
object
Vergleichsregionen.
MaxDistance
(input_control) integer →
(integer)
Maximaler Abstand der Regionen.
Defaultwert: 1
Wertevorschläge: 1, 2, 3, 4, 5, 6, 7, 8, 10, 15, 20, 50
Typischer Wertebereich: 1
≤
MaxDistance
≤
255
Minimale Schrittweite: 1
Empfohlene Schrittweite: 1
RegionIndex1
(output_control) integer-array →
(integer)
Indizes der gefundenen Regionen aus Regions1
.
RegionIndex2
(output_control) integer-array →
(integer)
Indizes der gefundenen Regionen aus Regions2
.
find_neighbors
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
spatial_relation
,
select_region_spatial
,
expand_region
,
distance_transform
,
interjacent
,
boundary
Foundation