Entités de l’index du quadrillage (Cartographie)

Résumé

Crée une grille d’entités surfaciques rectangulaires pouvant être utilisée en tant qu’index pour spécifier des pages dans une série de cartes spatiales. 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 l’ordre suivant :

    • Si un système de coordonnées est spécifié par l’environnement Output Coordinate System (Système de coordonnées en sortie), 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 l’environnement Output Coordinate System (Système de coordonnées en sortie), la classe d’entités en sortie utilise le système de coordonnées de la carte ou de la fenêtre cartographique active.
    • Si aucun système de coordonnées n’est spécifié par l’environnement Output Coordinate System (Système de coordonnées en sortie) et qu’aucune carte n’est active (ArcGIS Pro 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 l’environnement Output Coordinate System (Système de coordonnées en sortie), qu’aucune carte n’est active (ArcGIS Pro n’est pas ouvert) et qu’aucune entité en entrée n’est indiquée, le système de coordonnées de la classe d’entités en sortie est inconnu.
  • Le paramètre Input Features (Entités en entrée) peut s’appliquer à des points, des lignes, des polygones ou des rasters.

  • Lorsque vous utilisez le paramètre Use Page Unit and Scale (Utiliser l'unité et l'échelle de la page), le paramètre Map Scale (Échelle de la carte) est 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 le paramètre Polygon Grid Origin Coordinate (Coordonnées d’origine de la grille du polygone) a été spécifié, le nombre de lignes et de colonnes change automatiquement. Les lignes et les colonnes sont automatiquement calculées en fonction des coordonnées d’origine de la grille pour l’étendue de la classe d’entités. Si l'étendue totale augmente suite à la modification des coordonnées x,y d'origine, le nombre de lignes et de colonnes est mis à jour en conséquence. Si l'étendue totale diminue, les modifications sont ignorées et l'étendue globale des entités est utilisée.

  • Lorsque vous ajoutez le paramètre Input Features (Entités en entrée), la valeur du paramètre Polygon Grid Origin Coordinate (Coordonnées d'origine du quadrillage du polygone) est calculée automatiquement.

  • Lorsque l’option Use Page Unit and Scale (Utiliser l’unité et l’échelle de la page) est sélectionnée, les unités de Polygon Width (Largeur du polygone) et Polygon Height (Hauteur du polygone) sont automatiquement remplacées par les unités de page définies dans la fenêtre cartographique active. Lorsque vous utilisez l’outil en dehors d’une session ArcGIS Pro, les unités sont par défaut exprimées en pouces. Bien que vous ayez la possibilité de spécifier les unités de carte, telles que les mètres ou les miles, utilisez des unités appropriées pour la page en cours.

  • Lorsque l’option Use Page Unit and Scale (Utiliser l’unité et l’échelle de la page) est cochée, l’échelle de la carte prend par défaut celle de la fenêtre cartographique active appliquée à la mise en page. Si vous utilisez l’outil en dehors d’une session ArcGIS Pro, la valeur par défaut de l’échelle est 1.

  • Pour obtenir de meilleurs résultats, toutes les couches et classes d’entités en entrée doivent figurer dans le même système de coordonnées que la carte ou la fenêtre cartographique. Si vous utilisez l’outil en dehors d’une session ArcGIS Pro, toutes les couches et classes d’entités en entrée doivent figurer dans le même système de coordonnées que la première couche ou classe d’entités en entrée de 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ètreExplicationType de données
out_feature_class

La classe d'entités résultante des entités d'index surfaciques.

Le système de coordonnées de la classe d'entités en sortie est déterminé dans l’ordre suivant :

  • Si un système de coordonnées est spécifié par l’environnement Output Coordinate System (Système de coordonnées en sortie), 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 l’environnement Output Coordinate System (Système de coordonnées en sortie), la classe d’entités en sortie utilise le système de coordonnées de la carte active (ArcGIS Pro est ouvert).
  • Si aucun système de coordonnées n’est spécifié par l’environnement Output Coordinate System (Système de coordonnées en sortie) et qu’aucune carte n’est active (ArcGIS Pro 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 l’environnement Output Coordinate System (Système de coordonnées en sortie), qu’aucune carte n’est active (ArcGIS Pro n’est pas ouvert) et qu’aucune entité en entrée n’est indiquée, le système de coordonnées de la classe d’entités en sortie est inconnu.
Feature Class
in_features
[in_features,...]
(Facultatif)

Les entités en entrée qui serviront à définir l'étendue du quadrillage de polygone qui sera créé.

Feature Layer; Raster Layer
intersect_feature
(Facultatif)

Limite la classe d’entités de la grille en sortie aux surfaces qui intersectent des couches d’entités ou des jeux de données en entrée. L'intersection d'entités en entrée permettra de créer des entités d'index.

  • INTERSECTFEATURELimite la classe d’entités de la grille en sortie aux surfaces qui intersectent des couches d’entités ou des jeux de données en entrée. Ceci est le paramètre par défaut lorsque des entités en entrée sont spécifiées.
  • NO_INTERSECTFEATUREUne classe d'entités du quadrillage en sortie est créée à partir des coordonnées, des lignes et des colonnes spécifiées.
Boolean
use_page_unit
(Facultatif)

Indique si la taille du polygone d’index indiquée est en unités de page.

  • USEPAGEUNITLa hauteur et la largeur du polygone d'index sont calculées en unités de page.
  • NO_USEPAGEUNITLa hauteur et la largeur du polygone d'index sont calculées en unités de carte. Il s’agit de l’option par défaut.
Boolean
scale
(Facultatif)

Échelle de la carte. L’échelle doit être spécifiée pour que la hauteur et la largeur du polygone d'index soient calculées en unités de page. Si l’outil est utilisé en dehors d’une session ArcGIS Pro active, la valeur d’échelle par défaut est 1.

Long
polygon_width
(Facultatif)

La 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)

La 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)

Valeur de coordonnée de l’origine dans l’angle inférieur gauche de la classe d’entités de la grille 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)

Spécifie où commence la numérotation des pages (étiquettes).

  • LABELFROMORIGINLes numéros de page (étiquettes) commencent par l’entité surfacique dans le coin inférieur gauche de la grille en sortie.
  • NO_LABELFROMORIGINLes numéros de page (étiquettes) commencent par l’entité surfacique dans le coin supérieur gauche de la grille en sortie. Il s’agit de l’option par défaut.
Boolean

Exemple de code

Exemple 1 d'utilisation de l'outil GridIndexFeatures (fenêtre Python)

L’exemple suivant crée des entités d’index du quadrillage à 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
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)

L’exemple suivant crée des entités d’index du quadrillage à partir de l'étendue totale des entités en entrée et des dimensions des entités d'index spécifiées en unités de page.

import arcpy
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)

L’exemple suivant crée des entités d'index du quadrillage à 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
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)

L’exemple suivant crée des entités d’index du quadrillage 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
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)

L’exemple suivant crée des entités d’index du quadrillage 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
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.GridIndexFeatures_cartography("gridIndexFeatures", "", "", "USEPAGEUNIT",
                                    "100000", "5 inches", "5 inches",
                                    "-6000000 -1600000", "15", "20", "5",
                                    "LABELFROMORIGIN")
Exemple 6 d'utilisation de l'outil GridIndexFeatures (script autonome)

L’exemple suivant crée des entités d’index du quadrillage à 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 7 d'utilisation de l'outil GridIndexFeatures (script autonome)

L’exemple suivant crée des entités d’index du quadrillage à partir de l'étendue totale 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 8 d'utilisation de l'outil GridIndexFeatures (script autonome)

L’exemple suivant crée des entités d'index du quadrillage à 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 9 d'utilisation de l'outil GridIndexFeatures (script autonome)

L’exemple suivant crée des entités d’index du quadrillage 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 10 d'utilisation de l'outil GridIndexFeatures (script autonome)

L’exemple suivant crée des entités d’index du quadrillage 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)

Informations de licence

  • Basic: Oui
  • Standard: Oui
  • Advanced: Oui

Rubriques connexes