Layer lagebezogen auswählen (Data Management)—ArcGIS Pro (2024)

Parameter

BeschriftungErläuterungDatentyp

Eingabe-Features

Die Features, die anhand der Werte des Parameters Auswahl-Features ausgewertet werden. Die Auswahl wird auf diese Features angewendet.

Feature Layer; Raster Layer; Mosaic Layer

Beziehung

(optional)

Gibt die räumliche Beziehung an, die ausgewertet werden soll.

  • ÜberschneidenDie Features im Eingabe-Layer werden ausgewählt, wenn sie ein Auswahl-Feature schneiden. Dies ist die Standardeinstellung.
  • Überschneiden 3DDie Features im Eingabe-Layer werden ausgewählt, wenn sie sich mit einem Auswahl-Feature im dreidimensionalen Raum (x, y und z) überschneiden.
  • Überschneiden (DBMS)Die Features im Eingabe-Layer werden ausgewählt, wenn sie ein Auswahl-Feature schneiden.Diese Option gilt nur für Enterprise-Geodatabases. Wenn alle Anforderungen erfüllt sind (siehe die Verwendungshinweise), wird die Auswahl im Enterprise-Geodatabase-DBMS und nicht auf dem Client verarbeitet.Diese Option bietet möglicherweise eine bessere Performance als die Durchführung der Auswahl auf dem Client.
  • In einer EntfernungDie Features im Eingabe-Layer werden ausgewählt, wenn sie sich innerhalb der (mittels Euklidischen Abstands) angegebenen Entfernung zum Auswahl-Feature befinden. Geben Sie die Entfernung mithilfe des Parameters Suchentfernung an.
  • In einer geodätischen EntfernungDie Features im Eingabe-Layer werden ausgewählt, wenn sie sich innerhalb einer bestimmten Entfernung zum Auswahl-Feature befinden. Die Entfernung zwischen Features wird mit einer geodätischen Formel berechnet, bei der die Krümmung des Sphäroiden berücksichtigt und die Daten in der Nähe der Datumsgrenze und der Pole richtig verarbeitet werden. Geben Sie die Entfernung mithilfe des Parameters Suchentfernung an.
  • In einer Entfernung (3D)Die Features im Eingabe-Layer werden ausgewählt, wenn sie sich in einem bestimmten Abstand zu einem Auswahl-Feature im dreidimensionalen Raum befinden. Geben Sie die Entfernung mithilfe des Parameters Suchentfernung an.
  • EnthältDie Features im Eingabe-Layer werden ausgewählt, wenn sie ein Auswahl-Feature enthalten.
  • Enthält vollständigDie Features im Eingabe-Layer werden ausgewählt, wenn sie ein Auswahl-Feature vollständig enthalten.
  • Enthält ClementiniDiese räumliche Beziehung liefert die gleichen Ergebnisse wie Enthält. Eine Ausnahme ist, wenn sich das Auswahl-Feature vollständig auf der Grenze des Eingabe-Features befindet (kein Teil liegt inner- oder außerhalb). In diesem Fall wird das Feature nicht ausgewählt."Clementini" legt das Grenzpolygon als Linie zwischen innen und außen fest. Die Grenze einer Linie ist als ihr Endpunkt definiert, und die Grenze eines Punktes ist immer leer.
  • InnerhalbDie Features im Eingabe-Layer werden ausgewählt, wenn sie innerhalb eines Auswahl-Features liegen.
  • Vollständig innerhalb vonDie Features im Eingabe-Layer werden ausgewählt, wenn sie vollständig innerhalb eines Auswahl-Features liegen bzw. in diesem enthalten sind.
  • Innerhalb von ClementiniDie Ergebnisse stimmen mit denen für Innerhalb überein, es sei denn, das gesamte Feature im Eingabe-Layer befindet sich auf der Grenze des Features im Auswahl-Layer. In diesem Fall wird das Feature nicht ausgewählt."Clementini" legt das Grenzpolygon als Linie zwischen innen und außen fest. Die Grenze einer Linie ist als ihr Endpunkt definiert, und die Grenze eines Punktes ist immer leer.
  • Sind identisch zuDie Features im Eingabe-Layer werden ausgewählt, wenn ihre geometrische Form mit der eines Auswahl-Features übereinstimmt.
  • GrenzberührungenDie Features im Eingabe-Layer werden ausgewählt, wenn ihre Grenze ein Auswahl-Feature berührt. Wenn es sich bei den Eingabe-Features um Linien oder Polygone handelt, kann die Grenze des Eingabe-Features die Grenze des Auswahl-Features nur berühren. Kein Teil des Eingabe-Features kann die Grenze des Auswahl-Features kreuzen.
  • Ein Liniensegment gemeinsam haben mitDie Features im Eingabe-Layer werden ausgewählt, wenn sie mit einem Auswahl-Feature ein gemeinsames Liniensegment teilen. Die Eingabe- und Auswahl-Features müssen Linien oder Polygone sein.
  • Gekreuzt durch den Umriss vonDie Features im Eingabe-Layer werden ausgewählt, wenn sie vom Umriss eines Auswahl-Features geschnitten werden. Die Eingabe- und Auswahl-Features müssen Linien oder Polygone sein. Wenn für den Eingabe- oder Auswahl-Layer Polygone verwendet werden, wird die Grenze (Linie) des Polygons verwendet. Linien, die sich in einem Punkt schneiden, werden ausgewählt. Dies gilt jedoch nicht für Linien, die ein Liniensegment gemeinsam haben.
  • Mit Mittelpunkt inDie Features im Eingabe-Layer werden ausgewählt, wenn ihr Mittelpunkt innerhalb eines Auswahl-Features liegt. Der Mittelpunkt des Features wird wie folgt berechnet: Bei Polygonen und Multipoints wird der Schwerpunkt der Geometrie verwendet, bei Linien die geometrische Mitte.
String

Auswahl-Features

(optional)

Die Features im Parameter Eingabe-Features werden auf Grundlage ihrer Beziehung zu den Features dieses Layers oder dieser betreffenden Feature-Class ausgewählt.

Feature Layer

Suchentfernung

(optional)

Die Entfernung, in der gesucht wird. Dieser Parameter ist nur gültig, wenn für den Parameter Beziehung eine der folgenden Optionen ausgewählt wurde: In einer Entfernung, In einer geodätischen Entfernung, In einer Entfernung 3D, Überschneiden (Intersect), Überschneiden 3D, Mit Mittelpunkt in oder Enthält.

Wenn die Option In einer geodätischen Entfernung ausgewählt ist, verwenden Sie eine lineare Einheit wie Kilometer oder Meilen.

Linear Unit

Auswahltyp

(optional)

Gibt an, wie die Auswahl auf die Eingabe angewendet und mit einer vorhandenen Auswahl kombiniert wird. Dieses Werkzeug bietet keine Option, eine vorhandene Auswahl aufzuheben. Verwenden Sie dazu im Werkzeug Layer nach Attributen auswählen die Option Aktuelle Auswahl löschen.

  • Neue AuswahlDie getätigte Auswahl ersetzt eine bestehende Auswahl. Dies ist die Standardeinstellung.
  • Zur aktuellen Auswahl hinzufügenDie getätigte Auswahl wird einer bestehenden Auswahl hinzugefügt. Wenn keine Auswahl vorhanden ist, entspricht diese Option der Option Neue Auswahl.
  • Aus aktueller Auswahl entfernenDie getätigte Auswahl wird aus einer bestehenden Auswahl entfernt. Wenn keine Auswahl vorhanden ist, hat der Vorgang keine Auswirkungen.
  • Teilmenge aus der aktuellen Auswahl auswählenDie getätigte Auswahl wird mit der bestehenden Auswahl kombiniert. Nur Datensätze, die in beiden Auswahlen vorhanden sind, werden ausgewählt.
  • Aktuelle Auswahl umkehrenDie Auswahl wird umgekehrt. Alle bisher ausgewählten Datensätze werden von der Auswahl entfernt und alle bisher nicht ausgewählten Datensätze werden der Auswahl hinzugefügt.Die Parameter Auswahl-Features sowie Beziehung werden bei Aktivierung dieser Option ignoriert.
String

Räumliche Beziehung umkehren

(optional)

Gibt an, ob das Ergebnis der Auswertung der räumlichen Beziehung verwendet wird oder das gegenteilige Ergebnis. Dieser Parameter kann beispielsweise verwendet werden, um eine Liste von Features abzurufen, die sich nicht überschneiden oder nicht innerhalb einer angegebenen Entfernung von Features in einem anderen Dataset liegen.

  • Deaktiviert: Das Abfrageergebnis wird verwendet. Dies ist die Standardeinstellung.
  • Aktiviert: Das Gegenteil des Abfrageergebnisses wird verwendet. Wenn der Parameter Auswahltyp verwendet wird, erfolgt die Umkehrung der Auswahl vor dem Kombinieren mit einer vorhandenen Auswahl.
Boolean

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Layer mit Auswahl

Die aktualisierten Eingaben mit angewendeter Auswahl.

Feature Layer; Mosaic Layer
Ausgabe-Layer-Namen

Die Namen der aktualisierten Eingaben.

Feature Layer; Mosaic Layer
Anzahl

Die Anzahl der ausgewählten Datensätze.

Long
arcpy.management.SelectLayerByLocation(in_layer, {overlap_type}, {select_features}, {search_distance}, {selection_type}, {invert_spatial_relationship})
NameErläuterungDatentyp

in_layer

[in_layer,...]

Die Features, die anhand der Werte des Parameters select_features ausgewertet werden. Die Auswahl wird auf diese Features angewendet.

Feature Layer; Raster Layer; Mosaic Layer

overlap_type

(optional)

Gibt die räumliche Beziehung an, die ausgewertet werden soll.

  • INTERSECTDie Features im Eingabe-Layer werden ausgewählt, wenn sie ein Auswahl-Feature schneiden. Dies ist die Standardeinstellung.
  • INTERSECT_3DDie Features im Eingabe-Layer werden ausgewählt, wenn sie sich mit einem Auswahl-Feature im dreidimensionalen Raum (x, y und z) überschneiden.
  • INTERSECT_DBMSDie Features im Eingabe-Layer werden ausgewählt, wenn sie ein Auswahl-Feature schneiden.Diese Option gilt nur für Enterprise-Geodatabases. Wenn alle Anforderungen erfüllt sind (siehe die Verwendungshinweise), wird die Auswahl im Enterprise-Geodatabase-DBMS und nicht auf dem Client verarbeitet.Diese Option bietet möglicherweise eine bessere Performance als die Durchführung der Auswahl auf dem Client.
  • WITHIN_A_DISTANCEDie Features im Eingabe-Layer werden ausgewählt, wenn sie sich innerhalb der (mittels Euklidischen Abstands) angegebenen Entfernung zum Auswahl-Feature befinden. Geben Sie die Entfernung mithilfe des Parameters search_distance an.
  • WITHIN_A_DISTANCE_3DDie Features im Eingabe-Layer werden ausgewählt, wenn sie sich in einem bestimmten Abstand zu einem Auswahl-Feature im dreidimensionalen Raum befinden. Geben Sie die Entfernung mithilfe des Parameters search_distance an.
  • WITHIN_A_DISTANCE_GEODESICDie Features im Eingabe-Layer werden ausgewählt, wenn sie sich innerhalb einer bestimmten Entfernung zum Auswahl-Feature befinden. Die Entfernung zwischen Features wird mit einer geodätischen Formel berechnet, bei der die Krümmung des Sphäroiden berücksichtigt und die Daten in der Nähe der Datumsgrenze und der Pole richtig verarbeitet werden. Geben Sie die Entfernung mithilfe des Parameters search_distance an.
  • CONTAINSDie Features im Eingabe-Layer werden ausgewählt, wenn sie ein Auswahl-Feature enthalten.
  • COMPLETELY_CONTAINSDie Features im Eingabe-Layer werden ausgewählt, wenn sie ein Auswahl-Feature vollständig enthalten.
  • CONTAINS_CLEMENTINIDiese räumliche Beziehung liefert die gleichen Ergebnisse wie CONTAINS. Eine Ausnahme ist, wenn sich das Auswahl-Feature vollständig auf der Grenze des Eingabe-Features befindet (kein Teil liegt inner- oder außerhalb). In diesem Fall wird das Feature nicht ausgewählt."Clementini" legt das Grenzpolygon als Linie zwischen innen und außen fest. Die Grenze einer Linie ist als ihr Endpunkt definiert, und die Grenze eines Punktes ist immer leer.
  • WITHINDie Features im Eingabe-Layer werden ausgewählt, wenn sie innerhalb eines Auswahl-Features liegen.
  • COMPLETELY_WITHINDie Features im Eingabe-Layer werden ausgewählt, wenn sie vollständig innerhalb eines Auswahl-Features liegen bzw. in diesem enthalten sind.
  • WITHIN_CLEMENTINIDie Ergebnisse stimmen mit denen für WITHIN überein, es sei denn, das gesamte Feature im Eingabe-Layer befindet sich auf der Grenze des Features im Auswahl-Layer. In diesem Fall wird das Feature nicht ausgewählt."Clementini" legt das Grenzpolygon als Linie zwischen innen und außen fest. Die Grenze einer Linie ist als ihr Endpunkt definiert, und die Grenze eines Punktes ist immer leer.
  • ARE_IDENTICAL_TODie Features im Eingabe-Layer werden ausgewählt, wenn ihre geometrische Form mit der eines Auswahl-Features übereinstimmt.
  • BOUNDARY_TOUCHESDie Features im Eingabe-Layer werden ausgewählt, wenn ihre Grenze ein Auswahl-Feature berührt. Wenn es sich bei den Eingabe-Features um Linien oder Polygone handelt, kann die Grenze des Eingabe-Features die Grenze des Auswahl-Features nur berühren. Kein Teil des Eingabe-Features kann die Grenze des Auswahl-Features kreuzen.
  • SHARE_A_LINE_SEGMENT_WITHDie Features im Eingabe-Layer werden ausgewählt, wenn sie mit einem Auswahl-Feature ein gemeinsames Liniensegment teilen. Die Eingabe- und Auswahl-Features müssen Linien oder Polygone sein.
  • CROSSED_BY_THE_OUTLINE_OFDie Features im Eingabe-Layer werden ausgewählt, wenn sie vom Umriss eines Auswahl-Features geschnitten werden. Die Eingabe- und Auswahl-Features müssen Linien oder Polygone sein. Wenn für den Eingabe- oder Auswahl-Layer Polygone verwendet werden, wird die Grenze (Linie) des Polygons verwendet. Linien, die sich in einem Punkt schneiden, werden ausgewählt. Dies gilt jedoch nicht für Linien, die ein Liniensegment gemeinsam haben.
  • HAVE_THEIR_CENTER_INDie Features im Eingabe-Layer werden ausgewählt, wenn ihr Mittelpunkt innerhalb eines Auswahl-Features liegt. Der Mittelpunkt des Features wird wie folgt berechnet: Bei Polygonen und Multipoints wird der Schwerpunkt der Geometrie verwendet, bei Linien die geometrische Mitte.
String

select_features

(optional)

Die Features im Parameter Eingabe-Features werden auf Grundlage ihrer Beziehung zu den Features dieses Layers oder dieser betreffenden Feature-Class ausgewählt.

Feature Layer

search_distance

(optional)

Die Entfernung, in der gesucht wird. Dieser Parameter ist nur gültig, wenn der Parameter overlap_type auf WITHIN_A_DISTANCE, WITHIN_A_DISTANCE_GEODESIC, WITHIN_A_DISTANCE_3D, INTERSECT, INTERSECT_3D, HAVE_THEIR_CENTER_IN oder CONTAINS. festgelegt wurde.

Wenn die Option WITHIN_A_DISTANCE_GEODESIC ausgewählt ist, verwenden Sie eine lineare Einheit wie Kilometer oder Meilen.

Linear Unit

selection_type

(optional)

Gibt an, wie die Auswahl auf die Eingabe angewendet und mit einer vorhandenen Auswahl kombiniert wird. Dieses Werkzeug bietet keine Option, eine vorhandene Auswahl aufzuheben. Verwenden Sie dazu im Werkzeug Layer nach Attributen auswählen die Option CLEAR_SELECTION.

  • NEW_SELECTIONDie getätigte Auswahl ersetzt eine bestehende Auswahl. Dies ist die Standardeinstellung.
  • ADD_TO_SELECTIONDie getätigte Auswahl wird einer bestehenden Auswahl hinzugefügt. Wenn keine Auswahl vorhanden ist, entspricht diese Option der Option NEW_SELECTION.
  • REMOVE_FROM_SELECTIONDie getätigte Auswahl wird aus einer bestehenden Auswahl entfernt. Wenn keine Auswahl vorhanden ist, hat der Vorgang keine Auswirkungen.
  • SUBSET_SELECTIONDie getätigte Auswahl wird mit der bestehenden Auswahl kombiniert. Nur Datensätze, die in beiden Auswahlen vorhanden sind, werden ausgewählt.
  • SWITCH_SELECTIONDie Auswahl wird umgekehrt. Alle bisher ausgewählten Datensätze werden von der Auswahl entfernt und alle bisher nicht ausgewählten Datensätze werden der Auswahl hinzugefügt.Die Parameter select_features und overlap_type werden bei Auswahl dieser Option ignoriert.
String

invert_spatial_relationship

(optional)

Gibt an, ob das Ergebnis der Auswertung der räumlichen Beziehung verwendet wird oder das gegenteilige Ergebnis. Dieser Parameter kann beispielsweise verwendet werden, um eine Liste von Features abzurufen, die sich nicht überschneiden oder nicht innerhalb einer angegebenen Entfernung von Features in einem anderen Dataset liegen.

  • NOT_INVERTDas Abfrageergebnis wird verwendet. Dies ist die Standardeinstellung.
  • INVERTDas Gegenteil des Abfrageergebnisses wird verwendet. Wenn der Parameter selection_type verwendet wird, erfolgt die Umkehrung der Auswahl vor dem Kombinieren mit einer vorhandenen Auswahl.
Boolean

Abgeleitete Ausgabe

NameErläuterungDatentyp
out_layer_or_view

Die aktualisierten Eingaben mit angewendeter Auswahl.

Feature Layer; Mosaic Layer
out_layers_or_views

Die Namen der aktualisierten Eingaben.

Feature Layer; Mosaic Layer
count

Die Anzahl der ausgewählten Datensätze.

Long

Codebeispiel

SelectLayerByLocation - Beispiel1 (Python-Fenster)

Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion SelectLayerByLocation im unmittelbaren Modus verwendet wird.

import arcpyarcpy.SelectLayerByLocation_management("parcel_lyr", "have_their_center_in", "c:/kamsack.gdb/city_limits")
SelectLayerByLocation - Beispiel2 (eigenständiges Skript)

Das folgende eigenständige Skript zeigt, wie mit der Funktion SelectLayerByLocation Features auf Grundlage von Position und einer Attributabfrage in eine neue Feature-Class extrahiert werden.

# Description: Extract features to a new feature class based on a # location and an attribute query# Import arcpy and set path to dataimport arcpyarcpy.env.workspace = "c:/data/mexico.gdb"# Make a layer and select cities that overlap the chihuahua polygonchihuahua_cities = arcpy.SelectLayerByLocation_management('cities', 'INTERSECT', 'chihuahua')# From the previous selection, select a subset of cities that have # population > 10,000arcpy.SelectLayerByAttribute_management(chihuahua_cities, 'SUBSET_SELECTION', '"population" > 10000')# If features matched criteria, write them to a new feature classmatchcount = int(arcpy.GetCount_management(chihuahua_cities)[0]) if matchcount == 0: print('no features matched spatial and attribute criteria')else: arcpy.CopyFeatures_management(chihuahua_cities, 'chihuahua_10000plus') print('{0} cities that matched criteria written to {0}'.format( matchcount, chihuahua_10000plus))
SelectLayerByLocation - Beispiel3 (eigenständiges Skript)

Das folgende eigenständige Skript zeigt eine Vielzahl von Verwendungsmöglichkeiten für die Optionen WITHIN_A_DISTANCE und WITHIN_A_DISTANCE_GEODESIC des Parameters overlap_type mit dem Parameter search_distance.

# Description: Select features within a distance# Import arcpy and set path to dataimport arcpyarcpy.env.workspace = r"c:\data\mexico.gdb"arcpy.SelectLayerByLocation_management('cities', 'WITHIN_A_DISTANCE', 'chihuahua', '1.5 Miles')arcpy.SelectLayerByLocation_management('cities', 'WITHIN_A_DISTANCE_GEODESIC', 'chihuahua', '200 Kilometers')# When using WITHIN_A_DISTANCE, if distance units are not specified, the # distance value is assumed to be in the units of the input dataset's coordinate # systemarcpy.SelectLayerByLocation_management('cities', 'WITHIN_A_DISTANCE', 'chihuahua', '200')# When using WITHIN_A_DISTANCE_GEODESIC, if distance units are not specified, # the distance value is assumed to be in metersarcpy.SelectLayerByLocation_management('cities', 'WITHIN_A_DISTANCE_GEODESIC', 'chihuahua', '200')
Layer lagebezogen auswählen (Data Management)—ArcGIS Pro (2024)
Top Articles
Latest Posts
Article information

Author: Frankie Dare

Last Updated:

Views: 5911

Rating: 4.2 / 5 (53 voted)

Reviews: 84% of readers found this page helpful

Author information

Name: Frankie Dare

Birthday: 2000-01-27

Address: Suite 313 45115 Caridad Freeway, Port Barabaraville, MS 66713

Phone: +3769542039359

Job: Sales Manager

Hobby: Baton twirling, Stand-up comedy, Leather crafting, Rugby, tabletop games, Jigsaw puzzles, Air sports

Introduction: My name is Frankie Dare, I am a funny, beautiful, proud, fair, pleasant, cheerful, enthusiastic person who loves writing and wants to share my knowledge and understanding with you.