Máscaras Cul de Sac (Cartografía)

Resumen

Crea una clase de entidad de máscaras de polígono desde una capa de línea de entrada simbolizada.

Uso

  • Esta herramienta solo crea máscaras en los extremos no conectados de las líneas (también llamados cul-de-sac). Un extremo de línea se considera conectado si comparte su extremo con el extremo de otra línea. Esta herramienta solo acepta capas de línea como entrada.

  • Esta herramienta está diseñada para proporcionar máscaras de extremo de línea en casos en que las líneas se hayan simbolizado utilizando un tope de extremo redondeado para suavizar la transición de las conexiones de línea. En lugar de tener líneas con topes de extremos redondeados, el extremo de la línea se puede enmascarar utilizando la clase de entidad poligonal creada con esta herramienta.

  • Normalmente, los márgenes son superiores a 0. Un tamaño de margen de 0 crea máscaras que representan la forma exacta de las entidades simbolizadas.

  • Si la capa de línea de entrada contiene geometrías de línea multiparte, se crean máscaras cul-de-sac para todos los extremos de línea no conectados, incluidos los extremos de las partes dentro de las líneas multiparte.

  • Durante la creación de máscaras, es importante saber que al agregar máscaras a los mapas, se aumenta la complejidad, lo que lentifica el dibujo de los mapas y afecta su impresión y exportación. Generalmente, hay tres factores que se deben tener en cuenta al crear máscaras para un mapa: la cantidad de máscaras, la complejidad de las máscaras y si las máscaras se van a utilizar para enmascarar entidades poligonales rellenas con símbolos de línea o marcador. Un aumento en la cantidad de máscaras, tener máscaras más complejas y enmascarar contra símbolos de relleno de polígono o marcador hacen que el dibujo sea más lento en la pantalla. Además, el rendimiento de impresión y exportación puede ser bajo e incluso no producir una salida válida. Esto se debe a la gran cantidad de procesamiento necesario para imprimir y exportar mapas con máscaras, así como a las limitaciones conocidas sobre cómo los formatos de archivos gráficos almacenan los resultados de exportación de mapas que tienen muchas máscaras complicadas.

  • Los valores de margen se especifican en unidades de página o en unidades de mapa. En la mayoría de los casos, especificará el valor de distancia de margen en unidades de página.

    Las unidades de valor de margen se interpretan de manera diferente según las unidades seleccionadas. Si elige puntos, pulgadas, milímetros o centímetros, las máscaras se crean con la distancia de margen calculada en el espacio de página (puede considerar que el margen es una distancia medida en el papel). En este cálculo se tiene en cuenta el valor del parámetro de escala de referencia.

    Si elige alguna otra unidad para el margen, las máscaras se crean con la distancia de margen calculada en el espacio de mapa (puede considerar que el margen es una medida de distancia real en la Tierra). Además, en este caso, el valor de parámetro de escala de referencia no se utiliza como parte del cálculo.

Sintaxis

arcpy.cartography.CulDeSacMasks(input_layer, output_fc, reference_scale, spatial_reference, margin, {attributes})
ParámetroExplicaciónTipo de datos
input_layer

La capa de línea de entrada desde la que se crean las máscaras.

Layer
output_fc

La clase de entidad que contendrá las entidades de máscara.

Feature Class
reference_scale

La escala de referencia utilizada para calcular la geometría de máscara cuando las máscaras se especifican en unidades de página. Esto es generalmente la escala de referencia del mapa.

Double
spatial_reference

La referencia espacial del mapa en el que se crearán los polígonos de máscara. No es la referencia espacial que se asignará a la clase de entidad de salida. Es la referencia espacial del mapa en el que se utilizarán los polígonos de máscara, ya que la posición de la simbología puede cambiar cuando se proyectan las entidades.

Spatial Reference
margin

El espacio en unidades de página que rodea a las entidades de entrada simbolizadas utilizadas para crear los polígonos de máscara. Generalmente, los polígonos de máscara se crean con un margen pequeño alrededor del símbolo para mejorar la apariencia visual. Los valores de margen se especifican en unidades de página o en unidades de mapa. En la mayoría de los casos, especificará el valor de distancia de margen en unidades de página.

El margen no puede ser negativo.

Linear Unit
attributes
(Opcional)

Especifica los atributos que se van a transferir desde las entidades de entrada a las entidades de salida.

  • ONLY_FIDSolo se transferirá el campo FID desde las entidades de entrada a las entidades de salida. Esta es la opción predeterminada.
  • NO_FIDSe transferirán todos los atributos, excepto FID, desde las entidades de entrada a las entidades de salida.
  • ALLSe transferirán todos los atributos desde las entidades de entrada a las entidades de salida.
String

Muestra de código

Ejemplo 1 de CulDeSacMasks (ventana de Python)

El script de la ventana de Python muestra cómo utilizar la herramienta CulDeSacMasks en el modo inmediato.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.CulDeSacMasks_cartography("C:/data/cartography.gdb/transportation/roads",
                                "C:/data/cartography.gdb/transportation/cds_polys",
                                "25000", "", "5 meters", "ALL")
Ejemplo 2 de CulDeSacMasks (script independiente)

Este script independiente muestra un ejemplo del uso de la herramienta CulDeSacMasks.

# Name: CulDeSacMasks_standalone_script.py
# Description: Creates masks at the unconnected ends of lines in the input layer. 
 
# Import system modules
import arcpy

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

# Set local variables
input_layer = "cartography.gdb/transportation/roads"
outpuf_fc = "cartography.gdb/transportation/cds_polys"
reference_scale = "25000"
spatial_reference = arcpy.Describe(input_layer).spatialReference
margin = "5 meters"
attributes = "ALL"

# Execute Cul De Sac Masks
arcpy.CulDeSacMasks_cartography(input_layer, output_fc, reference_scale, 
                                spatial_reference, margin, attributes)

Información de licenciamiento

  • Basic: No
  • Standard: No
  • Advanced: Sí

Temas relacionados