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
La herramienta Elipse de desviación estándar crea una nueva Clase de entidad de elipse de salida que contiene polígonos elípticos o multiparches elipsoidales 3D, uno para cada caso, si se utiliza 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 son CenterX, CenterY, XStdDist, YStdDist y Rotación. Si las entidades de entrada son puntos 3D, se agregan los siguientes campos adicionales a la Clase de entidad de elipse de salida: CenterZ, ZStdDist, AngleZ, TiltX, RollY y Volumen. Cuando se proporciona un Campo de caso, este campo también se agrega a la Clase de entidad de salida.
Esta herramienta respeta la naturaleza 3D de sus datos de puntos y utilizará los valores x, y 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.
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 de Rayleigh), un polígono elipse de desviación estándar cubrirá aproximadamente el 63 por ciento de las entidades; dos desviaciones estándar tendrán aproximadamente el 98 por ciento de las entidades y tres desviaciones estándar cubrirán aproximadamente el 99 por ciento de las entidades en dos dimensiones. En tres dimensiones, dará como resultado una regla con un porcentaje de 61-99-100.
Si sus datos 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 de la elipsoide en un espacio 3D. Si sus datos no están habilitados para z, el valor del campo Rotación de salida representa la rotación del eje largo medida en el sentido de las agujas del reloj a partir del mediodía.
Si sus datos están habilitados para z, se puede utilizar la herramienta Agregar atributos de geometría 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 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 para el 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.
Sintaxis
arcpy.stats.DirectionalDistribution(Input_Feature_Class, Output_Ellipse_Feature_Class, Ellipse_Size, {Weight_Field}, {Case_Field})| Parámetro | 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 | El tamaño de las elipses de salida en desviaciones estándar. El tamaño de elipse predeterminado es 1; las opciones válidas son 1, 2 ó 3 desviaciones estándar.
| String |
Weight_Field (Opcional) | El campo numérico que se utiliza para pesar las ubicaciones de acuerdo con la importancia relativa. | Field |
Case_Field (Opcional) | Campo que se utiliza 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 herramienta DirectionalDistribution.
import arcpy
arcpy.env.workspace = r"C:\data"
arcpy.DirectionalDistribution_stats("AutoTheft.shp", "auto_theft_SE.shp", "1_STANDARD_DEVIATION")El siguiente script de Python independiente muestra cómo utilizar la herramienta 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.StandardDistance_stats(locations, standardDistance, "1_STANDARD_DEVIATION", "#", "#")
# Process: Directional Distribution (Standard Deviational Ellipse) of auto theft locations...
arcpy.DirectionalDistribution_stats(locations, standardEllipse, "1_STANDARD_DEVIATION", "#", "#")
# Process: Linear Directional Mean of auto thefts...
arcpy.DirectionalMean_stats(links, linearDirectMean, "DIRECTION", "#")Entornos
- 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álculos matemáticos se basan en la referencia espacial del Sistema de coordenadas de salida.
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí