Zusammenfassung
Erstellt einen gruppierten Layer von Feature-Classes, der Gitternetz-, Gradnetz- und Rahmen-Features mit vordefinierten kartografischen Spezifikationen darstellt. Gitternetz-Layer sind ideal für erweiterte maßstabs- und ausdehnungsspezifische Gitternetzdefinitionen.
Ein Gitternetz-Layer kann aus einem Maskenpolygon, einem Clip-Polygon, Segmenten (Linie), Gitternetzlinien (Linie), Ticks (Linie), Endpunkten (Punkt), Punkten (Punkt) und Annotation-Feature-Classes bestehen. Diese Komponenten werden als Features in entsprechenden Feature-Classes gespeichert. Diese Feature-Classes werden innerhalb eines angegebenen Feature-Datasets in einer Geodatabase gespeichert. Es gibt sieben Feature-Classes, in denen die grundlegenden Komponenten eines Gitternetzes gespeichert werden. Jede Feature-Class wird mit einem aus drei Buchstaben bestehenden Präfix benannt, das die Identifikation der in der Feature-Class enthaltenen Gitternetzkomponenten erleichtert. Diese Feature-Classes/Komponenten lauten wie folgt:
- ANO_ ist die Annotation-Feature-Class.
- EPT_ ist die Endpoints-Feature-Class.
- GLN_ ist die Gridlines-Feature-Class.
- MSK_ ist die Masks-Feature-Class.
- PNT_ ist die Points-Feature-Class.
- SEG_ ist die Segments-Feature-Class.
- TKS_ ist die Ticks-Feature-Class.
Diese Feature-Classes können Informationen für mehrere Gitternetze enthalten. Eine achte Feature-Class (GRD_) enthält organisatorische Informationen, z. B. Kartenname und Gittertypen, die verwendet werden, um die Gitter zu organisieren.
Die Gitternetz-Definitionsvorlage ist in einer vordefinierten XML-Datei gespeichert. In dieser Datei sind Spezifikationseigenschaften für jedes Gitternetz gespeichert, z. B. die Zahl, Farbe und Linienstärke von Gitternetzlinien. Wenn die Definitionsvorlage angewendet wird, werden Features nach der Spezifikation auf Grundlage der aktuellen Ausdehnung oder der Ausdehnung eines ausgewählten Features (Interessenbereich), des Maßstabs oder Koordinatensystems erstellt.
Verwendung
Dieses Werkzeug ist für projizierte Karten konzipiert, die gedruckt oder exportiert werden. Es ist nicht zum Erstellen von Gitter- oder Gradnetzen vorgesehen, die beim Navigieren des Benutzers in der Karte dynamisch aktualisiert werden.
Sie müssen einen Interessenbereich eingeben, um die Ausdehnung des zu erstellenden Gitternetz-Layers zu bestimmen. Wenn Sie zur Definition des Interessenbereichs einen Feature-Layer verwenden, muss es sich um eine Polygon-Feature-Class oder einen Polygon-Layer handeln.
Sobald der Parameter Gitternetz-Vorlage (XML-Datei) definiert wurde, können Sie mit der Maus auf den kontextbezogenen Bereich links neben dem Parameternamen zeigen oder darauf klicken, um Informationen zur definierten XML-Gitternetz-Definitionsvorlage (Gitternetztyp, Beschreibung, Rotationstyp und Maßstabstyp) anzuzeigen.
Die Gitternetz-Vorlagen-XML-Datei gibt Gitternetz-Komponenten an, die Messungen oder Positionen zu primären und Zusatzkoordinatensystemen darstellen. Die angegebenen Koordinatensysteme müssen ein gemeinsames geographisches Koordinatensystem besitzen. Wenn Sie das primäre Koordinatensystem in ein Koordinatensystem ändern möchten, das ein anderes Datum verwendet als das Standard-Koordinatensystem (z. B. ein Koordinatensystem, das WGS 1984 verwendet, in ein Koordinatensystem, das NAD 1983 verwendet), müssen Sie auch jedes Standard-Zusatzkoordinatensystem in NAD 1983 ändern.
Die Gitternetz-Vorlage, der Interessenbereich (Area of Interest, AOI), das Eingabe-Feature-Dataset und die primären und Zusatzkoordinatensystemparameter müssen das gleiche Datum, z. B. WGS 1984 oder NAD 1983, verwenden.
Die Gitternetz-Vorlagen-XML-Datei erstellt Gitternetz-Komponenten für bis zu vier Zusatzkoordinatensysteme. Die Anzahl der Nebengitternetze ist in der XML-Datei angegeben. Sie können keine Zusatzkoordinatensysteme hinzufügen oder löschen, aber Sie können die Standardwerte überschreiben.
Das primäre Koordinatensystem muss ein projiziertes Koordinatensystem sein
Bei einem Zusatzkoordinatensystem kann es sich um ein geographisches oder um ein projiziertes Koordinatensystem handeln.
Dem Raumbezug des Eingabe-Feature-Datasets muss das in der Gitternetz-Vorlagen-XML-Datei angegebene geographische Koordinatensystem zu Grunde liegen.
Dem Raumbezug des Eingabe-Interessenbereichs muss das in der Gitternetz-Vorlagen-XML-Datei angegebene geographische Koordinatensystem zu Grunde liegen.
Wenn Sie über ArcMap auf das Werkzeug zugreifen, können Sie durch Aktivieren des Kontrollkästchens Datenrahmen und Layout mit Gitter-Einstellungen konfigurieren sicherstellen, dass der Datenrahmen im Layout optimal an das erstellte Gitter angepasst wird. Das Koordinatensystem des Datenrahmens sowie Maßstab, Drehung, Größe, Ausdehnung und Ausschnitt können zur besseren Übereinstimmung mit der XML-Gitternetz-Spezifikation geändert werden. Diese Einstellung ist nur dann verfügbar, wenn das Werkzeug in der Layout-Ansicht in ArcMap und nicht im Hintergrund ausgeführt wird. In der Standardeinstellung ist dieses Kontrollkästchen deaktiviert, wodurch keine Datenrahmeneigenschaften geändert werden.
Wenn der angegebene Gitter-Name bereits im Ausgabeverzeichnis vorhanden ist, wird das vorhandene Gitter überschrieben.
Die folgenden Parameterwerte werden automatisch von der Gitternetz-Vorlagen-XML-Datei abgeleitet:
- Ausgabe-Layer
- Name mit dem Zeichenfolgenwert
- Bezugsmaßstab
- Rotation
- Maskengröße
- XY-Toleranz
- Primäres Koordinatensystem
- Zusatzkoordinatensystem
Diese Standardwerte können jedoch mit neuen Werten überschrieben werden.
Syntax
arcpy.cartography.MakeGridsAndGraticulesLayer(in_template, in_aoi, input_feature_dataset, output_layer, {name}, {refscale}, {rotation}, {mask_size}, {xy_tolerance}, {primary_coordinate_system}, {configure_layout}, {ancillary_coordinate_system_1}, {ancillary_coordinate_system_2}, {ancillary_coordinate_system_3}, {ancillary_coordinate_system_4})
Parameter | Erklärung | Datentyp |
in_template | In der XML-Gitternetz-Definitionsvorlage sind die grafischen Eigenschaften der Spezifikation für jeden Gitternetz-Layer gespeichert. Zusätzlich zu den grafischen Eigenschaften, die vor dem Ausführen nicht geändert werden können, weist die Definition bestimmte Standardwerte in Form von Parametern auf, die vor dem Ausführen geändert werden können. Vorlagendateien befinden sich im Verzeichnis GridTemplates. Zusätzliche Gitternetzvorlagen können über das ArcGIS Resource Center bezogen und weitergegeben werden. Die Erweiterung "Production Mapping" stellt auch einen Gitternetz-Designer bereit, mit dem Sie neue Vorlagen erstellen und vorhandene ändern können. | File |
in_aoi | Der Feature-Layer oder die XY-Ausdehnung, die zur Festlegung des erstellten Gitternetz-Layers verwendet wird.
| Feature Layer; Extent |
input_feature_dataset | Das Feature-Dataset, in dem die Features gespeichert werden. Gitternetzspezifische Feature-Classes werden erstellt, wenn sie nicht bereits vorhanden sind. Wenn sie bereits vorhanden sind und ein Gitternetz mit dem gleichen Namen und Typ wie das gerade erstellte ebenfalls vorhanden ist, wird es überschrieben. | Feature Dataset |
output_layer | Der gruppierte Layer von Feature-Classes, der Gitternetz-, Gradnetz- und Rahmen-Features darstellt. Ein Gitternetz-Layer kann aus einem Maskenpolygon, einem Clip-Polygon, Segmenten (Linie), Gitternetzlinien (Linie), Ticks (Linie), Endpunkten (Punkt), Punkten (Punkt) und Annotation-Feature-Classes bestehen. | Group Layer |
name (optional) | Der Name des erstellten kartografischen Gitternetzes, der die Unterscheidung zwischen Gitternetzen ermöglicht, die im gleichen Feature-Dataset und Satz von Feature-Classes gespeichert sind, in einem der folgenden Formate:
Der Gitternetzname darf die folgenden Sonderzeichen nicht enthalten:
| String; Field |
refscale (optional) | Der Maßstab, in dem das Gitternetz erstellt wird und angezeigt werden sollte. Wenn der Bezugsmaßstab für die XML-Gitternetz-Definitionsdatei als "Umgebung verwenden" definiert wird, wird der Bezugsmaßstab in folgender Reihenfolge abgeleitet:
| Double |
rotation (optional) | Der Rotationswinkel für die Gitternetzkomponenten. Rotation wird verwendet, um Annotationen entsprechend der Seite bereitzustellen. Wenn nicht anders angegeben, wird die Rotation mithilfe des Interessenbereich-Features berechnet. Wenn der Rotationstyp für die XML-Gitternetz-Definitionsdatei als "Umgebung verwenden" definiert wird, wird die Rotation in folgender Reihenfolge abgeleitet:
| Double |
mask_size (optional) | Die Maske ist ein Polygon-Feature, das einen äußeren Ring um die Ausdehnung des Kartenrahmens bildet und zur Maskierung von Daten verwendet wird, die in die für Koordinatenbeschriftungen reservierte Fläche fallen. Die Maskengröße legt die Breite des Polygonmasken-Features in Karten- oder Seiteneinheiten fest. Die Größe des Datenrahmens muss möglicherweise geändert werden, damit dieser sowohl die Kante der Maske als auch die Koordinatenbeschriftungen umfasst. | Linear Unit |
xy_tolerance (optional) | Die minimal zulässige Entfernung zwischen Geodatabase-Features in linearen Einheiten. Für diesen Wert wird als Standard der Wert aus der XML-Datei übernommen. Sie können den Wert für Daten mit einer geringeren Koordinatengenauigkeit höher und für Daten mit sehr hoher Genauigkeit niedriger festlegen. Features, die in die festgelegte XY-Toleranz fallen, werden als lagegleich angesehen. | Linear Unit |
primary_coordinate_system (optional) | Mit der Gitternetz-Vorlagen-XML-Datei werden Gitternetzkomponenten erstellt, die Koordinaten oder Positionen für ein primäres und bis zu vier Zusatzkoordinatensysteme darstellen. Die Anzahl der Nebengitternetze ist in der XML-Datei angegeben. Sie können keine Zusatzkoordinatensysteme hinzufügen oder löschen. Die angegebenen Koordinatensysteme müssen ein gemeinsames geographisches Koordinatensystem besitzen. Wenn Sie das primäre Koordinatensystem in ein Koordinatensystem ändern möchten, das ein anderes Datum verwendet als das Standard-Koordinatensystem (z. B. ein Koordinatensystem, das WGS 1984 verwendet, in ein Koordinatensystem, das NAD 1983 verwendet), müssen Sie auch jedes Standard-Zusatzkoordinatensystem in NAD 1983 ändern. Dies ist das primäre Koordinatensystem für den Gitternetz-Layer, der gerade erstellt wird. In der Regel ist dies das Koordinatensystem des endgültigen Produkts oder Datenrahmens. Dieses Koordinatensystem muss ein projiziertes Koordinatensystem sein. Wenn das primäre Koordinatensystem in der XML-Gitternetz-Definitionsdatei als "Umgebung verwenden" definiert wird, wird das primäre Koordinatensystem in folgender Reihenfolge abgeleitet:
In allen Fällen hat die Benutzereingabe den höchsten Vorrangswert. | Spatial Reference |
configure_layout (optional) | Passt die Datenrahmeneinstellungen an, um sicherzustellen, dass sie mit dem Gitternetz-Layer übereinstimmen. Das Koordinatensystem des Datenrahmens sowie Maßstab, Drehung, Größe, Ausdehnung und Ausschnitt können geändert werden, um Konsistenz zu gewährleisten. Diese Einstellung ist nur dann verfügbar, wenn das Werkzeug in der Layout-Ansicht in ArcMap und nicht im Hintergrund ausgeführt wird.
| Boolean |
ancillary_coordinate_system_1 (optional) | Mit der Gitternetz-Vorlagen-XML-Datei werden Gitternetzkomponenten erstellt, die Koordinaten oder Positionen für ein primäres und bis zu vier Zusatzkoordinatensysteme darstellen. Die Anzahl der Nebengitternetze ist in der XML-Datei angegeben. Sie können keine Zusatzkoordinatensysteme hinzufügen oder löschen. Die angegebenen Koordinatensysteme müssen ein gemeinsames geographisches Koordinatensystem besitzen. Wenn Sie das primäre Koordinatensystem in ein Koordinatensystem ändern möchten, das ein anderes Datum verwendet als das Standard-Koordinatensystem (z. B. ein Koordinatensystem, das WGS 1984 verwendet, in ein Koordinatensystem, das NAD 1983 verwendet), müssen Sie auch jedes Standard-Zusatzkoordinatensystem in NAD 1983 ändern. Dies ist das erste Zusatzkoordinatensystem. | Spatial Reference |
ancillary_coordinate_system_2 (optional) | Mit der Gitternetz-Vorlagen-XML-Datei werden Gitternetzkomponenten erstellt, die Koordinaten oder Positionen für ein primäres und bis zu vier Zusatzkoordinatensysteme darstellen. Die Anzahl der Nebengitternetze ist in der XML-Datei angegeben. Sie können keine Zusatzkoordinatensysteme hinzufügen oder löschen. Die angegebenen Koordinatensysteme müssen ein gemeinsames geographisches Koordinatensystem besitzen. Wenn Sie das primäre Koordinatensystem in ein Koordinatensystem ändern möchten, das ein anderes Datum verwendet als das Standard-Koordinatensystem (z. B. ein Koordinatensystem, das WGS 1984 verwendet, in ein Koordinatensystem, das NAD 1983 verwendet), müssen Sie auch jedes Standard-Zusatzkoordinatensystem in NAD 1983 ändern. Dies ist das zweite Zusatzkoordinatensystem. | Spatial Reference |
ancillary_coordinate_system_3 (optional) | Mit der Gitternetz-Vorlagen-XML-Datei werden Gitternetzkomponenten erstellt, die Koordinaten oder Positionen für ein primäres und bis zu vier Zusatzkoordinatensysteme darstellen. Die Anzahl der Nebengitternetze ist in der XML-Datei angegeben. Sie können keine Zusatzkoordinatensysteme hinzufügen oder löschen. Die angegebenen Koordinatensysteme müssen ein gemeinsames geographisches Koordinatensystem besitzen. Wenn Sie das primäre Koordinatensystem in ein Koordinatensystem ändern möchten, das ein anderes Datum verwendet als das Standard-Koordinatensystem (z. B. ein Koordinatensystem, das WGS 1984 verwendet, in ein Koordinatensystem, das NAD 1983 verwendet), müssen Sie auch jedes Standard-Zusatzkoordinatensystem in NAD 1983 ändern. Dies ist das dritte Zusatzkoordinatensystem. | Spatial Reference |
ancillary_coordinate_system_4 (optional) | Mit der Gitternetz-Vorlagen-XML-Datei werden Gitternetzkomponenten erstellt, die Koordinaten oder Positionen für ein primäres und bis zu vier Zusatzkoordinatensysteme darstellen. Die Anzahl der Nebengitternetze ist in der XML-Datei angegeben. Sie können keine Zusatzkoordinatensysteme hinzufügen oder löschen. Die angegebenen Koordinatensysteme müssen ein gemeinsames geographisches Koordinatensystem besitzen. Wenn Sie das primäre Koordinatensystem in ein Koordinatensystem ändern möchten, das ein anderes Datum verwendet als das Standard-Koordinatensystem (z. B. ein Koordinatensystem, das WGS 1984 verwendet, in ein Koordinatensystem, das NAD 1983 verwendet), müssen Sie auch jedes Standard-Zusatzkoordinatensystem in NAD 1983 ändern. Dies ist das vierte Zusatzkoordinatensystem. | Spatial Reference |
Codebeispiel
Werkzeug "MakeGridsAndGraticulesLayer" – Beispiel 1 (eigenständiges Skript)
Dieses eigenständige Skript stellt ein Beispiel für die Verwendung des Werkzeugs MakeGridsAndGraticulesLayer zum Erstellen eine kartografischen Gitternetzes dar.
# Name: MakeGridsAndGraticulesLayer.py
# Description: Create grid for a selected area of interest in a file
# geodatabase
# Import system module
import arcpy
import os
# Create a feature layer from the input area of interest feature class
# to pass to the Selection geoprocess below
arcpy.MakeFeatureLayer_management("C:/Base_Data/AOIs.gdb/QUAD_24K",
"QUAD_24K")
# Select a feature from the area of interest feature layer based on a
# definition query (this query, formatted for a file geodatabase, has
# been adjusted for use in python, in particular the use of \ in
# conjunction with the double quotes surrounding the field name in the
# definition query)
arcpy.SelectLayerByAttribute_management("QUAD_24K", "NEW_SELECTION",
"\"MSNAME\" = 'Swift Minnesota'")
# Set the values of the tool's parameters using one of the grid
# definition XML files located under the GridTemplates directory
template = os.path.join(arcpy.GetInstallInfo()['InstallDir'],
"GridTemplates/Quad_24K_NAD83.xml")
in_aoi = "QUAD_24K"
input_feature_dataset = "C:/Python_Output/grid_layers.gdb/QUAD_24K"
output_layer = "QUAD_24K_NAD83_Grid"
name = "MSNAME"
# Process: Make Grids and Graticules Layer
arcpy.MakeGridsAndGraticulesLayer_cartography(template, in_aoi,
input_feature_dataset,
output_layer, name)
Umgebungen
Lizenzinformationen
- Basic: Nein
- Standard: Ja
- Advanced: Ja