| Etiqueta | Explicación | Tipo de datos |
Clase de entidad de entrada | Una clase de entidad que contiene una distribución de entidades para las cuales se calculará la elipse o elipsoide de desviación estándar. | Feature Layer |
Clase de entidad de elipse de salida | Una clase de entidad poligonal que contendrá la entidad de elipse de salida. | Feature Class |
Tamaño de elipse | Especifica el tamaño de las elipses de salida en desviaciones estándar.
| String |
Campo de peso (Opcional) | Campo numérico que se utilizará para pesar las ubicaciones de acuerdo con la importancia relativa. | Field |
Campo de caso (Opcional) | Campo que se utilizará para agrupar entidades para cálculos de distribución direccional separados. El campo caso puede ser del tipo de cadena de caracteres, fecha o entero. | Field |
Resumen
Crea elipses o elipsoides de desviación estándar para resumir las características espaciales de las entidades geográficas: tendencia central, dispersión y tendencias direccionales.
Más información sobre cómo funciona la distribución direccional (Elipse de desviación estándar)
Ilustración
Uso
Esta herramienta crea una salida que contiene polígonos elípticos o multiparches elipsoidales 3D, uno para cada caso, si se especifica el parámetro Campo de caso. Los valores de atributo para estos polígonos elípticos incluyen coordenadas x e y para el centro medio, dos distancias estándar (ejes largos y cortos) y la orientación de la elipse. Cuando se utilizan datos de puntos habilitados para z, los valores de atributo también incluirán la coordenada z para el centro medio, una tercera distancia estándar (altura) y medidas de orientación del elipsoide. Si las entidades de entrada son 2D, los nombres de campo serán CenterX, CenterY, XStdDist, YStdDist y Rotation. Si las entidades de entrada son puntos 3D, también se agregan los siguientes campos a la salida: CenterZ, ZStdDist, AngleZ, TiltX, RollY y Volume. Cuando se proporciona un valor en el parámetro Campo de caso, este campo también se agregará a la salida.
Esta herramienta respeta la naturaleza 3D de los datos de puntos y utilizará los valores x, y y z en sus 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.
Se requieren datos proyectados para medir las distancias con exactitud.
Cuando el patrón espacial de entidades subyacente se concentra hacia el centro con menos entidades hacia la periferia (siguiendo una distribución gaussiana espacial), un polígono elipse de desviación estándar cubrirá aproximadamente el 68 por ciento de las entidades; dos desviaciones estándar cubrirán aproximadamente el 95 por ciento de las entidades y tres desviaciones estándar cubrirán aproximadamente el 99 por ciento de las entidades.
Si los datos de entrada están habilitados para z, los valores de los campos de salida AngleZ, TiltX y RollY serán ángulos de Euler y describirán la orientación del elipsoide en un espacio 3D. Si sus los datos no están habilitados para z, el valor del campo Rotation de salida representa la rotación del eje largo medida en el sentido de las agujas del reloj a partir del mediodía.
La herramienta Calcular atributos de geometría se puede utilizar para ver las coordenadas x, y y z de los datos.
El parámetro Campo de caso se utiliza para agrupar entidades antes del análisis. Cuando se especifica un valor en el parámetro Campo de caso, primero se agrupan las entidades de entrada según los valores de campo de caso. A continuación, se calcula una elipse o elipsoide de desviación estándar para cada grupo. El campo caso puede ser del tipo de cadena de caracteres, fecha o entero. Los registros con valores nulos correspondientes al valor del parámetro Campo de caso se excluirán del análisis.
El cálculo de la elipse o elipsoide de desviación estándar se puede basar en un parámetro Campo de peso opcional (para obtener las elipses para accidentes de tráfico ponderadas según la gravedad, por ejemplo). El campo de peso debe ser numérico.
-
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.
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.
Parámetros
arcpy.stats.DirectionalDistribution(Input_Feature_Class, Output_Ellipse_Feature_Class, Ellipse_Size, {Weight_Field}, {Case_Field})| Nombre | Explicación | Tipo de datos |
Input_Feature_Class | Una clase de entidad que contiene una distribución de entidades para las cuales se calculará la elipse o elipsoide de desviación estándar. | Feature Layer |
Output_Ellipse_Feature_Class | Una clase de entidad poligonal que contendrá la entidad de elipse de salida. | Feature Class |
Ellipse_Size | Especifica el tamaño de las elipses de salida en desviaciones estándar.
| String |
Weight_Field (Opcional) | Campo numérico que se utilizará para pesar las ubicaciones de acuerdo con la importancia relativa. | Field |
Case_Field (Opcional) | Campo que se utilizará para agrupar entidades para cálculos de distribución direccional separados. 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 DirectionalDistribution.
import arcpy
arcpy.env.workspace = r"C:\data"
arcpy.stats.DirectionalDistribution("AutoTheft.shp", "auto_theft_SE.shp",
"1_STANDARD_DEVIATION")El siguiente script independiente de Python muestra cómo utilizar la función DirectionalDistribution.
# Measure the geographic distribution of auto thefts.
# Import system modules
import arcpy
# Local variables...
workspace = "C:/data"
locations = "AutoTheft.shp"
links = "AutoTheft_links.shp"
standardDistance = "auto_theft_SD.shp"
stardardEllipse = "auto_theft_SE.shp"
linearDirectMean = "auto_theft_LDM.shp"
# Set the workspace (to avoid having to type in the full path to the data every
# time).
arcpy.env.workspace = workspace
# Process: Standard Distance of auto theft locations
arcpy.stats.StandardDistance(locations, standardDistance, "1_STANDARD_DEVIATION")
# Process: Directional Distribution (Standard Deviational Ellipse) of auto theft
# locations.
arcpy.stats.DirectionalDistribution(locations, standardEllipse,
"1_STANDARD_DEVIATION")
# Process: Linear Directional Mean of auto thefts.
arcpy.stats.DirectionalMean(links, linearDirectMean, "DIRECTION")Entornos
Sistema de coordenadas de salida, 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, Dominio Z de salida
Casos especiales
- Sistema de coordenadas de salida
La geometría de entidades se proyecta al Sistema de coordenadas de salida antes del análisis. Todos los cómputos matemáticos se basan en la referencia espacial del Sistema de coordenadas de salida.