Zusammenfassung
Erstellt ein Gitter rechteckiger Polygon-Features, das als Index zum Angeben von Seiten für eine räumliche Kartenserie verwendet werden kann. Sie können ein Gitter erstellen, das nur Polygon-Features umfasst, die einen anderen Feature-Layer überschneiden.
Verwendung
Das Koordinatensystem der Ausgabe-Feature-Class wird in der folgenden Reihenfolge bestimmt:
- Wenn ein Koordinatensystem durch die Umgebung "Ausgabe-Koordinatensystem" angegeben wird, wird dieses Koordinatensystem in der Ausgabe-Feature-Class verwendet.
- Wenn durch die Umgebung "Ausgabe-Koordinatensystem" kein Koordinatensystem angegeben wird, wird in der Ausgabe-Feature-Class das Koordinatensystem der aktiven Karte bzw. des Kartenrahmens verwendet.
- Wenn mit der Umgebung "Ausgabe-Koordinatensystem" kein Koordinatensystem angegeben wird und keine aktive Karte verfügbar ist (ArcGIS Pro ist nicht geöffnet), wird für die Ausgabe-Feature-Class das Koordinatensystem des ersten Eingabe-Features verwendet.
- Wenn mit der Umgebung "Ausgabe-Koordinatensystem" kein Koordinatensystem angegeben wird, keine aktive Karte verfügbar ist (ArcGIS Pro ist nicht geöffnet) und keine Eingabe-Features angegeben wurden, ist das Koordinatensystem der Ausgabe-Feature-Class unbekannt.
Als Parameter für Eingabe-Features können Punkte, Linien oder Raster verwendet werden.
Bei Verwendung des Parameters Seiteneinheit und Kartenmaßstab verwenden ist der Parameter Kartenmaßstab erforderlich.
Wenn Sie das Werkzeugdialogfeld verwenden und der Parameter Ursprungskoordinate des Polygongitters angegeben ist, führen Änderungen der Breiten- oder Höhenwerte für Polygone automatisch zur Änderung der Anzahl der Zeilen und Spalten. Zeilen und Spalten werden automatisch basierend auf den Ursprungskoordinaten des Gitters der Feature-Class-Ausdehnung berechnet. Wenn die XY-Koordinaten des Ursprungs so geändert werden, dass die Gesamtausdehnung erhöht wird, wird die entsprechende Anzahl der Zeilen und Spalten aktualisiert. Bei einer Erhöhung der Gesamtausdehnung werden die Änderungen ignoriert und wird die volle Ausdehnung der Features verwendet.
Wenn Sie den Parameter Eingabe-Features hinzufügen, wird der Parameterwert Ursprungskoordinate des Polygongitters automatisch berechnet.
Wenn Seiteneinheit und Maßstab verwenden aktiviert ist, ändern sich die Einheiten für Polygonbreite und Polygonhöhe automatisch in die Seiteneinheiten, die im aktiven Kartenrahmen festgelegt sind. Wenn Sie das Werkzeug außerhalb einer ArcGIS Pro-Sitzung verwenden, werden die Einheiten standardmäßig auf Zoll festgelegt. Obwohl Sie Karteneinheiten selbst angeben können, z. B. Meter oder Meilen, sollten Sie Einheiten verwenden, die für die Seite geeignet sind.
Wenn Seiteneinheit und Maßstab verwenden aktiviert ist, wird der Kartenmaßstab standardmäßig auf den Maßstabswert des aktiven Kartenrahmens im Seitenlayout festgelegt. Wenn Sie das Werkzeug außerhalb einer ArcGIS Pro-Sitzung verwenden, wird der Maßstab standardmäßig auf 1 festgelegt.
Sie erzielen optimale Ergebnisse, wenn sich alle Eingabe-Feature-Layer und Feature-Classes im gleichen Koordinatensystem wie die Karte oder der Kartenrahmen befinden. Wird das Werkzeug außerhalb einer ArcGIS Pro-Sitzung verwendet, werden optimale Ergebnisse erzielt, wenn sich alle Eingabe-Feature-Layer und Feature-Classes im gleichen Koordinatensystem wie der erste Eingabe-Feature-Layer oder die erste Feature-Class in der Liste befinden.
Syntax
arcpy.cartography.GridIndexFeatures(out_feature_class, {in_features}, {intersect_feature}, {use_page_unit}, {scale}, {polygon_width}, {polygon_height}, {origin_coord}, {number_rows}, {number_columns}, {starting_page_number}, {label_from_origin})| Parameter | Erklärung | Datentyp |
out_feature_class | Die aus Polygon-Index-Features resultierende Feature-Class. Das Koordinatensystem der Ausgabe-Feature-Class wird in der folgenden Reihenfolge bestimmt:
| Feature Class |
in_features [in_features,...] (optional) | Die Eingabe-Features, die zum Definieren der Ausdehnung des zu erstellenden Polygongitters verwendet werden sollen. | Feature Layer; Raster Layer |
intersect_feature (optional) | Beschränkt die Ausgabe-Grid-Feature-Class auf Flächen, die die Eingabe-Feature-Layer oder -Datasets überschneiden. Der Schnittpunkt von Eingabe-Features wird verwendet, um Index-Features zu erstellen.
| Boolean |
use_page_unit (optional) | Gibt an, ob die Größenangabe für Index-Polygone in Seiteneinheiten angegeben wird.
| Boolean |
scale (optional) | Der Kartenmaßstab. Der Maßstab muss angegeben werden, wenn die Höhe und Breite des Index-Polygons in Seiteneinheiten berechnet werden sollen. Wenn das Werkzeug außerhalb einer aktiven ArcGIS Pro-Sitzung verwendet wird, beträgt der Standardmaßstabswert 1. | Long |
polygon_width (optional) | Die Breite des Index-Polygons in Karten- oder Seiteneinheiten. Bei Verwendung von Seiteneinheiten beträgt der Standardwert 1 Zoll. Bei Verwendung von Karteneinheiten beträgt der Standardwert 1 Grad. | Linear Unit |
polygon_height (optional) | Die Höhe des Index-Polygons in Karten- oder Seiteneinheiten. Bei Verwendung von Seiteneinheiten beträgt der Standardwert 1 Zoll. Bei Verwendung von Karteneinheiten beträgt der Standardwert 1 Grad. | Linear Unit |
origin_coord (optional) | Der Koordinatenwert für den Ursprung links unten der Ausgabe-Grid-Feature-Class. Wenn Eingabe-Features angegeben sind, wird der Standardwert anhand der Ausdehnung der Vereinigungsmengen der Ausdehnungen dieser Features bestimmt. Wenn keine Eingabe-Features angegeben sind, sind die Standardkoordinaten 0 und 0. | Point |
number_rows (optional) | Die Anzahl der Zeilen, die in der Y-Richtung ab dem Ursprungspunkt erstellt werden sollen. Die Standardeinstellung ist 10. | Long |
number_columns (optional) | Die Anzahl der Spalten, die in der X-Richtung ab dem Ursprungspunkt erstellt werden sollen. Die Standardeinstellung ist 10. | Long |
starting_page_number (optional) | Jedem Indexgitter-Feature wird eine sequenzielle Seitenzahl zugewiesen, die mit einer angegebenen Start-Seitenzahl beginnt. Der Standardwert ist 1. | Long |
label_from_origin (optional) | Gibt an, wo die Seitenzahlen (Beschriftungen) beginnen.
| Boolean |
Codebeispiel
Im folgenden Beispiel werden Indexgitter-Features anhand des Schnittpunktes von Eingabe-Features sowie der angegebenen Index-Feature-Bemaßungen in Karteneinheiten erstellt.
import arcpy
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.GridIndexFeatures_cartography("gridIndexFeatures","poly", "", "", "",
"1000 meters", "1000 meters")Im folgenden Beispiel werden Indexgitter-Features anhand der gesamten Ausdehnung von Eingabe-Features sowie der angegebenen Index-Feature-Bemaßungen in Seiteneinheiten erstellt.
import arcpy
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.GridIndexFeatures_cartography("gridIndexFeatures","poly",
"NO_INTERSECTFEATURE", "USEPAGEUNIT",
"100000", "5 inches", "5 inches")Im folgenden Beispiel werden Indexgitter-Features anhand des Schnittpunktes von Eingabe-Features, der angegebenen Index-Feature-Bemaßungen in Karteneinheiten sowie 5 als Seitenzahl der Anfangsseite erstellt.
import arcpy
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.GridIndexFeatures_cartography("gridIndexFeatures","poly", "", "", "",
"1000 meters", "1000 meters", "", "",
"", "5")Im folgenden Beispiel werden Indexgitter-Features durch Angabe der Ursprungskoordinaten, der Index-Feature-Bemaßungen in Karteneinheiten, der Anzahl der Zeilen und der Anzahl der Spalten erstellt.
import arcpy
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.GridIndexFeatures_cartography("gridIndexFeatures", "", "", "", "",
"1000 meters","1000 meters",
"-6000000 -1600000", "15", "20")Im folgenden Beispiel werden Indexgitter-Features durch Angabe der Ursprungskoordinaten, der Index-Feature-Bemaßungen in Seiteneinheiten, der Anzahl der Zeilen, der Anzahl der Spalten, 5 als Seitenzahl der Anfangsseite und am Ursprung beginnender Beschriftung erstellt.
import arcpy
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.GridIndexFeatures_cartography("gridIndexFeatures", "", "", "USEPAGEUNIT",
"100000", "5 inches", "5 inches",
"-6000000 -1600000", "15", "20", "5",
"LABELFROMORIGIN")Im folgenden Beispiel werden Indexgitter-Features anhand des Schnittpunktes von Eingabe-Features sowie der angegebenen Index-Feature-Bemaßungen in Karteneinheiten erstellt.
# gridindexfeatures_example1.py
# Description: Creates Grid Index Features using the intersection of input
# features and specified index feature dimensions in map units
# Author: ESRI
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
arcpy.env.workspace = "C:\data\ProjectData.gdb"
# Set local variables
outFeatureClass = "gridIndexFeatures"
inFeatures = "poly"
polygonWidth = "1000 meters"
polygonHeight= "1000 meters"
# Execute GridIndexFeatures
arcpy.GridIndexFeatures_cartography(outFeatureClass,inFeatures, "", "", "",
polygonWidth, polygonHeight)Im folgenden Beispiel werden Indexgitter-Features anhand der gesamten Ausdehnung von Eingabe-Features sowie der angegebenen Index-Feature-Bemaßungen in Seiteneinheiten erstellt.
# gridindexfeatures_example2.py
# Description: Creates Grid Index Features using the entire extent of input
# features and specified index feature dimensions in page units
# Author: ESRI
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
arcpy.env.workspace = "C:\data\ProjectData.gdb"
# Set local variables
outFeatureClass = "gridIndexFeatures"
inFeatures = "poly"
noIntersect = "NO_INTERSECTFEATURE"
usePageUnit = "USEPAGEUNIT"
scale = "100000"
polygonWidth = "5 inches"
polygonHeight= "5 inches"
# Execute GridIndexFeatures
arcpy.GridIndexFeatures_cartography(outFeatureClass, inFeatures, noIntersect,
usePageUnit, scale, polygonWidth,
polygonHeight)Im folgenden Beispiel werden Indexgitter-Features anhand des Schnittpunktes von Eingabe-Features, der angegebenen Index-Feature-Bemaßungen in Karteneinheiten sowie 5 als Seitenzahl der Anfangsseite erstellt.
# gridindexfeatures_example3.py
# Description: Creates Grid Index Features using the intersection of input
# features, specified index feature dimensions in map units and 5 as the
# starting page number
# Author: ESRI
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
arcpy.env.workspace = "C:\data\ProjectData.gdb"
# Set local variables
outFeatureClass = "gridIndexFeatures"
inFeatures = "poly"
polygonWidth = "1000 meters"
polygonHeight= "1000 meters"
startingPageNum = "5"
# Execute GridIndexFeatures
arcpy.GridIndexFeatures_cartography(outFeatureClass,inFeatures, "", "", "",
polygonWidth, polygonHeight, "", "", "",
startingPageNum)Im folgenden Beispiel werden Indexgitter-Features durch Angabe der Ursprungskoordinaten, der Index-Feature-Bemaßungen in Karteneinheiten, der Anzahl der Zeilen und der Anzahl der Spalten erstellt.
# gridindexfeatures_example4.py
# Description: Creates Grid Index Features by specifying the origin
# coordinates, the index feature dimensions in map units, the number of
# rows and the number of columns
# Author: ESRI
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
env.workspace = "C:\data\ProjectData.gdb"
env.outputCoordinateSystem = arcpy.SpatialReference("North America Albers Equal Area Conic.prj")
# Set local variables
outFeatureClass = "gridIndexFeatures"
polygonWidth = "1000 meters"
polygonHeight= "1000 meters"
originCoord = "-6000000 -1600000"
numberRows = "15"
numberColumns = "20"
# Execute GridIndexFeatures
arcpy.GridIndexFeatures_cartography(outFeatureClass, "", "", "", "",
polygonWidth, polygonHeight, originCoord,
numberRows, numberColumns)Im folgenden Beispiel werden Indexgitter-Features durch Angabe der Ursprungskoordinaten, der Index-Feature-Bemaßungen in Seiteneinheiten, der Anzahl der Zeilen, der Anzahl der Spalten, 5 als Seitenzahl der Anfangsseite und am Ursprung beginnender Beschriftung erstellt.
# gridindexfeatures_example5.py
# Description: Creates Grid Index Features by specifying the origin
# coordinates, the index feature dimensions in page units, the number of
# rows, the number of columns, 5 as the starting page number and labeling
# to start at the origin
# Author: ESRI
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
env.workspace = "C:\data\ProjectData.gdb"
env.outputCoordinateSystem = arcpy.SpatialReference("North America Albers Equal Area Conic.prj")
# Set local variables
outFeatureClass = "gridIndexFeatures"
usePageUnit = "USEPAGEUNIT"
scale = "100000"
polygonWidth = "1000 meters"
polygonHeight= "1000 meters"
originCoord = "-6000000 -1600000"
numberRows = "15"
numberColumns = "20"
startingPageNum = "5"
labeling = "LABELFROMORIGIN"
# Execute GridIndexFeatures
arcpy.GridIndexFeatures_cartography(outFeatureClass, "", "", usePageUnit,
scale, polygonWidth, polygonHeight,
originCoord, numberRows, numberColumns,
startingPageNum, labeling)Umgebungen
Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja