Collecter des événements (Statistiques spatiales)

Synthèse

Convertit les données d’événement, telles que les délits ou les incidents sanitaires, en données ponctuelles pondérées.

Illustration

Illustration de l’outil Collecter des événements

Utilisation

  • Cet outil combine les points coïncidents. Il crée une valeur Classe d’entités en sortie qui contient les emplacements uniques trouvés dans la valeur Classe d’entités en entrée. Il ajoute ensuite un champ ICOUNT qui indique la somme de tous les incidents à chaque emplacement unique.

  • Cet outil combine uniquement des entités qui ont exactement les mêmes coordonnées de centroïde x et y. Vous pouvez utiliser l’outil Intégrer pour capturer les unes aux autres les entités les plus proches avant d’exécuter cet outil.

    Attention :

    L’outil Intégrer modifie définitivement la géométrie de l’entité ; veillez à toujours faire une copie de sauvegarde de la classe d’entités avant d’utiliser l’outil Intégrer.

  • Les outils Analyse des points chauds (Getis-Ord Gi*), Analyse des valeurs aberrantes et des agrégats (Local Moran’s I) et Autocorrélation spatiale (Morans I), par exemple, nécessitent des points pondérés plutôt que des incidents individuels. Vous pouvez utiliser cet outil pour créer des pondérations lorsque la classe d’entités en entrée contient des entités coïncidentes.

  • Bien que cet outil fonctionne avec des données surfaciques ou linéaires, il n’est adapté qu’aux données d’événement, d’incident ou autres données d’entités ponctuelles. Pour les entités linéaires et surfaciques, la coïncidence des entités est basée sur les centroïdes géométriques réels des entités. Pour les multi-points, les polylignes, ou les polygones comprenant plusieurs parties, le centroïde est calculé à l'aide du centre moyen pondéré de toutes les parties d'entité. La pondération pour les entités ponctuelles est de 1 ; pour les entités linéaires, elle correspond à la longueur et pour les entités surfaciques, à la superficie.

  • Si vous souhaitez que chacune des données ponctuelles ou une partie des données multi-points ou multi-parties soient traitées en tant qu’entités mono-parties, exécutez l’outil Multi-parties vers une partie. Puis, exécutez l’outil Collecter les événements sur la classe d’entités mono-partie. Pour plus d'informations, reportez-vous à la rubrique Traitement des données multi-points.

  • Outre la valeur Classe d’entités ponctuelles pondérées en sortie, cet outil transmet, comme valeurs en sortie dérivées, le nom du champ de décompte et la valeur de décompte maximale rencontrée pour un emplacement. Ces valeurs en sortie dérivées sont utiles lorsque vous utilisez cet outil dans les modèles ou les scripts.

Paramètres

ÉtiquetteExplicationType de données
Entités représentant un incident en entrée

Entités représentant les données d'événement ou d'incident.

Feature Layer
Classe d’entités ponctuelles pondérées en sortie

Classe d’entités en sortie qui contiendra les données ponctuelles pondérées.

Feature Class

Sortie obtenue

ÉtiquetteExplicationType de données
Champ de résultats

Le nom du champ de total.

Field
Valeur Z maximale

La valeur totale maximale rencontrée pour un emplacement.

Double

arcpy.stats.CollectEvents(Input_Incident_Features, Output_Weighted_Point_Feature_Class)
NomExplicationType de données
Input_Incident_Features

Entités représentant les données d'événement ou d'incident.

Feature Layer
Output_Weighted_Point_Feature_Class

Classe d’entités en sortie qui contiendra les données ponctuelles pondérées.

Feature Class

Sortie obtenue

NomExplicationType de données
Results_Field

Le nom du champ de total.

Field
Z_Max_Value

La valeur totale maximale rencontrée pour un emplacement.

Double

Exemple de code

Exemple 1 d’utilisation de l’outil CollectEvents (fenêtre Python)

Le script suivant pour la fenêtre Python illustre l’utilisation de la fonction CollectEvents.

import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.stats.CollectEvents("911Copied.shp", "911Count.shp")
Exemple 2 d’utilisation de l’outil CollectEvents (script autonome)

Le script Python autonome ci-dessous illustre l’utilisation de la fonction CollectEvents.


# Analyze the spatial distribution of 911 calls in a metropolitan area
# using the Hot-Spot Analysis Tool (Local Gi*)

# Import system modules
import arcpy

# Set property to overwrite existing output, by default
arcpy.env.overwriteOutput = True

# Local variables...
workspace = "C:/Data"

try:
    # Set the current workspace (to avoid having to specify the full 
    # path to the feature classes each time)
    arcpy.env.workspace = workspace

    # Copy the input feature class and integrate the points to snap
    # together at 500 feet
    # Process: Copy Features and Integrate
    cf = arcpy.management.CopyFeatures("911Calls.shp", "911Copied.shp")

    integrate = arcpy.management.Integrate("911Copied.shp #", "500 Feet")

    # Use Collect Events to count the number of calls at each location
    # Process: Collect Events
    ce = arcpy.stats.CollectEvents("911Copied.shp", "911Count.shp")

    # Add a unique ID field to the count feature class
    # Process: Add Field and Calculate Field
    af = arcpy.management.AddField("911Count.shp", "MyID", "LONG", "#", 
                     "#", "#", "#", "NON_NULLABLE", "NON_REQUIRED", "#",
                     "911Count.shp")
    
    cf = arcpy.management.CalculateField("911Count.shp", "MyID", 
                                         "!FID!", "PYTHON")

    # Create Spatial Weights Matrix for Calculations
    # Process: Generate Spatial Weights Matrix... 
    swm = arcpy.stats.GenerateSpatialWeightsMatrix("911Count.shp", "MYID",
                        "euclidean6Neighs.swm",
                        "K_NEAREST_NEIGHBORS",
                        "#", "#", "#", 6,
                        "NO_STANDARDIZATION") 

    # Hot Spot Analysis of 911 Calls
    # Process: Hot Spot Analysis (Getis-Ord Gi*)
    hs = arcpy.stats.HotSpots("911Count.shp", "ICOUNT", "911HotSpots.shp", 
                     "GET_SPATIAL_WEIGHTS_FROM_FILE",
                     "EUCLIDEAN_DISTANCE", "NONE",
                     "#", "#", "euclidean6Neighs.swm")

except arcpy.ExecuteError:
    # If an error occurred when running the tool, print the error message.
    print(arcpy.GetMessages())

Environnements

Cas particuliers

Système de coordonnées en sortie

La géométrie de l'entité est projetée au système de coordonnées en sortie avant l'analyse. Tous les calculs mathématiques sont basés sur la référence spatiale du système de coordonnées en sortie.