Layer lagebezogen auswählen (Data Management)

Zusammenfassung

Wählt Features auf Grundlage einer räumlichen Beziehung zu Features in einem oder im selben Dataset aus.

Die einzelnen Features im Parameter Eingabe-Features werden anhand der Features im Parameter Auswahl-Features ausgewertet. Wenn der festgelegte Parameterwert Beziehung erfüllt ist, wird das Eingabe-Feature ausgewählt.

Weitere Informationen zu "Lagebezogen auswählen" und Beispielabbildungen von Beziehungen

Verwendung

  • Wenn es sich bei der Eingabe um eine Feature-Class oder einen Dataset-Pfad handelt, wird von diesem Werkzeug ein neuer Layer erstellt und mit dem Ergebnis des angewendeten Werkzeugs zurückgegeben.

  • Das Koordinatensystem, in dem die räumliche Beziehung ausgewertet wird, kann sich auf das Ergebnis auswirken. Features, die sich in einem Koordinatensystem überschneiden, überschneiden sich in einem anderen möglicherweise nicht.

    • Dieses Werkzeug wertet die räumliche Beziehung im Koordinatensystem der Datenquelle der Eingabe-Features aus. Legen Sie die Umgebungseinstellung Ausgabe-Koordinatensystem auf Aktuelle Karte [Layer] fest, um dasselbe Koordinatensystem wie die aktuelle Anzeige zu verwenden.

  • Um Features auf der Grundlage ihrer räumlichen Beziehungen zu anderen Features im selben Layer auszuwählen, siehe die Beispiele unter Auswählen anhand einer räumlichen Beziehung im Layer.

  • Die Anzahl der ausgewählten Datensätze wird im Geoverarbeitungsverlauf aufgeführt. Klicken Sie für den Zugriff auf Parameter > Anzahl. Zusätzlich kann die Anzahl der ausgewählten Datensätze mit dem Werkzeug Anzahl erhalten bestimmt werden. In Python kann auch über das Objekt Result des Werkzeugs auf die Anzahl der ausgewählten Datensätze zugegriffen werden.

  • Beim Anwenden von Auswahlen ist auch eine Auswahl ohne Datensätze möglich. Zum Beispiel führt die Verwendung der Option Überschneiden für den Parameter Beziehung, wenn sich keine Features überschneiden, zu einer Auswahl ohne Datensätze. Ein Geoverarbeitungswerkzeug, das den Layer als Eingabe verwendet, verwendet keine Datensätze aus der Eingabe.

  • Weitere Informationen zu den Optionen Überschneiden 3D und In einer Entfernung (3D) für die dreidimensionalen räumlichen Beziehungen finden Sie unter 3D-Beziehungen lagebezogen auswählen.

  • Für den Parameter Beziehung kann die Option Überschneiden (DBMS) eine bessere Leistung als die Option Überschneiden bieten, wenn Enterprise-Geodatabase-Daten verwendet werden; diese Option wird jedoch nur unter bestimmten Bedingungen unterstützt. Wenn alle Bedingungen erfüllt sind, wird die räumliche Operation im Enterprise-Geodatabase-Datenbankmanagementsystem (DBMS) und nicht auf dem Client durchgeführt. Berücksichtigen Sie bei Verwendung dieser Option für räumliche Beziehungen Folgendes:

    • Zum Ausführen der Operation innerhalb des DBMS müssen die folgenden Voraussetzungen erfüllt sein:
      • Die Parameterwerte für Eingabe-Features und Auswahl-Features müssen aus demselben Enterprise-Geodatabase-Workspace stammen und denselben Raumbezug sowie Geometriespeichertyp aufweisen.
      • Der Benutzer, der sich mit der Geodatenbank verbindet, muss über die Berechtigung verfügen, eine Ansicht in der Datenbank zu erstellen, in der die Feature-Classes gespeichert sind.
      • Die unterstützten Geometriespeichertypen für diese Option sind ST_GEOMETRY (IBM Db2, Oracle, PostgreSQL und SAP HANA), PostGIS (PostgreSQL), SDO_GEOMETRY (Oracle) und "Geometrie" und "Geographie" (Microsoft SQL Server). Unter Geodatabase-Verwaltung finden Sie Informationen zum Installieren und Konfigurieren Ihres DBMS sowie zum Konfigurieren des Geometriespeichertyps Ihrer Wahl, damit Sie ihn verwenden können. Nähere Informationen zum jeweiligen Geometriespeichertyp finden Sie in der Dokumentation des Anbieters Ihres DBMS. Beim Durchführen räumlicher Operationen kann es durch Speicherbeschränkungen zu Beeinträchtigungen der Performance und Skalierbarkeit kommen.
      • Wenn die Feature-Classes in Oracle ST_Geometry verwenden, um räumliche Daten zu speichern, müssen Sie extproc in Oracle für den Zugriff auf ST_Geometry konfigurieren. Weitere Informationen finden Sie unter Konfigurieren von "extproc" für den Zugriff auf "ST_Geometry" in Oracle.
      • Der Parameter Suchentfernung ist nicht festgelegt.
      • Der Parameterwert für Auswahltyp ist Neue Auswahl.
      • Die vor der Werkzeugausführung vorgenommene Auswahl wurde mit einer Layer-Definitionsabfrage erstellt, nicht mit einem Auswahlsatz.
    • Die räumliche Operation wird ohne Anwendung einer XY-Toleranz bei der Verarbeitung durchgeführt. Die Verwendung einer XY-Toleranz wird im DBMS nicht unterstützt. Dies kann dazu führen, dass im Vergleich zur Durchführung der Analyse auf dem Client unter Anwendung einer XY-Toleranz geringfügig andere Auswahlen zurückgegeben werden. Weitere Informationen dazu, wie bei clientseitigen Operationen eine XY-Toleranz angewendet wird, finden Sie unter Grundlagen zu Feature-Classes.

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 auszuwertende räumliche Beziehung an.

  • Ü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 Euklidischer Entfernung) angegebenen Entfernung zum Auswahl-Feature befinden. Geben Sie die Entfernung mithilfe des Parameters Suchentfernung an.
  • In einer geodätischen EntfernungDiese räumliche Beziehung entspricht In einer Entfernung, es wird jedoch geodätische anstelle von planarer Entfernung verwendet. 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. Wählen Sie diese Option aus, wenn die Daten eine große geographische Ausdehnung abdecken oder das Koordinatensystem der Eingaben für Entfernungsberechnungen ungeeignet ist. 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 die Option 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 ClementiniDas Ergebnis stimmt mit dem Ergebnis für die Option 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 des betreffenden Layers oder der 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, Überschneiden 3D, Mit Mittelpunkt in oder Enthält.

Wenn die Option In einer Entfernung geodätisch 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 des Parameters Auswahltyp.

  • 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, bleiben 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 Evaluierungsergebnis wird verwendet. Dies ist die Standardeinstellung.
  • Aktiviert: Das Gegenteil des Evaluierungsergebnisses 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 erste Eingabe mit angewendeter Auswahl.

Feature Layer; Mosaic Layer
Ausgabe-Layer-Namen

Ein MultiValue-Parameter, der alle Eingaben enthält, für die eine Auswahl vorliegt.

Verwenden Sie diesen Ausgabeparameter in einem Modell, um ein Werkzeug wie Zusammenführen (Merge) mit einer MultiValue-Eingabe zu verbinden.

Feature Layer; Mosaic Layer
Anzahl

Die Anzahl der ausgewählten Datensätze.

Wenn es mehrere Werte für den Parameter Eingabe-Features gibt, wird die Anzahl in der Reihenfolge der Eingaben ausgegeben.

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 auszuwertende räumliche Beziehung an.

  • 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 Euklidischer Entfernung) 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_GEODESICDiese räumliche Beziehung entspricht WITHIN_A_DISTANCE, es wird jedoch geodätische anstelle von planarer Entfernung verwendet. 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. Wählen Sie diese Option aus, wenn die Daten eine große geographische Ausdehnung abdecken oder das Koordinatensystem der Eingaben für Entfernungsberechnungen ungeeignet ist. 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 die Option 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_CLEMENTINIDas Ergebnis stimmt mit dem Ergebnis für die Option WITHIN überein, es sei denn, das gesamte Feature im Eingabe-Layer befindet sich auf der Grenze des Features im Ausgabe-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 des betreffenden Layers oder der 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 des Parameters selection_type.

  • 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, bleiben 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 sowie overlap_type werden bei Aktivierung 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 Evaluierungsergebnis wird verwendet. Dies ist die Standardeinstellung.
  • INVERTDas Gegenteil des Evaluierungsergebnisses 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 erste Eingabe mit angewendeter Auswahl.

Feature Layer; Mosaic Layer
out_layers_or_views

Ein MultiValue-Parameter, der alle Eingaben enthält, für die eine Auswahl vorliegt.

Verwenden Sie diesen Ausgabeparameter in einem Modell, um ein Werkzeug wie Zusammenführen (Merge) mit einer MultiValue-Eingabe zu verbinden.

Feature Layer; Mosaic Layer
count

Die Anzahl der ausgewählten Datensätze.

Wenn es mehrere Werte für den Parameter in_features gibt, wird die Anzahl in der Reihenfolge der Eingaben ausgegeben.

Long

Codebeispiel

SelectLayerByLocation: Beispiel 1 (Python-Fenster)

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

import arcpy
arcpy.management.SelectLayerByLocation("parcel_lyr", "have_their_center_in", 
                                       "c:/kamsack.gdb/city_limits")
SelectLayerByLocation: Beispiel 2 (eigenständiges Skript)

Das folgende eigenständige Skript zeigt, wie mit der Funktion SelectLayerByLocation in einem Workflow 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 data
import arcpy
arcpy.env.workspace = "c:/data/mexico.gdb"

# Make a layer and select cities that overlap the chihuahua polygon
chihuahua_cities = arcpy.management.SelectLayerByLocation('cities', 'INTERSECT', 
                                                          'chihuahua')

# From the previous selection, select a subset of cities that have 
# population > 10,000
arcpy.management.SelectLayerByAttribute(chihuahua_cities, 
                                        'SUBSET_SELECTION', 
                                        '"population" > 10000')

# If features matched criteria, write them to a new feature class
matchcount = int(arcpy.management.GetCount(chihuahua_cities)[0]) 

if matchcount == 0:
    print('no features matched spatial and attribute criteria')
else:
    arcpy.management.CopyFeatures(chihuahua_cities, 'chihuahua_10000plus')
    print('{0} cities that matched criteria written to {0}'.format(
        matchcount, chihuahua_10000plus))
SelectLayerByLocation: Beispiel 3 (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 data
import arcpy

arcpy.env.workspace = r"c:\data\mexico.gdb"

arcpy.management.SelectLayerByLocation('cities', 'WITHIN_A_DISTANCE', 
                                       'chihuahua', '1.5 Miles')
arcpy.management.SelectLayerByLocation('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 
# system
arcpy.management.SelectLayerByLocation('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 meters
arcpy.management.SelectLayerByLocation('cities', 'WITHIN_A_DISTANCE_GEODESIC', 
                                       'chihuahua', '200')

Verwandte Themen