Résumés statistiques (Analyse)

Récapitulatif

Calcule les résumés statistiques de champs d'une table.

Utilisation

• La Table en sortie est constituée de champs contenant le résultat de l'opération statistique.

• Cet outil permet les opérations statistiques suivantes : Somme, Moyenne, Maximum, Minimum, Plage, Ecart type, Total, Premier et Dernier. L'opération Médiane n'est pas disponible.

• Un champ est créé pour chaque type statistique à l'aide de la convention d'affectation de noms suivante : SUM_CHAMP, MAX_CHAMP, MIN_CHAMP, RANGE_CHAMP, STD_CHAMP, FIRST_CHAMP, LAST_CHAMP, COUNT_CHAMP. Le nom de champ est tronqué à 10 caractères lorsque la table en sortie est une table dBASE.

• Si un Champ de récapitulation est spécifié, les statistiques sont calculées séparément pour chaque valeur attributaire unique. Si aucun Champ de récapitulation n'est spécifié, la Table en sortie contient un seul enregistrement. S'il est spécifié, un enregistrement est créé pour chaque valeur du Champ de récapitulation.

• Les valeurs nulles sont exclues de tous les calculs statistiques. Par exemple, la moyenne (fonction AVERAGE) des valeurs 10, 5 et NULL est de 7,5 ((10+5)/2). L'outil Total (fonction COUNT) retourne le nombre de valeurs comprises dans le calcul statistique, c'est-à-dire 2 dans cet exemple.

• Le bouton Ajouter un champ du paramètre Champ(s) statistique(s) est utilisé uniquement dans ModelBuilder. Dans ModelBuilder, lorsque l'outil précédent n'a pas été exécuté ou si ses données dérivées n'existent pas, le paramètre Champ(s) statistique(s) peut ne comporter aucun nom de champ. Le bouton Ajouter un champ permet d'ajouter les champs prévus pour terminer la saisie dans la boîte de dialogue Résumés statistiques et continuer la création du modèle.

• Lors de l'utilisation de couches, seules les entités actuellement sélectionnées permettent de calculer des statistiques.

Syntaxe

Statistics_analysis (in_table, out_table, statistics_fields, {case_field})

Paramètre	Explication	Type de données
in_table	Table en entrée contenant les champs utilisés pour le calcul des statistiques. L'entrée peut être une table INFO, dBASE, OLE DB, VPF ou une classe d'entités.	Table View; Raster Layer
out_table	Table de géodatabase ou dBASE en sortie devant stocker les statistiques calculées.	Table
statistics_fields [[field, statistics_type],...]	Champ numérique contenant les valeurs attributaires permettant de calculer les statistiques indiquées. Vous pouvez spécifier plusieurs combinaisons de statistiques et de champs. Les valeurs nulles sont exclues de tous les calculs statistiques. Le bouton Ajouter un champ, utilisé uniquement dans ModelBuilder, permet d'ajouter des champs prévus pour terminer la saisie dans la boîte de dialogue et continuer la création du modèle. Types de statistiques disponibles : SUM : ajoute la valeur totale du champ spécifié. MEAN : calcule la moyenne du champ spécifié. MIN - Recherche la plus petite valeur parmi tous les enregistrements du champ spécifié. MAX - Recherche la plus grande valeur parmi tous les enregistrements du champ spécifié. RANGE - Recherche la plage de valeurs (MAX moins MIN) du champ spécifié. STD - Recherche l'écart type sur les valeurs du champ spécifié. COUNT - Recherche le nombre de valeurs incluses dans les calculs statistiques. Toutes les valeurs sont prises en compte, hormis les valeurs Null. Pour déterminer le nombre de valeurs nulles dans un champ, utilisez la statistique COUNT sur le champ en question et une statistique COUNT sur un champ différent qui ne contient pas de valeurs nulles (par exemple l'identifiant OID, s'il existe), puis soustrayez les deux valeurs. FIRST : recherche le premier enregistrement de la table en entrée et utilise la valeur du champ spécifié. LAST : recherche le dernier enregistrement de la table en entrée et utilise la valeur du champ spécifié.	Value Table
case_field [case_field,...] (Facultatif)	Champs de la table en entrée utilisés pour calculer des statistiques distinctes pour chaque valeur attributaire unique (ou combinaison de valeurs attributaires lorsque plusieurs champs sont spécifiés).	Field

Exemple de code

Exemple d'utilisation de l'outil Statistiques (fenêtre Python)

Le script de fenêtre Python ci-dessous illustre l'utilisation de l'outil Statistiques en mode immédiat.

import arcpy
from arcpy import env
env.workspace = "C:/data/Habitat_Analysis.gdb"
arcpy.Statistics_analysis("futrds", "C:/output/output.gdb/stats", [["Shape_Length", "SUM"]], "NM")

Exemple d'utilisation de l'outil Statistiques 2 (script autonome)

Le script autonome ci-dessous résume la végétation par surface à moins de 150 pieds des routes principales.

# Name: Statistics_Example2.py
# Description: Summarize the vegetation by area within 150 feet of major roads
 
# Import system modules
import arcpy
from arcpy import env
 
# Set environment settings
env.workspace = "C:/data"
 
# Set local variables
inRoads = "majorrds.shp"
outBuffer = "C:/output/output.gdb/buffer_out"
bufferDistance = "250 feet"
inVegetation = "Habitat_Analysis.gdb/vegtype"
outClip = "C:/output/output.gdb/clip_out"
joinField = "HOLLAND95"
joinTable = "c:/data/vegtable.dbf"
joinedField = "HABITAT"
outStatsTable = "C:/output/output.gdb/stats_out"
statsFields = [["Shape_Area", "SUM"]]
 
# Execute Buffer to get a buffer of major roads
arcpy.Buffer_analysis(inRoads, outBuffer, bufferDistance, dissolve_option = "ALL")
 
# Execute Clip using the buffer output to get a clipped feature class
#  of vegetation
arcpy.Clip_analysis(inVegetation, outBuffer, outClip)
 
# Execute JoinField to add the vegetation type
arcpy.JoinField_management(outClip, joinField, joinTable, joinField, joinedField)
 
# Execute Statistics to get the area of each vegetation type within
#  the clipped buffer.
arcpy.Statistics_analysis(outClip, outStatsTable, statsFields, joinedField)

Environnements

Mot-clé CONFIG en sortie, Espace de travail courant, Espace de travail temporaire

Informations de licence

ArcGIS for Desktop Basic : Oui

ArcGIS for Desktop Standard : Oui

ArcGIS for Desktop Advanced : Oui