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ètre | Explication | Type 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 :
| 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.
| Boolean |
use_page_unit (Facultatif) | Indique si la taille du polygone d’index indiquée est en unités de page.
| 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).
| Boolean |
Exemple de code
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")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")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")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")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")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)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)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)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)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)Environnements
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?