Créer un passage inférieur (Cartographie)—ArcMap

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

Résumé

Permet de créer des parapets de ponts et des masques de polygones aux intersections de lignes pour indiquer des passages inférieurs.

Illustration

Utilisation

Des entités linéaires d’intersection symbolisées par des représentations de traits sont requises en entrée.
Cet outil est identique à l’outil Créer un passage supérieur à part le fait que le paramètre Expression sélectionne les entités du paramètre Représentations inférieures en entrée dans cet outil ainsi que les entités du paramètre Représentations supérieures en entrée dans l’outil Créer un passage supérieur.
La couche Représentations supérieures en entrée peut être la même que la couche Représentations inférieures en entrée lorsque des entités se superposent. Lorsque les représentations supérieures et inférieures sont les mêmes, une expression SQL est requise pour que la sélection d'entités soit plus précise.

Syntaxe

arcpy.cartography.CreateUnderpass(in_above_features, in_below_features, margin_along, margin_across, out_underpass_feature_class, out_mask_relationship_class, {where_clause}, {out_decoration_feature_class}, {wing_type}, {wing_tick_length})

Paramètre	Explication	Type de données
in_above_features	Couche d’entités linéaires en entrée contenant les représentations de traits qui intersectent des représentations de traits dans le paramètre Input Below Features With Representations (Représentations inférieures en entrée) et qui seront symbolisées comme passant au-dessus de celles-ci.	Layer
in_below_features	Couche d’entités linéaires en entrée contenant les représentations de traits qui intersectent des représentations de traits dans le paramètre Input Above Features With Representations (Représentations supérieures en entrée) et qui seront symbolisées comme passant au-dessous de celles-ci. Ces entités seront masquées par les polygones créés dans le paramètre Output Underpass Feature Class (Classe d’entités passages inférieurs en sortie).	Layer
margin_along	Définit la longueur des polygones de masquage par rapport au paramètre Input Above Features With Representations (Représentations supérieures en entrée) en spécifiant la distance en unités de page sur laquelle le masque doit s’étendre au-delà de la largeur du symbole de trait du paramètre Input Below Features With Representations (Représentations inférieures en entrée). Le paramètre Margin Along (Marge longitudinale) spécifié doit être supérieur ou égal à zéro. Choisissez une unité de page pour la marge ; par défaut, la valeur est exprimée en points.	Linear Unit
margin_across	Définit la largeur des polygones de masquage sur le paramètre Input Above Features With Representations (Représentations supérieures en entrée) en spécifiant la distance en unités de page sur laquelle le masque doit s’étendre au-delà de la largeur du symbole de trait du paramètre Input Below Features With Representations (Représentations inférieures en entrée). Le paramètre Margin Across (Marge transversale) spécifié doit être supérieur ou égal à zéro. Choisissez une unité de page pour la marge ; par défaut, la valeur est exprimée en points.	Linear Unit
out_underpass_feature_class	Classe d’entités en sortie qui sera créée pour stocker les polygones servant à masquer le paramètre Input Below Features With Representations (Représentations inférieures en entrée).	Feature Class
out_mask_relationship_class	Classe de relations en sortie qui sera créée pour stocker les liens entre les polygones de masquage de passage inférieur et les lignes du paramètre Input Représentations inférieures en entrée.	Relationship Class
where_clause (Facultatif)	Expression SQL utilisée pour sélectionner un sous-ensemble d’entités dans le paramètre Input Above Features With Representations (Représentations supérieures en entrée). Utilisez des guillemets, par exemple, "MY_FIELD" ou, si vous interrogez des géodatabases personnelles, placez les champs entre crochets, par exemple, [MY_FIELD] Pour plus d'informations sur la syntaxe SQL, reportez-vous à la rubrique Référence SQL pour les expressions de requête utilisées dans ArcGIS.	SQL Expression
out_decoration_feature_class (Facultatif)	Classe d'entités linéaires en sortie qui sera créée pour stocker les entités parapets.	Feature Class
wing_type (Facultatif)	Spécifie le style des entités parapets. ANGLED —Les extrémités du parapet formeront un angle entre le paramètre Entités supérieures en entrée et le paramètre Entités inférieures en entrée. Il s’agit de l’option par défaut. PARALLEL —Les extrémités du parapet du passage inférieur seront parallèles au paramètre Entités inférieures en entrée. NONE —Aucune extrémité ne sera créée sur les parapets.	String
wing_tick_length (Facultatif)	Longueur des parapets en unités de page. La longueur doit être supérieure ou égale à zéro ; par défaut, elle est définie sur 1. Choisissez une unité de page (points, millimètres, etc.) pour la longueur ; par défaut, la valeur est exprimée en points. Ce paramètre ne s'applique pas lorsque la valeur Type de parapet est égale à AUCUNE.	Linear Unit

Exemple de code

Exemple 1 d’utilisation de l’outil CreateUnderpass (fenêtre Python)

Le script ci-dessous pour la fenêtre Python illustre l’utilisation de la fonction CreateUnderpass en mode immédiat.

import arcpy
arcpy.env.workspace = "C:\data"
arcpy.env.referenceScale = "50000"
arcpy.CreateUnderpass_cartography("roads.lyr", "railroads.lyr", "2 Points", "1 Points",
                                 "cartography.gdb/transportation/under_mask_fc",
                                 "cartography.gdb/transportation/under_mask_rc", "'RelationshipToSurface' = 3",
                                 "cartography.gdb/transportation/tunnel", "PARALLEL", "1 Points")

Exemple 2 d’utilisation de l’outil CreateUnderpass (script autonome)

Ce script autonome montre un exemple d’utilisation de la fonction CreateUnderpass.

# Name: CreateUnderpass_standalone_script.py
# Description: creates a mask where one feature
#              is visually below another feature
 
# Import system modules
import arcpy
from arcpy import env

# Set environment settings
env.workspace = "C:/data"
env.referenceScale = "50000"

# Set local variables
in_above_features = "roads.lyr"
in_below_features = "railroads.lyr"
margin_along = "2 Points"
margin_across = "1 Points"
out_overpass_feature_class = "cartography.gdb/trans/under_mask_fc"
out_mask_relationship_class = "cartography.gdb/trans/under_mask_rc"
where_clause = "'RelationshipToSurface' = 3"
out_decoration_feature_class = "cartography.gdb/trans/tunnel"
wing_type = "PARALLEL"
wing_tick_length = "1 Points"

# Execute Create Underpass
arcpy.CreateUnderpass_cartography(in_above_features,
                                  in_below_features,
                                  margin_along,
                                  margin_across,
                                  out_overpass_feature_class,
                                  out_mask_relationship_class,
                                  where_clause,
                                  out_decoration_feature_class,
                                  wing_type,
                                  wing_tick_length)