Convertir ubicación de marcador en puntos (Cartografía)

Resumen

Crea puntos a partir de los marcadores de una ubicación de marcador en una entidad de polígono simbolizada.

Ilustración

Ilustración de la herramienta Convertir ubicaciones de marcador en puntos
Los símbolos de marcador colocado dentro de polígonos se convierten en entidades de punto. Los puntos pueden desplazarse para garantizar el mantenimiento de una distancia mínima entre marcadores y pueden eliminarse para evitar conflictos con los límites o las entidades de barrera.

Uso

  • Esta herramienta evalúa los conflictos de gráficos de entidades simbolizadas para determinar qué marcadores se incluirán en la salida. Se usa tanto la extensión de la simbología como la escala de referencia. Ejecute esta herramienta cuando finalice la apariencia de los símbolos y asegúrese de que la escala de referencia se corresponda con la escala de salida final prevista.

  • El sistema de coordenadas predeterminado de la salida es el mismo que el de la vista del mapa actual. Para utilizar un sistema de coordenadas diferente, utilice la configuración del entorno del sistema de coordenadas cartográficas. Cuando se ejecute la herramienta en un entorno de secuencia de comandos sin un mapa activo, se utilizará el sistema de coordenadas de las entidades de entrada.

  • En la capa de salida solo se admiten el símbolo único y la simbología de valores únicos. Se respetará la configuración de asignación de atributos almacenada en la capa de entrada.

  • Cuando se especifica el parámetro Mantener al menos un marcador, se crea un archivo de registro en el que figuran las entidades de entrada para las que se ha creado un solo marcador que, de lo contrario, se habrían omitido. La ubicación del archivo de registro se incluye en los detalles del mensaje de geoprocesamiento.

  • Se crearán puntos para cada capa de marcadores admitida en un símbolo de entrada. Para asegurarse de que los marcadores multicapa complejos se traten como una sola entidad y se creen como un solo punto en la salida, primero hay que crear el símbolo como un símbolo de punto y guardarlo en un estilo. A continuación, en la pestaña Capas del panel Simbología, use el botón Estilo de Apariencia para establecer el símbolo del marcador a partir del estilo.

  • Los parámetros Método de desplazamiento y Distancia mínima del marcador están disponibles cuando al menos una capa de marcador utiliza una ubicación aleatoria. Utilice estos parámetros para resolver conflictos entre marcadores superpuestos y preservar una distancia mínima entre ellos. La opción Separar alejará los marcadores entre sí hasta que alcancen la distancia mínima y, si es necesario, los eliminará para evitar conflictos. La opción Desplazar hacia cuadrícula moverá los marcadores hasta que alcancen la distancia mínima entre ellos o alcancen su ubicación original en la cuadrícula. Con la opción Desplazar hacia cuadrícula no se eliminarán marcadores.

Parámetros

EtiquetaExplicaciónTipo de datos
Capa de entrada

Capa poligonal simbolizada con una ubicación de marcador.

Layer
Clase de entidad de salida

Clase de entidad de punto que contiene puntos creados a partir de marcadores en la configuración de colocación de marcadores de la capa de entradas. Los puntos se agregarán al mapa activo desde la entrada como capa simbolizada con un renderizar de valor único mediante el uso de símbolos.

Feature Class
Crear multipuntos
(Opcional)

Especifica si las entidades de punto de salida serán multipunto.

  • Activado: se creará una entidad multipunto para los marcadores en cada polígono de entrada. Esta es la opción predeterminada.
  • Desactivado: se creará una entidad de punto para cada marcador.

Boolean
Opción de límite
(Opcional)

Especifica si se crearán puntos de salida para los marcadores de entrada que cruzan los límites de polígonos.

  • Podría cruzar el límiteSe crearán puntos de salida para los marcadores de entrada que cruzan los límites de polígonos. Esta es la opción predeterminada.
  • Distancia fijaNo se crearán puntos de salida para los marcadores de entrada que se encuentran a la distancia de los límites de polígono especificada por el parámetro Distancia de límite.
  • Valor del campoNo se crearán puntos de salida para los marcadores de entrada que se encuentran a la distancia de los límites de polígono especificada por el parámetro Campo de distancia de límite.
String
Distancia de límite
(Opcional)

Distancia mínima entre los símbolos de punto de salida y los límites de polígono. Este parámetro solo se aplica cuando el parámetro Opción de límite se configura en Distancia fija. El valor predeterminado es 0.

Double
Campo de distancia de límite
(Opcional)

Campo numérico de los polígonos de entrada que se utilizará para determinar la distancia de límite. Este parámetro se aplica solo cuando el parámetro Opción de límite se configura en Valor de campo.

Field
Unidad de distancia de límite
(Opcional)

Especifica la unidad lineal que se utilizará en el caso de los valores de distancia de límite.

  • KilómetrosLa unidad será kilómetros.
  • MetrosLa unidad será metros.
  • DecímetrosLa unidad será decímetros.
  • CentímetrosLa unidad será centímetros.
  • MilímetrosLa unidad será milímetros.
  • Millas náuticasLa unidad será millas náuticas.
  • Millas terrestresLa unidad será millas terrestres.
  • YardasLa unidad será yardas.
  • PiesLa unidad será pies.
  • PulgadasLa unidad será pulgadas.
  • GradosLa unidad estará en grados
  • PuntosLa unidad será puntos. Esta es la opción predeterminada.
String
Capas de barrera de entrada
(Opcional)

Capas que contienen las entidades de punto, línea o polígono que son barreras de conflicto para las entidades de entrada. No se crearán marcadores que entren en conflicto con las barreras. Se tendrá en cuenta la simbología de las capas de barrera.

  • Capa de barrera: capa que contiene entidades de punto, línea o polígono.
  • Distancia de barrera: valor numérico que especifica la distancia mínima entre los marcadores y la barrera. Se ignorará si se define el valor de Campo de distancia de barrera. El valor predeterminado es 0.
  • Campo de distancia de barrera: campo numérico de la capa de barrera que se utilizará como distancia de barrera. Hará que se anule el valor de Distancia de barrera. El valor predeterminado es <Ninguno>.
  • Unidad de distancia de barrera: unidad lineal que se utilizará en el caso de los valores de distancia de barrera. El predeterminado es Puntos.

Value Table
Conservar al menos un marcador
(Opcional)

Especifica si se creará un solo marcador para los polígonos de entrada cuando todos los marcadores entran en conflicto con los límites o las barreras.

  • Activado: se creará un marcador para los polígonos de entrada cuando todos los marcadores entren en conflicto con los límites o las barreras.
  • Desactivado: no se creará ningún marcador para los polígonos de entrada cuando todos los marcadores entran en conflicto con los límites o las barreras. Esta es la opción predeterminada.

Boolean
Método de desplazamiento
(Opcional)

Especifica el método de desplazamiento que se utilizará para mover los marcadores que están demasiado cerca entre sí. Este parámetro se aplica solamente cuando los marcadores se sitúan aleatoriamente dentro de los polígonos.

  • No desplazarLos marcadores no se desplazarán. Esta es la opción predeterminada.
  • Desplazar hacia cuadrículaLos marcadores en conflicto se moverán hacia sus puntos de cuadrícula regular originales.
  • SepararLos marcadores en conflicto se separarán unos de otros.
String
Distancia mínima del marcador
(Opcional)

Distancia mínima entre marcadores individuales. Este parámetro se aplica solamente cuando los marcadores se sitúan aleatoriamente dentro de los polígonos. El valor predeterminado es 0.

Linear Unit

arcpy.cartography.ConvertMarkerPlacementToPoints(in_layer, out_feature_class, {create_multipoints}, {boundary_option}, {boundary_distance}, {boundary_distance_field}, {boundary_distance_unit}, {in_barriers}, {keep_at_least_one_marker}, {displacement_method}, {minimum_marker_distance})
NombreExplicaciónTipo de datos
in_layer

Capa poligonal simbolizada con una ubicación de marcador.

Layer
out_feature_class

Clase de entidad de punto que contiene puntos creados a partir de marcadores en la configuración de colocación de marcadores de la capa de entradas. Los puntos se agregarán al mapa activo desde la entrada como capa simbolizada con un renderizar de valor único mediante el uso de símbolos.

Feature Class
create_multipoints
(Opcional)

Especifica si las entidades de punto de salida serán multipunto.

  • CREATE_MULTIPOINTSSe creará una entidad multipunto para los marcadores en cada polígono de entrada. Esta es la opción predeterminada.
  • CREATE_POINTSSe creará una entidad de punto para cada marcador.
Boolean
boundary_option
(Opcional)

Especifica si se crearán puntos de salida para los marcadores de entrada que cruzan los límites de polígonos.

  • MAY_CROSS_BOUNDARYSe crearán puntos de salida para los marcadores de entrada que cruzan los límites de polígonos. Esta es la opción predeterminada.
  • FIXED_DISTANCENo se crearán puntos de salida para los marcadores de entrada que se encuentran a la distancia de los límites de polígono especificada por el parámetro boundary_distance.
  • VALUE_FROM_FIELDNo se crearán puntos de salida para los marcadores de entrada que se encuentran a la distancia de los límites de polígono especificada por el parámetro boundary_distance_field.
String
boundary_distance
(Opcional)

Distancia mínima entre los símbolos de punto de salida y los límites de polígono. Este parámetro solo se aplica cuando el parámetro boundary_option se configura en FIXED_DISTANCE. El valor predeterminado es 0.

Double
boundary_distance_field
(Opcional)

Campo numérico de los polígonos de entrada que se utilizará para determinar la distancia de límite. Este parámetro solo se aplica cuando el parámetro boundary_option se configura en VALUE_FROM_FIELD.

Field
boundary_distance_unit
(Opcional)

Especifica la unidad lineal que se utilizará en el caso de los valores de distancia de límite.

  • KilometersLa unidad será kilómetros.
  • MetersLa unidad será metros.
  • DecimetersLa unidad será decímetros.
  • CentimetersLa unidad será centímetros.
  • MillimetersLa unidad será milímetros.
  • Nautical MilesLa unidad será millas náuticas.
  • Statute MilesLa unidad será millas terrestres.
  • YardsLa unidad será yardas.
  • FeetLa unidad será pies.
  • InchesLa unidad será pulgadas.
  • DegreesLa unidad estará en grados
  • PointsLa unidad será puntos. Esta es la opción predeterminada.
String
in_barriers
[[barrier_layer, {barrier_distance}, {barrier_distance_field}, {barrier_distance_unit}],...]
(Opcional)

Capas que contienen las entidades de punto, línea o polígono que son barreras de conflicto para las entidades de entrada. No se crearán marcadores que entren en conflicto con las barreras. Se tendrá en cuenta la simbología de las capas de barrera.

  • barrier_layer: capa que contiene entidades de punto, línea o polígono.
  • barrier_distance: valor numérico que especifica la distancia mínima entre los marcadores y la barrera. Se ignorará si se configura el valor de barrier_distance_field. El valor predeterminado es 0.
  • barrier_distance_field: campo numérico de la capa de barrera que se utilizará como distancia de barrera. Hará que se ignore el valor de barrier_distance. El valor predeterminado es <None>.
  • barrier_distance_unit: unidad lineal que se utilizará en el caso de los valores de distancia de barrera. El valor predeterminado es Points.

Value Table
keep_at_least_one_marker
(Opcional)

Especifica si se creará un solo marcador para los polígonos de entrada cuando todos los marcadores entran en conflicto con los límites o las barreras.

  • KEEP_AT_LEAST_ONE_MARKERSe creará un marcador para los polígonos de entrada cuando todos los marcadores entren en conflicto con los límites o las barreras.
  • DO_NOT_KEEP_AT_LEAST_ONE_MARKERNo se creará ningún marcador para los polígonos de entrada cuando todos los marcadores entren en conflicto con los límites o las barreras. Esta es la opción predeterminada.
Boolean
displacement_method
(Opcional)

Especifica el método de desplazamiento que se utilizará para mover los marcadores que están demasiado cerca entre sí. Este parámetro se aplica solamente cuando los marcadores se sitúan aleatoriamente dentro de los polígonos.

  • DO_NOT_DISPLACELos marcadores no se desplazarán. Esta es la opción predeterminada.
  • DISPLACE_TOWARD_GRIDLos marcadores en conflicto se moverán hacia sus puntos de cuadrícula regular originales.
  • DISPLACE_APARTLos marcadores en conflicto se separarán unos de otros.
String
minimum_marker_distance
(Opcional)

Distancia mínima entre marcadores individuales. Este parámetro se aplica solamente cuando los marcadores se sitúan aleatoriamente dentro de los polígonos. El valor predeterminado es 0.

Linear Unit

Muestra de código

Ejemplo 1 de ConvertMarkerPlacementToPoints (ventana de Python)

La siguiente secuencia de comandos de la ventana de Python muestra cómo utilizar la función ConvertMarkerPlacementToPoints de modo inmediato.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.env.referenceScale = 5000
arcpy.cartography.ConvertMarkerPlacementToPoints("parks.lyrx", "cartography.gdb/tree_markers")
Ejemplo 2 de ConvertMarkerPlacementToPoints (secuencia de comandos independiente)

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

# Name: ConvertMarkerPlacementToPoints_standalone_script.py
# Description: Converts markers in a marker placement into point features.

# Import system modules
import arcpy
from arcpy import env

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

# Set local variables
in_layer = "parks.lyrx"
out_feature_class = "cartography.gdb/tree_markers"
create_multipoints = "CREATE_MULTIPOINTS"
boundary_option = "VALUE_FROM_FIELD"
boundary_distance = ""
boundary_distance_field = "distance"
boundary_distance_unit = "Points"
in_barriers = [["roads.lyrx", 1, "", "Points"],["rivers.lyrx", 0, "distance", "Points"]]
keep_at_least_one_marker = "KEEP_AT_LEAST_ONE_MARKER"
displacement_method = "DISPLACE_APART"
minimum_marker_distance = "2 Points"


arcpy.cartography.ConvertMarkerPlacementToPoints(in_layer,
                                                 out_feature_class,
                                                 create_multipoints,
                                                 boundary_option,
                                                 boundary_distance,
                                                 boundary_distance_field,
                                                 boundary_distance_unit,
                                                 in_barriers,
                                                 keep_at_least_one_marker,
                                                 displacement_method,
                                                 minimum_marker_distance
)

Información de licenciamiento

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

Temas relacionados