# Avg - fonction de graphique

Avg() renvoie la moyenne agrégée de l'expression ou du champ itéré(e) sur les dimensions du graphique.

Syntaxe :

Avg([{SetExpression}] [DISTINCT] [TOTAL [<fld{, fld}>]] expr)

Type de données renvoyé : numérique

Arguments :

* expr : Expression ou champ contenant les données à mesurer.

* SetExpression : Par défaut, la fonction d'agrégation couvre l'ensemble des enregistrements possibles définis par la sélection. Il est possible de définir un ensemble d'enregistrements alternatif à l'aide d'une expression d'analyse d'ensembles.

* DISTINCT : Si le terme DISTINCT précède les arguments de la fonction, les doublons résultant de l'évaluation des arguments de la fonction sont ignorés.

* TOTAL : Si le terme TOTAL précède les arguments de la fonction, le calcul est effectué à partir de toutes les valeurs possibles au vu des sélections actives, et pas seulement à partir de celles qui sont associées à la valeur dimensionnelle active. Autrement dit, les dimensions du graphique ne sont pas prises en compte. Le qualificateur TOTAL peut être suivi d'une liste d'un ou de plusieurs noms de champ placés entre crochets angulaires <fld>. Ces noms de champ doivent constituer un sous-ensemble des variables de dimension du graphique.

  [Définition de l'étendue d'une agrégation](https://help.qlik.com/fr-FR/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/ChartFunctions/define-aggregation-scope.htm)

Limitations :

Le paramètre de la fonction d'agrégation ne doit pas contenir d'autres fonctions d'agrégation, sauf si ces agrégations internes contiennent le qualificateur TOTAL. Pour des agrégations imbriquées plus avancées, utilisez la fonction avancée Aggr en combinaison avec une dimension spécifiée.

Exemples :

Exemples et résultats

| Exemple | Résultat |
| --- | --- |
| `Avg(Sales)` | Pour une table dotée de la dimension `Customer` et de la mesure `Avg([Sales])`, si les valeurs Totaux sont affichées, le résultat correspond à 2566. |
| `Avg([TOTAL (Sales))` | 53.458333 pour toutes les valeurs de la colonne `Customer`, puisque le qualificateur TOTAL entraîne la non-prise en compte des dimensions. |
| `Avg(DISTINCT (Sales))` | 51.862069 pour le total, puisque l'utilisation du qualificateur Distinct permet d'évaluer uniquement les valeurs uniques figurant sous `Sales` pour chaque `Customer`. |

Exemple de sortie sous forme de table

| Customer | Sum(Sales) | Avg(Sales) | Avg(TOTAL Sales) | Avg(DISTINCT Sales) | Avg({1}DISTINCT Sales) |
| --- | --- | --- | --- | --- | --- |
| - | 2566 | 53.46 | 53.458333 | 51.862069 | 53.458333 |
| Astrida | 587 | 48.92 | 53.458333 | 43.1 | 53.458333 |
| Betacab | 539 | 44.92 | 53.458333 | 43.909091 | 53.458333 |
| Canutility | 683 | 56.92 | 53.458333 | 55.909091 | 53.458333 |
| Divadip | 757 | 63.08 | 53.458333 | 61 | 53.458333 |

**Données utilisées dans les exemples :**

`Monthnames:` `LOAD * INLINE [` `Month, Monthnumber` `Jan, 1` `Feb, 2` `Mar, 3` `Apr, 4` `May, 5` `Jun, 6` `Jul, 7` `Aug, 8` `Sep, 9` `Oct, 10` `Nov, 11` `Dec, 12` `];` `Sales2013:
` `crosstable (Month, Sales) LOAD * inline [
` `Customer|Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec` `Astrida|46|60|70|13|78|20|45|65|78|12|78|22` `Betacab|65|56|22|79|12|56|45|24|32|78|55|15` `Canutility|77|68|34|91|24|68|57|36|44|90|67|27` `Divadip|57|36|44|90|67|27|57|68|47|90|80|94` `] (delimiter is '|');`

Pour que les mois soient triés dans l'ordre correct, au moment de la création des graphiques, accédez à l'onglet Sort des propriétés du graphique, puis cochez la case Expression sous Sort by. Dans la zone de l'expression, spécifiez `Monthnumber`.

Exemple de données sous forme de table

| Customer | Jan | Feb | Mar | Apr | May | Jun | Jul | Aug | Sep | Oct | Nov | Dec |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| Astrida | 46 | 60 | 70 | 13 | 78 | 20 | 45 | 65 | 78 | 12 | 78 | 22 |
| Betacab | 65 | 56 | 22 | 79 | 12 | 56 | 45 | 24 | 32 | 78 | 55 | 15 |
| Canutility | 77 | 68 | 34 | 91 | 24 | 68 | 57 | 36 | 44 | 90 | 67 | 27 |
| Divadip | 57 | 36 | 44 | 90 | 67 | 27 | 57 | 68 | 47 | 90 | 80 | 94 |

## En savoir plus

* [Aggr](https://help.qlik.com/fr-FR/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/ChartFunctions/aggr.htm)
* [Analyse d'ensembles et expressions d'ensemble](https://help.qlik.com/fr-FR/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/ChartFunctions/SetAnalysis/set-analysis-expressions.htm)