Resumen
Crea parapetos de puente y máscaras de polígono en intersecciones de líneas para indicar pasos subterráneos.
Ilustración
Uso
Se requieren como entrada entidades de línea que se intersequen, simbolizadas con representaciones de trazo.
Esta herramienta es idéntica a la herramienta Crear paso elevado salvo en que el parámetro Expresión selecciona desde el parámetro Entidades de entrada inferior con representaciones en esta herramienta y también desde el parámetro Entidades de entrada superior con representaciones en la herramienta Crear paso elevado.
La capa Entidades de entrada superior con representaciones puede ser la misma que la capa Entidades de entrada inferior con representaciones en el caso de las entidades superpuestas en sí mismas. Cuando las representaciones de entrada superior y de entrada inferior son las mismas, se necesita una expresión SQL para un mayor refinamiento de la selección de entidades.
Sintaxis
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})| Parámetro | Explicación | Tipo de datos |
in_above_features | La capa de entidades de línea de entrada que contiene representaciones de trazo que se intersecan con (y que estarán simbolizadas como pasando por encima de) las representaciones de trazo en el parámetro Entidades de entrada inferior con representaciones. | Layer |
in_below_features | La capa de entidades de línea de entrada que contiene representaciones de trazo que se intersecan con (y que estarán simbolizadas como pasando por debajo de) las representaciones de trazo en el parámetro Entidades de entrada superior con representaciones. Estas entidades son enmascaradas por los polígonos creados en el parámetro Clase de entidad de paso subterráneo de salida. | Layer |
margin_along | Establece la longitud de los polígonos de máscara a lo largo del parámetro Entidades de entrada superior con representaciones al especificar la distancia en unidades de página a la que debe extenderse la máscara más allá del ancho del símbolo de trazo del parámetro Entidades de entrada inferior con representaciones. Se debe especificar el parámetro Margen paralelo y debe ser mayor o igual que cero. Elija una unidad de página para el margen; el valor predeterminado es puntos. | Linear Unit |
margin_across | Establece el ancho de los polígonos de máscara a lo largo del parámetro Entidades de entrada superior con representaciones al especificar la distancia en unidades de página a la que debe extenderse la máscara más allá del ancho del símbolo de trazo del parámetro Entidades de entrada inferior con representaciones. Se debe especificar el parámetro Margen perpendicular y debe ser mayor o igual que cero. Elija una unidad de página para el margen; el valor predeterminado es puntos. | Linear Unit |
out_underpass_feature_class | Clase de entidad de salida que se creará para almacenar los polígonos para enmascarar el parámetro Entidades de entrada inferior con representaciones. | Feature Class |
out_mask_relationship_class | La clase de relación de salida que se creará para almacenar vínculos entre los polígonos de máscara de paso subterráneo y las líneas del parámetro Entidades de entrada inferior con representaciones. | Relationship Class |
where_clause (Opcional) | Una expresión SQL utilizada para seleccionar un subconjunto de entidades en el parámetro Entidades de entrada superior con representaciones. Utilice comillas (por ejemplo, "MY_FIELD") o, si consulta geodatabases personales, encierre los campos entre corchetes (por ejemplo, [MY_FIELD]). Consulte Referencia de SQL para las expresiones de consulta utilizadas en ArcGIS para obtener más información sobre la sintaxis SQL. | SQL Expression |
out_decoration_feature_class (Opcional) | Clase de entidad de línea de salida que se creará para almacenar entidades de parapeto. | Feature Class |
wing_type (Opcional) | Especifica el estilo de ala de las entidades de parapeto.
| String |
wing_tick_length (Opcional) | La longitud de las alas del parapeto en unidades de página. La longitud debe ser mayor o igual a cero; la longitud predeterminada es 1. Elija una unidad de página (puntos, milímetros, etc.) para la longitud; el valor predeterminado es puntos. Este parámetro no se aplica al Tipo de ala con valor NINGUNO. | Linear Unit |
Muestra de código
Ejemplo 1 de CreateUnderpass (ventana de Python)
La siguiente secuencia de comandos de la ventana de Python demuestra cómo utilizar la función CreateUnderpass de modo inmediato.
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")
Ejemplo 2 de CreateUnderpass (script independiente).
Esta secuencia de comandos independiente muestra un ejemplo de uso de la función 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)
Entornos
Información de licenciamiento
- Basic: No
- Standard: No
- Advanced: Sí