spatial_relationT_spatial_relationSpatialRelationspatial_relationSpatialRelationSpatialRelation (Operator)

Name

spatial_relationT_spatial_relationSpatialRelationspatial_relationSpatialRelationSpatialRelation — Ermitteln der Lagebeziehung von Regionen bzgl. der Koordinatenachsen.

Signatur

Beschreibung

spatial_relationspatial_relationSpatialRelationspatial_relationSpatialRelationSpatialRelation wählt Regionen aus, die um PercentPercentPercentPercentPercentpercent Prozent „links“, „rechts“, „oberhalb“ oder „unterhalb“ von anderen Regionen liegen. Regions1Regions1Regions1Regions1Regions1regions1 und Regions2Regions2Regions2Regions2Regions2regions2 enthalten die zu vergleichenden Regionen. Regions1Regions1Regions1Regions1Regions1regions1 kann dabei auf drei verschiedene Arten besetzt werden:

• Regions1Regions1Regions1Regions1Regions1regions1 enthält ein leeres Objekttupel, d.h., count_objcount_objCountObjcount_objCountObjCountObj liefert 0 zurück:

  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.

Der Prozentsatz PercentPercentPercentPercentPercentpercent wird so interpretiert, dass die Fläche der zweiten Region um mindestens PercentPercentPercentPercentPercentpercent Prozent echt links/rechts bzw. oberhalb/unterhalb der Regionengrenzen der ersten Region liegen muss. Die Indizes der Regionen, die mindestens eine dieser Bedingungen erfüllen, stehen dann an n-ter Position in den Ausgabeparametern RegionIndex1RegionIndex1RegionIndex1RegionIndex1RegionIndex1regionIndex1 und RegionIndex2RegionIndex2RegionIndex2RegionIndex2RegionIndex2regionIndex2. Zusätzlich enthalten die Ausgabeparameter Relation1Relation1Relation1Relation1Relation1relation1 und Relation2Relation2Relation2Relation2Relation2relation2 an n-ter Position die Art der Relation, in der das Regionenpaar (RegionIndex1RegionIndex1RegionIndex1RegionIndex1RegionIndex1regionIndex1[n], RegionIndex2RegionIndex2RegionIndex2RegionIndex2RegionIndex2regionIndex2[n]) steht, d.h. Region mit Index RegionIndex2RegionIndex2RegionIndex2RegionIndex2RegionIndex2regionIndex2[n] steht mit Region mit Index RegionIndex1RegionIndex1RegionIndex1RegionIndex1RegionIndex1regionIndex1[n] in der Relation1Relation1Relation1Relation1Relation1relation1[n] und Relation2Relation2Relation2Relation2Relation2relation2[n].

Mögliche Werte für Relation1Relation1Relation1Relation1Relation1relation1 und Relation2Relation2Relation2Relation2Relation2relation2 sind:

Relation1:

'left', 'right' oder “

Relation2:

'above', 'below' oder “

In RegionIndex1RegionIndex1RegionIndex1RegionIndex1RegionIndex1regionIndex1 und RegionIndex2RegionIndex2RegionIndex2RegionIndex2RegionIndex2regionIndex2 werden die Indizes der Regionen in den Tupeln der Eingaberegionen (Regions1Regions1Regions1Regions1Regions1regions1 bzw. Regions2Regions2Regions2Regions2Regions2regions2) als Bildidentifikatoren eingetragen. Der Zugriff auf ausgewählte 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

spatial_relationspatial_relationSpatialRelationspatial_relationSpatialRelationSpatialRelation liefert den Wert 2 (H_MSG_TRUE), falls Regions2Regions2Regions2Regions2Regions2regions2 nicht leer und PercentPercentPercentPercentPercentpercent korrekt besetzt 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

select_region_spatialselect_region_spatialSelectRegionSpatialselect_region_spatialSelectRegionSpatialSelectRegionSpatial, find_neighborsfind_neighborsFindNeighborsfind_neighborsFindNeighborsFindNeighbors, copy_objcopy_objCopyObjcopy_objCopyObjCopyObj, obj_to_integerobj_to_integerObjToIntegerobj_to_integerObjToIntegerObjToInteger

Modul

Foundation