Générer les pondérations spatiales de réseau

Disponible avec une licence Network Analyst.

Résumé

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 :

De nombreuses organisations gèrent leurs propres jeux de données de réseau de transport auxquels vous avez peut-être déjà accès. Street Map Premium for ArcGIS comprend également des jeux de données de réseau préconçus au format SDC qui couvrent l'Amérique du Nord, l'Amérique latine, l'Europe, l'Afrique Moyen-Orient/Afrique, le Japon, l'Australie et la Nouvelle-Zélande. Ces jeux de données réseau peuvent être utilisés en l'état par cet outil.

• Le champ ID unique est associé aux relations d'entité qui découlent de l'exécution de cet outil. Par conséquent, les valeurs ID unique doivent être uniques pour chaque entité et, en général, doivent se trouver dans un champ 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 de type 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 ou OBJECTID (Calculer un champ). Les valeurs des champs FID et OBJECTID pouvant changer lorsque vous copiez ou mettez à jour une classe d’entités, vous ne pouvez pas utiliser ces champs directement pour le paramètre Unique ID (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.

• Si vous utilisez des jeux de données réseau préconçus provenant de Street Map Premium for ArcGIS qui utilisent un mode de déplacement, certaines options de paramètre sont peut-être déjà renseignées et ne peuvent pas être modifiées.

• L'outil ne respecte pas le paramètre d'environnement du système de coordonnées en sortie. 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 shapefiles, 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

arcpy.stats.GenerateNetworkSpatialWeights(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}, {Travel_Mode}, {Time_of_Day})

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. Si aucun champ Unique ID (ID unique) n’est présent, il est facile d’en créer un en ajoutant un nouveau champ d’entier à votre table de classes d’entités et en calculant les valeurs du champ de sorte qu’elles soient égales à celles du champ FID ou OBJECTID.	Field
Output_Spatial_Weights_Matrix_File	Fichier matrice de pondérations spatiales du réseau en sortie (.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. Les jeux de données réseau représentent le plus souvent des réseaux de transport, mais aussi d'autres types de réseaux. Le jeu de données réseau doit présenter au moins un attribut de coût basé sur le temps et un autre basé sur la distance.	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 Impedance_Attribute. 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. Il s'agit du paramètre 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) ALLOW_DEAD_ENDS_AND_INTERSECTIONS_ONLY —Les demi-tours sont possibles uniquement au niveau des voies sans issue et des intersections	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 Input_Feature_Class 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. INVERSE —Les entités les plus éloignées ont une pondération plus faible que les entités proches. FIXED —Les entités se trouvant dans la Impendance_Cutoff sont voisines (pondération de 1) ; les entités hors de la Impendance_Cutoff ne sont pas pondérées (pondération de 0).	String
Exponent (Facultatif)	Paramètre de calcul de la INVERSE Conceptualization_of_Spatial_Relationships. Les valeurs standard sont 1 ou 2. Les pondérations chutent plus rapidement avec la distance à mesure que cette valeur 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
Travel_Mode (Facultatif)	Mode de transport pour l'analyse. Custom est toujours proposé. Pour que les autres modes de déplacement apparaissent, ils doivent être présents dans le jeu de données réseau spécifié dans le paramètre Jeu de données réseau. Un mode de déplacement est défini sur un jeu de données réseau et offre des valeurs de remplacement des paramètres qui modélisent la voiture, le camion, le piéton et d'autres modes de déplacement.	String
Time_of_Day (Facultatif)	Indique si les temps de trajet doivent prendre en compte les conditions de trafic. Les conditions de trafic, en particulier dans les zones urbanisées, peuvent avoir une grande influence sur la zone couverte dans un temps de trajet spécifié. Si aucune date ou heure n'est spécifiée, la distance couverte au cours d'un temps de trajet spécifié n'est pas influencée par le trafic.	Date

Exemple de code

Exemple 1 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 2 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 ArcGIS Network Analyst extension (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

• Basic: Requiert Network Analyst
• Standard: Requiert Network Analyst
• Advanced: Requiert Network Analyst