Générer la matrice de pondérations spatiales (Statistiques spatiales)

Niveau de licence :BasicStandardAdvanced

Récapitulatif

Génère un fichier de matrice de pondérations spatiales (SWM) pour représenter les relations spatiales entre les entités d'un jeu de données.

Pour en savoir plus sur la génération d'une matrice de pondérations spatiales

Illustration

Pondérations spatiales basées sur la contiguïté polygonale
Relations spatiales basées sur la contiguïté polygonale, cas du Queen : limites ou nœuds mitoyens.

Utilisation

Syntaxe

GenerateSpatialWeightsMatrix_stats (Input_Feature_Class, Unique_ID_Field, Output_Spatial_Weights_Matrix_File, Conceptualization_of_Spatial_Relationships, {Distance_Method}, {Exponent}, {Threshold_Distance}, {Number_of_Neighbors}, {Row_Standardization}, {Input_Table}, {Date_Time_Field}, {Date_Time_Interval_Type}, {Date_Time_Interval_Value})
ParamètreExplicationType de données
Input_Feature_Class

Classe d'entités pour laquelle les relations spatiales des entités sont évaluées.

Feature Class
Unique_ID_Field

Champ de nombre entier qui contient une valeur différente pour chaque entité dans la classe d'entités en entrée.

Field
Output_Spatial_Weights_Matrix_File

Chemin d'accès complet au fichier de matrice de pondérations spatiales (SWM) que vous voulez créer.

File
Conceptualization_of_Spatial_Relationships

Indique la façon dont les relations spatiales sont conceptualisées parmi les entités.

  • INVERSE_DISTANCEL'impact d'une entité sur une autre s'atténue avec la distance.
  • FIXED_DISTANCETout ce qui se trouve à une distance critique spécifiée de chaque entité est inclus dans l'analyse ; tout le reste est exclu.
  • K_NEAREST_NEIGHBORSLes k entités les plus proches sont incluses dans l'analyse ; k est un paramètre numérique spécifié.
  • CONTIGUITY_EDGES_ONLYLes entités surfaciques qui partagent une limite sont voisines.
  • CONTIGUITY_EDGES_CORNERSLes entités surfaciques qui partagent une limite et/ou partagent un nœud sont voisines.
  • DELAUNAY_TRIANGULATIONUn maillage de triangles non superposés est créé à partir de centroïdes d'entités ; les entités associées aux nœuds de triangle qui partagent des limites sont voisines.
  • SPACE_TIME_WINDOWLes entités qui se trouvent au sein d'une distance critique spécifiée et d'un intervalle de temps spécifié les unes par rapport aux autres sont voisines.
  • CONVERT_TABLELes relations spatiales sont définies dans une table.

Remarque : les méthodes de contiguïté polygonale sont uniquement disponibles avec une licence ArcGIS for Desktop Advanced.

String
Distance_Method
(Facultatif)

Spécifie le mode de calcul des distances de chaque entité avec les entités voisines.

  • EUCLIDEANDistance en ligne droite entre deux points (distance à vol d'oiseau).
  • MANHATTANDistance entre deux points mesurée le long des axes à angle droit (bloc de bâtiments) ; calculée en totalisant la différence (absolue) entre les coordonnées x et y.
String
Exponent
(Facultatif)

Paramètre de calcul de la distance inverse. Les valeurs standard sont 1 ou 2.

Double
Threshold_Distance
(Facultatif)

Spécifie une distance limite pour les conceptualisations Inverse Distance et Fixed Distance de relations spatiales. Saisissez cette valeur à l'aide des unités spécifiées dans le système de coordonnées en sortie de l'environnement. Définit la taille de la fenêtre d'espace pour la conceptualisation de fenêtre spatio-temporelle des relations spatiales.

Une valeur de zéro indique qu'aucune distance de seuil n'est appliquée. Si ce paramètre n'est pas défini, une valeur de seuil par défaut est calculée en fonction de l'étendue de la classe d'entités en sortie et du nombre d'entités.

Double
Number_of_Neighbors
(Facultatif)

Nombre entier qui reflète le minimum ou le nombre exact de voisins. Pour K Nearest Neighbors, chaque entité a exactement ce nombre de voisins. Pour Inverse Distance ou Fixed Distance, chaque entité a au moins ce nombre de voisins (la distance de seuil est étendue temporairement pour assurer ce nombre de voisins, si nécessaire). En présence de polygones d'îlot et si une Conceptualisation de relations spatiales de type Contiguity est sélectionnée, le nombre spécifié de polygones les plus proches est associé à ces polygones d'îlot.

Long
Row_Standardization
(Facultatif)

La standardisation par lignes est recommandée chaque fois que la distribution des entités est potentiellement influencée par la conception de l'échantillonnage ou par un schéma d'agrégation imposé.

  • ROW_STANDARDIZATIONLes pondérations spatiales sont standardisées par ligne. Chaque pondération est divisée par la somme de ses lignes.
  • NO_STANDARDIZATIONAucune standardisation de pondérations spatiales n'est appliquée.
Boolean
Input_Table
(Facultatif)

Table qui contient des pondérations numériques associant chaque entité à toutes les autres dans la classe d'entités en entrée. Les champs obligatoires sont le champ d'ID unique de la classe d'entités en entrée, NID (ID de voisin) et WEIGHT.

Table
Date_Time_Field
(Facultatif)

Champ de date possédant un horodatage pour chaque entité.

Field
Date_Time_Interval_Type
(Facultatif)

Unités utilisées pour mesurer le temps.

  • SECONDSSecondes
  • MINUTESMinutes
  • HOURSHeures
  • DAYSJours
  • WEEKSSemaine
  • MONTHSMois
  • YEARSAnnées
String
Date_Time_Interval_Value
(Facultatif)

Nombre entier qui reflète le nombre d'unités de temps composant la fenêtre horaire.

Par exemple, si vous sélectionnez les heures pour le Type d'intervalle de date/heure et 3 pour la Valeur d'intervalle de date/heure, la fenêtre horaire est de 3 heures. Les entités se trouvant dans les fenêtres d'espace et de temps spécifiées sont voisines.

Long

Exemple de code

Exemple 1 d'utilisation de l'outil GenerateSpatialWeightsMatrix (fenêtre Python)

Le script de fenêtre Python ci-dessous illustre l'utilisation de l'outil GenerateSpatialWeightsMatrix.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.GenerateSpatialWeightsMatrix_stats("911Count.shp", "MYID","euclidean6Neighs.swm","K_NEAREST_NEIGHBORS","#", "#", "#", 6,"NO_STANDARDIZATION")
Exemple 2 d'utilisation de l'outil GenerateSpatialWeightsMatrix (script autonome Python)

Le script Python autonome ci-dessous illustre l'utilisation de l'outil GenerateSpatialWeightsMatrix.

# 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 geoprocessor object property to overwrite existing output, by default
arcpy.gp.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.CopyFeatures_management("911Calls.shp", "911Copied.shp",
                         "#", 0, 0, 0)

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

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

    # Add a unique ID field to the count feature class
    # Process: Add Field and Calculate Field
    af = arcpy.AddField_management("911Count.shp", "MyID", "LONG", "#", "#", "#", "#",
                     "NON_NULLABLE", "NON_REQUIRED", "#",
                     "911Count.shp")
    
    cf = arcpy.CalculateField_management("911Count.shp", "MyID", "[FID]", "VB")

    # Create Spatial Weights Matrix for Calculations
    # Process: Generate Spatial Weights Matrix... 
    swm = arcpy.GenerateSpatialWeightsMatrix_stats("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.HotSpots_stats("911Count.shp", "ICOUNT", "911HotSpots.shp", 
                     "GET_SPATIAL_WEIGHTS_FROM_FILE",
                     "EUCLIDEAN_DISTANCE", "NONE",
                     "#", "#", "euclidean6Neighs.swm")

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, donc les valeurs entrées pour le paramètre Distance seuil 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. Lorsque le système de coordonnées en sortie est exprimé en degrés, minutes et secondes, les distances géodésiques sont estimées à l'aide de distances à la corde en mètres.

Thèmes connexes

Informations de licence

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