| Étiquette | Explication | Type de données |
Classe d’entités en entrée | Classe d'entités contenant une distribution d'entités pour lesquelles la distance standard est calculée. | Feature Layer |
Classe d’entités Distance standard en sortie | Classe d'entités surfaciques qui contiendra un polygone circulaire pour chaque centre en entrée. Ces polygones circulaires représentent graphiquement la distance standard à chaque point central. | Feature Class |
Taille du cercle | Spécifie la taille des cercles en sortie dans les écarts types.
| String |
Champ de pondération (Facultatif) | Champ numérique permettant de pondérer les emplacements en fonction de leur importance relative. | Field |
Champ de récapitulation (Facultatif) | Champ permettant de grouper des entités pour des calculs de distance standard distincts. Ce champ de récapitulation peut être de type entier, date ou chaîne. | Field |
Synthèse
Mesure le degré auquel les entités sont concentrées ou dispersées autour du centre moyen géométrique.
Pour en savoir plus sur le fonctionnement de l'outil Distance standard
Illustration
Utilisation
La distance standard est une statistique utile, puisqu'elle fournit une mesure synthétique unique de la distribution des entités autour de leur centre (de la même façon que l'écart type mesure la distribution des valeurs de données autour de la moyenne statistique).
L'outil Distance Standard permet de créer une nouvelle classe d'entités qui contient un polygone circulaire ou un multipatch sphérique centré sur la moyenne pour chaque cas. Le rayon de chaque polygone circulaire ou multipatch sphérique est égal à la distance standard. La valeur attributaire de chaque polygone circulaire ou multipatch sphérique est sa valeur de distance standard.
Cet outil respecte la nature 3D des données ponctuelles et utilise les valeurs x, y et z dans les calculs si les valeurs z sont disponibles. Comme ces résultats sont en 3D, vous devez les afficher dans une scène. Veillez à exécuter l'analyse dans une scène ou à copier la couche de résultats dans une scène pour afficher correctement les résultats de l'analyse.
Il est possible que votre résultat 3D prenne la forme d’un œuf au lieu de la sphère attendue. Les calculs, distances et volumes sont corrects, mais la distorsion est provoquée par l’exagération z lors de la visualisation du résultat. Vous pouvez ajuster le paramètre Exagération verticale dans l’onglet Altitude de la fenêtre Propriétés de la couche.
Le paramètre Case Field (Champ de récapitulation) permet de regrouper des entités avant l’analyse. Lorsque le paramètre Case Field (Champ de récapitulation) est spécifié, les entités en entrée sont groupées en premier selon les valeurs du champ de récapitulation. Un cercle de distance standard est ensuite calculé pour chaque groupe. Le champ de récapitulation peut être un entier, une date ou un type de chaîne et apparaît sous forme d’attribut dans Output Standard Distance Feature Class (Classe d’entités de distance standard en sortie). Les enregistrements avec la valeur NULL pour le champ de récapitulation sont exclus de l'analyse.
Le calcul de la distance standard peut se fonder sur le paramètre Weight Field (Champ de pondération) facultatif (pour obtenir la distance standard d’entreprises pondérées par nombre d’employés, par exemple). Le champ de pondération doit être numérique.
Lorsque le modèle spatial sous-jacent des entités est concentré vers le centre avec un nombre réduit d’entités vers la périphérie (suivant une distribution Rayleigh), une taille de cercle d’un écart type recouvre approximativement 63 pour cent des entités, une taille de cercle de deux écarts types contient approximativement 98 pour cent des entités et une taille de cercle de trois écarts types recouvre approximativement 99 pour cent des entités en deux dimensions. En trois dimensions, la règle de pourcentage est 61-99-100.
Cet outil nécessite des données projetées pour mesurer précisément les distances.
-
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.
-
Les couches peuvent permettre de définir la classe d'entités en entrée. Lorsque vous utilisez une couche avec une sélection, seules les entités sélectionnées sont comprises dans l'analyse.
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.
Paramètres
arcpy.stats.StandardDistance(Input_Feature_Class, Output_Standard_Distance_Feature_Class, Circle_Size, {Weight_Field}, {Case_Field})| Nom | Explication | Type de données |
Input_Feature_Class | Classe d'entités contenant une distribution d'entités pour lesquelles la distance standard est calculée. | Feature Layer |
Output_Standard_Distance_Feature_Class | Classe d'entités surfaciques qui contiendra un polygone circulaire pour chaque centre en entrée. Ces polygones circulaires représentent graphiquement la distance standard à chaque point central. | Feature Class |
Circle_Size | Spécifie la taille des cercles en sortie dans les écarts types.
| String |
Weight_Field (Facultatif) | Champ numérique permettant de pondérer les emplacements en fonction de leur importance relative. | Field |
Case_Field (Facultatif) | Champ permettant de grouper des entités pour des calculs de distance standard distincts. Ce champ de récapitulation peut être de type entier, date ou chaîne. | Field |
Exemple de code
Le script suivant pour la fenêtre Python illustre l’utilisation de la fonction StandardDistance.
import arcpy
arcpy.env.workspace = r"C:\data"
arcpy.stats.StandardDistance("AutoTheft.shp", "auto_theft_SD.shp", "1_STANDARD_DEVIATION")Le script Python autonome ci-dessous illustre l’utilisation de la fonction StandardDistance.
# Measure the geographic distribution of auto thefts
# Import system modules
import arcpy
# Local variables...
workspace = "C:/data"
locations = "AutoTheft.shp"
links = "AutoTheft_links.shp"
standardDistance = "auto_theft_SD.shp"
stardardEllipse = "auto_theft_SE.shp"
linearDirectMean = "auto_theft_LDM.shp"
# Set the workspace (to avoid having to type in the full path to the data every time)
arcpy.env.workspace = workspace
# Process: Standard Distance of auto theft locations...
arcpy.stats.StandardDistance(locations, standardDistance, "1_STANDARD_DEVIATION")
# Process: Directional Distribution (Standard Deviational Ellipse) of auto theft locations...
arcpy.stats.DirectionalDistribution(locations, standardEllipse, "1_STANDARD_DEVIATION")
# Process: Linear Directional Mean of auto thefts...
arcpy.stats.DirectionalMean(links, linearDirectMean, "DIRECTION")Environnements
Système de coordonnées en sortie, Transformations géographiques, Espace de travail courant, Espace de travail temporaire, Noms de champ qualifiés, Valeurs M en sortie, Résolution M, Tolérance M, Valeurs Z en sortie, Valeur Z en sortie par défaut, Résolution Z, Tolérance Z, Résolution XY, Tolérance XY, Domaine Z en sortie
Cas particuliers
- Système de coordonnées en sortie
La géométrie de l'entité est projetée au système de coordonnées en sortie avant l'analyse. Tous les calculs mathématiques sont basés sur la référence spatiale du système de coordonnées en sortie.
Vous avez un commentaire à formuler concernant cette rubrique ?