| Étiquette | Explication | Type de données |
Entités en entrée | Entités ponctuelles ou surfaciques qui permettent de créer les composantes spatiales. | Feature Layer |
Entités en sortie | Classe d’entités en sortie qui contient les composantes spatiales sous forme de champs. Le nombre de champs créés dépend des valeurs des paramètres Seuil relatif de l’indice de Moran et Nombre maximal de composantes. | Feature Class |
Ajouter tous les champs des entités en entrée (Facultatif) | Indique si tous les champs sont copiés depuis les entités en entrée vers la classe d’entités en sortie.
| Boolean |
Seuil relatif de l’indice de Moran (Facultatif) | Valeur du seuil pour l’inclusion d’un composant spatial. La valeur représente une proportion de la valeur la plus élevée possible de l’indice de Moran pour les pondérations spatiales. Un composant doit avoir une valeur d’indice de Moran supérieure au seuil pour être inclus. La valeur 0,25 est définie par défaut. Autrement dit, pour inclure un composant, la valeur d’indice de Moran correspondante doit être au moins égale à 25 pour cent de la valeur d’indice de Moran maximale. La valeur doit être comprise entre 0 et 1. Si vous spécifiez une valeur inférieure, vous obtiendrez davantage de composantes. | Double |
Nombre maximal de composantes spatiales (Facultatif) | Nombre maximal de composantes spatiales à créer. La valeur par défaut est égale à 15. | Long |
Type de voisinage (Facultatif) | Spécifie comment les voisins seront sélectionnés pour chaque entité en entrée. Les entités voisines doivent être identifiées de manière à décomposer la structure spatiale des entités en entrée.
| String |
Canal de distance (Facultatif) | Distance selon laquelle les entités sont incluses comme voisins. Si aucune valeur n’est fournie, une valeur est estimée pendant le traitement et incluse sous forme de message de géotraitement. Si la distance spécifiée génère plus de 1 000 voisins, seules les 1 000 entités les plus proches seront incluses en tant que voisines. | Linear Unit |
Nombre de voisins (Facultatif) | Nombre de voisins à inclure pour chaque entité. Le nombre n’inclut pas l’entité focale. La valeur par défaut est 8. | Long |
Fichier de matrice de pondérations (Facultatif) | Chemin d’accès et nom du fichier de matrice de pondérations spatiales (.swm) définissant les voisins et les pondérations entre les entités en entrée. | File |
Structure de pondération locale (Facultatif) | Spécifie la structure de pondération à appliquer aux entités voisines.
| String |
Bande passante de noyau (Facultatif) | La bande passante des structures de pondération locales bicarrées ou Gaussienne. Si aucune valeur n’est fournie, une valeur est estimée pendant le traitement et incluse sous forme de message de géotraitement. | Linear Unit |
Fichier matrice de pondérations spatiales en sortie (Facultatif) | Fichier de matrice de pondérations spatiales en sortie (.swm) des voisins et des pondérations de toutes les paires d’entités. S’il est créé, ce fichier peut être réutilisé dans les outils qui autorisent la définition de voisins et de pondérations dans les fichiers de matrice de pondérations spatiales. | File |
Champ d’ID unique (Facultatif) | Champ d’ID unique du fichier de matrice de pondérations spatiales en sortie. Le champ doit être un entier et comporter une valeur unique pour chaque entité en entrée. | Field |
Synthèse
Décompose une classe d’entités et un voisinage dans un jeu de composantes spatiales. Les composantes représentent des modèles spatiaux potentiels des entités, tels que des agrégats ou des tendances.
Les composantes sont renvoyées en tant que champs de la classe d’entités en sortie et représentent les variables des entités en entrée et le voisinage détenant la plus forte agrégation spatiale possible (autocorrélation spatiale). Les composantes sont désignées comme des vecteurs propres de Moran, et chaque composante représente un modèle spatial différent et indépendant d’un autre.
Illustration
Utilisation
Les composantes spatiales créées par l’outil représentent des modèles spatiaux potentiels pour les entités et le voisinage. Néanmoins, ces modèles peuvent ne pas correspondre aux modèles des variables d’intérêt. Cet outil est fourni pour visualiser les composantes spatiales sur les cartes et activer les procédures de sélection personnalisée pour diverses applications. D’autres outils figurant dans le jeu d’outils Utilitaires des composantes spatiales (vecteurs propres de Moran) créent également des composantes spatiales, mais les utilisent ou les sélectionnent en complément dans des processus courants, tels que la création de variables explicatives des composantes (outil Créer des variables explicatives des composantes spatiales), la suppression de l’autocorrélation spatiale à partir d’un champ (outil Filtrer l’autocorrélation spatiale à partir d’un champ) ou la suggestion d’un voisinage approprié et d’une échelle spatiale pour l’analyse (outil Comparer les conceptualisations de voisinage). Faites preuve de prudence lorsque vous appliquez une méthode de sélection personnalisée (telle qu’une sélection AIC ou l’utilisation des K premières composantes). En effet, il est courant de sélectionner par inadvertance un trop grand nombre de composantes, ce qui entraîne un sur-ajustement et introduit des biais dans les analyses suivantes. Les autres outils du jeu d’outils ont été conçus et validés pour empêcher le sur-ajustement.
Le nombre maximal de composantes spatiales créées par l’outil dépend des valeurs des paramètres Seuil relatif de l’indice de Moran et Nombre maximal de composantes. Les composantes sont classées de la plus grande valeur de l’indice de Moran à la plus petite. L’outil cesse d’inclure de nouvelles composantes dès qu’il atteint le nombre maximal ou dès que la valeur de l’indice de Moran de la composante suivante est inférieure au seuil. Le seuil est fourni sous la forme d’une proportion de la valeur de l’indice de Moran de la première composante. Si, par exemple, la première composante a une valeur d’indice de Moran égale à 0,8 alors que la valeur de seuil est égale à 0,25, la composante suivante n’est ajustée que si la valeur d’indice de Moran correspondante s’élève à au moins 0,2 (0,8 x 0,25).
Les composantes spatiales sont renvoyées en tant que champs dans la classe d’entités en sortie et lorsque l’outil est exécuté dans une carte active, la couche d’entités en sortie est dessinée en fonction de la première composante spatiale.
Les messages de géotraitement incluent une table Autocorrélation spatiale des composantes spatiales dans laquelle apparaissent la valeur de l’indice de Moran et la valeur p de chaque composante créée par l’outil.
Paramètres
arcpy.stats.DecomposeSpatialStructure(in_features, out_features, {append_all_fields}, {min_autocorrelation}, {max_components}, {neighborhood_type}, {distance_band}, {number_of_neighbors}, {weights_matrix_file}, {local_weighting_scheme}, {kernel_bandwidth}, {out_swm}, {id_field})| Nom | Explication | Type de données |
in_features | Entités ponctuelles ou surfaciques qui permettent de créer les composantes spatiales. | Feature Layer |
out_features | Classe d’entités en sortie qui contient les composantes spatiales sous forme de champs. Le nombre de champs créés dépend des valeurs des paramètres min_autocorrelation et max_components. | Feature Class |
append_all_fields (Facultatif) | Indique si tous les champs sont copiés depuis les entités en entrée vers la classe d’entités en sortie.
| Boolean |
min_autocorrelation (Facultatif) | Valeur du seuil pour l’inclusion d’un composant spatial. La valeur représente une proportion de la valeur la plus élevée possible de l’indice de Moran pour les pondérations spatiales. Un composant doit avoir une valeur d’indice de Moran supérieure au seuil pour être inclus. La valeur 0,25 est définie par défaut. Autrement dit, pour inclure un composant, la valeur d’indice de Moran correspondante doit être au moins égale à 25 pour cent de la valeur d’indice de Moran maximale. La valeur doit être comprise entre 0 et 1. Si vous spécifiez une valeur inférieure, vous obtiendrez davantage de composantes. | Double |
max_components (Facultatif) | Nombre maximal de composantes spatiales à créer. La valeur par défaut est égale à 15. | Long |
neighborhood_type (Facultatif) | Spécifie comment les voisins seront sélectionnés pour chaque entité en entrée. Les entités voisines doivent être identifiées de manière à décomposer la structure spatiale des entités en entrée.
| String |
distance_band (Facultatif) | Distance selon laquelle les entités sont incluses comme voisins. Si aucune valeur n’est fournie, une valeur est estimée pendant le traitement et incluse sous forme de message de géotraitement. Si la distance spécifiée génère plus de 1 000 voisins, seules les 1 000 entités les plus proches seront incluses en tant que voisines. | Linear Unit |
number_of_neighbors (Facultatif) | Nombre de voisins à inclure pour chaque entité. Le nombre n’inclut pas l’entité focale. La valeur par défaut est 8. | Long |
weights_matrix_file (Facultatif) | Chemin d’accès et nom du fichier de matrice de pondérations spatiales (.swm) définissant les voisins et les pondérations entre les entités en entrée. | File |
local_weighting_scheme (Facultatif) | Spécifie la structure de pondération à appliquer aux entités voisines.
| String |
kernel_bandwidth (Facultatif) | La bande passante des structures de pondération locales bicarrées ou Gaussienne. Si aucune valeur n’est fournie, une valeur est estimée pendant le traitement et incluse sous forme de message de géotraitement. | Linear Unit |
out_swm (Facultatif) | Fichier de matrice de pondérations spatiales en sortie (.swm) des voisins et des pondérations de toutes les paires d’entités. S’il est créé, ce fichier peut être réutilisé dans les outils qui autorisent la définition de voisins et de pondérations dans les fichiers de matrice de pondérations spatiales. | File |
id_field (Facultatif) | Champ d’ID unique du fichier de matrice de pondérations spatiales en sortie. Le champ doit être un entier et comporter une valeur unique pour chaque entité en entrée. | Field |
Exemple de code
Le script de fenêtre Python ci-dessous illustre l’utilisation de la fonction DecomposeSpatialStructure :
# Extract patterns in the spatial arrangement of the input features.
arcpy.env.workspace = r"c:\data\project_data.gdb"
arcpy.stats.DecomposeSpatialStructure(
in_features="myFeatureClass",
out_features=r"myOutputFeatureClass",
append_all_fields="ALL",
min_autocorrelation=0.25,
max_components=15,
neighborhood_type="CONTIGUITY_EDGES_CORNERS",
distance_band=None,
number_of_neighbors=None,
weights_matrix_file=None,
local_weighting_scheme="",
kernel_bandwidth=None,
out_swm=None,
id_field=None
)Le script autonome ci-dessous illustre l’utilisation de la fonction DecomposeSpatialStructure :
# Extract patterns in the spatial arrangement of the input features.
import arcpy
# Set the current workspace
arcpy.env.workspace = r"c:\data\project_data.gdb"
# Run the tool
arcpy.stats.DecomposeSpatialStructure(
in_features="myFeatureClass",
out_features=r"myOutputFeatureClass",
append_all_fields="ALL",
min_autocorrelation=0.25,
max_components=15,
neighborhood_type="CONTIGUITY_EDGES_CORNERS",
distance_band=None,
number_of_neighbors=None,
weights_matrix_file=None,
local_weighting_scheme="",
kernel_bandwidth=None,
out_swm=None,
id_field=None
)
# Print the messages.
print(arcpy.GetMessages())Environnements
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui
Rubriques connexes
- Vue d’ensemble du jeu d’outils Utilitaires des composantes spatiales (vecteurs propres de Moran)
- Comprendre les vecteurs propres de Moran
- Comparer les conceptualisations de voisinage
- Create Spatial Component Explanatory Variables (Créer des variables explicatives de composant spatial)
- Filtrer l’autocorrélation spatiale à partir d’un champ
- Rechercher un outil de géotraitement
Vous avez un commentaire à formuler concernant cette rubrique ?