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 la distancia Euclídea o la distancia Manhattan, tal y como se especifica en el 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.
Esta herramienta respeta la naturaleza 3D de sus datos de puntos y utilizará los valores x, y, z en los cálculos si hay valores z disponibles. Dado que estos resultados son 3D por naturaleza, será necesario visualizarlos en una Escena. Asegúrese de que está ejecutando el análisis en una Escena o copie la capa de resultados en una Escena para visualizar correctamente los resultados del análisis.
-
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).
Precaución:
Al utilizar shapefiles tenga en cuenta que no pueden almacenar valores nulos. Las herramientas u otros procedimientos que crean shapefiles a partir de entradas sin shapefiles pueden almacenar o interpretar valores nulos como cero. En algunos casos, los nulos se almacenan como valores negativos muy grandes en shapefiles. Esto puede ocasionar resultados inesperados. Consulte Consideraciones de geoprocesamiento para la salida del shapefile para obtener más información.
Sintaxis
arcpy.stats.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
El siguiente script de la ventana de Python muestra cómo utilizar la función CentralFeature.
import arcpy
arcpy.env.workspace = r"C:\data"
arcpy.CentralFeature_stats("coffee_shops.shp", "coffee_CENTRALFEATURE.shp",
"EUCLIDEAN_DISTANCE", "NUM_EMP")
El siguiente script independiente de Python muestra cómo utilizar la función 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"
# 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)
Entornos
- Sistema de coordenadas de salida
La geometría de entidades se proyecta al Sistema de coordenadas de salida antes del análisis.
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí