Créer un index le long d'une entité linéaire (Cartographie)—ArcMap

Résumé
Utilisation
Syntaxe
Exemple de code
Environnements
Informations de licence

Résumé

Crée une série de polygones rectangulaires, ou d'entités d'index, qui suit une entité linéaire unique ou un groupe d'entités linéaires. Ces entités d'index peuvent être utilisées avec des pages dynamiques pour définir les pages au sein d'une carte de bande ou un ensemble de cartes qui suit une entité linéaire. The resulting index features contain attributes that can be used to rotate and orient the map on the page and determine which index features, or pages, are next to the current page (to the left and right or to the top and bottom).

Utilisation

Les entités linéaires ne peuvent pas se trouver dans un réseau géométrique.
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. Si ArcMap est ouvert, l'échelle de la carte de bloc de données actif est utilisée. Sinon, la valeur par défaut est égale à 1. Si vous indiquez la taille des entités d'index dans l'espace de la carte et que l'option Use Page Unit and Scale (Utiliser l'unité et l'échelle de la page) n'est pas sélectionnée, le paramètre Map Scale (Échelle de la carte) n'est pas requis.
Les entités d’index obtenues sont créées avec un certain nombre d’attributs. Ces attributs sont notamment PageNumber, GroupId, SeqId, Previous, Next, LeftPage, RightPage, TopPage, BottomPage et Angle.
- Angle est une valeur numérique qui exprime l'angle de rotation de la carte (bloc de données) afin d'aligner les tronçons de l'entité d'index sur les tronçons d'une mise en page. Afin de respecter les conventions cartographiques, ces angles sont calculés de sorte que le Nord demeure 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é correspond au plein Nord, 90 degrés au plein Est, 180 degrés au plein Sud et -90 degrés au plein Ouest.
- PageNumber est un nombre incrémentiel attribué à chaque entité d'index.
- GroupId est un entier attribué à toutes les entités d'index dans une chaîne de connexion ou un groupe d'entités linéaires. Les résultats de l'option Créer un index le long d'une entité linéaire peuvent inclure plusieurs groupes. En règle générale, un seul groupe provient d'un ensemble connecté d'entités linéaires ou d'une ligne unique avec plusieurs parties non connectées. Les entités d'index créées à partir d'entités linéaires individuelles et non connectées sont attribuées à des groupes distincts. Les valeurs GroupId sont uniques et sont dérivées de l'ObjectID de la première entité linéaire dans la chaîne concernée.
- SeqId est un nombre incrémentiel attribué à chaque entité d'index en fonction de l'ordre de création de l'entité au sein de chaque groupe.
- PrevPage est la valeur PageNumber de l'entité d'index créée précédemment. Ce champ sert à analyser l'ordre de création des entités d'index. N'utilisez pas ce champ dans le but d'exécuter un texte dynamique pour la page dynamique. Utilisez les champs LeftPage, RightPage, TopPage, et BottomPage pour le texte dynamique.
- Next est la valeur PageNumber de la prochaine entité d'index créée. Ce champ sert à analyser l'ordre de création des entités d'index. N'utilisez pas ce champ dans le but d'exécuter un texte dynamique pour la page dynamique. Utilisez les champs LeftPage, RightPage, TopPage, et BottomPage pour le texte dynamique.
- LeftPage, RightPage, TopPage, et BottomPage sont utiles lors de l'incorporation des résultats dans les pages dynamiques. LeftPage est la valeur PageNumber de l’entité d'index qui apparaît à gauche de l’entité d’index actuelle une fois la rotation appliquée. RightPage est la valeur PageNumber de l’entité d’index à droite. TopPage et BottomPage sont les valeurs des entités d’index supérieure et inférieure, respectivement.
Lorsque l'option Use Page Unit and Scale (Utiliser l'unité et l'échelle de la page) est sélectionnée, les unités des paramètres Length Along the Line (Longueur le long de la ligne) et Length Perpendicular to the Line (Longueur perpendiculaire à la ligne) changent automatiquement pour adopter les unités de page définies dans le document cartographique actif (si ArcMap est ouvert) ou les pouces si vous utilisez l'outil en dehors d'une session ArcMap. Pour optimiser les résultats, ces unités doivent être spécifiées dans des unités de pages, telles que les pouces ou les 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 des unités de la carte, telles que les mètres, les pieds, les kilomètres ou les degrés décimaux.

Syntaxe

arcpy.cartography.StripMapIndexFeatures(in_features, out_feature_class, {use_page_unit}, {scale}, {length_along_line}, {length_perpendicular_to_line}, {page_orientation}, {overlap_percentage}, {starting_page_number}, {direction_type})

Paramètre	Explication	Type de données
in_features	Les entités polylignes en entrée qui définissent la trajectoire des entités d'index de carte de bande.	Feature Layer
out_feature_class	La classe d'entités en sortie des entités d'index surfaciques.	Feature Class
use_page_unit (Facultatif)	Indique si la taille de l’entité d’index en entrée est en unités de page. USEPAGEUNIT —La hauteur et la largeur du polygone d'index sont calculées en unités de page. NO_USEPAGEUNIT —La 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)	L'échelle de la carte doit être spécifiée si les longueurs des entités d'index (le long de la ligne et perpendiculaires à la ligne) doivent être calculées en unités de page. Si vous utilisez ArcMap, la valeur par défaut est l'échelle de carte du bloc de données actif. Dans le cas contraire, la valeur par défaut 1 est utilisée.	Long
length_along_line (Facultatif)	La longueur de l'entité d'index surfacique 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 fonction de la référence spatiale des entités linéaires en entrée. Cette valeur correspond à 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)	La longueur de l'entité d'index surfacique 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 fonction de la référence spatiale des entités linéaires en entrée. Cette valeur correspond à la moitié du nombre utilisé pour la longueur le long de la ligne.	Linear Unit
page_orientation (Facultatif)	Spécifie l'orientation des entités linéaires en entrée dans la mise en page. VERTICAL —La série de cartes de bande est orientée de haut en bas sur la page. HORIZONTAL —La série de cartes de bande est orientée de gauche à droite sur la page. Il s’agit de l’option par défaut.	String
overlap_percentage (Facultatif)	Le pourcentage approximatif du chevauchement géographique entre une page individuelle de la carte et ses pages adjacentes dans la série. La valeur par défaut est 10.	Double
starting_page_number (Facultatif)	Numéro de la page de début. Un numéro de page séquentiel commençant à partir du numéro de page de départ spécifié est affecté à chaque entité d’index du carroyage. La valeur par défaut est 1.	Long
direction_type (Facultatif)	Spécifie la direction initiale des cartes de bande. WE_NS —Si la tendance directionnelle de la ligne va de l’ouest à l’est, le point de départ se trouve à l’extrémité ouest de la ligne ou, si la tendance directionnelle de la ligne va du nord au sud, le point de départ se trouve à l’extrémité nord de la ligne. Il s’agit de l’option par défaut. WE_SN —Si la tendance directionnelle de la ligne va de l’ouest à l’est, le point de départ se trouve à l’extrémité ouest de la ligne ou, si la tendance directionnelle de la ligne va du sud au nord, le point de départ se trouve à l’extrémité sud de la ligne. EW_NS —Si la tendance directionnelle de la ligne va de l’est à l’ouest, le point de départ se trouve à l’extrémité est de la ligne ou, si la tendance directionnelle de la ligne va du nord au sud, le point de départ se trouve à l’extrémité nord de la ligne. EW_SN —Si la tendance directionnelle de la ligne va de l’est à l’ouest, le point de départ se trouve à l’extrémité est de la ligne ou, si la tendance directionnelle de la ligne va du sud au nord, le point de départ se trouve à l’extrémité sud de la ligne.	String

Exemple de code

Exemple 1 d'utilisation de l'outil StripMapIndexFeatures (Fenêtre Python)

L’exemple suivant crée des entités d'index de carte de bande en fonction des entités linéaires en entrée avec les dimensions des entités d'index spécifiées pour une mise en page.

import arcpy
arcpy.env.workspace = 'C:\data\ProjectData.gdb'
arcpy.StripMapIndexFeatures_cartography('lines', 'indexFeatures',
                                        'USEPAGEUNIT', 500000,
                                        '7 inches', '5 inches')

Exemple 2 d'utilisation de l'outil StripMapIndexFeatures (script autonome)

L’exemple suivant crée des entités d'index de carte de bande en fonction des entités linéaires en entrée avec les dimensions des entités d'index spécifiées pour une mise en page.

# Description: Creates a series of strip map index features based on inputed
# line features with index feature dimensions specified for a layout page.

# Import system modules
import arcpy

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

Exemple 3 d'utilisation de l'outil StripMapIndexFeatures (Fenêtre Python)

L’exemple suivant crée des entités d'index de carte de bande en fonction des entités linéaires en entrée avec les dimensions des entités d'index spécifiées en unités de carte avec un chevauchement de 0.

import arcpy
arcpy.env.workspace = 'C:\data\ProjectData.gdb'
arcpy.StripMapIndexFeatures_cartography('lines', 'indexFeatures', '',
                                        '', '10 kilometers', '5 kilometers')

Exemple 4 d'utilisation de l'outil StripMapIndexFeatures (script autonome)

# 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.

# Import system modules
import arcpy

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

Exemple 5 d'utilisation de l'outil StripMapIndexFeatures (Fenêtre Python)

L’exemple suivant crée des entités d'index de carte de bande en fonction des entités linéaires en entrée avec les dimensions des entités d'index spécifiées pour une mise en page et l'orientation de page définie comme verticale.

import arcpy
arcpy.env.workspace = 'C:\data\ProjectData.gdb'
arcpy.StripMapIndexFeatures_cartography('lines', 'indexFeatures',
                                        'USEPAGEUNIT', 500000, '5 inches',
                                        '7 inches', 'VERTICAL')

Exemple 6 d'utilisation de l'outil StripMapIndexFeatures (script autonome)

# 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.

# Import system modules
import arcpy

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

Exemple 7 d'utilisation de l'outil StripMapIndexFeatures (Fenêtre Python)

L’exemple suivant crée des entités d'index de carte de bande en fonction des entités linéaires en entrée avec des spécifications pour les dimensions des entités exprimées en unités de carte, le numéro de page de début et la direction de la carte de bande.

import arcpy
arcpy.env.workspace = 'C:\data\ProjectData.gdb'
arcpy.StripMapIndexFeatures_cartography('lines', 'indexFeatures', '', '',
                                        '10 kilometers', '5 kilometers',
                                        '', '', 5, 'EW_SN')

Exemple 8 d'utilisation de l'outil StripMapIndexFeatures (script autonome)

# 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.

# Import system modules
import arcpy

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