Crear paso subterráneo (Herramientas de cartografía)

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 simbolizadas que se intersequen.
Se puede utilizar la misma entrada para los valores de los parámetros Entidades de entrada superior y Entidades de entrada inferior en el caso de las entidades superpuestas en sí mismas. Cuando los valores de los parámetros Entidades de entrada superior y Entidades de entrada inferior son los mismos, se necesita una expresión SQL para un mayor refinamiento de la selección de entidades. La herramienta intentará identificar automáticamente qué carreteras están por encima y por debajo cuando esto no quede claro con una expresión SQL. En este caso, pueden producirse resultados inesperados, sobre todo en intersecciones complejas con detalles más pequeños que la anchura de los símbolos de la carretera.
Esta herramienta es idéntica a la herramienta Crear paso elevado salvo en que el parámetro Expresión selecciona desde el valor del parámetro Entidades de entrada inferior en esta herramienta y también desde el valor del parámetro Entidades de entrada superior en la herramienta Crear paso elevado.

Etiqueta	Explicación	Tipo de datos
Entidades de entrada superior	Capa de entidades de línea de entrada que contiene líneas que se intersecan con (y que estarán simbolizadas como pasando por encima de) las líneas en el valor del parámetro Entidades de entrada inferior.	Layer
Entidades de entrada inferior	Capa de entidades de línea de entrada que contiene líneas que se intersecan con (y que estarán simbolizadas como pasando por debajo de) las líneas en el valor del parámetro Entidades de entrada superior. Estas entidades son enmascaradas por los polígonos creados en el valor del parámetro Clase de entidad de paso subterráneo de salida.	Layer
Margen paralelo	Longitud de los polígonos de máscara a lo largo del valor del parámetro Entidades de entrada superior, que es la distancia en unidades de página a la que se extenderá la máscara más allá del ancho del símbolo de trazo del valor del parámetro Entidades de entrada inferior. El valor de este parámetro debe ser mayor o igual que cero. Elija una unidad de página (puntos, milímetros, etc.) para el margen; el valor predeterminado es puntos.	Linear Unit
Margen perpendicular	Ancho de los polígonos de máscara a lo largo del valor del parámetro Entidades de entrada superior, que es la distancia en unidades de página a la que se extenderá la máscara más allá del ancho del símbolo de trazo del valor del parámetro Entidades de entrada superior. El valor de este parámetro debe ser mayor o igual que cero. Elija una unidad de página (puntos, milímetros, etc.) para el margen; el valor predeterminado es puntos.	Linear Unit
Clase de entidad de paso subterráneo de salida	Clase de entidad de salida que se creará para almacenar los polígonos para enmascarar el valor del parámetro Entidades de entrada inferior.	Feature Class
Clase de relación de máscara de salida	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 valor del parámetro Entidades de entrada inferior.	Relationship Class
Expresión (Opcional)	Una expresión SQL utilizada para seleccionar un subconjunto de entidades del valor del parámetro Entidades de entrada superior. Utilice comillas para los nombres de los campos, por ejemplo "MI_CAMPO". Para obtener más información sobre la sintaxis SQL, consulte Referencia SQL para las expresiones de consulta utilizadas en ArcGIS.	SQL Expression
Clase de entidad de decoración de salida (Opcional)	Clase de entidad de línea de salida que se creará para almacenar entidades de parapeto.	Feature Class
Tipo Wing (Opcional)	Especifica el estilo de ala que se utilizará para las entidades de parapeto. Marcas de ala en ángulo entre las entidades superiores e inferiores—La marca divisoria del ala del parapeto estará en ángulo entre el valor del parámetro Entidades de entrada superior y el valor del parámetro Entidades de entrada inferior. Esta es la opción predeterminada. Marcas de ala paralelas a las entidades inferiores—La marca divisoria del ala correspondiente al ala de paso subterráneo será paralela al valor del parámetro Entidades de entrada inferior. Sin marcas de ala creadas—No se crearán marcas divisorias de ala en los parapetos.	String
Longitud de Marca de ala (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 cuando el parámetro Tipo de ala está establecido en Sin marcas de ala creadas.	Linear Unit

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

Nombre	Explicación	Tipo de datos
in_above_features	Capa de entidades de línea de entrada que contiene líneas que se intersecan con (y que estarán simbolizadas como pasando por encima de) las líneas en el valor del parámetro `in_below_features`.	Layer
in_below_features	Capa de entidades de línea de entrada que contiene líneas que se intersecan con (y que estarán simbolizadas como pasando por debajo de) las líneas en el valor del parámetro `in_above_features`. Estas entidades son enmascaradas por los polígonos creados en el valor del parámetro `out_underpass_feature_class`.	Layer
margin_along	Longitud de los polígonos de máscara a lo largo del valor del parámetro `in_above_features`, que es la distancia en unidades de página a la que se extenderá la máscara más allá del ancho del símbolo de trazo del valor del parámetro `in_below_features`. El valor de este parámetro debe ser mayor o igual que cero. Elija una unidad de página (puntos, milímetros, etc.) para el margen; el valor predeterminado es puntos.	Linear Unit
margin_across	Longitud de los polígonos de máscara a lo largo del valor del parámetro `in_above_features`, que es la distancia en unidades de página a la que se extenderá la máscara más allá del ancho del símbolo de trazo del valor del parámetro `in_above_features`. El valor de este parámetro debe ser mayor o igual que cero. Elija una unidad de página (puntos, milímetros, etc.) 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 valor del parámetro `in_below_features`.	Feature Class
out_mask_relationship_class	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 valor del parámetro `in_below_features`.	Relationship Class
where_clause (Opcional)	Una expresión SQL utilizada para seleccionar un subconjunto de entidades del valor del parámetro `in_above_features`. Utilice comillas para los nombres de los campos, por ejemplo "MI_CAMPO". Para obtener más información sobre la sintaxis SQL, consulte Referencia SQL para las expresiones de consulta utilizadas en ArcGIS.	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 que se utilizará para las entidades de parapeto. `ANGLED`—La marca divisoria del ala del parapeto estará en ángulo entre el valor del parámetro `in_above_features` y el valor del parámetro `in_below_features`. Esta es la opción predeterminada. `PARALLEL`—La marca divisoria del ala correspondiente al ala de paso subterráneo será paralela al valor del parámetro `in_below_features`. `NONE`—No se crearán marcas divisorias de ala en los parapetos.	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 cuando el parámetro `wing_type` está establecido en `NONE`.	Linear Unit

Muestra de código

Ejemplo 1 de CreateUnderpass (ventana de Python)

El siguiente script de la ventana de Python demuestra cómo utilizar la función CreateUnderpass en modo inmediato.

import arcpy
arcpy.env.workspace = "C:\\data"
arcpy.env.referenceScale = "50000"
arcpy.cartography.CreateUnderpass("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).

Este script 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

# Set environment settings
arcpy.env.workspace = "C:/data"
arcpy.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"

# Run Create Underpass
arcpy.cartography.CreateUnderpass(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

Sistema de coordenadas cartográficas, Escala de referencia

Información de licenciamiento

Basic: No
Standard: No
Avanzado: Sí