Résumé
Permet d'afficher, les unes au-dessous des autres, les lignes qui se coupent, en créant des parapets de pont et des masques pour recouvrir chaque segment de route passant au-dessous d'un autre.
Illustration
Utilisation
Les entités linéaires qui s’intersectent doivent être symbolisées en entrée.
Cet outil est identique à l’outil Create Overpass (Créer un passage supérieur) à part le fait que le paramètre Expression sélectionne les entités du paramètre Input Below Features (Entités inférieures en entrée) dans cet outil et sélectionne les entités du paramètre Input Above Features (Entités supérieures en entrée) dans l’outil Create Overpass (Créer un passage supérieur).
-
La couche Input Above Features (Entités supérieures en entrée) peut être la même que la couche Input Below Features (Entités inférieures en entrée) lorsque des entités se superposent. Lorsque les couches 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 lignes qui intersectent des lignes dans le paramètre Input Below Features (Entités 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 qui intersectent des lignes dans le paramètre Input Above Features (Entités 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 (Entités supérieures) 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 (Entités inférieures). 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 (Entités supérieures) 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 (Entités inférieures). 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 (Entités inférieures en entrée). | Feature Class |
out_mask_relationship_class |
Classe de relations en sortie qui est créée pour stocker les liens entre les polygones de masquage de passage inférieur et les lignes du paramètre Input Below Features (Entités 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 (Entités supérieures en entrée). Utilisez des guillemets, "MY_FIELD" ou, si vous interrogez des géodatabases personnelles, placez les champs entre crochets : [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.
| String |
wing_tick_length (Facultatif) | Définit la 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 Wing Type (type de parapet) est égal à NONE. | Linear Unit |
Exemple de code
Le script de fenêtre Python suivant montre comment utiliser l'outil 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")
Ce script autonome montre un exemple d'utilisation de l'outil 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)
Environnements
Informations de licence
- Basic: Non
- Standard: Non
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?