API · NumPy
Python numpy.argmax()
La fonction numpy.argmax() retourne les indices des valeurs les plus élevées dans le tableau NumPy donné.
Sur cette page
En Python avec NumPy, numpy.argmax() renvoie l’indice d’une valeur maximale dans un tableau, et non la valeur elle-même. Utilisez cet indice pour récupérer la valeur, ou choisissez un axis afin d’obtenir un indice pour chaque tranche. Si plusieurs valeurs partagent le maximum, la première occurrence est renvoyée.
Comment numpy.argmax() sélectionne l’indice d’un maximum
Avec sa valeur par défaut, axis=None, numpy.argmax() parcourt le tableau comme si ses éléments formaient une seule séquence aplatie. Pour une entrée multidimensionnelle, l’indice renvoyé correspond donc à une position dans cette séquence. Si vous indiquez un axe, la recherche s’effectue le long de cette dimension et renvoie des indices pour les tranches restantes.
Syntaxe et paramètres
La signature de la fonction est numpy.argmax(a, axis=None, out=None). L’argument a correspond au tableau d’entrée ou à un objet assimilable à un tableau. axis sélectionne la dimension dans laquelle effectuer la recherche ; si cet argument est omis ou vaut None, l’entrée est d’abord aplatie. Dans un tableau à deux dimensions, axis=0 parcourt chaque colonne et renvoie des indices de ligne, tandis que axis=1 parcourt chaque ligne et renvoie des indices de colonne. L’axe sélectionné est supprimé de la forme du résultat.
L’argument facultatif out est un tableau dans lequel le résultat est écrit. Sa forme doit correspondre à celle du résultat, et son type doit pouvoir représenter les indices renvoyés. La fonction renvoie l’indice ou le tableau d’indices ; utilisez ces positions pour accéder aux valeurs maximales correspondantes.
Trouver l’indice d’un maximum dans des tableaux à une ou plusieurs dimensions
Exécutez cet exemple :
Le code et les libellés ou sorties affichés dans cette section restent en anglais.
import numpy as np
a = np.array([2, 6, 1, 5])
index = np.argmax(a)
print(index)
print(a[index])
1
6
Ici, la valeur maximale est 6 et sa position est 1, car les indices NumPy commencent à zéro. Pour un tableau multidimensionnel, le comportement par défaut renvoie toujours une seule position dans le tableau aplati, et non une paire d’indices de ligne et de colonne. Pour obtenir les coordonnées dans la forme d’origine, convertissez cette position avec numpy.unravel_index.
import numpy as np
a = np.array([[2, 1, 6],
[7, 4, 5]])
index = np.argmax(a)
print(index)
print(np.unravel_index(index, a.shape))
3
(np.int64(1), np.int64(0))
La position aplatie 3 correspond à la ligne 1 et à la colonne 0, où se trouve la valeur 7.
Choisir un axe pour obtenir les indices de chaque tranche
Pour un tableau 2D de forme (2, 3), axis=0 réduit la dimension des lignes : le résultat contient un indice de ligne pour chaque colonne. axis=1 réduit la dimension des colonnes : le résultat contient un indice de colonne pour chaque ligne. Ces indices désignent des positions dans chaque tranche examinée, et non des positions dans le tableau d’origine aplati.
Le code et les libellés ou sorties affichés dans cette section restent en anglais.
import numpy as np
a = np.array([[2, 1, 6],
[7, 4, 5]])
print(np.argmax(a, axis=0))
print(np.argmax(a, axis=1))
[1 1 0]
[2 0]
Par exemple, le plus grand élément de la première colonne est 7, à l’indice de ligne 1 ; le plus grand élément de la première ligne est 6, à l’indice de colonne 2.
Gérer les égalités et utiliser l’indice renvoyé
Si le maximum apparaît plusieurs fois, numpy.argmax() renvoie la première position correspondante dans l’ordre de recherche. Lorsqu’un axe est indiqué, cette règle s’applique séparément à chaque tranche. L’exemple unidimensionnel suivant montre la position renvoyée et la valeur qui s’y trouve.
Le code et les libellés ou sorties affichés dans cette section restent en anglais.
import numpy as np
a = np.array([2, 6, 1, 6])
index = np.argmax(a)
print(index)
print(a[index])
1
6
Les deux valeurs maximales sont 6, mais l’indice 1 précède l’indice 3. Pour une recherche multidimensionnelle sans axe, « première » désigne l’ordre aplati ; avec un axe, cela désigne l’ordre dans chaque tranche.
Écrire le résultat dans out
Utilisez out pour écrire le résultat dans un tableau existant. Sa forme doit correspondre au résultat : un tableau de forme scalaire convient à un résultat scalaire, tandis qu’une recherche avec un axe nécessite un tableau ayant la forme du résultat. Choisissez un type entier capable de représenter les indices. L’appel renvoie également le même résultat que celui qu’il écrit dans out.
Le code et les libellés ou sorties affichés dans cette section restent en anglais.
import numpy as np
a = np.array([[2, 1, 6],
[7, 4, 5]])
result = np.empty((), dtype=np.intp)
np.argmax(a, out=result)
print(result)
3
Pour cette recherche par défaut, le résultat a une forme scalaire ; result est donc un tableau à zéro dimension. Si vous ajoutez un axe, créez out avec la forme du tableau d’indices obtenu.