Commande HISTOGRAM
Regroupe des enregistrements en fonction des valeurs d'un champ caractère ou numérique, compte le nombre d'enregistrements dans chaque groupe et affiche les groupes et les comptes dans un graphe à barres.
Syntaxe
HISTOGRAM {<ON> champ_caractère|<ON> champ_numérique MINIMUM valeur MAXIMUM valeur {<INTERVALS nombre>|FREE valeur_intervalle <...n> dernier_intervalle}} <TO {SCREEN|nom_fichier|GRAPH|PRINT}> <IF test> <WHILE test> <FIRST plage|NEXT plage> <HEADER texte_en-tête> <FOOTER texte_pied_page> <KEY champ_fractionnement> <SUPPRESS> <COLUMNS nombre> <APPEND> <LOCAL> <OPEN>
Paramètres
| Nom | Description |
|---|---|
| ON champ_caractère |
Expression ou champ de type caractère à utiliser pour l'histogramme. |
| ON champ_numérique |
Expression ou champ numérique à utiliser pour l'histogramme. |
| MINIMUM valeur |
S'applique aux champs numériques uniquement. Valeur minimale du premier intervalle numérique. MINIMUM est facultatif si vous utilisez FREE, sinon il est obligatoire. |
| MAXIMUM valeur |
S'applique aux champs numériques uniquement. Valeur maximale du dernier intervalle numérique. MAXIMUM est facultatif si vous utilisez FREE, sinon il est obligatoire. |
| INTERVALS nombre optionnel |
S'applique aux champs numériques uniquement. Le nombre d'intervalles à taille égale générés par Analytics sur la plage spécifiée par les valeurs MINIMUM et MAXIMUM. Si vous n'indiquez pas de nombre d'intervalles, c'est la valeur par défaut qui est utilisée. La valeur par défaut est spécifiée par le nombre d'Intervalles dans l'onglet Commande de la boîte de dialogue Options. |
| FREE valeur_intervalle <...n> dernier_intervalle optionnel |
S'applique aux champs numériques uniquement. Crée des intervalles de taille personnalisée en spécifiant le point de départ de chaque intervalle et le point de fin du dernier intervalle. Si vous spécifiez les valeurs MINIMUM et MAXIMUM, ces valeurs se trouvent au point de départ du premier intervalle et au point de fin du dernier intervalle ; chaque valeur_intervalle crée un nouvel intervalle à l'intérieur de la plage. Les valeurs des intervalles que vous spécifiez doivent être supérieures à la valeur MINIMUM et inférieures ou égales à la valeur MAXIMUM. Les valeurs des intervalles doivent suivre l'ordre numérique et ne peuvent pas contenir de doublons : FREE -1000; 0; 1000; 2000; 3000 Si vous indiquez à la fois FREE et INTERVALS, INTERVALS est ignoré. |
| TO SCREEN | nom_fichier | GRAPH | PRINT |
Emplacement vers lequel envoyer les résultats de la commande :
Remarque La sortie des résultats de l'histogramme dans un fichier s'affiche en tant que représentation textuelle d'un graphe à barres. |
| 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 :
Utilisez plage pour indiquer le nombre d'enregistrements à traiter. Si vous ignorez FIRST et NEXT, tous les enregistrements sont traités par défaut. |
| HEADER texte_en-tête optionnel |
Texte à insérer en haut de chaque page d'un rapport. texte_en-tête doit être indiqué sous forme de chaîne entre guillemets. La valeur remplace la variable système Analytics HEADER. |
| FOOTER texte_pied_page optionnel |
Texte à insérer en bas de chaque page d'un rapport. texte_pied_page doit être indiqué sous forme de chaîne entre guillemets. La valeur remplace la variable système Analytics FOOTER. |
| KEY champ_fractionnement optionnel |
Champ ou expression regroupant les calculs de sous-totaux. Un sous-total est calculé chaque fois que la valeur de champ_fractionnement change. champ_fractionnement doit être un champ ou une expression de type caractère. Vous ne pouvez indiquer qu'un seul champ, mais vous pouvez utiliser une expression contenant plusieurs champs. |
| SUPPRESS optionnel |
Les valeurs supérieures à la valeur MAXIMUM et inférieures à la valeur MINIMUM sont exclues de la sortie de commande. |
| COLUMNS nombre optionnel |
Longueur de l'axe des abscisses dans la représentation textuelle du graphe à barres si vous sortez les résultats de l'histogramme dans un fichier texte. La valeur nombre correspond au nombre d'espaces caractères (colonnes de texte) à utiliser pour les étiquettes de l'axe des abscisses (et de l'axe des ordonnées). Si vous omettez COLUMNS, la valeur par défaut de 78 espaces caractères est utilisée. |
| 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 :
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. |
| LOCAL optionnel |
Enregistre le fichier de sortie au même emplacement que le projet Analytics. Remarque Applicable uniquement lorsque vous exécutez la commande sur une table de serveur avec un fichier de sortie qui est une table Analytics. |
| OPEN optionnel |
Ouvre la table créée par la commande après l'exécution de la commande. Valide uniquement lorsque la commande crée une table de sortie. |
Exemples
Histogramme de base pour le salaire horaire
Vous utilisez HISTOGRAM pour créer un graphe indiquant la distribution des salaires de 0 à 100 euros par heure :
HISTOGRAM ON Taux MINIMUM 0 MAXIMUM 100 TO GRAPH
Histogramme avec des intervalles définis pour le salaire horaire
Suite à l'exemple précédent, vous utilisez HISTOGRAM pour indiquer les plages de manière plus précise dans le graphique.
La plupart des salaires se situent entre 20 et 50 dollars par heure. Le graphique inclut le nombre d'intervalles suivant :
- trois dans la plage 20 à 50
- un pour la plage 0-20
- un pour la plage 50-100
- un pour la plage > 100
HISTOGRAM ON Taux MINIMUM 0 MAXIMUM 100 FREE 20;30;40;50;100 TO GRAPH
Remarques
Remarque
Pour plus d'informations sur le fonctionnement de cette commande, consultez le Aide d'Analytics.
Remplissage des valeurs les plus faibles et les plus élevées
Vous pouvez exécuter les commandes STATISTICS ou PROFILE sur un champ numérique avant l'exécution de la commande HISTOGRAM afin de remplir automatiquement les valeurs des paramètres MINIMUM et MAXIMUM avec la valeur la plus faible et la plus élevée dans le champ.
Commandes associées
La création d'un histogramme avec un champ caractère revient à un classement. La création d'un histogramme avec un champ numérique revient à une stratification.
À la différence des autres opérations de regroupements dans Analytics, les histogrammes ne prennent pas en charge la sous-totalisation de champs numériques.
Guide de création de scripts ACL 14.1