Créer un index le long d'une entité linéaire (Outils de cartographie)

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 une série de cartes spatiales pour définir les pages d’une carte de bande ou d’un ensemble de cartes suivant 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.
Si 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 ArcGIS Pro est ouvert, l’échelle de la carte du bloc de données actif est utilisée. Sinon, la valeur par défaut est 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 les suivants : 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 Strip Map Index Features (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 dérivées du champ ObjectID de la première entité linéaire dans la chaîne donnée.
- SeqId est un nombre incrémentiel attribué à chaque entité d’index en fonction de l’ordre de création de l’entité dans 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 une série de cartes. Utilisez les champs LeftPage, RightPage, TopPage et BottomPage pour du texte dynamique.
- Next est la valeur PageNumber pour l’entité d’index suivante 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 une série de cartes. Utilisez les champs LeftPage, RightPage, TopPage et BottomPage pour du texte dynamique.
- LeftPage, RightPage, TopPage et BottomPage sont utiles lors de l’intégration des résultats dans une série de cartes. 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 le champ PageNumber de l’entité d’index à droite. TopPage et BottomPage sont les valeurs des entités d’index supérieure et inférieure, respectivement.
Si 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) sont remplacées automatiquement par les unités de page définies dans la mise en page active (si ArcGIS‏ Pro est ouvert) ou par les pouces si vous utilisez l’outil en dehors d’une session ArcGIS Pro. 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 Use Page Units and Scale (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, pieds, kilomètres ou degrés décimaux.

Etiqueter	Explication	Type de données
Entités linéaires en entrée	Les entités polylignes en entrée qui définissent la trajectoire des entités d'index de carte de bande.	Feature Layer
Classe d’entités en sortie	La classe d'entités en sortie des entités d'index surfaciques.	Feature Class
Utiliser l'unité et l'échelle de la page (Facultatif)	Indique si la taille de l’entité d’index en entrée est en unités de page. Activé—La hauteur et la largeur du polygone d'index sont calculées en unités de page. Décoché—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
Echelle de la carte (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 ArcGIS Pro, la valeur par défaut est l’échelle du bloc de données actif. Autrement, la valeur par défaut est 1.	Long
Longueur le long de la ligne (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
Longueur perpendiculaire à la ligne (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
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
Pourcentage de superposition (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
Numéro de la page de début (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 de la carte de bande (Facultatif)	Spécifie la direction initiale des cartes de bande. Ouest vers Est et Nord vers Sud—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. Ouest vers Est et Sud vers Nord—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. Est vers Ouest et Nord vers Sud—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. Est vers Ouest et Sud vers Nord—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

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

Nom	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 ArcGIS Pro, la valeur par défaut est l’échelle du bloc de données actif. Autrement, la valeur par défaut est 1.	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.cartography.StripMapIndexFeatures('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"

# Run StripMapIndexFeatures
arcpy.cartography.StripMapIndexFeatures(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.cartography.StripMapIndexFeatures('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"

# Run StripMapIndexFeatures
arcpy.cartography.StripMapIndexFeatures(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.cartography.StripMapIndexFeatures('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"

# Run StripMapIndexFeatures
arcpy.cartography.StripMapIndexFeatures(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.cartography.StripMapIndexFeatures('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"

# Run StripMapIndexFeatures
arcpy.cartography.StripMapIndexFeatures(inFeatures, outFeatureClass, "", "",
                                        lenA, lenP, "", "", startingPageNum,
                                        directionType)

Environnements

Cet outil n’utilise pas d’environnement de géotraitement.

Informations de licence