Résumé
Calcule les résumés statistiques des champs d'une classe d’entité.
Utilisation
L’outil Synthétiser les attributs est un outil d’analyse tabulaire et non un outil d’analyse spatiale. En entrée, vous pouvez utiliser une couche tabulaire ou une couche comportant une géométrie (points, lignes ou polygones).
Vous pouvez spécifier un ou plusieurs champs pour effectuer la synthèse ou synthétiser toutes les entités. Dans le premier cas de figure, les statistiques sont calculées pour chaque combinaison unique de valeurs attributaires.
La table en sortie est constituée de champs contenant le résultat de l'opération statistique.
Un champ est créé pour chaque type de statistique, selon la convention de dénomination suivante : sum_<field>, max_<field>, min_<field>, range_<field>, std_<field>, count_<field>, var_<field> et any_<field> (où <field> est le nom du champ en entrée auquel correspond le calcul statistique). Les statistiques sont calculées séparément sur chaque groupe.
Vous pouvez appliquer cet outil à des données spatiales pour obtenir un résultat tabulaire. Vous pouvez joindre vos résultats à des données spatiales à l’aide de l’outil Entités jointes.
Si le temps est activé en entrée, vous pouvez appliquer une discrétisation temporelle à votre analyse. Chaque intervalle temporel est analysé indépendamment des entités en dehors de l’intervalle temporel. Pour que vous puissiez utiliser la discrétisation temporelle, vos données en entrée doivent être temporelles et représenter un instant dans le temps. Lorsque la discrétisation temporelle est appliquée, les entités en sortie sont des intervalles temporels représentés par les champs START_DATETIME et END_DATETIME.
Les tableaux ci-dessous présentent les calculs statistiques d’une couche synthétisée à l’aide des valeurs identiques de champs. Le champ VO2 a permis de calculer les statistiques numériques (Count (Total), Sum (Somme), Minimum, Maximum, Range (Plage), Mean (Moyenne), Standard Deviation (Écart type) et Variance (Variance)) de la couche. Le champ Rating a permis de calculer les statistiques de chaîne (Count (Total) et Any (Tout)) pour la couche.
La couche en entrée à synthétiser s’affiche. La table ci-dessus a été synthétisée en fonction du champ Designation et le champ VO2 a permis de calculer les statistiques numériques (Count (Total), Sum (Somme), Minimum, Maximum, Range (Plage), Mean (Moyenne), Standard Deviation (Écart type) et Variance) pour la couche. Le champ Rating a permis de calculer les statistiques de chaîne (Count (Total) et Any (Tout)) pour la couche. Il en résulte une table comportant deux entités représentant les valeurs distinctes de Designation.
La couche en entrée synthétisée à l’aide du champ Designation s’affiche. La table suivante représente les premiers champs lorsque la couche est synthétisée à l’aide des champs Designation et Age Group. Les statistiques sont calculées à l’aide des mêmes méthodes que celles utilisées dans l’exemple précédent.
La couche en entrée synthétisée à l’aide des champs Designation et Age Group s’affiche. Vous pouvez améliorer les performances de l’outil Summarize Attributes (Synthétiser les attributs) en suivant les conseils ci-après :
- Définissez l’environnement de l’étendue de manière à analyser uniquement des données d’intérêt.
- Utilisez les données locales de l’environnement de l’analyse.
Cet outil de géotraitement est mis en œuvre par Spark. L’analyse est effectuée sur votre ordinateur de bureau en utilisant plusieurs cœurs en parallèle. Pour en savoir plus sur l’exécution de l’analyse, reportez-vous à la rubrique Remarques relatives aux outils GeoAnalytics Desktop.
Lorsque vous exécutez des outils GeoAnalytics Desktop, l’analyse est effectuée sur votre ordinateur de bureau. Pour des performances optimales, les données doivent être accessibles sur votre bureau. Si vous utilisez une couche d’entités hébergée, nous vous recommandons de faire appel à ArcGIS GeoAnalytics Server. Si vos données ne sont pas enregistrées en local, l’exécution des outils prendra plus de temps. Pour utiliser votre instance ArcGIS GeoAnalytics Server en vue d’une analyse, reportez-vous à la rubrique Outils GeoAnalytics.
Une analyse semblable peut également être réalisée à l’aide de l’outil Résumés statistiques de la boîte d’outils Analyse.
Syntaxe
arcpy.gapro.SummarizeAttributes(input_layer, out_table, fields, {summary_fields}, {time_step_interval}, {time_step_repeat}, {time_step_reference})| Paramètre | Explication | Type de données |
input_layer | Couche de points, de polylignes ou de polygones à synthétiser. | Table View |
out_table | Nouvelle table avec les attributs synthétisés. | Table |
fields [fields,...] | Champ ou champs utilisés pour synthétiser des entités similaires. Par exemple, si vous choisissez un seul champ nommé PropertyType avec les valeurs commercial et residential (résidentiel), tous les champs avec la valeur residential (résidentiel) sont synthétisés ensemble (les résumés statistiques sont calculés) et tous les champs avec la valeur commercial sont synthétisés ensemble. Cet exemple génère deux lignes dans la sortie, une pour les valeurs de synthèse commercial, et une autre pour les valeurs de synthèse residential (résidentiel). Vous pouvez également ne sélectionner aucun champ et récapituler toutes les entités dans un seul résultat de récapitulation. | Field |
summary_fields [summary_fields,...] (Facultatif) | Statistiques qui seront calculées sur les champs spécifiés.
| Value Table |
time_step_interval (Facultatif) | Valeur qui spécifie la durée de l'intervalle de temps. Ce paramètre n’est disponible que si les points en entrée sont temporels et représentent un instant dans le temps. Une discrétisation temporelle peut être appliquée uniquement si le temps est activé sur les données en entrée. | Time Unit |
time_step_repeat (Facultatif) | Valeur qui spécifie la fréquence à laquelle l'intervalle de temps intervient. Ce paramètre n’est disponible que si les points en entrée sont temporels et représentent un instant dans le temps. | Time Unit |
time_step_reference (Facultatif) | Une date qui indique l'heure de référence sur laquelle aligner les intervalles temporels. La valeur par défaut est le 1er janvier 1970 à 12 h 00. Ce paramètre n’est disponible que si les points en entrée sont temporels et représentent un instant dans le temps. | Date |
Exemple de code
Le script autonome suivant illustre l'utilisation de l'outil SummarizeAttributes.
# Name: Summarize Attributes.py
# Description: Summarize Crime Data by year and beat.
# Import system modules
import arcpy
arcpy.env.workspace = "C:/data/CityData.gdb"
# Set local variables
inFeatures = "ChicagoCrimes"
summaryFields = ["Year", "Beat"]
summaryStatistics = [["Arrest", "COUNT"], ["District", "COUNT"]]
out = 'SummarizeCrimes'
# Execute SummarizeAttributes
arcpy.gapro.SummarizeAttributes(inFeatures, out, summaryFields,
summaryStatistics)Environnements
Informations de licence
- Basic: Non
- Standard: Non
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?