Commande STATISTICS

Information de concept

Calcule des statistiques sur un ou plusieurs champs numériques ou DateHeure dans une table Analytics.

Syntaxe

STATISTICS {<ON> nom_champ <...n>|<ON> ALL <EXCLUDE nom_champ <...n>>} <STD> <MODMEDQ> <NUMBER n> <TO {SCREEN|nom_fichier|PRINT}> <IF test> <WHILE test> <FIRST plage|NEXT plage> <APPEND>

Paramètres

Nom	Description
ON nom_champ <...n> \| ON ALL	Indiquez un ou plusieurs champs numériques ou DateHeure sur lesquels générer des statistiques, ou indiquez ON ALL pour générer des statistiques sur tous les champs numérique ou DateHeure de la table Analytics.
EXCLUDE nom_champ optionnel	Valide uniquement lors de la génération de statistiques à l'aide d'ON ALL. Le ou les champs à exclure de la commande. EXCLUDE vous permet de personnaliser ON ALL, en excluant les champs spécifiés. EXCLUDE doit suivre immédiatement ON ALL. Par exemple : ON ALL EXCLUDE champ_1 champ_2
STD optionnel	Calcule l'écart-type des champs spécifiés, en plus des autres statistiques.
MODMEDQ optionnel	Calcule le mode, la valeur médiane, les valeurs du premier quartile et du troisième quartile des champs spécifiés, en plus des autres statistiques.
NUMBER n optionnel	Nombre de valeurs faibles et élevées à conserver durant le traitement. La valeur par défaut est 5.
TO SCREEN \| nom_fichier \| PRINT optionnel	Emplacement vers lequel envoyer les résultats de la commande : SCREEN : affiche les résultats dans la zone d'affichage d'Analytics Astuce Vous pouvez cliquer sur n'importe quelle valeur de résultat liée dans la zone d'affichage pour explorer jusqu'à l'enregistrement ou aux enregistrements associés dans la table source. nom_fichier enregistre les résultats dans un fichier Indiquez nom_fichier sous forme de chaîne entre guillemets avec l'extension de fichier appropriée. Par exemple : TO "Sortie.TXT" Par défaut, le fichier est enregistré dans le dossier contenant le projet Analytics. Utilisez un chemin de fichier absolu ou relatif pour enregistrer le fichier dans un autre dossier existant : TO "C:\Sortie.TXT" TO "Résultats\Sortie.TXT" PRINT envoie les résultats vers l'imprimante par défaut
IF test optionnel	Expression conditionnelle qui doit être vraie afin de traiter chaque enregistrement. La commande est exécutée uniquement sur les enregistrements remplissant la condition. Remarque La condition IF est évaluée uniquement par rapport aux enregistrements restant dans une table après application des options relevant du champ d'application (WHILE, FIRST, NEXT).
WHILE test optionnel	Expression conditionnelle qui doit être vraie afin de traiter chaque enregistrement. La commande est exécutée jusqu'à ce que la condition soit évaluée comme fausse ou lorsque la fin de la table est atteinte. Remarque Si vous utilisez WHILE conjointement avec FIRST ou NEXT, le traitement des enregistrements s'arrête dès qu'une limite est atteinte.
FIRST plage \| NEXT plage optionnel	Le nombre d'enregistrements à traiter : FIRST pour commencer le traitement à partir du premier enregistrement jusqu'à ce que le nombre d'enregistrements spécifié soit atteint NEXT pour commencer le traitement à partir de l'enregistrement actuellement sélectionné jusqu'à ce que le nombre d'enregistrements spécifié soit atteint Utilisez plage pour indiquer le nombre d'enregistrements à traiter. Si vous ignorez FIRST et NEXT, tous les enregistrements sont traités par défaut.
APPEND optionnel	Ajoute la sortie de commande à la fin d'un fichier existant au lieu de remplacer ce fichier. Remarque Vous devez vous assurer que la structure de la sortie de la commande et du fichier existant est identique : les mêmes champs le même ordre des champs les champs correspondants ont la même longueur les champs correspondants ont le même type de données Analytics ajoute la sortie à un fichier existant sans tenir compte de sa structure, ce qui peut désordonner les données si la structure de la sortie et du fichier existant ne correspond pas.

Variables de sortie Analytics

Remarque

Si vous générez des statistiques pour plusieurs champs dans une table, les variables de sortie générées par le système contiennent des valeurs pour le premier champ répertorié uniquement.

Nom	Contient
ABSn	Valeur absolue calculée par la commande. Non calculée pour les champs DateHeure.
AVERAGEn	Valeur moyenne calculée par la commande.
COUNTn	Nombre d'enregistrements calculé par la commande. Si le nom de variable est COUNT1, elle stocke le nombre d'enregistrements de la dernière commande exécutée. Si le nom de variable est COUNTn, où n est supérieur à 1, la variable stocke le nombre d'enregistrements d'une commande exécutée dans une commande GROUP. La valeur n est attribuée en fonction du numéro de ligne de la commande dans GROUP. Par exemple, si la commande se situe une ligne sous de la commande GROUP, la valeur COUNT2 lui est attribuée. Si la commande se situe quatre lignes sous de la commande GROUP, la valeur COUNT5 lui est attribuée.
HIGHn	5e valeur la plus élevée, ou 5e date la plus récente, identifiée par la commande. La 5e valeur la plus élevée est le paramètre par défaut. Il est possible de modifier le paramètre à l'aide du paramètre NUMBER. Par exemple, NUMBER 3 indique que la 3e valeur la plus élevée est stockée. Remarque Lorsqu'Analytics identifie la valeur la plus élevée, les valeurs dupliquées ne sont pas exclues. Par exemple, si dans l'ordre décroissant les valeurs sont 100, 100, 99, 98, la 3e valeur la plus élevée est 99 et non 98.
LOWn	5e valeur la plus basse, ou 5e date la plus ancienne, identifiée par la commande. La 5e valeur la plus basse est le paramètre par défaut. Il est possible de modifier le paramètre à l'aide du paramètre NUMBER. Par exemple, NUMBER 3 indique que la 3e valeur la plus basse est stockée. Remarque Lorsqu'Analytics identifie la valeur la plus basse, les valeurs dupliquées ne sont pas exclues. Par exemple, si dans l'ordre croissant les valeurs sont 1, 1, 2, 3, la 3e valeur la plus basse est 2 et non 3.
MAXn	Valeur maximale, ou date la plus récente, identifiée par la commande.
MEDIANn	Valeur médiane identifiée par la commande. Une date médiane est affichée en tant que valeur DateHeure sérielle.
MINn	Valeur minimale, ou date la plus ancienne, identifiée par la commande.
MODEn	Valeur apparaissant le plus souvent qui a été identifiée par la commande. Une date modale est affichée en tant que valeur DateHeure sérielle.
Q25n	Valeur du premier quartile (valeur du quartile inférieur) calculée par la commande. Une date de premier quartile est affichée en tant que valeur DateHeure sérielle.
Q75n	Valeur du troisième quartile (valeur du quartile supérieur) calculée par la commande. Une date de troisième quartile est affichée en tant que valeur DateHeure sérielle.
RANGEn	Différence entre les valeurs maximale et minimale calculée par la commande.
STDDEVn	Valeur d'écart-type calculée par la commande.
TOTALn	Valeur totale calculée par la commande. La valeur n est 1, sauf si la commande TOTAL est incluse dans une commande GROUP, auquel cas la valeur n correspond au numéro de ligne de la commande TOTAL dans la commande GROUP. Pour plus d'informations, consultez la rubrique Commande GROUP. Pour les champs DateHeure, total des valeurs DateHeure sérielles dans le champ.

Exemples

Génération de statistiques conditionnelles

Vous générez des statistiques sur le champ Quantité dans des enregistrements dont l'identifiant de classe de produit est 01 :

STATISTICS ON Quantité IF ClsProd = "01"

Remarques

Toutes les statistiques sont générées pour des champs numériques. Seul un sous-ensemble des statistiques est généré pour les champs DateHeure.

Plusieurs statistiques DateHeure sont affichées en tant que valeurs DateHeure sérielles. Vous pouvez utiliser une fonction de conversion pour convertir une valeur DateHeure sérielle en valeur DateHeure ordinaire lisible par l'homme. Pour plus d'informations, consultez la rubrique DateHeures sérielles.

Nom de la statistique	Champ numérique	Champ DateHeure
Plage	Différence entre les valeurs supérieures et inférieures	Nombre de jours entre les dates les plus anciennes et les plus récentes
Positif	Nombre de valeurs positives Total de toutes les valeurs positives Valeur positive moyenne	Nombre de valeurs DateHeure Total des valeurs DateHeure sérielles Non significatif pour les dates ou les valeurs temporelles qui représentent des moments dans le temps. Significatif pour les valeurs temporelles qui représentent des quantités d'heures. Pour plus d'informations, consultez la section Une quantité d'heures par rapport à un moment dans le temps. Valeur DateHeure moyenne
Négatif	Nombre de valeurs négatives Total de toutes les valeurs négatives Valeur négative moyenne	Non applicable, non généré
Zéros	Nombre de valeurs nulles	Nombre de dates vierges
Totaux	Nombre total de valeurs positives, négatives et nulles Total de toutes les valeurs positives, négatives et nulles Moyenne de toutes les valeurs positives, négatives et nulles	Non applicable, non généré
Valeur abs.	Total de toutes les valeurs indépendamment du signe placé devant le nombre	Non applicable, non généré
Écart type (facultatif)	Écart type par rapport à la valeur moyenne	Écart type par rapport à la valeur DateHeure moyenne Non affiché lors de la sortie des statistiques à l'écran, mais capturé dans la variable de sortie générée par le système STDDEVn.
Médiane (facultatif)	La valeur médiane Jeux de valeurs impaires : la valeur du milieu Jeux de valeurs paires : la moyenne des deux valeurs du milieu	Date médiane Jeux de dates impaires : la date du milieu Jeux de dates paires : la moyenne des deux dates du milieu
Q25 (facultatif)	La valeur du premier quartile (valeur du quartile inférieur) Le résultat est une valeur interpolée calculée sur un algorithme Analytics Produit le même résultat que les fonctions QUARTILE et QUARTILE.INC dans Microsoft Excel	La date du premier quartile (valeur de la date inférieure) Le résultat est une valeur interpolée calculée sur un algorithme Analytics Décalage de 1 jour par rapport aux résultats des fonctions QUARTILE et QUARTILE.INC dans Microsoft Excel Pour plus d'informations, consultez la section DateHeures sérielles.
Q75 (facultatif)	La valeur du troisième quartile (valeur du quartile supérieur) Le résultat est une valeur interpolée calculée sur un algorithme Analytics Produit le même résultat que les fonctions QUARTILE et QUARTILE.INC dans Microsoft Excel	La date du troisième quartile (valeur de la date supérieure) Le résultat est une valeur interpolée calculée sur un algorithme Analytics Décalage de 1 jour par rapport aux résultats des fonctions QUARTILE et QUARTILE.INC dans Microsoft Excel Pour plus d'informations, consultez la section DateHeures sérielles.
Mode (facultatif)	La valeur la plus fréquente Affiche « N/A » si aucune valeur n'apparaît plusieurs fois En cas d'égalité, affiche la valeur la plus faible	La date la plus fréquente Affiche « N/A » si aucune date n'apparaît plusieurs fois En cas d'égalité, affiche la date la plus ancienne
Plus élevé	Les cinq valeurs les plus élevées Vous pouvez changer le nombre de valeurs élevées grâce au paramètre Nombre de valeurs extrêmes dans l'onglet Plus de la boîte de dialogue Statistiques.	Les cinq dernières dates Vous pouvez changer le nombre de dates récentes grâce au paramètre Nombre de valeurs extrêmes dans l'onglet Plus de la boîte de dialogue Statistiques.
Plus bas	Les cinq valeurs les plus faibles Vous pouvez changer le nombre de valeurs faibles grâce au paramètre Nombre de valeurs extrêmes dans l'onglet Plus de la boîte de dialogue Statistiques.	Les cinq dates les plus anciennes Vous pouvez changer le nombre de dates les plus anciennes grâce au paramètre Nombre de valeurs extrêmes dans l'onglet Plus de la boîte de dialogue Statistiques.