Récapitulatif
Crée une classe d'entités de masques de polygones à partir d'une couche de lignes symbolisées en entrée.
Utilisation
Cet outil crée seulement des masques aux extrémités non connectées de lignes (également appelées impasses). Une extrémité de ligne est considérée comme connectée si elle partage son extrémité avec l'extrémité d'une autre ligne. Cet outil accepte uniquement les couches de ligne en entrée.
Cet outil est spécialement conçu pour fournir des masques d'extrémités de lignes lorsque des lignes ont été symbolisées avec une extrémité arrondie pour que la transition des connexions entre les lignes soit plus harmonieuse. Plutôt que d'avoir des terminaisons de lignes arrondies, il est possible de masquer l'extrémité des lignes à l'aide de la classe d'entités surfaciques créée avec cet outil.
Les masques seront créés si la distance de marge est 0 ou négative. Une distance de marge de 0 créera un polygone qui représente la forme exacte de l'entité symbolisée. Une distance de marge négative génèrera un polygone plus petit que l'entité symbolisée. En général, une valeur de marge supérieure à 0 devra être spécifiée pour produire l'effet de masquage souhaité.
Si la couche de lignes en entrée contient des géométries de ligne multi-parties, les masques d'impasse sont créés pour toutes les extrémités de ligne non connectées, y compris les extrémités des parties dans les lignes multi-parties.
Lors de la création de masques, n'oubliez pas que le fait d'ajouter des masques aux cartes apporte un surcroît de complexité qui ralentit leur affichage et a une incidence sur leur impression et leur exportation. En général, trois points sont à prendre en compte lors de la création de masques pour une carte : (1) le nombre de masques, (2) la complexité des masques, et (3) l'utilisation des masques, à savoir s'ils doivent masquer des entités surfaciques remplies de symboles ponctuels ou linéaires. Une augmentation du nombre de masques, de leur complexité et/ou un masquage par rapport à des symboles ponctuels ou de remplissage des polygones se traduit par un ralentissement du tracé à l'écran. En outre, les performances d'impression et d'exportation risquent d'être médiocres, voire même d'échouer à produire une sortie valide, premièrement en raison du traitement extrêmement volumineux nécessaire pour imprimer et exporter des cartes avec des masques et deuxièmement en raison des limitations connues sur la manière dont les formats de fichiers graphiques stockent les résultats des exportations des cartes dotées d'un grand nombre de masques complexes.
Les valeurs de marge sont exprimées en unités de page ou en unités de carte. En général, il est préférable de spécifier la valeur de distance de marge en unités de page.
La valeur de marge est interprétée différemment selon les unités choisies. Si vous sélectionnez des points, des pouces, des millimètres ou des centimètres, les masques sont alors créés à partir de la distance de marge telle que calculée dans l'espace de la page (la marge correspond à une distance mesurée sur le papier). La valeur de l'échelle de référence est prise en compte dans ce calcul.
Si vous sélectionnez d'autres unités, les masques sont alors créés à partir de la distance de marge telle que calculée dans l'espace cartographique (la marge correspond à une distance réelle mesurée sur la Terre). Dans ce cas, la valeur de l'échelle de référence n'est pas prise en compte dans ce calcul.
Syntaxe
CulDeSacMasks_cartography (input_layer, output_fc, reference_scale, spatial_reference, margin, {attributes})| Paramètre | Explication | Type de données |
input_layer | Couche de lignes en entrée servant à créer des masques. | Layer |
output_fc | Classe d'entités contenant les entités masques. | Feature Class |
reference_scale | Echelle de référence utilisée pour calculer la géométrie de masquage lorsque les masques sont spécifiés en unités de page. Il s'agit, en règle générale, de l'échelle de référence de la carte. | Double |
spatial_reference | Référence spatiale pour laquelle les polygones de masquage sont créés. Il ne s'agit pas de la référence spatiale attribuée à la classe d'entités en sortie. Il s'agit de la référence spatiale de la carte dans laquelle les polygones de masquage seront utilisés étant donné que la position de la symbologie est susceptible de varier lorsque les entités sont projetées. | Spatial Reference |
margin | Espace en unités de page entourant les entités symbolisées en entrée permettant de créer le polygone de masquage. En règle générale, les polygones de masquage sont créés avec une petite marge autour du symbole afin d'améliorer l'apparence visuelle. Les valeurs de marge sont exprimées en unités de page ou en unités de carte. En général, il est préférable de spécifier la valeur de la distance de marge en unités de page. La valeur de marge est interprétée différemment selon les unités choisies. Si vous sélectionnez des points, des pouces, des millimètres ou des centimètres, les masques sont alors créés en utilisant la distance de marge telle que calculée dans l'espace de la page (la marge correspond à une distance mesurée sur le papier). La valeur de l'échelle de référence est prise en compte dans ce calcul. Si vous sélectionnez d'autres unités, les masques sont alors créés en utilisant la distance de marge telle que calculée dans l'espace cartographique (la marge correspond à une distance réelle mesurée sur la terre). Dans ce cas, la valeur de l'échelle de référence n'est pas prise en compte dans ce calcul. | Linear unit |
attributes (Facultatif) | Détermine les attributs des entités en entrée à transférer aux entités en sortie.
| String |
Exemple de code
Exemple d'utilisation de l'outil CulDeSacMasks (Fenêtre Python)
Le script de fenêtre Python ci-dessous illustre l'utilisation de l'outil CulDeSacMasks en mode immédiat.
import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.CulDeSacMasks_cartography("C:/data/cartography.gdb/transportation/roads",
"C:/data/cartography.gdb/transportation/cds_polys",
"25000", "", "5 meters", "ALL")
Exemple d'utilisation de l'outil CulDeSacMasks (script Python autonome)
Ce script autonome montre un exemple de l'utilisation de l'outil CulDeSacMasks.
# Name: CulDeSacMasks_standalone_script.py
# Description: Creates masks at the unconnected ends of lines in the input layer.
# Author: ESRI
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
env.workspace = "C:/data"
# Set local variables
input_layer = "C:/data/cartography.gdb/transportation/roads"
outpuf_fc = "C:/data/cartography.gdb/transportation/cds_polys"
reference_scale = "25000"
spatial_reference = x
margin = "5 meters"
attributes = "ALL"
# Execute Cul De Sac Masks
arcpy.CulDeSacMasks_cartography(input_layer, output_fc, reference_scale, spatial_reference, margin, attributes)
Environnements
Informations de licence
- ArcGIS for Desktop Basic: Annuler
- ArcGIS for Desktop Standard: Annuler
- ArcGIS for Desktop Advanced: Oui