Résumé
Crée une couche groupée de classes d'entités qui représentent des entités quadrillages, graticules et bordures à l'aide de caractéristiques cartographiques prédéfinies. Les couches de quadrillages sont idéales pour les définitions de quadrillage avancées qui sont spécifiques à l'échelle et à l'étendue.
Chaque couche de grille peut être composée d'un polygone de masquage, d'un polygone de découpage, de segments (ligne), de quadrillages (ligne), de croisillons (ligne), d'extrémités (point), de points (point) et de classes d'entités annotations. Ces composants sont stockés en tant qu'entités dans les classes d'entités correspondantes. Ces classes d'entités sont enregistrées dans un jeu de données d'entité spécifié dans une géodatabase. Il existe sept classes d'entités qui stockent les composants de base d'un quadrillage. Chacune d'elles est nommée avec un préfixe de trois lettres que facilite l'identification du composant de grille que la classe d'entités détient. Ces classes et ces composants d'entités sont les suivants :
- ANO_ est la classe d'entités annotations.
- EPT_ est la classe d'entités extrémités.
- GLN_ est la classe d'entités quadrillages.
- MSK_ est la classe d'entités masques.
- PNT_ est la classe d'entités points.
- SEG_ est la classe d'entités segments.
- TKS_ est la classe d'entités croisillons.
Ces classes d'entités peuvent détenir des informations relatives à plusieurs grilles. Une huitième classe d'entités (GRD_) contient des informations d'organisation, telles que le nom de carte et les types de grilles utilisés pour organiser vos grilles.
Le modèle de définition de quadrillage est stocké dans un fichier XML prédéfini. Ce fichier stocke les propriétés de spécification pour chaque quadrillage, telles que le nombre, la couleur et la pondération des lignes de quadrillage. Lorsque le modèle de définition est appliqué, les entités sont créées d'après la spécification basée sur l'étendue courante ou l'étendue d'une entité sélectionnée (zone d'intérêt), l'échelle et les systèmes de coordonnées.
Utilisation
Cet outil est conçu pour des cartes projetées destinées à être imprimées ou exportées. Il n'est pas destiné à la création de quadrillages ou de graticules se mettant à jour automatiquement lorsque l'utilisateur déplace le curseur sur la carte.
Vous devez entrer une zone d'intérêt pour déterminer l'étendue de la couche de quadrillage à créer. Si vous utilisez une couche d'entités pour définir la zone d'intérêt, ce doit être une classe d'entités surfaciques ou une couche surfacique.
Une fois le paramètre Modèle de grille (fichier XML) défini dans la boîte de dialogue Etablir la couche de quadrillages et de graticules, placez le curseur sur la surface contextuelle juste à gauche du nom de paramètre ou cliquez dessus pour afficher le type de quadrillage, la description, le type de rotation et les informations de type d'échelle pour le modèle de définition de grille XML défini.
Le fichier XML de modèle de grille spécifie des composants de quadrillage qui représentent des mesures ou des emplacements pour les systèmes de coordonnées principal et auxiliaire. Tous les systèmes de coordonnées spécifiés doivent partager un système de coordonnées géographiques commun. Si vous souhaitez modifier le système de coordonnées principal en un qui utilise un datum différent de la valeur par défaut, par exemple, si vous voulez modifier un système de coordonnées basé sur le datum WGS 1984 en un basé sur NAD 1983, vous devez également baser chaque système de coordonnées auxiliaire par défaut sur le datum NAD 1983.
Le modèle de grille, la zone d'intérêt, le jeu de données d'entité en entrée et les paramètres des systèmes de coordonnées principal et auxiliaire doivent utiliser le même datum, par exemple, WGS 1984 ou NAD 1983.
Le fichier XML de modèle de grille peut créer des composants de quadrillage pour un maximum de quatre systèmes de coordonnées auxiliaires. Le nombre de quadrillages auxiliaires est spécifié par le fichier XML. Vous ne pouvez pas ajouter ou supprimer de systèmes de coordonnées auxiliaires, mais vous pouvez remplacer les valeurs par défaut.
Le système de coordonnées principal doit être un système de coordonnées projetées.
Les systèmes de coordonnées auxiliaires peuvent être soit un système de coordonnées projetées, soit un système de coordonnées géographiques.
La référence spatiale du jeu de données d'entité en entrée doit avoir le même système de coordonnées géographiques que celui spécifié par le fichier XML de modèle de grille.
La référence spatiale de la zone d'intérêt en entrée doit avoir le même système de coordonnées géographiques que celui spécifié par le fichier XML de modèle de grille.
Si vous accédez à l'outil depuis ArcMap et activez la case à cocher Configurer un bloc de données et une mise en page à l'aide des paramètres de grille, le bloc de données sur la mise en page sera ajusté au mieux à la grille créée Le système de coordonnées, l'échelle, la rotation, la taille, l'étendue et le découpage du bloc de données peuvent être modifiés pour correspondre au fichier XML de spécification du quadrillage. Ce paramètre est disponible uniquement lorsque l'outil est exécuté à partir du mode Mise en page d'ArcMap et n'est pas exécuté en arrière-plan. Par défaut, cette case à cocher est désactivée et aucune de vos propriétés de bloc de données ne sera modifiée.
Lorsque vous spécifiez un nom de grille qui existe déjà dans l'emplacement en sortie, la grille existante est remplacée.
Les valeurs de paramètres suivantes sont dérivées automatiquement du modèle de grille XML :
- Couche en sortie
- Nom avec la valeur de chaîne
- Echelle de référence
- Rotation
- Taille du masque
- Tolérance XY
- Système de coordonnées principal
- Système de coordonnées auxiliaire
Toutefois, toutes ces valeurs par défaut peuvent être remplacées par de nouvelles valeurs.
Syntaxe
MakeGridsAndGraticulesLayer_cartography (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})| Paramètre | Explication | Type de données |
in_template | Le modèle de définition de quadrillage XML stocke les propriétés graphiques de la spécification pour chaque couche du quadrillage. En plus des propriétés graphiques, qui ne peuvent pas être modifiées avant l'exécution, la définition comporte des valeurs par défaut spécifiques exposées en tant que paramètres et modifiables avant l'exécution. Les fichiers modèles se trouvent dans le répertoire GridTemplates. Des modèles de grille supplémentaires peuvent être obtenus et partagés à partir du Centre de ressources ArcGIS. L'extension Esri Production Mapping fournit également un concepteur de grilles qui permet de modifier des modèles et d'en créer. | File |
in_aoi | Couche d'entités ou étendue x, y utilisée pour déterminer l'étendue de la couche de quadrillage créée.
| Feature Layer; Extent |
input_feature_dataset | Jeu de données d'entité qui stockera les entités. Des classes d'entités spécifiques au quadrillage seront créées si elles n'existent pas déjà. Si elles existent déjà, et si une grille des mêmes nom et type que celle en cours de création existe déjà, elle sera remplacée. | Feature Dataset |
output_layer | Couche groupée des classes d'entités qui représentent le quadrillage, le graticule et la bordure. Chaque couche de grille peut être composée d'un polygone de masquage, d'un polygone de découpage, de segments (ligne), de quadrillages (ligne), de croisillons (ligne), d'extrémités (point), de points (point) et de classes d'entités annotations. | Group Layer |
name (Facultatif) | Nom du quadrillage cartographique créé qui permet de distinguer les quadrillages stockés dans le même jeu de données d'entité et l'ensemble de classes d'entités, exprimé dans l'un des formats suivants :
Le nom du quadrillage ne peut pas contenir les caractères spéciaux suivants :
| String; Field |
refscale (Facultatif) | Echelle à laquelle la grille doit être créée et affichée. Lorsque l'échelle de référence du fichier XML de définition de quadrillage est définie sur Utiliser l'environnement, elle est dérivée dans l'ordre suivant :
| Double |
rotation (Facultatif) | Angle de rotation des composants de quadrillage. La rotation permet de fournir une annotation qui est au même niveau que la page. Sauf spécification contraire, la rotation est calculée à partir de l'entité de zone d'intérêt. Lorsque le type de rotation du fichier XML de définition de quadrillage est défini sur Utiliser l'environnement, la rotation est dérivée dans l'ordre suivant :
| Double |
mask_size (Facultatif) | Le masque est une entité surfacique qui forme une boucle externe autour de l'étendue du cadre et utilisé pour masquer des données qui se trouvent dans la surface réservée aux étiquettes de coordonnées. La taille de masque définit la largeur de l'entité masque du polygone dans la carte ou les unités de page. Vous devrez peut-être redimensionner le bloc de données pour l'ajuster au tronçon du masque tout en incluant les étiquettes de coordonnées. | Linear Unit |
xy_tolerance (Facultatif) | Distance minimale tolérée entre les entités de géodatabase, exprimée en unités linéaires. La valeur par défaut est issue de la valeur définie dans le fichier XML. Vous pouvez définir une valeur supérieure pour les données dont les coordonnées sont moins précises et inférieure pour les données d'une précision extrêmement élevée. Les entités comprises dans la tolérance XY définie sont considérées comme coïncidentes. | Linear Unit |
primary_coordinate_system (Facultatif) | Le fichier XML de modèle de quadrillage crée des composants de quadrillage qui représentent des coordonnées ou des emplacements pour un système de coordonnées principal et jusqu'à quatre systèmes de coordonnées auxiliaires. Le nombre de quadrillages auxiliaires est spécifié par le fichier. Vous ne pouvez pas ajouter ou supprimer des systèmes de coordonnées auxiliaires. Tous les systèmes de coordonnées spécifiés doivent partager un système de coordonnées géographiques commun. Si vous souhaitez modifier le système de coordonnées principal en un qui utilise un datum différent de la valeur par défaut, par exemple, si vous voulez modifier un système de coordonnées basé sur le datum WGS 1984 en un basé sur NAD 1983, vous devez également baser chaque système de coordonnées auxiliaire par défaut sur le datum NAD 1983. Il s'agit du système de coordonnées principal pour la couche de quadrillage créée, qui est en général le système de coordonnées du dernier produit ou bloc de données. Le système de coordonnées principal doit être un système de coordonnées projetées. Lorsque le système de coordonnées principal du fichier XML de définition de grille est défini sur Utiliser l'environnement, il est dérivé dans l'ordre suivant :
Dans tous les cas, les données entrées par l'utilisateur ont priorité. | Spatial Reference |
configure_layout (Facultatif) | Ajuste les paramètres du bloc de données de sorte à garantir qu'ils correspondent à la couche de quadrillage. Le système de coordonnées, l'échelle, la rotation, la taille, l'étendue et le découpage du bloc de données peuvent être modifiés pour appliquer une cohérence. Ce paramètre est disponible uniquement lorsque l'outil est exécuté à partir du mode Mise en page d'ArcMap et n'est pas exécuté en arrière-plan.
| Boolean |
ancillary_coordinate_system_1 (Facultatif) | Le fichier XML de modèle de quadrillage crée des composants de quadrillage qui représentent des coordonnées ou des emplacements pour un système de coordonnées principal et jusqu'à quatre systèmes de coordonnées auxiliaires. Le nombre de quadrillages auxiliaires est spécifié par le fichier. Vous ne pouvez pas ajouter ou supprimer des systèmes de coordonnées auxiliaires. Tous les systèmes de coordonnées spécifiés doivent partager un système de coordonnées géographiques commun. Si vous souhaitez modifier le système de coordonnées principal en un qui utilise un datum différent de la valeur par défaut, par exemple, si vous voulez modifier un système de coordonnées basé sur le datum WGS 1984 en un basé sur NAD 1983, vous devez également baser chaque système de coordonnées auxiliaire par défaut sur le datum NAD 1983. Il s'agit du premier système de coordonnées auxiliaire. | Spatial Reference |
ancillary_coordinate_system_2 (Facultatif) | Le fichier XML de modèle de quadrillage crée des composants de quadrillage qui représentent des coordonnées ou des emplacements pour un système de coordonnées principal et jusqu'à quatre systèmes de coordonnées auxiliaires. Le nombre de quadrillages auxiliaires est spécifié par le fichier. Vous ne pouvez pas ajouter ou supprimer des systèmes de coordonnées auxiliaires. Tous les systèmes de coordonnées spécifiés doivent partager un système de coordonnées géographiques commun. Si vous souhaitez modifier le système de coordonnées principal en un qui utilise un datum différent de la valeur par défaut, par exemple, si vous voulez modifier un système de coordonnées basé sur le datum WGS 1984 en un basé sur NAD 1983, vous devez également baser chaque système de coordonnées auxiliaire par défaut sur le datum NAD 1983. Il s'agit du deuxième système de coordonnées auxiliaire. | Spatial Reference |
ancillary_coordinate_system_3 (Facultatif) | Le fichier XML de modèle de quadrillage crée des composants de quadrillage qui représentent des coordonnées ou des emplacements pour un système de coordonnées principal et jusqu'à quatre systèmes de coordonnées auxiliaires. Le nombre de quadrillages auxiliaires est spécifié par le fichier. Vous ne pouvez pas ajouter ou supprimer des systèmes de coordonnées auxiliaires. Tous les systèmes de coordonnées spécifiés doivent partager un système de coordonnées géographiques commun. Si vous souhaitez modifier le système de coordonnées principal en un qui utilise un datum différent de la valeur par défaut, par exemple, si vous voulez modifier un système de coordonnées basé sur le datum WGS 1984 en un basé sur NAD 1983, vous devez également baser chaque système de coordonnées auxiliaire par défaut sur le datum NAD 1983. Il s'agit du troisième système de coordonnées auxiliaire. | Spatial Reference |
ancillary_coordinate_system_4 (Facultatif) | Le fichier XML de modèle de quadrillage crée des composants de quadrillage qui représentent des coordonnées ou des emplacements pour un système de coordonnées principal et jusqu'à quatre systèmes de coordonnées auxiliaires. Le nombre de quadrillages auxiliaires est spécifié par le fichier. Vous ne pouvez pas ajouter ou supprimer des systèmes de coordonnées auxiliaires. Tous les systèmes de coordonnées spécifiés doivent partager un système de coordonnées géographiques commun. Si vous souhaitez modifier le système de coordonnées principal en un qui utilise un datum différent de la valeur par défaut, par exemple, si vous voulez modifier un système de coordonnées basé sur le datum WGS 1984 en un basé sur NAD 1983, vous devez également baser chaque système de coordonnées auxiliaire par défaut sur le datum NAD 1983. Il s'agit du quatrième système de coordonnées auxiliaire. | Spatial Reference |
Exemple de code
Exemple 1 d'utilisation de l'outil MakeGridsAndGraticulesLayer (script autonome)
Ce script autonome montre un exemple d'utilisation de l'outil MakeGridsAndGraticulesLayer pour créer une grille cartographique.
# 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
t = 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(t, in_aoi,
input_feature_dataset,
output_layer, name)
Environnements
Informations de licence
- ArcGIS Desktop Basic: Non
- ArcGIS Desktop Standard: Oui
- ArcGIS Desktop Advanced: Oui