Resumen
Crea elipses 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 salida que contiene polígonos elípticos, uno para cada caso (parámetro Campo de caso). Los valores de atributo para estos polígonos elipse incluyen coordenadas X e Y para el centro medio, dos distancias estándar (ejes largos y cortos) y la orientación de la elipse. Los nombres de campo son CenterX, CenterY, XStdDist, YStdDist y Rotación. Cuando se proporciona un Campo de caso, este campo también se agrega a la Clase de entidad de salida.
-
Los cálculos basados en la distancia euclidiana o de Manhattan requieren datos proyectados para medir distancias correctamente.
Cuando el patrón espacial de entidades subyacente se concentra en el centro con menos entidades hacia la periferia (una distribución espacial normal), un polígono elipse de desviación estándar cubrirá aproximadamente el 68 por ciento de las entidades; dos desviaciones estándar tendrán aproximadamente el 95 por ciento de las entidades; y tres desviaciones estándar cubrirán aproximadamente el 99 por ciento de las entidades en el cluster.
-
El valor en el 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.
-
El Campo de caso se utiliza para agrupar entidades antes del análisis. Cuando se especifica un Campo de caso, las entidades de entrada se agrupan primero de acuerdo a los valores de campo de caso y, a continuación, se calcula un elipse 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 elipse de desviación estándar se puede basar en un Campo de peso opcional (para que los elipses para accidentes de tráfico se pesen 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.
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 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
Ejemplo de DirectionalDistribution (ventana de Python)
La siguiente secuencia de comandos 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", "#", "#")
Ejemplo de DirectionalDistribution (secuencia de comandos de Python independiente)
La siguiente secuencia de comandos 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"
try:
# 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", "#")
except:
# If an error occurred while running a tool, print the messages
print(arcpy.GetMessages())
Entornos
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí