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

Résumé

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.

En savoir plus sur la modélisation de relations spatiales

Illustration

Utilisation

La sortie de cet outil est un fichier de matrice de pondérations spatiales (.swm). Les outils qui nécessitent la spécification d’un type de voisinage (parfois appelé conceptualisation de relations spatiales), comme Hot Spot Analysis (Analyse des points chauds) et Bivariate Spatial Association (Lee’s L) (Association spatiale bivariée (statistique L de Lee)), permettent de définir des voisinages et des pondérations à l’aide d’un fichier de matrice de pondérations spatiales. L’utilisation d’un fichier est judicieuse si vous prévoyez d’exécuter plusieurs analyses avec les mêmes entités (comme des emplacements d’hôpitaux ou des comtés des États-Unis) ou lorsque vous partagez les résultats.
Les messages incluent un rapport du fichier de matrice de pondérations spatiales qui affiche le nombre d’entités, la connectivité, ainsi que le nombre de voisins minimum, maximum et moyen.
Pour les analyses spatiales et temporelles, sélectionnez l’option Space time window (Fenêtre spatio-temporelle) pour le paramètre Neighborhood Type (Type de voisinage). Vous définissez l’espace en spécifiant une valeur Threshold Distance (Distance seuil). Vous définissez le temps en spécifiant une valeur dans Date/Time Field (Champ de date/heure) et dans Date/Time Type (Type de date/heure) (par exemple, heures ou jours) et Date/Time Interval Value (Valeur d’intervalle de date/heure). La valeur du paramètre Date/Time Interval Value (Valeur d’intervalle de date/heure) est un entier. Par exemple, si vous entrez 1 000 pieds, sélectionnez l’option Hours (Heures) et, dans Date/Time Interval Value (Valeur d’intervalle de date/heure), indiquez 3. Les entités qui se trouvent à moins de 1 000 pieds et qui se produisent à moins de 3 heures les unes des autres sont considérées comme étant voisines.
Pour améliorer les performances, le fichier a été créé au format binaire. Les relations entre entités sont stockées sous la forme d’une matrice creuse, afin que seules les relations non nulles soient écrites dans le fichier .swm. Lorsqu’il y a un très grand nombre de relations (généralement des dizaines ou des centaines de millions de relations de voisinage), des erreurs de mémoire peuvent se produire. Dans ce cas, utilisez différentes options pour réduire le nombre de voisins par entité (comme la réduction de la distance seuil).
Les points coïncidents ne sont pas utilisés dans le calcul de la distance seuil par défaut.
Lorsque vous utilisez des données avec des coordonnées qui incluent une valeur z, les seules options prises en charge pour le paramètre Neighborhood Type (Type de voisinage) sont Inverse distance (Inverse de la distance), Fixed distance (Distance fixe), K nearest neighbors (K voisins les plus proches) et Space time window (Fenêtre spatio-temporelle).
Si les entités en entrée contiennent des valeurs z, les unités linéaires du système de coordonnées verticales (VCS) doivent correspondre aux unités linéaires du système de coordonnées horizontales. Si les entités en entrée ne possèdent aucun système de coordonnées verticales, on suppose que l’unité linéaire verticale est identique à l’unité linéaire horizontale.
Lorsque les entités en entrée ne sont pas projetées (c’est-à-dire, lorsque les coordonnées sont exprimées en degrés de latitude et de longitude) ou que le système de coordonnées en sortie est un système de coordonnées géographiques, les distances sont calculées à l’aide des distances à la corde. Les distances à la corde sont utilisées, car elles sont calculées rapidement et fournissent une très bonne estimation des distances géodésiques réelles, jusqu’à environ 30 degrés. Pour deux points sur un sphéroïde, la distance à la corde qui les sépare est la longueur d’une ligne qui traverse la Terre en trois dimensions pour relier ces deux points. Les distances à la corde sont exprimées en mètres.

Attention :

Projetez les données si la zone d’étude s’étend au-delà de 30 degrés. Les distances à la corde ne constituent pas une bonne estimation des distance géodésiques au-delà de 30 degrés.
Lorsque vous utilisez des distances à la corde dans l’analyse, la distance seuil doit être exprimée en mètres.
Pour les entités linéaires et surfaciques, les centroïdes d’entité sont utilisés dans les calculs de distance. 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.
La valeur du paramètre Unique ID Field (Champ ID unique) est associée aux relations d’entité qui découlent de l’exécution de cet outil. Par conséquent, les valeurs du champ 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 de type entier (Add Field (Ajouter un champ)) à la 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 (Calculate Field (Calculer un champ)). Les valeurs des champs FID et OBJECTID pouvant changer lorsque vous copiez ou mettez à jour une classe d’entités, il est recommandé de ne pas utiliser ces champs comme champ d’ID unique.
Le paramètre Number of Neighbors (Nombre de voisins) peut remplacer le paramètre Threshold Distance (Distance seuil) pour les voisinages de type distance fixe ou inverse de la distance. Par exemple, si vous spécifiez une distance seuil de 10 miles et 3 pour le paramètre Number of Neighbors (Nombre de voisins), toutes les entités reçoivent un minimum de 3 voisins, même si le seuil de distance doit être augmenté pour les trouver. La distance seuil est augmentée uniquement si le nombre minimal de voisins n’est pas suffisant.
L’option Convert table (Convertir la table) du paramètre Neighborhood Type (Type de voisinage) permet de convertir un fichier de matrice de pondérations spatiales ASCII en un fichier de matrice de pondérations spatiales au format SWM. En premier lieu, placez les pondérations ASCII dans une table avec mise en forme (à l’aide de Microsoft Excel, par exemple).
Pour les entités surfaciques, il est recommandé de sélectionner le paramètre Row Standardization (Standardisation par lignes). La standardisation par lignes limite les représentations incorrectes lorsque le nombre de voisins de chaque entité est une fonction de la structure d’agrégation ou du processus d’échantillonnage, au lieu de refléter la distribution spatiale réelle de la variable que vous analysez.
La rubrique d’aide Modélisation de relations spatiales fournit des informations supplémentaires sur les paramètres de cet outil.
Les outils qui peuvent utiliser un fichier de matrice de pondérations spatiales projettent les entités au système de coordonnées en sortie avant l’analyse et tous les calculs mathématiques sont basés sur le système de coordonnées en sortie. Par conséquent, si le paramètre du système de coordonnées en sortie ne correspond pas à la référence spatiale de la classe d’entités en entrée, assurez-vous que, pour toutes les analyses utilisant le fichier de matrice de pondérations spatiales, le système de coordonnées en sortie correspond aux paramètres utilisés lors de la création du fichier de matrice de pondérations spatiales ou projetez la classe d’entités en entrée afin qu’elle corresponde à la référence spatiale associée au fichier de matrice de pondérations spatiales.

Attention :

Lorsque vous utilisez des shapefiles, gardez à l’esprit qu’ils ne peuvent pas stocker de valeurs nulles. 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 des shapefiles pour plus d’informations.

Etiqueter	Explication	Type de données
Input Features (Entités en entrée)	Entités pour lesquelles les relations spatiales des entités sont créées.	Feature Class
Champ d’ID unique	Champ de nombre entier qui contient une valeur différente pour chaque entité de la classe d’entités en entrée. Si aucun champ d’ID unique n’est présent, vous pouvez en créer un en ajoutant un nouveau champ de type entier à la 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
Fichier matrice de pondérations spatiales en sortie	Chemin d’accès complet du fichier de pondérations spatiales (`.swm`).	File
Type de voisinage	Spécifie la manière dont les voisins de chaque entité est déterminée. Inverse de la distance—L’impact d’une entité sur une autre s’atténue avec la distance. Distance fixe—Tout ce qui se trouve à une distance critique spécifiée de chaque entité est inclus dans l’analyse. Tout le reste est exclu. K voisins les plus proches—Les k entités les plus proches sont incluses dans l’analyse ; k est un paramètre numérique spécifié. Tronçons de contiguïté uniquement—Les entités surfaciques qui partagent une limite sont voisines. Angles des tronçons de contiguïté—Les entités surfaciques qui partagent une limite ou un nœud sont voisines. triangulation de Delaunay—Un maillage de triangles non superposés est créé à partir de centroïdes d’entités et les entités associées aux nœuds de triangle qui partagent des limites sont voisines. Fenêtre spatio-temporelle—Les 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. Convertir la table—Les relations spatiales sont définies dans une table.	String
Méthode de calcul de distance (Facultatif)	Spécifie le mode de calcul des distances de chaque entité avec les entités voisines. Euclidien—La distance en ligne droite entre deux points (distance à vol d‘oiseau) est calculée. Il s’agit de l’option par défaut. Manhattan—La distance entre deux points mesurée le long des axes à angle droit (un bloc de bâtiments, par exemple) est calculée en totalisant la différence (absolue) entre les coordonnées x et y.	String
Exposant (Facultatif)	Valeur de calcul de l’inverse de la distance. Les valeurs standard sont 1 et 2.	Double
Distance seuil (Facultatif)	Distance limite pour les options Inverse distance (Inverse de la distance) et Fixed distance (Distance fixe) du paramètre Neighborhood Type (Type de voisinage). 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 l’option Space time window (Fenêtre spatio-temporelle). 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. Pour la conceptualisation de l’inverse de la distance des relations spatiales, la valeur zéro indique qu’aucune distance seuil n’est appliquée et que toutes les entités sont voisines les unes des autres.	Double
Nombre de voisins (Facultatif)	Nombre entier qui reflète le minimum ou le nombre exact de voisins. Lorsque le paramètre Neighborhood Type (Type de voisinage) a la valeur K nearest neighbors (K voisins les plus proches), chaque entité a exactement ce nombre de voisins. Pour les options Inverse distance (Inverse de la distance) et Fixed distance (Distance fixe), chaque entité a au moins ce nombre de voisins (la distance seuil est prolongée temporairement pour assurer ce nombre de voisins, si nécessaire). Si l’option Contiguity edges only (Tronçons de contiguïté uniquement) ou Contiguity edges corners (Angles des tronçons de contiguïté) est sélectionnée, ce nombre minimal de voisins est affecté à chaque polygone. Pour les polygones dont le nombre de voisins contigus est inférieur à celui spécifié, les voisins supplémentaires reposeront sur la proximité avec le centroïde des entités. Pour K nearest neighbors (K voisins les plus proches), la valeur par défaut est 8. Pour tous les autres types de voisinage, la valeur par défaut est 0. Cette valeur ne comprend pas les entités focales. Par conséquent, si ces dernières sont incluses, le nombre de voisins correspond à la valeur indiquée plus un.	Long
Standardisation par lignes (Facultatif)	Indique si les pondérations spatiales sont standardisées par ligne. 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é. Activé—Les pondérations spatiales sont standardisées par ligne. Chaque pondération est divisée par la somme de ses lignes. Il s’agit de l’option par défaut. Décoché—Aucune standardisation des pondérations spatiales n’est appliquée.	Boolean
Input Table (Table en entrée) (Facultatif)	Table contenant des pondérations numériques entre des paires de voisins lors de la conversion d’une table en matrice de pondérations spatiales. Les champs obligatoires pour la table sont le nom de champ d’ID unique, `NID` (ID de voisin), et `WEIGHT`.	Table
Champ de date/heure (Facultatif)	Champ de date contenant un horodatage pour chaque entité.	Field
Type d’intervalle de date/heure (Facultatif)	Indique les unités utilisées pour mesurer le temps. Secondes—L’unité est la seconde. Minutes—L’unité est la minute. Heures—L’unité est l’heure. Jours—L’unité est le jour. Semaines—L’unité est la semaine. Mois—L’unité est 30 jours. Années—L’unité est l’année.	String
Valeur d’intervalle de date/heure (Facultatif)	Nombre entier qui reflète le nombre d’unités de temps composant la fenêtre horaire. Par exemple, si vous sélectionnez Hours (Heures) pour le paramètre Date/Time Interval Type (Type d’intervalle de date/heure) et 3 pour ce paramètre, la fenêtre horaire est de 3 heures. Les entités se trouvant dans les fenêtres horaire et d’espace spécifiées sont voisines.	Long
Utiliser des valeurs Z (Facultatif)	Indique si les coordonnées z sont utilisées dans la construction de la matrice de pondérations spatiales si les entités en entrée prennent en charge les valeurs z. Activé—Des valeurs z sont utilisées dans la construction de la matrice de pondérations spatiales. Décoché—Les valeurs z ne sont pas utilisées. Elles sont ignorées et seules les coordonnées x et y sont prises en compte dans la construction de la matrice de pondérations spatiales. Il s’agit de l’option par défaut.	Boolean
Ordre de contiguïté (Facultatif)	Ordre de la contiguïté de polygones. L’ordre est le nombre d’étapes qui seraient nécessaires pour passer du polygone focal à ses voisins. La valeur par défaut est 1, ce qui signifie que seuls les voisins immédiats du polygone focal seront des voisins (ceux pouvant être atteints en une seule étape). L’ordre deux signifie que tous les polygones pouvant être atteints en deux étapes ou moins (les voisins de premier ordre et tous leurs voisins de premier ordre) seront des voisins. La valeur doit être comprise entre 1 et 10 ; toutefois, il est généralement recommandé d’utiliser des valeurs comprises entre 1 et 3.	Long
Inclure l’entité focale	Indique si chaque entité est considérée comme voisine d’elle-même. Activé—Chaque entité est considérée comme voisine d’elle-même. Décoché—Chaque entité n’est pas considérée comme voisine d’elle-même. Il s’agit de l’option par défaut.	Boolean
Méthode de pondération (Facultatif)	Indique la méthode de pondération qui est utilisée pour déterminer les pondérations spatiales des voisins autour de chaque entité focale. Non pondéré—Les voisins ne sont pas pondérés. Il s’agit de l’option par défaut. Noyau bicarré—Les voisins sont pondérés en utilisant un noyau bicarré. Noyau Gaussien—Les voisins sont pondérés en utilisant un noyau Gaussien. Noyau triangulaire—Les voisins sont pondérés en utilisant un noyau triangulaire. Noyau Epanechenikov (quadratique)—Les voisins sont pondérés en utilisant un noyau quadratique. Valeurs des champs—Les voisins sont pondérés par les valeurs d’un champ. Longueur de bordure partagée—Les voisins sont pondérés par la longueur de leur bordure partagée avec l’entité focale.	String
Type du noyau (Facultatif)	Indique si la bande passante du noyau est une distance fixe qui est partagée entre toutes les entités ou si chaque entité utilise une bande passante (adaptative) différente. Ce paramètre s’applique uniquement au type de voisinage K voisins les plus proches. Distance fixe—Chaque entité utilise la même bande passante du noyau. La valeur est fournie dans le paramètre de bande passante du noyau. Adaptatif—Chaque entité utilise une bande passante du noyau (adaptative) différente. Il s’agit de l’option par défaut.	String
Nombre de voisins pour un noyau adaptatif (Facultatif)	Pour une bande passante de noyau adaptatif, indique le nombre de voisins qui est utilisé pour déterminer le noyau adaptatif. Par exemple, avec la valeur 10, la bande passante pour chaque entité est égale à la distance par rapport à son 10e voisin. La valeur par défaut est le nombre de voisins plus un. L’utilisation d’une valeur supérieure au nombre de voisins permet de s’assurer que chaque voisin reçoit par défaut une pondération non nulle.	Long
Bande passante du noyau (Facultatif)	Distance de bande passante du noyau. Si aucune valeur n’est spécifiée, une valeur est estimée lors du traitement et incluse comme message de géotraitement.	Linear Unit
Champ de pondération (Facultatif)	Champ contenant des valeurs de pondération pour chaque entité, qui sont utilisées lors de la pondération à l’aide des valeurs d’un champ. Toutes les valeurs doivent être supérieures à zéro et la standardisation par lignes est toujours effectuée sur les valeurs de champ.	Field

arcpy.stats.GenerateSpatialWeightsMatrix(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}, {Use_Z_values}, {order}, include_focal_feature, {weighting_method}, {kernel_type}, {adaptive_neighbors}, {kernel_bandwidth}, {weight_field})

Nom	Explication	Type de données
Input_Feature_Class	Entités pour lesquelles les relations spatiales des entités sont créées.	Feature Class
Unique_ID_Field	Champ de nombre entier qui contient une valeur différente pour chaque entité de la classe d’entités en entrée. Si aucun champ d’ID unique n’est présent, vous pouvez en créer un en ajoutant un nouveau champ de type entier à la 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	Chemin d’accès complet du fichier de pondérations spatiales (`.swm`).	File
Conceptualization_of_Spatial_Relationships	Spécifie la manière dont les voisins de chaque entité est déterminée. `INVERSE_DISTANCE`—L’impact d’une entité sur une autre s’atténue avec la distance. `FIXED_DISTANCE`—Tout 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_NEIGHBORS`—Les k entités les plus proches sont incluses dans l’analyse ; k est un paramètre numérique spécifié. `CONTIGUITY_EDGES_ONLY`—Les entités surfaciques qui partagent une limite sont voisines. `CONTIGUITY_EDGES_CORNERS`—Les entités surfaciques qui partagent une limite ou un nœud sont voisines. `DELAUNAY_TRIANGULATION`—Un maillage de triangles non superposés est créé à partir de centroïdes d’entités et les entités associées aux nœuds de triangle qui partagent des limites sont voisines. `SPACE_TIME_WINDOW`—Les 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_TABLE`—Les relations spatiales sont définies dans une table.	String
Distance_Method (Facultatif)	Spécifie le mode de calcul des distances de chaque entité avec les entités voisines. `EUCLIDEAN`—La distance en ligne droite entre deux points (distance à vol d‘oiseau) est calculée. Il s’agit de l’option par défaut. `MANHATTAN`—La distance entre deux points mesurée le long des axes à angle droit (un bloc de bâtiments, par exemple) est calculée en totalisant la différence (absolue) entre les coordonnées x et y.	String
Exponent (Facultatif)	Valeur de calcul de l’inverse de la distance. Les valeurs standard sont 1 et 2.	Double
Threshold_Distance (Facultatif)	Distance de limite des options `INVERSE_DISTANCE` et `FIXED_DISTANCE` du paramètre `Conceptualization_of_Spatial_Relationships`. 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 l’option `SPACE_TIME_WINDOW`. 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. Pour la conceptualisation de l’inverse de la distance des relations spatiales, la valeur zéro indique qu’aucune distance seuil n’est appliquée et que toutes les entités sont voisines les unes des autres.	Double
Number_of_Neighbors (Facultatif)	Nombre entier qui reflète le minimum ou le nombre exact de voisins. Lorsque le paramètre `Conceptualization_of_Spatial_Relationships` a la valeur `K_NEAREST_NEIGHBORS`, chaque entité a exactement ce nombre de voisins. Pour les options `INVERSE_DISTANCE` et `FIXED_DISTANCE`, chaque entité aura au moins ce nombre de voisins (la distance seuil sera étendue temporairement pour assurer ce nombre de voisins, si cela est nécessaire). Si l’option `CONTIGUITY_EDGES_ONLY` ou `CONTIGUITY_EDGES_CORNERS` est sélectionnée, ce nombre minimal de voisins est affecté à chaque polygone. Pour les polygones dont le nombre de voisins contigus est inférieur à celui spécifié, les voisins supplémentaires reposeront sur la proximité avec le centroïde des entités. Pour `K_NEAREST_NEIGHBORS`, la valeur par défaut est 8. Pour tous les autres types de voisinage, la valeur par défaut est 0. Cette valeur ne comprend pas les entités focales. Par conséquent, si ces dernières sont incluses, le nombre de voisins correspond à la valeur indiquée plus un.	Long
Row_Standardization (Facultatif)	Indique si les pondérations spatiales sont standardisées par ligne. 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. Il s’agit de l’option par défaut. `NO_STANDARDIZATION`—Aucune standardisation des pondérations spatiales n’est appliquée.	Boolean
Input_Table (Facultatif)	Table contenant des pondérations numériques entre des paires de voisins lors de la conversion d’une table en matrice de pondérations spatiales. Les champs obligatoires pour la table sont le nom de champ d’ID unique, `NID` (ID de voisin), et `WEIGHT`.	Table
Date_Time_Field (Facultatif)	Champ de date contenant un horodatage pour chaque entité.	Field
Date_Time_Interval_Type (Facultatif)	Indique les unités utilisées pour mesurer le temps. `SECONDS`—L’unité est la seconde. `MINUTES`—L’unité est la minute. `HOURS`—L’unité est l’heure. `DAYS`—L’unité est le jour. `WEEKS`—L’unité est la semaine. `MONTHS`—L’unité est 30 jours. `YEARS`—L’unité est l’année.	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 `HOURS` pour le paramètre `Date_Time_Interval_Type` et 3 pour ce paramètre, la fenêtre horaire est de 3 heures. Les entités se trouvant dans les fenêtres horaire et d’espace spécifiées sont voisines.	Long
Use_Z_values (Facultatif)	Indique si les coordonnées z sont utilisées dans la construction de la matrice de pondérations spatiales si les entités en entrée prennent en charge les valeurs z. `USE_Z_VALUES`—Des valeurs z sont utilisées dans la construction de la matrice de pondérations spatiales. `DO_NOT_USE_Z_VALUES`—Les valeurs z ne sont pas utilisées. Elles sont ignorées et seules les coordonnées x et y sont prises en compte dans la construction de la matrice de pondérations spatiales. Il s’agit de l’option par défaut.	Boolean
order (Facultatif)	Ordre de la contiguïté de polygones. L’ordre est le nombre d’étapes qui seraient nécessaires pour passer du polygone focal à ses voisins. La valeur par défaut est 1, ce qui signifie que seuls les voisins immédiats du polygone focal seront des voisins (ceux pouvant être atteints en une seule étape). L’ordre deux signifie que tous les polygones pouvant être atteints en deux étapes ou moins (les voisins de premier ordre et tous leurs voisins de premier ordre) seront des voisins. La valeur doit être comprise entre 1 et 10 ; toutefois, il est généralement recommandé d’utiliser des valeurs comprises entre 1 et 3.	Long
include_focal_feature	Indique si chaque entité est considérée comme voisine d’elle-même. `INCLUDE_FOCAL`—Chaque entité est considérée comme voisine d’elle-même. `EXCLUDE_FOCAL`—Chaque entité n’est pas considérée comme voisine d’elle-même. Il s’agit de l’option par défaut.	Boolean
weighting_method (Facultatif)	Indique la méthode de pondération qui est utilisée pour déterminer les pondérations spatiales des voisins autour de chaque entité focale. `UNWEIGHTED`—Les voisins ne sont pas pondérés. Il s’agit de l’option par défaut. `BISQUARE`—Les voisins sont pondérés en utilisant un noyau bicarré. `GAUSSIAN`—Les voisins sont pondérés en utilisant un noyau Gaussien. `TRIANGULAR`—Les voisins sont pondérés en utilisant un noyau triangulaire. `QUADRATIC`—Les voisins sont pondérés en utilisant un noyau quadratique. `FIELD`—Les voisins sont pondérés par les valeurs d’un champ. `BORDER`—Les voisins sont pondérés par la longueur de leur bordure partagée avec l’entité focale.	String
kernel_type (Facultatif)	Indique si la bande passante du noyau est une distance fixe qui est partagée entre toutes les entités ou si chaque entité utilise une bande passante (adaptative) différente. Ce paramètre s’applique uniquement au type de voisinage K voisins les plus proches. `FIXED`—Chaque entité utilise la même bande passante du noyau. La valeur est fournie dans le paramètre de bande passante du noyau. `ADAPTIVE`—Chaque entité utilise une bande passante du noyau (adaptative) différente. Il s’agit de l’option par défaut.	String
adaptive_neighbors (Facultatif)	Pour une bande passante de noyau adaptatif, indique le nombre de voisins qui est utilisé pour déterminer le noyau adaptatif. Par exemple, avec la valeur 10, la bande passante pour chaque entité est égale à la distance par rapport à son 10e voisin. La valeur par défaut est le nombre de voisins plus un. L’utilisation d’une valeur supérieure au nombre de voisins permet de s’assurer que chaque voisin reçoit par défaut une pondération non nulle.	Long
kernel_bandwidth (Facultatif)	Distance de bande passante du noyau. Si aucune valeur n’est spécifiée, une valeur est estimée lors du traitement et incluse comme message de géotraitement.	Linear Unit
weight_field (Facultatif)	Champ contenant des valeurs de pondération pour chaque entité, qui sont utilisées lors de la pondération à l’aide des valeurs d’un champ. Toutes les valeurs doivent être supérieures à zéro et la standardisation par lignes est toujours effectuée sur les valeurs de champ.	Field

Exemple de code

GenerateSpatialWeightsMatrix Exemple 1 (fenêtre Python)

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.stats.GenerateSpatialWeightsMatrix(
    "911Count.shp", "MYID", "euclidean6Neighs.swm", "K_NEAREST_NEIGHBORS", "#",
    "#", "#", 6, "NO_STANDARDIZATION")

GenerateSpatialWeightsMatrix Exemple 2 (script autonome)

Le script Python autonome ci-dessous illustre l’utilisation de la fonction 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 property to overwrite existing output, by default.
arcpy.env.overwriteOutput = True

# Local variables...
workspace = "C:/Data"

# 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
arcpy.management.CopyFeatures(
    "911Calls.shp", "911Copied.shp")

arcpy.management.Integrate("911Copied.shp #", "500 Feet")

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

# Add a unique ID field to the count feature class.
# Process: Add Field and Calculate Field
arcpy.management.AddField(
    "911Count.shp", "MyID", "LONG", "#", "#", "#", "#", "NON_NULLABLE",
    "NON_REQUIRED", "#", "911Count.shp")

arcpy.management.CalculateField("911Count.shp", "MyID", "[FID]", "VB")

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

Environnements

Espace de travail courant, Espace de travail temporaire, Système de coordonnées en sortie, Transformations géographiques

Cas particuliers

Système de coordonnées en sortie: Feature geometry is projected to the output coordinate system prior to analysis, so values entered for the Threshold Distance parameter should match those specified in the output coordinate system. All mathematical computations are based on the spatial reference of the output coordinate system. When the output coordinate system is based on degrees, minutes, and seconds, geodesic distances are estimated using chordal distances in meters.

Informations de licence

Basic: Oui
Standard: Oui
Advanced: Oui