Entités de l'index de carte de bande (Cartographie)
Récapitulatif
Crée une série de polygones rectangulaires, ou entités d'index, qui suivent une seule entité linéaire ou un groupe d'entités linéaires. Ces entités d'index peuvent être utilisées avec des pages dynamiques pour définir des pages dans une carte de bande, ou un ensemble de cartes qui suit une entité linéaire. Les entités d'index obtenues contiennent des attributs qui peuvent être utilisés pour faire pivoter et orienter la carte sur la page et déterminer les entités d'index, ou pages, devant se trouver à côté de la page courante (à gauche et à droite ou en haut et en bas).
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 la variable Système de coordonnées en sortie dans les 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 la variable Système de coordonnées en sortie, la classe d'entités en sortie utilise le système de coordonnées de l'entité en entrée.
-
Les entités linéaires sont la seule entrée valide.
-
Lorsque vous sélectionnez Utiliser l'unité et l'échelle de la page, Echelle de la carte devient un paramètre requis. Si ArcMap est ouvert, l'échelle de la carte du bloc de données actif sera utilisée ; sinon, la valeur par défaut est 1. Si vous spécifiez la taille d'entités d'index dans l'espace de carte alors que l'option Utiliser l'unité et l'échelle de la page n'est pas sélectionnée Echelle de la carte n'est pas un paramètre requis.
-
Les entités d'index obtenues sont créées avec plusieurs attributs. Ces attributs comprennent : PageNumber, GroupId, SeqId, PrevPage, NextPage, LeftPage, RightPage, TopPage, BottomPage et Angle.
- La valeur de l'attribut Angle est une valeur numérique qui exprime l'angle de rotation requis par la carte (bloc de données) pour aligner les tronçons de l'entité d'index avec ceux d'une mise en page. Pour respecter les conventions cartographiques, ces angles sont calculés de sorte que le nord soit orienté autant que possible vers le haut de la page. Les angles sont calculés par rapport à l'orientation par défaut d'une carte où 0 degré représente le plein nord, 90 degrés le plein est, 180 degrés le plein sud et -90 degrés le plein ouest.
- La valeur de l'attribut PageNumber est un nombre incrémentiel affecté à chaque entité d'index.
- La valeur de l'attribut GroupId est un nombre entier affecté à toutes les entités d'index dans une chaîne de connexion ou un groupe d'entités linéaires. Les résultats générés par l'outil Entités de l'index de carte de bande peuvent comprendre plusieurs groupes. Normalement, un seul groupe sera issu d'un ensemble connecté d'entités linéaires ou d'une ligne seule dotée de plusieurs parties non connectées. Des entités d'index créées à partir d'entités linéaires individuelles non connectées seront affectées à des groupes distincts. Les valeurs GroupId sont uniques et dérivées de l'OID de la première entité linéaire d'une chaîne donnée.
- La valeur de l'attribut SeqId est un nombre incrémentiel affecté à chaque entité d'index selon l'ordre de création de l'entité dans chaque groupe.
- PrevPage est la valeur PageNumber pour l'entité d'index créée précédemment. Ce champ est utilisé lors de l'analyse de l'ordre de création des entités d'index. N'utilisez pas ce champ pour exécuter le texte dynamique pour une page dynamique. Pour le texte dynamique, utilisez les champs LeftPage, RightPage, TopPage et BottomPage.
- NextPage est la valeur PageNumber pour la prochaine entité d'index créée. Ce champ est utilisé lors de l'analyse de l'ordre de création des entités d'index. N'utilisez pas ce champ pour exécuter le texte dynamique pour une page dynamique. Pour le texte dynamique, utilisez les champs LeftPage, RightPage, TopPage et BottomPage.
- LeftPage, RightPage, TopPage et BottomPage sont utiles lors de l'incorporation des résultats dans des pages dynamiques. LeftPage est la valeur PageNumber de l'entité d'index qui apparaît à gauche de l'entité d'index courante une fois la rotation appliquée. RightPage est la valeur PageNumber appliquée à droite de l'entité d'index. TopPage et BottomPage sont les valeurs des entités d'index situées en haut et en bas, respectivement.
-
Lorsque l'option Utiliser l'unité et l'échelle de la page est sélectionnée, les unités Longueur le long de la ligne et Longueur perpendiculaire à la ligne se transforment automatiquement en des unités de page définies dans la carte active (si ArcMap est ouvert) ou en pouces si vous utilisez l'outil en dehors d'une session ArcMap. Pour obtenir de meilleurs résultats, il est recommandé de spécifier ces unités en unités de page, telles que des pouces ou des centimètres. Si l'option Utiliser l'unité et l'échelle de la page n'est pas sélectionnée, les unités doivent être spécifiées dans les unités de carte (mètres, pieds, kilomètres, miles ou degrés décimaux, par exemple).
Syntaxe
| Paramètre | Explication | Type de données |
in_features |
Polyligne ou polylignes en entrée qui définissent le chemin des entités d'index de la carte de bande. | Feature Layer |
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 l'ordre suivant.
| Feature Class |
use_page_unit (Facultatif) |
Indique si la taille de l'entité d'index en entrée figure dans l'espace de la page. La valeur par défaut est NO_USEPAGEUNIT.
| Boolean |
scale (Facultatif) |
L'échelle de la carte doit être spécifiée si les longueurs de l'entité d'index (le long de la ligne et perpendiculaire à la ligne) sont calculées dans l'espace de la page. Si ArcMap est ouvert, la valeur par défaut sera l'échelle du bloc de données actif. Si ArcMap n'est pas ouvert, la valeur par défaut sera 1. | Long |
length_along_line (Facultatif) |
Longueur de l'entité d'index du polygone le long de l'entité linéaire en entrée spécifiée en unités de carte ou de page. La valeur par défaut est déterminée par la référence spatiale de l'entité ou des entités surfaciques en entrée. Cette valeur sera 1/100 de l'étendue de la classe d'entités en entrée le long de l'axe X. | Linear unit |
length_perpendicular_to_line (Facultatif) |
Longueur de l'entité d'index du polygone perpendiculaire à l'entité linéaire en entrée spécifiée en unités de carte ou de page. La valeur par défaut est déterminée par la référence spatiale de l'entité ou des entités surfaciques en entrée. Cette valeur sera 1/2 du nombre utilisé pour la longueur le long de la ligne. | Linear unit |
page_orientation (Facultatif) |
Utilisé pour déterminer l'orientation des entités surfaciques en entrée dans la mise en page. La valeur par défaut est HORIZONTAL.
| String |
overlap_percentage (Facultatif) |
Pourcentage approximatif de superposition géographique entre une page de carte individuelle et ses pages adjacentes dans la série. La valeur par défaut est 10. | Double |
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 |
direction_type (Facultatif) |
Les entités d'index sont créées en ordre séquentiel et nécessitent un point de départ. La définition du type de direction de la carte de bande constitue un point de départ. La valeur par défaut est WE_NS. Cela signifie que le point de départ de la carte de bande se situe à l'extrémité ouest de l'entité linéaire si son orientation va d'ouest en est/est en ouest ou alors, si son orientation va du nord au sud/sud au nord, le point de départ sera le point le plus au nord de l'entité linéaire. Le type de direction est également appliqué aux entités linéaires secondaires.
| String |
Exemple de code
Crée des entités d'index de la carte de bande selon les entités surfaciques en entrée avec les dimensions d'entité d'index spécifiées pour une mise en page.
import arcpy
from arcpy import env
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.StripMapIndexFeatures_cartography ("lines", "indexFeatures",
USEPAGEUNIT, "500000",
"7 inches", "5 inches")
Crée des entités d'index de la carte de bande selon les entités surfaciques en entrée avec les dimensions d'entité d'index spécifiées pour une mise en page.
# stripmapindexfeatures_example1.py
# Description: Creates a series of strip map index features based on inputed
# line features with index feature dimensions specified for a layout page.
# Author: ESRI
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
arcpy.env.workspace = r"C:\data\ProjectData.gdb"
# Set local variables
inFeatures = "line"
outFeatureClass = "indexFeatures"
usePageUnit = "USEPAGEUNIT"
scale = "500000"
lenA = "7 Inches"
lenP = "5 Inches"
# Execute StripMapIndexFeatures
arcpy.StripMapIndexFeatures_cartography (inFeatures, outFeatureClass,
usePageUnit, scale, lenA, lenP)
Crée des entités d'index de la carte de bande selon les entités surfaciques en entrée avec les dimensions d'entité d'index spécifiées dans les unités de carte avec une superposition de 0.
import arcpy
from arcpy import env
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.StripMapIndexFeatures_cartography ("lines", "indexFeatures", "",
"", "10 kilometers", "5 kilometers")
Crée des entités d'index de la carte de bande selon les entités surfaciques en entrée avec les dimensions d'entité d'index spécifiées dans les unités de carte avec une superposition de 0.
# stripmapindexfeatures_example2.py
# Description: Creates a series of strip map index features based on inputed
# line features with index feature dimensions specified in map units with an
# overlap set at 0.
# Author: ESRI
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
arcpy.env.workspace = r"C:\data\ProjectData.gdb"
# Set local variables
inFeatures = "line"
outFeatureClass = "indexFeatures"
lenA = "10 Kilometers"
lenP = "5 Kilometers"
# Execute StripMapIndexFeatures
arcpy.StripMapIndexFeatures_cartography (inFeatures, outFeatureClass, "",
"", lenA, lenP)
Crée des entités d'index de la carte de bande selon les entités surfaciques en entrée avec les dimensions d'entité d'index spécifiées pour une mise en page et l'orientation de page définie sur VERTICAL.
import arcpy
from arcpy import env
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.StripMapIndexFeatures_cartography ("lines", "indexFeatures",
USEPAGEUNIT, "500000", "5 inches",
"7 inches", VERTICAL)
Crée des entités d'index de la carte de bande selon les entités surfaciques en entrée avec les dimensions d'entité d'index spécifiées pour une mise en page et l'orientation de page définie sur VERTICAL.
# stripmapindexfeatures_example3.py
# Description: Creates a series of strip map index features based on inputed
# line features with index feature dimensions specified for a layout and
# the page orientation set as vertical.
# Author: ESRI
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
arcpy.env.workspace = r"C:\data\ProjectData.gdb"
# Set local variables
inFeatures = "line"
outFeatureClass = "indexFeatures"
usePageUnit = "USEPAGEUNIT"
scale = "500000"
lenA = "7 Inches"
lenP = "5 Inches"
pageOrientation = "VERTICAL"
# Execute StripMapIndexFeatures
arcpy.StripMapIndexFeatures_cartography (inFeatures, outFeatureClass,
usePageUnit, scale, lenA, lenP,
pageOrientation)
Crée des entités d'index de la carte de bande selon les entités surfaciques en entrée avec les dimensions d'entité d'index spécifiées en unités de page, numéro de page de départ et direction de la carte de bande.
import arcpy
from arcpy import env
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.StripMapIndexFeatures_cartography ("lines", "indexFeatures", "", "",
"10 kilometers", "5 kilometers",
"", "", "5", "EW_SN")
Crée des entités d'index de la carte de bande selon les entités surfaciques en entrée avec les dimensions d'entité d'index spécifiées en unités de page, numéro de page de départ et direction de la carte de bande.
# stripmapindexfeatures_example4.py
# Description: Creates a series of strip map index features based on inputed
# line features with index feature dimensions specified in map units, the
# starting page number is 5 and the strip map direction is
# East-West/South-North.
# Author: ESRI
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
arcpy.env.workspace = r"C:\data\ProjectData.gdb"
# Set local variables
inFeatures = "line"
outFeatureClass = "indexFeatures"
lenA = "10 Kilometers"
lenP = "5 Kilometers"
startingPageNum = "5"
directionType = "EW_SN"
# Execute StripMapIndexFeatures
arcpy.StripMapIndexFeatures_cartography (inFeatures, outFeatureClass, "", "",
lenA, lenP, "", "", startingPageNum,
directionType)