Générer les pondérations spatiales de réseau (Statistiques spatiales)

Récapitulatif

Crée un fichier de matrice de pondérations spatiales (.swm) à partir d'un jeu de données réseau qui définit des relations spatiales entre entités, en termes de structure de réseau sous-jacente.

Pour en savoir plus sur le fonctionnement de l'outil Générer les pondérations spatiales de réseau

Illustration

Utilisation

• La sortie de cet outil est un fichier de matrice de pondérations spatiales (.swm). Les outils qui nécessitent d'indiquer une option de Conceptualisation de relations spatiales prennent en charge les fichiers de matrice de pondérations spatiales ; sélectionnez GET_SPATIAL_WEIGHTS_FROM_FILE comme paramètre de Conceptualisation de relations spatiales et, pour le paramètre Fichier de matrice de pondérations, spécifiez le chemin d'accès complet au fichier de pondérations spatiales créé à l'aide de cet outil.

• Cet outil a été conçu pour utiliser uniquement des données ponctuelles pour la Classe d'entités en entrée.

• Une matrice de pondérations spatiales quantifie les relations spatiales qui existent parmi les entités du jeu de données. De nombreux outils de la boîte à outils Spatial Statistics évaluent chaque entité dans le contexte de ses entités voisines. Le fichier de matrice de pondérations spatiales définit ces relations de voisinage. Pour cet outil, les relations de voisinage sont basées sur le temps ou la distance entre entités, si le déplacement se limite à un réseau. Pour plus d'informations sur les pondérations spatiales et les fichiers de matrice de pondérations spatiales, reportez-vous à la rubrique Pondérations spatiales.

Astuce:

Le site ESRI Data & Maps, gratuit pour les utilisateurs d'ArcGIS, contient des données StreetMap comprenant un jeu de données réseau préconçu au format SDC. La couverture de ce jeu de données correspond aux Etats-Unis et au Canada. Ces jeux de données réseau peuvent être utilisés en l'état par cet outil.

• Le champ d'ID unique est lié aux relations d'entité dérivées de l'exécution de cet outil. Par conséquent, les valeurs d'ID unique doivent être uniques pour chaque entité et, en général, ce champ est associé de façon permanente à la classe d'entités. Si vous n'avez pas de champ d'ID unique, il est facile d'en créer un en ajoutant un nouveau champ d'entier (Ajouter un champ) à votre table de classes d'entités et en calculant les valeurs de champ de sorte qu'elles soient égales à celles du champ FID/OID (Calculer un champ). Vous ne pouvez pas utiliser directement le champ FID/OID comme paramètre d'ID unique.

• Le paramètre Nombre maximal de voisins spécifie le nombre exact des voisins qui seront associés à chaque entité. La Limite d'impédance remplace le paramètre de nombre de voisins, afin que certaines entités puissent disposer de moins de voisins si le nombre de voisins spécifié ne peut pas être trouvé dans la distance/temps impartis.

• Vous pouvez définir des relations spatiales à l'aide de la hiérarchie dans le jeu de données réseau, le cas échéant, en activant le paramètre Utiliser la hiérarchie lors de l'analyse. La hiérarchie classe les tronçons de réseau en routes principales, secondaires et locales. Lors de l'utilisation de la hiérarchie du réseau pour créer des relations spatiales parmi des entités, les routes principales sont privilégiés par rapport aux routes locales et les routes locales sont privilégiés par rapport aux routes secondaires, pour les déplacements.

• L'outil ne respecte pas système de coordonnées en sortie de l'environnement. La géométrie des entités est entièrement projetée pour correspondre à la référence spatiale associée au Jeu de données réseau avant l'analyse. Le fichier de matrice de pondérations spatiales résultant généré par l'outil reflète les relations spatiales définies à l'aide de la référence spatiale du jeu de données réseau. Lors des analyses qui associent un fichier de matrice de pondérations spatiales de réseau, il est préférable que la classe d'entités en entrée soit projetée pour correspondre au système de coordonnées du jeu de données réseau utilisé pour créer le fichier réseau .swm.

Attention :

Lorsque vous utilisez des fichiers de formes, n'oubliez pas qu'ils ne peuvent pas stocker de valeurs Null. Il se peut que des outils ou autres procédures qui créent des fichiers de formes à partir d'entrées autres que des fichiers de formes stockent ou interprètent des valeurs Null comme étant égales à zéro. Dans certains cas, les valeurs Null sont stockées sous forme de valeurs négatives très élevées dans les fichiers de formes. Cela peut aboutir à des résultats inattendus. Reportez-vous à la rubrique Remarques concernant le géotraitement pour la sortie de fichiers de formes pour plus d'informations.

Syntaxe

GenerateNetworkSpatialWeights_stats (Input_Feature_Class, Unique_ID_Field, Output_Spatial_Weights_Matrix_File, Input_Network, Impedance_Attribute, {Impedance_Cutoff}, {Maximum_Number_of_Neighbors}, {Barriers}, {U-turn_Policy}, {Restrictions}, {Use_Hierarchy_in_Analysis}, {Search_Tolerance}, {Conceptualization_of_Spatial_Relationships}, {Exponent}, {Row_Standardization})

Paramètre	Explication	Type de données
Input_Feature_Class	Classe d'entités points pour laquelle les relations spatiales de réseau seront évaluées parmi les entités.	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 de réseau (SWM).	File
Input_Network	Jeu de données réseau pour lequel les relations spatiales seront définies parmi les entités de la classe d'entités en entrée.	Network Dataset Layer
Impedance_Attribute	Type d'unités de coût à utiliser comme impédance dans l'analyse.	String
Impedance_Cutoff (Facultatif)	Spécifie une valeur limite pour les conceptualisations Inverse et Fixed de relations spatiales. Saisissez cette valeur en utilisant les unités spécifiées par le paramètre Attribut d'impédance. Une valeur de zéro indique qu'aucun seuil n'est appliqué. 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 entrée et du nombre d'entités.	Double
Maximum_Number_of_Neighbors (Facultatif)	Nombre entier qui reflète le nombre maximal de voisins à rechercher pour chaque entité.	Long
Barriers (Facultatif)	Nom d'une classe d'entités ponctuelles comportant des entités qui représentent des intersections bloquées, des fermetures de route, des sites d'accident ou d'autres localisations où l'itinéraire est bloqué le long du réseau.	Feature Layer
U-turn_Policy (Facultatif)	Spécifie les restrictions de demi-tour facultatives. ALLOW_UTURNS —Les demi-tours sont possibles partout (par défaut). NO_UTURNS —Aucun demi-tour n'est autorisé sur le parcours. ALLOW_DEAD_ENDS_ONLY —Les demi-tours sont possibles uniquement dans les voies sans issue (jonctions de type impasse, par exemple).	String
Restrictions [Restriction,...] (Facultatif)	Liste de restrictions. Activez les restrictions à respecter dans les calculs de relations spatiales.	String
Use_Hierarchy_in_Analysis (Facultatif)	Spécifie si une hiérarchie est utilisée dans l'analyse. USE_HIERARCHY —Utilise l'attribut hiérarchique du jeu d'entités réseau dans un algorithme de parcours heuristique afin d'accélérer l'analyse. NO_HIERARCHY —Utilise un algorithme de parcours exact. S'il n'existe aucun attribut de hiérarchie, cette option n'affecte pas l'analyse.	Boolean
Search_Tolerance (Facultatif)	Seuil de recherche utilisé pour localiser des entités de la classe d'entités en entrée dans le jeu de données réseau. Ce paramètre comprend une valeur de recherche et des unités de tolérance.	Linear unit
Conceptualization_of_Spatial_Relationships (Facultatif)	Indique le mode de spécification de la pondération associée à chaque relation spatiale. Pour INVERSE, les entités les plus éloignées ont une pondération plus faible que les entités proches. Pour FIXED, les entités se trouvant dans la limite d'impédance d'une entité cible sont voisines (pondération de 1) ; les entités hors de la limite d'impédance d'une entité cible ne le sont pas (pondération de 0).	String
Exponent (Facultatif)	Paramètre pour la conceptualisation INVERSE du calcul de relations spatiales. Les valeurs types sont 1 et 2. Les pondérations chutent plus rapidement avec la distance à mesure que cette valeur d'exposant augmente.	Double
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_STANDARDIZATION —Les pondérations spatiales sont standardisées par ligne. Chaque pondération est divisée par la somme de ses lignes. NO_STANDARDIZATION —Aucune standardisation de pondérations spatiales n'est appliquée.	Boolean

Exemple de code

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

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

import arcpy
arcpy.env.workspace = "c:/data"
arpcy.GenerateNetworkSpatialWeights_stats("Hospital.shp", "MyID","network6Neighs.swm", "Streets_ND","MINUTES", 10, 6, "#", "ALLOW_UTURNS","#", "USE_HIERARCHY", "#", "INVERSE", 1,"ROW_STANDARDIZATION")

Exemple d'utilisation de l'outil GenerateNetworkSpatialWeights (script autonome Python)

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

# Create a Spatial Weights Matrix based on Network Data 

# Import system modules
import arcpy

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

# Check out the Extension ArcGIS Network Analystextension (required for the Generate Network Spatial Weights tool)
arcpy.CheckOutExtension("Network")

# 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

    # Create Spatial Weights Matrix based on Network Data 
    # Process: Generate Network Spatial Weights... 
    nwm = arcpy.GenerateNetworkSpatialWeights_stats("Hospital.shp", "MyID",
                        "network6Neighs.swm", "Streets_ND",
                        "MINUTES", 10, 6, "#", "ALLOW_UTURNS",
                        "#", "USE_HIERARCHY", "#", "INVERSE",
                        1, "ROW_STANDARDIZATION")

    # Create Spatial Weights Matrix based on Euclidean Distance
    # Process: Generate Spatial Weights Matrix... 
    swm = arcpy.GenerateSpatialWeightsMatrix_stats("Hospital.shp", "MYID",
                        "euclidean6Neighs.swm",
                        "K_NEAREST_NEIGHBORS",
                        "#", "#", "#", 6) 

    # Calculate Moran's Index of Spatial Autocorrelation for 
    # average hospital visit times using Network Spatial Weights 
    # Process: Spatial Autocorrelation (Morans I)...       
    moransINet = arcpy.SpatialAutocorrelation_stats("Hospital.shp", "VisitTime",
                        "NO_REPORT", "GET_SPATIAL_WEIGHTS_FROM_FILE", 
                        "EUCLIDEAN_DISTANCE", "NONE", "#", 
                        "network6Neighs.swm")

    # Calculate Moran's Index of Spatial Autocorrelation for 
    # average hospital visit times using Euclidean Spatial Weights   
    # Process: Spatial Autocorrelation (Morans I)...       
    moransIEuc = arcpy.SpatialAutocorrelation_stats("Hospital.shp", "VisitTime",
                        "NO_REPORT", "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

Espace de travail courant, Espace de travail temporaire

Informations de licence

ArcGIS for Desktop Basic : Requis Network Analyst

ArcGIS for Desktop Standard : Requis Network Analyst

ArcGIS for Desktop Advanced : Requis Network Analyst