Collecter des événements (Outils de statistiques spatiales)

Résumé

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 Collect Events (Collecter des événements)

Utilisation

Cet outil combine les points coïncidents. Il crée une valeur Output Feature Class (Classe d’entités en sortie) qui contient les emplacements uniques trouvés dans la valeur Input Feature Class (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 Integrate (Intégrer) pour capturer les unes aux autres les entités les plus proches avant d’exécuter cet outil.

Attention :

L’outil Integrate (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 Integrate (Intégrer).
Les outils [**Hot Spot Analysis (Getis-Ord Gi*) (Analyse des points chauds Getis-Ord Gi*])**, Cluster and Outlier Analysis (Local Moran's I) (Analyse des valeurs aberrantes et des agrégats [Local Moran’s I]) et Spatial Autocorrelation (Morans I) (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 Multipart to Singlepart (Multi-parties vers une partie). Ensuite, exécutez l’outil Collect Events (Collecter des é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 Output Weighted Point Feature Class (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.

Etiqueter	Explication	Type 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 dérivée

Etiqueter	Explication	Type 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)

Nom	Explication	Type 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 dérivée

Nom	Explication	Type 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

CollectEvents Exemple 1 (fenêtre Python)

Le script de la fenêtre Python ci-après illustre l’utilisation de la fonction CollectEvents.

import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.stats.CollectEvents("911Copied.shp", "911Count.shp")

CollectEvents Exemple 2 (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

Système de coordonnées en sortie, Transformations géographiques, Espace de travail courant, Espace de travail temporaire, Valeurs M en sortie, Résolution M, Tolérance M, Valeurs Z en sortie, Valeur Z en sortie par défaut, Résolution Z, Tolérance Z, Résolution XY, Tolérance XY

Cas particuliers

Système de coordonnées en sortie: Feature geometry is projected to the Output Coordinate System prior to analysis. All mathematical computations are based on the Output Coordinate System spatial reference.

Informations de licence

Basic: Oui
Standard: Oui
Advanced: Oui

Collecter des événements (Outils de statistiques spatiales)

Résumé

Illustration

Utilisation

Attention :

Paramètres

Sortie dérivée

Environnements

Cas particuliers

Informations de licence

Rubriques connexes