1. Description de la méthode numpy.unique()
La méthode numpy.unique() est une fonction de la bibliothèque NumPy en Python, utilisée pour extraire les éléments uniques d'un tableau (array) NumPy. Elle renvoie un tableau contenant les éléments distincts du tableau d'entrée, dans l'ordre où ils apparaissent pour la première fois.
2. Syntaxe et paramètres principaux de la méthode numpy.unique()
La méthode numpy.unique() en Python a la syntaxe suivante :
Syntaxe sans paramètres:
|
1 |
numpy.unique(arr) |
arr : Le tableau (array) d'entrée dont on souhaite extraire les éléments.
Syntaxe avec paramètres:
|
1 |
numpy.unique(ar, return_index=False, return_inverse=False, return_counts=False, axis=None) |
Paramètres :
- ar : Le tableau (array) d'entrée dont on souhaite extraire les éléments uniques.
- return_index (bool, facultatif) : Si défini à True, la fonction renvoie également les indices des premières occurrences des éléments uniques dans le tableau d'origine.
- return_inverse (bool, facultatif) : Si défini à True, la fonction renvoie un tableau représentant l'indice inverse, c'est-à-dire un tableau qui peut être utilisé pour reconstruire l'entrée à partir des éléments uniques.
- return_counts (bool, facultatif) : Si défini à True, la fonction renvoie également le nombre de fois que chaque élément unique apparaît dans le tableau d'entrée.
- axis (int, facultatif) : L'axe le long duquel les éléments uniques doivent être trouvés. Par défaut, la recherche est effectuée sur l'ensemble du tableau.
Valeur de retour :
- La méthode numpy.unique() : renvoie différents résultats en fonction des paramètres facultatifs spécifiés :
- Si aucun paramètre facultatif n'est spécifié: elle renvoie un tableau contenant les éléments uniques.
- Si return_index est défini à True : elle renvoie un tuple avec le tableau des éléments uniques et un tableau des indices des premières occurrences.
- Si return_inverse est défini à True : elle renvoie un tuple avec le tableau des éléments uniques et un tableau représentant l'indice inverse.
- Si return_counts est défini à True : elle renvoie un tuple avec le tableau des éléments uniques et un tableau contenant le nombre d'occurrences de chaque élément unique.
3. Exemples d'usages de la méthode numpy.unique()
Exemple 1 (numpy.unique sans paramètres)
|
1 2 3 4 5 6 7 8 9 10 11 |
import numpy as np arr = np.array([2, 1, 3, 3, 2, 4, 5, 5, 5, 3, 7]) unique_elements = np.unique(arr) print("Éléments uniques :", unique_elements) """ output: Éléments uniques : [1 2 3 4 5] """ |
Exemple 2 (numpy.unique() éléments uniques avec leurs occurrences (effectifs))
|
1 2 3 4 5 6 7 8 9 10 11 12 |
import numpy as np arr = np.array([2, 1, 3, 3, 2, 4, 5, 5, 5, 3]) unique_elements, counts = np.unique(arr, return_counts=True) print("Éléments uniques :", unique_elements) print("Nombre d'occurrences de chaque élément unique :", counts) """ output: Éléments uniques : [1 2 3 4 5] Nombre d'occurrences de chaque élément unique : [1 2 3 1 3] """ |
Exemple 3
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 |
import numpy as np arr = np.array([2, 1, 3, 3, 2, 4, 5, 5, 5, 3]) unique_elements, indices, inverse_indices, counts = np.unique(arr, return_index=True, return_inverse=True, return_counts=True) print("Éléments uniques :", unique_elements) print("Indices des premières occurrences :", indices) print("Indice inverse :", inverse_indices) print("Nombre d'occurrences de chaque élément unique :", counts) """ output: Éléments uniques : [1 2 3 4 5] Indices des premières occurrences : [1 0 2 5 6] Indice inverse : [1 0 2 2 1 3 4 4 4 2] Nombre d'occurrences de chaque élément unique : [1 2 3 1 3] """ |
Younes Derfoufi
CRMEF OUJDA
1 thought on “La méthode numpy.unique() Python”