find_neighborsT_find_neighborsFindNeighborsFindNeighbors (Operator)

Name

find_neighborsT_find_neighborsFindNeighborsFindNeighbors — Suchen von direkten Nachbarn.

Signatur

Beschreibung

find_neighborsfind_neighborsFindNeighborsFindNeighborsFindNeighbors bestimmt benachbarte Regionen. Regions1Regions1Regions1Regions1regions1 und Regions2Regions2Regions2Regions2regions2 enthalten dabei die zu testenden Regionen. Regions1Regions1Regions1Regions1regions1 kann dabei auf drei verschiedene Arten besetzt werden:

• Regions1Regions1Regions1Regions1regions1 ist leer:

  In diesem Fall werden alle Regionen in Regions2Regions2Regions2Regions2regions2 permutativ auf Nachbarschaft getestet.

• Regions1Regions1Regions1Regions1regions1 besteht aus einer Region:

  Die Regionen von Regions1Regions1Regions1Regions1regions1 werden mit allen Regionen in Regions2Regions2Regions2Regions2regions2 verglichen.

• Regions1Regions1Regions1Regions1regions1 besteht aus gleich vielen Regionen wie Regions2Regions2Regions2Regions2regions2:

  Hier werden jeweils die Regionen an n-ter Position in Regions1Regions1Regions1Regions1regions1 und Regions2Regions2Regions2Regions2regions2 auf die Nachbarschaftsbeziehung untersucht.

find_neighborsfind_neighborsFindNeighborsFindNeighborsFindNeighbors verwendet die Chessboard-Norm bei der Berechnung des Abstandes. Der maximale Abstand wird mit MaxDistanceMaxDistanceMaxDistanceMaxDistancemaxDistance angegeben. Zueinander benachbarte Regionen stehen an n-ter Position in RegionIndex1RegionIndex1RegionIndex1RegionIndex1regionIndex1 und RegionIndex2RegionIndex2RegionIndex2RegionIndex2regionIndex2, d.h. Region mit Index RegionIndex1RegionIndex1RegionIndex1RegionIndex1regionIndex1[n] aus Regions1Regions1Regions1Regions1regions1 ist benachbart zur Region mit Index RegionIndex2RegionIndex2RegionIndex2RegionIndex2regionIndex2[n] aus Regions2Regions2Regions2Regions2regions2.

Achtung

Verdeckte Regionen werden nicht gefunden!

Ausführungsinformationen

• Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
• Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
• Wird ohne Parallelisierung verarbeitet.

Parameter

Ergebnis

find_neighborsfind_neighborsFindNeighborsFindNeighborsFindNeighbors 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>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>) festlegen. Das Verhalten bei einer leeren Region (Region ist die leere Menge) wird mit set_system('empty_region_result',<Result>)set_system("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>) bestimmt. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

thresholdthresholdThresholdThresholdThreshold, regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowing, connectionconnectionConnectionConnectionConnection

Siehe auch

spatial_relationspatial_relationSpatialRelationSpatialRelationSpatialRelation, select_region_spatialselect_region_spatialSelectRegionSpatialSelectRegionSpatialSelectRegionSpatial, expand_regionexpand_regionExpandRegionExpandRegionExpandRegion, distance_transformdistance_transformDistanceTransformDistanceTransformDistanceTransform, interjacentinterjacentInterjacentInterjacentInterjacent, boundaryboundaryBoundaryBoundaryBoundary

Modul

Foundation