Máscaras en la intersección de capas (Cartografía)

Resumen

Crea polígonos de máscara con una forma y tamaño específicos en las intersecciones de dos capas de entrada simbolizadas: la capa para enmascarar y la capa enmascarada.

Más información sobre cómo funcionan Máscaras de contornos de entidades y Máscaras en la intersección de capas

Uso

  • Esta herramienta acepta como entrada capas de entidades de punto, línea y polígono, así como capas de anotaciones de geodatabase.

  • 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.

  • 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. Todas estas cosas dan como resultado un dibujo más lento en la pantalla. Además, el rendimiento de impresión y exportación puede ser bajo o no producir una salida válida. Esto se debe al procesamiento necesario para imprimir y exportar mapas con máscaras, y 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.

  • Para mejorar el rendimiento del dibujo, así como el rendimiento y la fiabilidad de la impresión y exportación, use las máscaras más simples necesarias para los propósitos del mapa. En particular, cuando se usa el parámetro Tipo de máscara para enmascarar texto de anotación, la opción de Casco convexo es suficiente para muchos objetivos del mapa. Para máscaras de texto más detalladas, utilice la opción Exacto simplificado. Al crear máscaras con una gran cantidad de texto en un mapa relativamente grande, evite utilizar la opción Exacta, ya que creará demasiadas máscaras complicadas como para producir una salida válida de manera eficaz.

  • Los valores de margen se pueden especificar en unidades de página o en unidades de mapa. Normalmente, los valores de distancia de margen se especifican 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 crearán con la distancia de margen calculada en el espacio de página (considere que el margen es una distancia medida en el papel). En este cálculo se tiene en cuenta el valor del parámetro Escala de referencia.

    Si elige alguna otra unidad para el valor del margen, las máscaras se crearán con la distancia de margen calculada en el espacio de mapa (considere 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.

  • Si una de las capas de entrada es un capa de anotación, la escala de referencia se establecerá automáticamente en la escala de referencia de la clase de entidad de la capa para garantizar un cálculo preciso de la máscara. Si se intersecan dos capas de anotación, deben tener la misma escala de referencia.

  • Al enmascarar una anotación proyectada al vuelo, cree máscaras utilizando la referencia espacial del mapa al establecerla adecuadamente en el parámetro Sistema de coordenadas del cálculo. La legibilidad se mantiene cuando el texto se proyecta al vuelo, que es la razón por la que pueden existir diferencias en el área espacial que ocupa el texto en distintas proyecciones.

  • Las máscaras de entidades de anotación son específicas de la fuente. Al utilizar máscaras con texto, asegúrese de utilizar la misma fuente en la pantalla y en la salida. Para ello, integre fuentes en la salida vectorial o descargue SoftFonts para impresoras o graficadores.

  • El procesamiento conjunto de datasets grandes podría superar los límites de la memoria. En este caso, considere el procesamiento de los datos de entrada por partición al identificar una clase de entidad poligonal relevante en la configuración de entorno Particiones cartográficas. Las partes de los datos definidos por los límites de partición se procesarán en secuencia. La clase de entidad de salida será sin fisuras y consistente en los bordes de la partición.

  • Las máscaras se crearán en función de la rotación del mapa actual y es posible que no sean válidas si el mapa se establece en una rotación diferente después de la creación de la máscara.

Parámetros

EtiquetaExplicaciónTipo de datos
Capa de máscara

La capa de entrada simbolizada que se intersecará con la capa enmascarada para crear polígonos de máscara. Esta es la capa que se visualizará cuando se aplique la creación de máscaras a la capa enmascarada.

Layer
Capa que será enmascarada

La capa de entrada simbolizada que se enmascarará. Esta es la capa que se oscurecerá debido a los polígonos de máscara.

Layer
Clase de entidad de salida

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

Feature Class
Escala de referencia

La escala de referencia que se utilizará 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
Sistema de coordenadas del cálculo

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
Margen

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 pueden especificar en unidades de página o en unidades de mapa. En la mayoría de las ocasiones, los valores de distancia del margen de tiempo se especifican en unidades de página.

El margen no puede ser negativo.

Linear Unit
Tipo de máscara

Especifica el tipo de geometría de máscara que se va a crear.

  • CajaSe creará un polígono que representa la extensión de la entidad simbolizada.
  • Envoltura convexaSe creará la envoltura convexa de la geometría simbolizada de la entidad. Esta es la opción predeterminada.
  • Exacta simplificadaSe creará un polígono generalizado que representa la forma exacta de la entidad simbolizada. Los polígonos creados con este método tendrán una cantidad significativamente menor de vértices en comparación con los polígonos creados con la opción Exacta.
  • ExactaSe creará un polígono que representa la forma exacta de la entidad simbolizada.
  • CajaSe creará un polígono que representa la extensión de la entidad simbolizada.
  • Envoltura convexaSe creará la envoltura convexa de la geometría simbolizada de la entidad. Esta es la opción predeterminada.
  • Exacta simplificadaSe creará un polígono generalizado que representa la forma exacta de la entidad simbolizada. Los polígonos creados con este método tendrán una cantidad significativamente menor de vértices en comparación con los polígonos creados con la opción EXACT.
  • ExactaSe creará un polígono que representa la forma exacta de la entidad simbolizada.
String
Crear máscaras para anotación no colocada

Especifica si se van a crear máscaras para anotaciones no colocadas. Este parámetro solo se utiliza al crear máscaras de capas de anotación de geodatabase.

  • Todas las entidades de anotaciónSe van a crear máscaras para todas las entidades de anotación. Esta es la opción predeterminada.
  • Solo entidades de anotación colocadasLas máscaras solo se crearán para entidades con estado de colocadas.
String
Transferir atributos
(Opcional)

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

  • Solo el campo FIDSolo se transferirá el campo FID desde las entidades de entrada a las entidades de salida. Esta es la opción predeterminada.
  • Todos los atributos excepto el campo FIDSe transferirán todos los atributos, excepto FID, desde las entidades de entrada a las entidades de salida.
  • Todos los atributosSe transferirán todos los atributos desde las entidades de entrada a las entidades de salida.
String

arcpy.cartography.IntersectingLayersMasks(masking_layer, masked_layer, output_fc, reference_scale, spatial_reference, margin, method, mask_for_non_placed_anno, {attributes})
NombreExplicaciónTipo de datos
masking_layer

La capa de entrada simbolizada que se intersecará con la capa enmascarada para crear polígonos de máscara. Esta es la capa que se visualizará cuando se aplique la creación de máscaras a la capa enmascarada.

Layer
masked_layer

La capa de entrada simbolizada que se enmascarará. Esta es la capa que se oscurecerá debido a los polígonos de máscara.

Layer
output_fc

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

Feature Class
reference_scale

La escala de referencia que se utilizará 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 pueden especificar en unidades de página o en unidades de mapa. En la mayoría de las ocasiones, los valores de distancia del margen de tiempo se especifican en unidades de página.

El margen no puede ser negativo.

Linear Unit
method

Especifica el tipo de geometría de máscara que se va a crear.

  • BOXSe creará un polígono que representa la extensión de la entidad simbolizada.
  • CONVEX_HULLSe creará la envoltura convexa de la geometría simbolizada de la entidad. Esta es la opción predeterminada.
  • EXACT_SIMPLIFIEDSe creará un polígono generalizado que representa la forma exacta de la entidad simbolizada. Los polígonos creados con este método tendrán una cantidad significativamente menor de vértices en comparación con los polígonos creados con la opción EXACT.
  • EXACTSe creará un polígono que representa la forma exacta de la entidad simbolizada.
String
mask_for_non_placed_anno

Especifica si se van a crear máscaras para anotaciones no colocadas. Este parámetro solo se utiliza al crear máscaras de capas de anotación de geodatabase.

  • ALL_FEATURESSe van a crear máscaras para todas las entidades de anotación. Esta es la opción predeterminada.
  • ONLY_PLACEDLas máscaras solo se crearán para entidades con estado de colocadas.
String
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 IntersectingLayersMasks (ventana de Python)

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

import arcpy
arcpy.cartography.IntersectingLayersMasks("C:/data/cartography.gdb/transportation/roads",
                                          "C:/data/cartography.gdb/transportation/railroads",
                                          "C:/data/cartography.gdb/transportation/ilm_polys",
                                          "25000", "", "5 meters", "EXACT_SIMPLIFIED", "", "ALL")
Ejemplo 2 de IntersectingLayersMasks (script independiente)

Esta secuencia de comandos independiente muestra un ejemplo de uso de la función IntersectingLayersMasks.

# Name: IntersectingLayersMasks_standalone_script.py
# Description: Creates masking polygons at a specified
#              shape and size at the intersections of symbolized features. 
 
# Import system modules
import arcpy

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

# Set local variables
masking_layer = "roads.lyrx"
masked_layer = "buildings_poly.lyrx"
outpuf_fc = "cartography.gdb/transportation/ilm_polys"
reference_scale = "25000"
spatial_reference = arcpy.Describe(masking_layer).spatialReference
margin = "5 Points"
method = "CONVEX_HULL"
mask_for_non_placed_anno = "ALL_FEATURES"
attributes = "ALL"

# Execute Intersecting Layers Masks
arcpy.IntersectingLayersMasks_cartography(masking_layer,
                                          masked_layer,
                                          output_fc,
                                          reference_scale,
                                          spatial_reference,
                                          margin, method,
                                          mask_for_non_placed_anno,
                                          attributes)

Información de licenciamiento

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

Temas relacionados