Analyse de grappe spatiale multi-distances (fonction K de Ripley) (Statistiques spatiales)

Niveau de licence :BasicStandardAdvanced

Récapitulatif

Détermine si les entités, ou les valeurs associées aux entités, présentent une agrégation statistiquement significative ou une dispersion sur une plage de distances.

Pour en savoir plus sur la fonction Analyse de grappe spatiale multi-distances

Illustration

Graphique de la fonction K
Mesure de la dispersion/l'agrégation spatiale sur une plage de distances.

Utilisation

Syntaxe

MultiDistanceSpatialClustering_stats (Input_Feature_Class, Output_Table, Number_of_Distance_Bands, {Compute_Confidence_Envelope}, {Display_Results_Graphically}, {Weight_Field}, {Beginning_Distance}, {Distance_Increment}, {Boundary_Correction_Method}, {Study_Area_Method}, {Study_Area_Feature_Class})
ParamètreExplicationType de données
Input_Feature_Class

La classe d'entités sur laquelle doit porter l'analyse.

Feature Layer
Output_Table

La table dans laquelle les résultats de l'analyse doivent être écrits.

Table
Number_of_Distance_Bands

Le nombre de fois qu'il convient d'incrémenter la taille du voisinage et d'effectuer une analyse d'agrégation sur le jeu de données. Le point de départ et la taille de l'incrément sont spécifiés par les paramètres Distance de départ et Incrément de distance, respectivement.

Long
Compute_Confidence_Envelope
(Facultatif)

L'enveloppe de confiance est calculée en plaçant aléatoirement des points d'entités (ou des valeurs d'entités) dans la zone d'étude. Le nombre de points/valeurs placés de manière aléatoire est égal au nombre de points trouvés dans la classe d'entités. Chaque jeu de points aléatoires est désigné sous le nom de "permutation" et l'enveloppe de confiance est créée à partir de ces permutations. Ce paramètre vous permet de spécifier le nombre de permutations à utiliser pour créer l'enveloppe de confiance.

  • 0 permutation : aucune enveloppe de confianceAucune enveloppe de confiance n'est créée.
  • 9 permutationsNeufs ensembles de points/valeurs sont placés de façon aléatoire.
  • 99 permutations99 ensembles de points/valeurs sont placés de façon aléatoire.
  • 999 permutations999 ensembles de points/valeurs sont placés de façon aléatoire.
String
Display_Results_Graphically
(Facultatif)
  • NO_DISPLAYAucun récapitulatif graphique n'est créé (par défaut).
  • DISPLAY_ITUn récapitulatif graphique est créé sous forme de couche de diagramme.
Boolean
Weight_Field
(Facultatif)

Champ numérique avec des pondérations représentant le nombre d'entités/d'événements à chaque emplacement.

Field
Beginning_Distance
(Facultatif)

La distance à laquelle doit commencer l'analyse d'agrégat et le point de départ de l'incrément. La valeur de ce paramètre doit être définie dans les mêmes unités que celles du système de coordonnées en sortie.

Double
Distance_Increment
(Facultatif)

L'incrément de distance à ajouter lors de chaque itération. La distance initialement utilisée dans l'analyse est définie par le paramètre Distance de départ et augmente conformément à la valeur du paramètre Incrément de distance. La valeur de ce paramètre doit être définie dans les mêmes unités que celles du système de coordonnées en sortie.

Double
Boundary_Correction_Method
(Facultatif)

Méthode à utiliser pour corriger les sous-estimations du nombre de voisins pour les entités proches des tronçons de la zone d'étude.

  • NONEAucune correction des tronçons n'est appliquée. Cependant, si la classe d'entités en entrée possède déjà des points qui se trouvent en dehors des limites de la zone d'étude, ceux-ci sont pris en compte dans le calcul des nombres de voisins pour les entités proches des limites.
  • SIMULER DES VALEURS A L'EXTERIEURCette méthode simule les points en dehors de la zone d'étude afin que le nombre de voisins proches des tronçons ne soit pas sous-estimé. Les points simulés sont des "répliques miroir" des points proches des tronçons au sein de la limite de la zone d'étude.
  • REDUIRE LA ZONE D'ANALYSECette méthode réduit la zone d'étude de sorte que certains points se retrouvent en dehors de la limite de la zone d'étude. Les points trouvés hors de la zone d'étude sont utilisés pour calculer les nombres de voisins, mais ils ne sont pas utilisés dans l'analyse de grappe elle-même.
  • FORMULE DE CORRECTION DES TRONCONS DE RIPLEYPour tous les points (j) voisins du point i, cette méthode détermine si le bord de la zone d'étude est plus proche de i ou si c'est j qui est plus proche de i. Si j est plus proche, un poids limite est affecté au point j. Cette méthode de correction des bords n'est appropriée que pour les zones d'étude carrées ou rectangulaires.
String
Study_Area_Method
(Facultatif)

Spécifie la région à utiliser pour définir la zone d'étude. La fonction K étant sensible aux variations de taille de la zone d'étude, il est important de sélectionner cette valeur avec soin.

  • RECTANGLE DE DELIMITATION MINIMALUtilise le plus petit rectangle possible entourant tous les points.
  • CLASSE D'ENTITES DE ZONE D'ETUDE PERSONNALISEEIndique qu'une classe d'entité définissant la zone d'étude sera fournie dans le paramètre Classe d'entités de la zone d'étude.
String
Study_Area_Feature_Class
(Facultatif)

Classe d'entités délimitant la zone sur laquelle la classe d'entités en entrée doit être analysée. A ne spécifier que si vous avez sélectionné l'option Classe d'entités de zone d'étude personnalisée pour le paramètre Méthode de la zone d'étude.

Feature Layer

Exemple de code

Exemple d'utilisation de la fonction Analyse de grappe spatiale multi-distances (fenêtre Python)

Le script de fenêtre Python ci-dessous illustre l'utilisation de l'outil Analyse de grappe spatiale multi-distances.

import arcpy
arcpy.env.workspace = r"C:\data"
arcpy.MultiDistanceSpatialClustering_stats("911Calls.shp","kFunResult.dbf", 11,
                                           "0_PERMUTATIONS_-_NO_CONFIDENCE_ENVELOPE",
                                           "NO_REPORT", "#", 1000, 200,"REDUCE_ANALYSIS_AREA",
                                           "MINIMUM_ENCLOSING_RECTANGLE", "#")
Exemple d'utilisation de la fonction Analyse de grappe spatiale multi-distances (script Python autonome)

Le script Python autonome suivant illustre l'utilisation de l'outil Analyse de grappe spatiale multi-distances.

# Use Ripley's K-Function to analyze the spatial distribution of 911
# calls in Portland Oregon 

# Import system modules
import arcpy

# Set the geoprocessor object property to overwrite existing outputs
arcpy.gp.overwriteOutput = True

# Local variables...
workspace = r"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

    # Set Distance Band Parameters: Analyze clustering of 911 calls from
    # 1000 to 3000 feet by 200 foot increments
    numDistances = 11
    startDistance = 1000.0
    increment = 200.0

    # Process: Run K-Function...
    kFun = arcpy.MultiDistanceSpatialClustering_stats("911Calls.shp",
                        "kFunResult.dbf", numDistances,
                        "0_PERMUTATIONS_-_NO_CONFIDENCE_ENVELOPE", 
                        "NO_REPORT", "#", startDistance, increment,
                        "REDUCE_ANALYSIS_AREA",
                        "MINIMUM_ENCLOSING_RECTANGLE", "#")

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

Environnements

Système de coordonnées en sortie

La géométrie de l'entité est projetée dans le système de coordonnées en sortie avant l'analyse. Par conséquent, les valeurs entrées pour les paramètres Distance de départ et Incrément de distance doivent correspondre à celles spécifiées dans le système de coordonnées en sortie. Tous les calculs mathématiques sont basés sur la référence spatiale du système de coordonnées en sortie.

Thèmes connexes

Informations de licence

ArcGIS for Desktop Basic: Oui
ArcGIS for Desktop Standard: Oui
ArcGIS for Desktop Advanced: Oui
5/10/2014