Résumé
Crée un quadrillage d'entités surfaciques rectangulaires pouvant être utilisé en tant qu'index pour spécifier des pages pour un atlas à l'aide de pages dynamiques. Un quadrillage peut être créé uniquement à partir d'entités surfaciques qui coupent une autre couche d'entités.
Utilisation
Le système de coordonnées de la classe d'entités en sortie est déterminé dans cet ordre.
- Si un système de coordonnées est spécifié par la variable Système de coordonnées en sortie dans Paramètres d'environnement, la classe d'entités en sortie utilise ce système de coordonnées.
- Si aucun système de coordonnées n'est spécifié par Système de coordonnées en sortie, la classe d'entités en sortie utilise le système de coordonnées du bloc de données actif (ArcMap est ouvert).
- Si aucun système de coordonnées n'est spécifié par Système de coordonnées en sortie et qu'aucun bloc de données n'est actif (ArcMap n'est pas ouvert) la classe d'entités en sortie utilise le système de coordonnées de la première entité en entrée.
- Si aucun système de coordonnées n'est spécifié par Système de coordonnées en sortie, qu'aucun bloc de données n'est actif (ArcMap n'est pas ouvert) et qu'aucune classe d'entités n'est indiquée, le système de coordonnées de la classe d'entités en sortie est inconnu.
Les entités en entrée peuvent être des points, des lignes, des polygones ou des rasters.
Lorsque vous sélectionnez Utiliser l'unité et l'échelle de la page, Echelle de la carte devient un paramètre requis.
Lors de l'utilisation de la boîte de dialogue de l'outil, si vous modifiez les valeurs de largeur ou de hauteur des polygones lorsque les coordonnées d'origine du quadrillage du polygone ont été spécifiées, le nombre de lignes et de colonnes change automatiquement.
Lorsque vous ajoutez Entités en entrée, les coordonnées d'origine du quadrillage sont calculées automatiquement.
Il est judicieux d'enregistrer la classe d'entités en sortie dans une géodatabase. Bien qu'il soit possible d'enregistrer la sortie dans un fichier de formes, si vous avez l'intention de calculer les références spatiales pour les entités de la couche d'indexation à l'aide de l'outil Calculer le méridien central et les parallèles ou Calculer la zone UTM, la chaîne de coordonnées générée risque de dépasser la limite du nombre de caractères par champ (255) appliquée aux fichiers de formes.
Lorsque l'option Utiliser l'unité et l'échelle de la page est sélectionnée, les unités pour Largeur du polygone et Hauteur du polygone sont automatiquement remplacées par les unités de page définies dans la carte active. Si vous utilisez l'outil en dehors d'une session ArcMap, par défaut, les unités sont exprimées en pouces. Bien que vous ayez la possibilité de spécifier les unités de carte que vous voulez, telles que les mètres ou les miles, vous devez utiliser des unités qui soient appropriées pour la page en cours.
Lorsque Utiliser l'unité et l'échelle de la page est sélectionné, l'échelle de la carte est par défaut l'échelle du bloc de données actif appliqué à la mise en page du document ArcMap actif. Si vous utilisez l'outil en dehors d'une session ArcMap, la valeur par défaut de l'échelle est 1.
Pour de meilleurs résultats, toutes les couches d'entités et les classes d'entités en entrée doivent être dans le même système de coordonnées que le bloc de données, ou si vous utilisez l'outil en dehors d'une session ArcMap, toutes les couches d'entités et les classes d'entités en entrée doivent être dans le même système de coordonnées que la première couche d'entités ou classe d'entités en entrée dans la liste.
Syntaxe
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})
Paramètre | Explication | Type de données |
out_feature_class | Classe d'entités surfaciques d'index générée. Le système de coordonnées de la classe d'entités en sortie est déterminé dans cet ordre.
| Feature Class |
in_features [in_features,...] (Facultatif) | Les entités en entrée peuvent servir à définir l'étendue du quadrillage de polygone créé. | Feature Layer; Raster Layer |
intersect_feature (Facultatif) | Limite la classe d'entités du quadrillage en sortie uniquement aux surfaces qui coupent des couches d'entités ou des jeux de données en entrée. Lorsque les entités en entrée sont spécifiées, la valeur par défaut est INTERSECTFEATURE. L'intersection d'entités en entrée permettra de créer des entités d'index.
| Boolean |
use_page_unit (Facultatif) | Indique si la taille du polygone d'index indiquée est en unités de page. La valeur par défaut est NO_USEPAGEUNIT. L'outil utilise les unités de carte par défaut.
| Boolean |
scale (Facultatif) | Les échelles doivent être spécifiées si la hauteur et la largeur du polygone d'index seront calculées en unités de page. Si l'outil est utilisé en dehors d'une session ArcMap active, la valeur d'échelle par défaut est 1. | Long |
polygon_width (Facultatif) | Largeur du polygone d'index spécifiée en unités de carte ou de page. Si les unités de page sont utilisées, la valeur par défaut est 1 pouce. Si les unités de carte sont utilisées, la valeur par défaut est 1 degré. | Linear unit |
polygon_height (Facultatif) | Hauteur du polygone d'index spécifiée en unités de carte ou de page. Si les unités de page sont utilisées, la valeur par défaut est 1 pouce. Si les unités de carte sont utilisées, la valeur par défaut est 1 degré. | Linear unit |
origin_coord (Facultatif) | Coordonnées de l'origine dans l'angle inférieur gauche de la classe d'entités du quadrillage en sortie. Si les entités en entrée sont spécifiées, la valeur par défaut est déterminée par l'étendue de l'agrégation des étendues pour ces entités. Si aucune entité en entrée n'est spécifiée, les coordonnées par défaut sont 0 et 0. | Point |
number_rows (Facultatif) | Nombre de lignes à créer dans la direction y à partir du point d'origine. La valeur par défaut est 10. | Long |
number_columns (Facultatif) | Nombre de colonnes à créer dans la direction x à partir du point d'origine. La valeur par défaut est 10. | Long |
starting_page_number (Facultatif) | Un numéro de page séquentiel commençant à partir d'un numéro de page de départ spécifié est affecté à chaque entité d'index du quadrillage. La valeur par défaut est 1. | Long |
label_from_origin (Facultatif) | Les numéros de page (étiquettes) déterminés à partir du numéro de page de départ spécifié (la valeur par défaut est 1) sont attribués en commençant par la cellule dans le coin inférieur gauche du quadrillage en sortie. La valeur par défaut est NO_LABELFROMORIGIN.
| Boolean |
Exemple de code
Exemple 1 d'utilisation de l'outil GridIndexFeatures (Fenêtre Python)
Crée des entités GridIndexFeatures à partir de l'intersection des entités en entrée et des dimensions des entités d'index spécifiées en unités de carte.
import arcpy
from arcpy import env
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.GridIndexFeatures_cartography("gridIndexFeatures","poly", "", "", "",
"1000 meters","1000 meters")
Exemple 2 d'utilisation de l'outil GridIndexFeatures (Fenêtre Python)
Crée des entités GridIndexFeatures à partir de l'étendue entière des entités en entrée et des dimensions des entités d'index spécifiées en unités de page.
import arcpy
from arcpy import env
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.GridIndexFeatures_cartography("gridIndexFeatures","poly",
"NO_INTERSECTFEATURE","USEPAGEUNIT",
"100000", "5 inches","5 inches")
Exemple 3 d'utilisation de l'outil GridIndexFeatures (Fenêtre Python)
Crée des entités GridIndexFeatures à partir de l'intersection des entités en entrée, des dimensions des entités d'index spécifiées en unités de carte et du numéro de page de départ, soit la page 5.
import arcpy
from arcpy import env
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.GridIndexFeatures_cartography("gridIndexFeatures","poly", "", "", "",
"1000 meters", "1000 meters", "", "",
"", "5")
Exemple 4 d'utilisation de l'outil GridIndexFeatures (Fenêtre Python)
Crée des entités GridIndexFeatures en spécifiant les coordonnées de l'origine, les dimensions des entités d'index en unités de carte, le nombre de lignes et le nombre de colonnes.
import arcpy
from arcpy import env
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.GridIndexFeatures_cartography("gridIndexFeatures", "", "", "", "",
"1000 meters","1000 meters",
"-6000000 -1600000", "15", "20",)
Exemple 5 d'utilisation de l'outil GridIndexFeatures (Fenêtre Python)
Crée des entités GridIndexFeatures en spécifiant les coordonnées de l'origine, les dimensions des entités d'index en unités de page, le nombre de lignes, le nombre de colonnes et le numéro de page de départ, soit la page 5, et en indiquant de commencer à l'origine.
import arcpy
from arcpy import env
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.GridIndexFeatures_cartography("gridIndexFeatures", "", "", "USEPAGEUNIT",
"100000", "5 inches", "5 inches",
"-6000000 -1600000", "5",
"LABELFROMORIGIN")
Exemple 1 d'utilisation de l'outil GridIndexFeatures (script Python autonome)
Crée des entités GridIndexFeatures à partir de l'intersection des entités en entrée et des dimensions des entités d'index spécifiées en unités de carte.
# 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)
Exemple 2 d'utilisation de l'outil GridIndexFeatures (script Python autonome)
Crée des entités GridIndexFeatures à partir de l'étendue entière des entités en entrée et des dimensions des entités d'index spécifiées en unités de page.
# 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)
Exemple 3 d'utilisation de l'outil GridIndexFeatures (script Python autonome)
Crée des entités GridIndexFeatures à partir de l'intersection des entités en entrée, des dimensions des entités d'index spécifiées en unités de carte et du numéro de page de départ, soit la page 5.
# 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)
Exemple 4 d'utilisation de l'outil GridIndexFeatures (script Python autonome)
Crée des entités GridIndexFeatures en spécifiant les coordonnées de l'origine, les dimensions des entités d'index en unités de carte, le nombre de lignes et le nombre de colonnes.
# 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)
Exemple 5 d'utilisation de l'outil GridIndexFeatures (script Python autonome)
Crée des entités GridIndexFeatures en spécifiant les coordonnées de l'origine, les dimensions des entités d'index en unités de page, le nombre de lignes, le nombre de colonnes et le numéro de page de départ, soit la page 5, et en indiquant de commencer à l'origine.
# 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)
Environnements
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui