Entidad central

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

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. EUCLIDEAN_DISTANCE —La distancia en línea recta entre dos puntos MANHATTAN_DISTANCE —La distancia entre dos puntos medida a lo largo de los ejes en ángulos rectos (manzana); se calcula al sumar la diferencia (absoluta) entre las coordenadas x e y	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)

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")

Ejemplo 2 de CentralFeature (script independiente)

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

  Nota:

  La geometría de entidades se proyecta al Sistema de coordenadas de salida antes del análisis.

• Transformaciones geográficas
• Espacio de trabajo actual
• Espacio de trabajo temporal
• Nombres de campos calificados
• La salida tiene valores M
• Resolución M
• Tolerancia M
• La salida tiene valores Z
• Valor Z de salida predeterminado
• Resolución Z
• Tolerancia Z
• Resolución XY
• Tolerancia XY

Información de licenciamiento

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