find_neighborsT_find_neighborsFindNeighborsFindNeighborsfind_neighbors (Operator)

Name

find_neighborsT_find_neighborsFindNeighborsFindNeighborsfind_neighbors — Suchen von direkten Nachbarn.

Signatur

find_neighbors(Regions1, Regions2 : : MaxDistance : RegionIndex1, RegionIndex2)

Herror T_find_neighbors(const Hobject Regions1, const Hobject Regions2, const Htuple MaxDistance, Htuple* RegionIndex1, Htuple* RegionIndex2)

void FindNeighbors(const HObject& Regions1, const HObject& Regions2, const HTuple& MaxDistance, HTuple* RegionIndex1, HTuple* RegionIndex2)

HTuple HRegion::FindNeighbors(const HRegion& Regions2, Hlong MaxDistance, HTuple* RegionIndex2) const

static void HOperatorSet.FindNeighbors(HObject regions1, HObject regions2, HTuple maxDistance, out HTuple regionIndex1, out HTuple regionIndex2)

HTuple HRegion.FindNeighbors(HRegion regions2, int maxDistance, out HTuple regionIndex2)

def find_neighbors(regions_1: HObject, regions_2: HObject, max_distance: int) -> Tuple[Sequence[int], Sequence[int]]

Beschreibung

find_neighborsfind_neighborsFindNeighborsFindNeighborsFindNeighborsfind_neighbors bestimmt benachbarte Regionen. Regions1Regions1Regions1Regions1regions1regions_1 und Regions2Regions2Regions2Regions2regions2regions_2 enthalten dabei die zu testenden Regionen. Regions1Regions1Regions1Regions1regions1regions_1 kann dabei auf drei verschiedene Arten besetzt werden:

find_neighborsfind_neighborsFindNeighborsFindNeighborsFindNeighborsfind_neighbors verwendet die Chessboard-Norm bei der Berechnung des Abstandes. Der maximale Abstand wird mit MaxDistanceMaxDistanceMaxDistanceMaxDistancemaxDistancemax_distance angegeben. Zueinander benachbarte Regionen stehen an n-ter Position in RegionIndex1RegionIndex1RegionIndex1RegionIndex1regionIndex1region_index_1 und RegionIndex2RegionIndex2RegionIndex2RegionIndex2regionIndex2region_index_2, d.h. Region mit Index RegionIndex1RegionIndex1RegionIndex1RegionIndex1regionIndex1region_index_1[n] aus Regions1Regions1Regions1Regions1regions1regions_1 ist benachbart zur Region mit Index RegionIndex2RegionIndex2RegionIndex2RegionIndex2regionIndex2region_index_2[n] aus Regions2Regions2Regions2Regions2regions2regions_2.

Achtung

Verdeckte Regionen werden nicht gefunden!

Ausführungsinformationen

Parameter

Regions1Regions1Regions1Regions1regions1regions_1 (input_object)  region(-array) objectHRegionHObjectHRegionHobject

Ausgangsregionen.

Regions2Regions2Regions2Regions2regions2regions_2 (input_object)  region(-array) objectHRegionHObjectHRegionHobject

Vergleichsregionen.

MaxDistanceMaxDistanceMaxDistanceMaxDistancemaxDistancemax_distance (input_control)  integer HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Maximaler Abstand der Regionen.

Defaultwert: 1

Wertevorschläge: 1, 2, 3, 4, 5, 6, 7, 8, 10, 15, 20, 50

Typischer Wertebereich: 1 ≤ MaxDistance MaxDistance MaxDistance MaxDistance maxDistance max_distance ≤ 255

Minimale Schrittweite: 1

Empfohlene Schrittweite: 1

RegionIndex1RegionIndex1RegionIndex1RegionIndex1regionIndex1region_index_1 (output_control)  integer-array HTupleSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Indizes der gefundenen Regionen aus Regions1Regions1Regions1Regions1regions1regions_1.

RegionIndex2RegionIndex2RegionIndex2RegionIndex2regionIndex2region_index_2 (output_control)  integer-array HTupleSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Indizes der gefundenen Regionen aus Regions2Regions2Regions2Regions2regions2regions_2.

Ergebnis

find_neighborsfind_neighborsFindNeighborsFindNeighborsFindNeighborsfind_neighbors liefert den Wert 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>)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>)set_system("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)set_system("empty_region_result",<Result>) bestimmt. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

thresholdthresholdThresholdThresholdThresholdthreshold, regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowingregiongrowing, connectionconnectionConnectionConnectionConnectionconnection

Siehe auch

spatial_relationspatial_relationSpatialRelationSpatialRelationSpatialRelationspatial_relation, select_region_spatialselect_region_spatialSelectRegionSpatialSelectRegionSpatialSelectRegionSpatialselect_region_spatial, expand_regionexpand_regionExpandRegionExpandRegionExpandRegionexpand_region, distance_transformdistance_transformDistanceTransformDistanceTransformDistanceTransformdistance_transform, interjacentinterjacentInterjacentInterjacentInterjacentinterjacent, boundaryboundaryBoundaryBoundaryBoundaryboundary

Modul

Foundation