Resumen
Identifica la entidad ubicada más cerca del centro en una clase de entidad de punto, línea o polígono.
Más información sobre el funcionamiento de la Entidad central
Ilustración
Uso
La entidad asociada con la menor distancia acumulada a todas las otras entidades en el dataset es la entidad ubicada más cerca del centro; esta entidad se selecciona y copia en una Clase de entidad de salida nueva. Es posible tener más de una entidad que comparta la distancia acumulada más pequeña con otras entidades. Cuando esto sucede, todas estas entidades ubicadas más cerca del centro se copian a la Clase de entidad de salida.
Las distancias acumuladas se miden utilizando EUCLIDEAN_DISTANCE o MANHATTAN_DISTANCE, tal y como se especifica por medio del parámetro Método de distancia .
-
Los centroides de entidad se utilizan en los cálculos de distancia para las entidades de línea y polígono. Para multipuntos, polilíneas o polígonos con varias partes, el centroide se calcula utilizando el centro medio ponderado de todas las partes de entidad. La ponderación para las entidades de punto es 1, para las entidades de línea es longitud y para las entidades de polígono es área.
-
Las capas del mapa se pueden utilizar para definir la Clase de entidad de entrada. Cuando se utiliza una capa con una selección, solo las entidades seleccionadas se incluyen en el análisis.
El Campo de caso se utiliza para agrupar las entidades para cómputos de Entidad central separada. El Campo Caso puede ser del tipo de cadena de caracteres, fecha o entero. Los registros con valores NULL para el Campo de caso se excluirán del análisis.
La distancia o el peso entre una entidad y el polígono se denomina auto potencial. Con frecuencia, este peso es cero, pero en algunos casos es necesario especificar otro valor fijo o un valor distinto para cada entidad (tal vez basado en el tamaño del polígono, por ejemplo).
Sintaxis
CentralFeature(Input_Feature_Class, Output_Feature_Class, Distance_Method, {Weight_Field}, {Self_Potential_Weight_Field}, {Case_Field})
Parámetro | Explicación | Tipo de datos |
Input_Feature_Class | La clase de entidad que contiene una distribución de entidades desde donde identificar la entidad ubicada más cerca del centro. | Feature Layer |
Output_Feature_Class | La clase de entidad que contiene la entidad ubicada más cerca del centro en la Clase de entidad de entrada. | Feature Class |
Distance_Method | Especifica cómo se calculan las distancias desde cada entidad hasta las entidades vecinas.
| String |
Weight_Field (Opcional) | El campo numérico que se utiliza para calcular las distancias en la matriz de distancia origen-destino. | Field |
Self_Potential_Weight_Field (Opcional) | El campo que representa el auto potencial: la distancia o el peso entre una entidad y el polígono. | Field |
Case_Field (Opcional) | El campo que se utiliza para agrupar entidades para cómputos de entidad central separada. El campo caso puede ser del tipo de cadena de caracteres, fecha o entero. | Field |
Muestra de código
Ejemplo 1 de CentralFeature (ventana de Python)
La siguiente secuencia de comandos de la ventana de Python demuestra cómo utilizar la herramienta CentralFeature.
import arcpy
arcpy.env.workspace = r"C:\data"
arcpy.CentralFeature_stats("coffee_shops.shp", "coffee_CENTRALFEATURE.shp", "EUCLIDEAN_DISTANCE", "NUM_EMP", "#", "#")
Ejemplo 2 de CentralFeature (secuencia de comandos de Python independiente)
La siguiente secuencia de comandos de Python independiente demuestra cómo utilizar la herramienta CentralFeature.
# Measure geographic distribution characteristics of coffee house locations weighted by the number of employees
# Import system modules
import arcpy
# Local variables...
workspace = "C:/data"
input_FC = "coffee_shops.shp"
CF_output = "coffee_CENTRALFEATURE.shp"
MEAN_output = "coffee_MEANCENTER.shp"
MED_output = "coffee_MEDIANCENTER.shp"
weight_field = "NUM_EMP"
try:
# Set the workspace to avoid having to type out full path names
arcpy.env.workspace = workspace
# Process: Central Feature...
arcpy.CentralFeature_stats(input_FC, CF_output, "EUCLIDEAN_DISTANCE", weight_field, "#", "#")
# Process: Mean Center...
arcpy.MeanCenter_stats(input_FC, MEAN_output, weight_field, "#", "#")
# Process: Median Center...
arcpy.MedianCenter_stats(input_FC, MED_output, weight_field, "#", "#")
except:
# If an error occurred when running the tool, print out the error message.
print(arcpy.GetMessages())
Entornos
Información sobre licencias
- Basic: Sí
- Standard: Sí
- Advanced: Sí