select_region_spatialT_select_region_spatialSelectRegionSpatialselect_region_spatialSelectRegionSpatialSelectRegionSpatial (Operator)

Name

select_region_spatialT_select_region_spatialSelectRegionSpatialselect_region_spatialSelectRegionSpatialSelectRegionSpatial — Ermitteln der Lagebeziehung von Regionen.

Signatur

Beschreibung

select_region_spatialselect_region_spatialSelectRegionSpatialselect_region_spatialSelectRegionSpatialSelectRegionSpatial wählt die Regionen aus Regions2Regions2Regions2Regions2Regions2regions2 aus, die der Nachbarschaftsbeziehung DirectionDirectionDirectionDirectionDirectiondirection genügen. Die zu untersuchenden Regionen sind in Regions1Regions1Regions1Regions1Regions1regions1 bzw. Regions2Regions2Regions2Regions2Regions2regions2 zu übergeben. Regions1Regions1Regions1Regions1Regions1regions1 kann dabei auf drei verschiedene Arten besetzt werden:

• Regions1Regions1Regions1Regions1Regions1regions1 ist leer:

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

• Regions1Regions1Regions1Regions1Regions1regions1 besteht aus einer Region:

  Die Regionen von Regions1Regions1Regions1Regions1Regions1regions1 werden mit allen Regionen in Regions2Regions2Regions2Regions2Regions2regions2 verglichen.

• Regions1Regions1Regions1Regions1Regions1regions1 besteht aus gleich vielen Regionen wie Regions2Regions2Regions2Regions2Regions2regions2:

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

Mögliche Werte für DirectionDirectionDirectionDirectionDirectiondirection sind:

'left':

Regions2Regions2Regions2Regions2Regions2regions2 ist links von Regions1Regions1Regions1Regions1Regions1regions1

'right':

Regions2Regions2Regions2Regions2Regions2regions2 ist rechts von Regions1Regions1Regions1Regions1Regions1regions1

'above':

Regions2Regions2Regions2Regions2Regions2regions2 ist oberhalb von Regions1Regions1Regions1Regions1Regions1regions1

'below':

Regions2Regions2Regions2Regions2Regions2regions2 ist unterhalb von Regions1Regions1Regions1Regions1Regions1regions1

select_region_spatialselect_region_spatialSelectRegionSpatialselect_region_spatialSelectRegionSpatialSelectRegionSpatial berechnet die Schwerpunkte der zu vergleichenden Regionen und entscheidet anhand des Winkels zwischen der Schwerpunktgeraden und der x-Achse, ob die Richtungsbeziehung erfüllt ist. Die Relation ist jeweils in dem Bereich von -45 Grad bis +45 Grad um die Koordinatenachsen erfüllt. Die Richtungsrelation ist also so zu verstehen, dass der Schwerpunkt der zweiten Region links (bzw. rechts, oben, unten) vom Schwerpunkt der ersten Region liegen muss. Die Indizes der Regionen, die die Richtungsbeziehung erfüllen, stehen an n-ter Position in RegionIndex1RegionIndex1RegionIndex1RegionIndex1RegionIndex1regionIndex1 und RegionIndex2RegionIndex2RegionIndex2RegionIndex2RegionIndex2regionIndex2, d.h. die Region mit Index RegionIndex2RegionIndex2RegionIndex2RegionIndex2RegionIndex2regionIndex2[n] steht mit Region mit Index RegionIndex1RegionIndex1RegionIndex1RegionIndex1RegionIndex1regionIndex1[n] in der angegebenen Relation. Der Zugriff auf Regionen über den Index kann mit copy_objcopy_objCopyObjcopy_objCopyObjCopyObj erfolgen.

Parallelisierung

• 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

select_region_spatialselect_region_spatialSelectRegionSpatialselect_region_spatialSelectRegionSpatialSelectRegionSpatial liefert den Wert 2 (H_MSG_TRUE), falls Regions2Regions2Regions2Regions2Regions2regions2 nicht leer ist. Das Verhalten bei leerem Parameter Regions2Regions2Regions2Regions2Regions2regions2 (keine Eingaberegionen vorhanden) lässt sich mittels set_system('no_object_result',<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("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>)set_system("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>) bestimmt. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

thresholdthresholdThresholdthresholdThresholdThreshold, regiongrowingregiongrowingRegiongrowingregiongrowingRegiongrowingRegiongrowing, connectionconnectionConnectionconnectionConnectionConnection

Alternativen

area_centerarea_centerAreaCenterarea_centerAreaCenterAreaCenter, intersectionintersectionIntersectionintersectionIntersectionIntersection

Siehe auch

spatial_relationspatial_relationSpatialRelationspatial_relationSpatialRelationSpatialRelation, find_neighborsfind_neighborsFindNeighborsfind_neighborsFindNeighborsFindNeighbors, copy_objcopy_objCopyObjcopy_objCopyObjCopyObj, obj_to_integerobj_to_integerObjToIntegerobj_to_integerObjToIntegerObjToInteger

Modul

Foundation