# KMeansND - fonction de graphique

KMeansND() évalue les lignes du graphique en appliquant un algorithme des k-moyennes, et, pour chaque ligne du graphique, il évalue l'id du cluster auquel ce point de données a été affecté. Les colonnes utilisées par l’algorithme sont déterminées par les paramètres coordinate\_1, coordinate\_2, etc., jusqu'à n colonnes. Ces paramètres sont tous des agrégations. Le nombre de clusters créés est déterminé par le paramètre num\_clusters.

KMeansND renvoie une valeur par point de données. La valeur renvoyée est une valeur double et est la valeur d'entier correspondant au cluster auquel chaque point de données a été affecté.

Syntaxe :

KMeansND(num\_clusters, num\_iter, coordinate\_1, coordinate\_2 [,coordinate\_3 [, ...]])

Type de données renvoyé : double

Arguments :

Arguments

| Argument | Description |
| --- | --- |
| num\_clusters | Entier qui spécifie le nombre de clusters. |
| num\_iter | Le nombre d'itérations de clustering avec des centres de cluster réinitialisés. |
| coordinate\_1 | L'agrégation calcule la première coordonnée, généralement l'axe x (d'un nuage de points qui peut être obtenu à partir du graphique). Les paramètres supplémentaires calculent les deuxième, troisième et quatrième coordonnées, etc. |

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/RelationalFunctions/KMeansND.htm)

#### Exemple : Expression de graphique

Dans cet exemple, nous créons un graphique Nuage de points à l'aide de l'ensemble de données Iris, puis nous utilisons KMeans pour colorer les données par expression.

Nous créons également une variable pour l'argument num\_clusters, puis nous utilisons une zone d'entrée de variable pour modifier le nombre de clusters.

Nous créons également une variable pour l'argument num\_iter, puis nous utilisons une deuxième zone d'entrée de variable pour modifier le nombre d'itérations.

L'ensemble de données Iris est publiquement disponible dans une variété de formats. Nous avons fourni les données sous forme de tableau intégré à charger via l'éditeur de chargement de données dans Qlik Sense. Notez que nous avons ajouté une colonne Id à la table de données pour cet exemple.

[Jeu de données Iris : chargement inline de l'éditeur de chargement de données dans Qlik Sense](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/RelationalFunctions/KMeansND.htm#IrisData)

Après avoir chargé les données dans Qlik Sense, procédez comme suit :

1. Glissez un graphique Nuage de points sur une nouvelle feuille. Nommez le graphique Pétale (expression de la couleur).
2. Créez une variable pour spécifier le nombre de clusters. Pour la variable Nom, saisissez KmeansPetalClusters. Pour la variable Définition, saisissez =2.
3. Créez une variable pour spécifier le nombre d'itérations. Pour la variable Nom, saisissez KmeansNumberIterations. Pour la variable Définition, saisissez =1.
4. Configurez Données pour le graphique :
   1. sous Dimensions, sélectionnez id pour le champ Bulle. Saisissez l'Id de cluster de l'Étiquette.

   2. Sous Mesures, sélectionnez Sum([petal.length]) pour l'expression Axe X.

   3. Sous Mesures, sélectionnez Sum([petal.width]) pour l'expression Axe Y.

      Paramètres des données pour le graphique Pétale (expression de la couleur)

      Paramètres des données pour le graphique Pétale (expression de la couleur)

      Paramètres des données pour le graphique Pétale (expression de la couleur)Pétale (expression de la couleur)![Configure Data for Petal (color by expression) chart](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Resources/Images/ui_KmeansData.png)

      Les points de données sont tracés sur le graphique.

      Points de données sur le graphique Pétale (expression de la couleur)

      Points de données sur le graphique Pétale (expression de la couleur)

      Points de données sur le graphique Pétale (expression de la couleur)Pétale (expression de la couleur)![Data points on Petal (color by expression) chart.](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Resources/Images/ui_KmeansChartDataPoints.png)
5. Configurez Aspect pour le graphique :
   1. Sous Couleurs et légende, sélectionnez Personnaliser pour Couleurs.

   2. Choisissez de colorer le graphique Par expression.

   3. Saisissez la valeur suivante pour Expression : kmeansnd($(KmeansPetalClusters),$(KmeansNumberIterations), Sum([petal.length]), Sum([petal.width]),Sum([sepal.length]), Sum([sepal.width]))

      Notez que KmeansPetalClusters est la variable définie sur 2. KmeansNumberIterations est la variable définie sur 1.

      Sinon, saisissez la valeur suivante : kmeansnd(2, 2, Sum([petal.length]), Sum([petal.width]),Sum([sepal.length]), Sum([sepal.width]))

   4. Décochez la case Expression sous forme de code couleur.

   5. Saisissez la valeur suivante pour Étiquette : Cluster Id

      Paramètres d'aspect pour le graphique Pétale (expression de la couleur)

      Paramètres d'aspect pour le graphique Pétale (expression de la couleur)

      Paramètres d'aspect pour le graphique Pétale (expression de la couleur)Pétale (expression de la couleur)![Aspect pour le graphique Pétale (expression de la couleur)](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Resources/Images/ui_KmeansAppearanceND_269x1115.png)

      Les deux clusters du graphique sont colorés par l'expression KMeans.

      Clusters colorés par expression sur le graphique Pétale (expression de la couleur)

      Clusters colorés par expression sur le graphique Pétale (expression de la couleur)

      Clusters colorés par expression sur le graphique Pétale (expression de la couleur)Pétale (expression de la couleur)![Clusters colorés par expression sur le graphique Pétale (expression de la couleur).](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Resources/Images/ui_KmeansChartColorByExpressionND.png)
6. Ajoutez une zone Entrée de variable pour le nombre de clusters.
   1. Dans le panneau des ressources, ouvrez Graphiques.

   2. Sous Objets de tableau de bord, faites glisser une zone Entrée de variable sur la feuille.

      Si nous n'avions pas accès au Dashboard bundle, nous pourrions tout de même modifier le nombre de clusters à l'aide de la variable que nous avons créée, ou directement sous forme d'entier dans l'expression.

   3. Sous Aspect, cliquez sur Général.

   4. Saisissez la valeur suivante pour Titre : Clusters.

   5. Cliquez sur Variable.

   6. Sélectionnez la variable suivante pour Nom : KmeansPetalClusters.

   7. Sélectionnez Curseur pour Afficher comme.

   8. Sélectionnez Valeurs et configurez les paramètres selon vos besoins.

      Aspect de la zone de saisie de la variable Clusters

      Aspect de la zone de saisie de la variable Clusters

      Aspect de la zone de saisie de la variable ClustersClusters ![Aspect de la zone de saisie de la variable Clusters](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Resources/Images/ui_KmeansVariableInputBox.png)
7. Ajoutez une zone Entrée de variable pour le nombre d'itérations.
   1. Glissez une zone Entrée de variable sur la feuille.
   2. Sous Aspect, sélectionnez Général.
   3. Saisissez la valeur suivante pour Titre : Itérations
   4. Sous Aspect, sélectionnez Variable.
   5. Sélectionnez la variable suivante sous Nom : KmeansNumberIterations.
   6. Configurez les paramètres supplémentaires selon les besoins.

   À présent, nous pouvons modifier le nombre de clusters et d'itérations à l'aide des curseurs des zones d'entrée de variable.

   Clusters colorés par expression sur le graphique Pétale (expression de la couleur)

   Clusters colorés par expression sur le graphique Pétale (expression de la couleur)

   Clusters colorés par expression sur le graphique Pétale (expression de la couleur)Pétale (expression de la couleur) ![Clusters colorés par expression sur le graphique Pétale (expression de la couleur).](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Resources/Images/ui_KmeansChartColorByExpressionVariableChangeND.png)

Clustering automatique

Les fonctions K-moyennes prennent en charge le clustering automatique via une méthode dite Différence de profondeur (DeD - Depth Difference). Quand un utilisateur définit 0 comme nombre de clusters, un nombre optimal de clusters est déterminé pour cet ensemble de données. Notez que même si entier n'est pas explicitement renvoyé pour le nombre de clusters (k), il est calculé dans l'algorithme K-moyennes. Par exemple, si 0 est spécifié dans la fonction pour la valeur de KmeansPetalClusters ou défini via une zone d'entrée de variable, les affectations de clusters sont automatiquement calculées pour l'ensemble de données en fonction d'un nombre optimal de clusters. Étant donné le jeu de données Iris, si 0 est sélectionné comme nombre de clusters, l'algorithme déterminera un nombre optimal de clusters (3) pour ce jeu de données (c'est ce qu'on appelle le clustering automatique).

La méthode Différence de profondeur de K-moyennes détermine le nombre optimal de clusters quand (k) est défini sur 0.

La méthode Différence de profondeur de K-moyennes détermine le nombre optimal de clusters quand (k) est défini sur 0.

La méthode Différence de profondeur de K-moyennes détermine le nombre optimal de clusters quand (k) est défini sur 0. ![La méthode Différence de profondeur de K-moyennes détermine le nombre optimal de clusters.](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Resources/Images/ui_KmeansNdDed.png)

#### Jeu de données Iris : chargement inline de l'éditeur de chargement de données dans Qlik Sense

```
IrisData:
Load * Inline [
sepal.length, sepal.width, petal.length, petal.width, variety, id
5.1, 3.5, 1.4, 0.2, Setosa, 1
4.9, 3, 1.4, 0.2, Setosa, 2
4.7, 3.2, 1.3, 0.2, Setosa, 3
4.6, 3.1, 1.5, 0.2, Setosa, 4
5, 3.6, 1.4, 0.2, Setosa, 5
5.4, 3.9, 1.7, 0.4, Setosa, 6
4.6, 3.4, 1.4, 0.3, Setosa, 7
5, 3.4, 1.5, 0.2, Setosa, 8
4.4, 2.9, 1.4, 0.2, Setosa, 9
4.9, 3.1, 1.5, 0.1, Setosa, 10
5.4, 3.7, 1.5, 0.2, Setosa, 11
4.8, 3.4, 1.6, 0.2, Setosa, 12
4.8, 3, 1.4, 0.1, Setosa, 13
4.3, 3, 1.1, 0.1, Setosa, 14
5.8, 4, 1.2, 0.2, Setosa, 15
5.7, 4.4, 1.5, 0.4, Setosa, 16
5.4, 3.9, 1.3, 0.4, Setosa, 17
5.1, 3.5, 1.4, 0.3, Setosa, 18
5.7, 3.8, 1.7, 0.3, Setosa, 19
5.1, 3.8, 1.5, 0.3, Setosa, 20
5.4, 3.4, 1.7, 0.2, Setosa, 21
5.1, 3.7, 1.5, 0.4, Setosa, 22
4.6, 3.6, 1, 0.2, Setosa, 23
5.1, 3.3, 1.7, 0.5, Setosa, 24
4.8, 3.4, 1.9, 0.2, Setosa, 25
5, 3, 1.6, 0.2, Setosa, 26
5, 3.4, 1.6, 0.4, Setosa, 27
5.2, 3.5, 1.5, 0.2, Setosa, 28
5.2, 3.4, 1.4, 0.2, Setosa, 29
4.7, 3.2, 1.6, 0.2, Setosa, 30
4.8, 3.1, 1.6, 0.2, Setosa, 31
5.4, 3.4, 1.5, 0.4, Setosa, 32
5.2, 4.1, 1.5, 0.1, Setosa, 33
5.5, 4.2, 1.4, 0.2, Setosa, 34
4.9, 3.1, 1.5, 0.1, Setosa, 35
5, 3.2, 1.2, 0.2, Setosa, 36
5.5, 3.5, 1.3, 0.2, Setosa, 37
4.9, 3.1, 1.5, 0.1, Setosa, 38
4.4, 3, 1.3, 0.2, Setosa, 39
5.1, 3.4, 1.5, 0.2, Setosa, 40
5, 3.5, 1.3, 0.3, Setosa, 41
4.5, 2.3, 1.3, 0.3, Setosa, 42
4.4, 3.2, 1.3, 0.2, Setosa, 43
5, 3.5, 1.6, 0.6, Setosa, 44
5.1, 3.8, 1.9, 0.4, Setosa, 45
4.8, 3, 1.4, 0.3, Setosa, 46
5.1, 3.8, 1.6, 0.2, Setosa, 47
4.6, 3.2, 1.4, 0.2, Setosa, 48
5.3, 3.7, 1.5, 0.2, Setosa, 49
5, 3.3, 1.4, 0.2, Setosa, 50
7, 3.2, 4.7, 1.4, Versicolor, 51
6.4, 3.2, 4.5, 1.5, Versicolor, 52
6.9, 3.1, 4.9, 1.5, Versicolor, 53
5.5, 2.3, 4, 1.3, Versicolor, 54
6.5, 2.8, 4.6, 1.5, Versicolor, 55
5.7, 2.8, 4.5, 1.3, Versicolor, 56
6.3, 3.3, 4.7, 1.6, Versicolor, 57
4.9, 2.4, 3.3, 1, Versicolor, 58
6.6, 2.9, 4.6, 1.3, Versicolor, 59
5.2, 2.7, 3.9, 1.4, Versicolor, 60
5, 2, 3.5, 1, Versicolor, 61
5.9, 3, 4.2, 1.5, Versicolor, 62
6, 2.2, 4, 1, Versicolor, 63
6.1, 2.9, 4.7, 1.4, Versicolor, 64
5.6, 2.9, 3.6, 1.3, Versicolor, 65
6.7, 3.1, 4.4, 1.4, Versicolor, 66
5.6, 3, 4.5, 1.5, Versicolor, 67
5.8, 2.7, 4.1, 1, Versicolor, 68
6.2, 2.2, 4.5, 1.5, Versicolor, 69
5.6, 2.5, 3.9, 1.1, Versicolor, 70
5.9, 3.2, 4.8, 1.8, Versicolor, 71
6.1, 2.8, 4, 1.3, Versicolor, 72
6.3, 2.5, 4.9, 1.5, Versicolor, 73
6.1, 2.8, 4.7, 1.2, Versicolor, 74
6.4, 2.9, 4.3, 1.3, Versicolor, 75
6.6, 3, 4.4, 1.4, Versicolor, 76
6.8, 2.8, 4.8, 1.4, Versicolor, 77
6.7, 3, 5, 1.7, Versicolor, 78
6, 2.9, 4.5, 1.5, Versicolor, 79
5.7, 2.6, 3.5, 1, Versicolor, 80
5.5, 2.4, 3.8, 1.1, Versicolor, 81
5.5, 2.4, 3.7, 1, Versicolor, 82
5.8, 2.7, 3.9, 1.2, Versicolor, 83
6, 2.7, 5.1, 1.6, Versicolor, 84
5.4, 3, 4.5, 1.5, Versicolor, 85
6, 3.4, 4.5, 1.6, Versicolor, 86
6.7, 3.1, 4.7, 1.5, Versicolor, 87
6.3, 2.3, 4.4, 1.3, Versicolor, 88
5.6, 3, 4.1, 1.3, Versicolor, 89
5.5, 2.5, 4, 1.3, Versicolor, 90
5.5, 2.6, 4.4, 1.2, Versicolor, 91
6.1, 3, 4.6, 1.4, Versicolor, 92
5.8, 2.6, 4, 1.2, Versicolor, 93
5, 2.3, 3.3, 1, Versicolor, 94
5.6, 2.7, 4.2, 1.3, Versicolor, 95
5.7, 3, 4.2, 1.2, Versicolor, 96
5.7, 2.9, 4.2, 1.3, Versicolor, 97
6.2, 2.9, 4.3, 1.3, Versicolor, 98
5.1, 2.5, 3, 1.1, Versicolor, 99
5.7, 2.8, 4.1, 1.3, Versicolor, 100
6.3, 3.3, 6, 2.5, Virginica, 101
5.8, 2.7, 5.1, 1.9, Virginica, 102
7.1, 3, 5.9, 2.1, Virginica, 103
6.3, 2.9, 5.6, 1.8, Virginica, 104
6.5, 3, 5.8, 2.2, Virginica, 105
7.6, 3, 6.6, 2.1, Virginica, 106
4.9, 2.5, 4.5, 1.7, Virginica, 107
7.3, 2.9, 6.3, 1.8, Virginica, 108
6.7, 2.5, 5.8, 1.8, Virginica, 109
7.2, 3.6, 6.1, 2.5, Virginica, 110
6.5, 3.2, 5.1, 2, Virginica, 111
6.4, 2.7, 5.3, 1.9, Virginica, 112
6.8, 3, 5.5, 2.1, Virginica, 113
5.7, 2.5, 5, 2, Virginica, 114
5.8, 2.8, 5.1, 2.4, Virginica, 115
6.4, 3.2, 5.3, 2.3, Virginica, 116
6.5, 3, 5.5, 1.8, Virginica, 117
7.7, 3.8, 6.7, 2.2, Virginica, 118
7.7, 2.6, 6.9, 2.3, Virginica, 119
6, 2.2, 5, 1.5, Virginica, 120
6.9, 3.2, 5.7, 2.3, Virginica, 121
5.6, 2.8, 4.9, 2, Virginica, 122
7.7, 2.8, 6.7, 2, Virginica, 123
6.3, 2.7, 4.9, 1.8, Virginica, 124
6.7, 3.3, 5.7, 2.1, Virginica, 125
7.2, 3.2, 6, 1.8, Virginica, 126
6.2, 2.8, 4.8, 1.8, Virginica, 127
6.1, 3, 4.9, 1.8, Virginica, 128
6.4, 2.8, 5.6, 2.1, Virginica, 129
7.2, 3, 5.8, 1.6, Virginica, 130
7.4, 2.8, 6.1, 1.9, Virginica, 131
7.9, 3.8, 6.4, 2, Virginica, 132
6.4, 2.8, 5.6, 2.2, Virginica, 133
6.3, 2.8, 5.1, 1.5, Virginica, 134
6.1, 2.6, 5.6, 1.4, Virginica, 135
7.7, 3, 6.1, 2.3, Virginica, 136
6.3, 3.4, 5.6, 2.4, Virginica, 137
6.4, 3.1, 5.5, 1.8, Virginica, 138
6, 3, 4.8, 1.8, Virginica, 139
6.9, 3.1, 5.4, 2.1, Virginica, 140
6.7, 3.1, 5.6, 2.4, Virginica, 141
6.9, 3.1, 5.1, 2.3, Virginica, 142
5.8, 2.7, 5.1, 1.9, Virginica, 143
6.8, 3.2, 5.9, 2.3, Virginica, 144
6.7, 3.3, 5.7, 2.5, Virginica, 145
6.7, 3, 5.2, 2.3, Virginica, 146
6.3, 2.5, 5, 1.9, Virginica, 147
6.5, 3, 5.2, 2, Virginica, 148
6.2, 3.4, 5.4, 2.3, Virginica, 149
5.9, 3, 5.1, 1.8, Virginica, 150
];
```