Máscaras de contornos de entidades (Cartografía)

Nivel de licencia:BasicStandardAdvanced

Resumen

Crea polígonos de máscara con una distancia y forma especificadas alrededor de las entidades simbolizadas en la capa de entrada.

Uso

Sintaxis

FeatureOutlineMasks_cartography (input_layer, output_fc, reference_scale, spatial_reference, margin, method, mask_for_non_placed_anno, {attributes})
ParámetroExplicaciónTipo de datos
input_layer

Capa de entrada simbolizada 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 para la 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 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 el polígono 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. Es posible que en la mayoría de los casos necesite 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 da cuenta del valor de 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.

Linear unit
method

El tipo de geometría de máscaras que se crea. Hay cuatro tipos:

  • BOXUn polígono que representa la extensión de la entidad simbolizada.
  • CONVEX_HULLLa envoltura convexa de la geometría simbolizada de la entidad. Esta es la opción predeterminada.
  • EXACT_SIMPLIFIEDUn polígono generalizado que representa la forma exacta de la entidad simbolizada. Los polígonos creados con este método tienen una cantidad significativamente menor de vértices en comparación con los polígonos creados con el método EXACT.
  • EXACTUn 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. Esta opción solo se utiliza al crear máscaras de capas de anotación de geodatabase.

  • ALL_FEATURESCrea máscaras para todas las entidades de anotación.
  • ONLY_PLACEDSolo crea máscaras para entidades con estado de colocadas.
String
attributes
(Opcional)

Determina 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.
  • ALL Se transferirán todos los atributos desde las entidades de entrada a las entidades de salida.
String

Ejemplo de código

Ejemplo de la herramienta FeatureOutlineMasks (ventana de Python)

La siguiente secuencia de comandos de la ventana de Python muestra cómo utilizar la herramienta FeatureOutlineMasks en el modo inmediato.

import arcpy from arcpy import env env.workspace = "C:/data" sr = arcpy.SpatialReference(4326) arcpy.FeatureOutlineMasks_cartography("C:/data/cartography.gdb/transportation/roads",                                 "C:/data/cartography.gdb/transportation/fom_polys",                                 "25000", sr, "5 meters","EXACT_SIMPLIFIED", "ALL_FEATURES", "ALL")
Ejemplo de la herramienta FeatureOutlineMasks (secuencia de comandos de Python independiente)

Esta secuencia de comandos independiente muestra un ejemplo del uso de la herramienta FeatureOutlineMasks.

# Name: FeatureOutlineMasks_standalone_script.py
# Description: Creates mask polygons at a specified distance and shape
#           around symbolized features. 
 
# Import system modules
import arcpy
from arcpy import env

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

# Set local variables
input_layer = "C:/data/roads.lyr"
output_fc = "C:/data/cartography.gdb/transportation/fom_polys"
reference_scale = "25000"
spatial_reference = arcpy.SpatialReference(4326)
margin = "5 meters"
method = "EXACT_SIMPLIFIED"
mask_for_non_placed_anno = "ONLY_PLACED"
attributes = "ALL"

# Execute Feature Outline Masks
arcpy.FeatureOutlineMasks_cartography(input_layer,
                                      output_fc,
                                      reference_scale,
                                      spatial_reference,
                                      margin, method,
                                      mask_for_non_placed_anno,
                                      attributes)

Entornos

Temas relacionados

Información sobre licencias

ArcGIS for Desktop Basic: No
ArcGIS for Desktop Standard: No
ArcGIS for Desktop Advanced: Sí
9/11/2013