HOWTO · NumPy
Créer un tableau NumPy vide
Apprenez à créer des tableaux NumPy vides en Python avec numpy.zeros() et numpy.empty(). Ce guide fournit des exemples clairs et des explications détaillées pour chaque méthode, afin de vous aider à initialiser efficacement des tableaux pour vos tâches de manipulation de données. Que vous soyez débutant ou programmeur expérimenté, vous y trouverez des informations précieuses pour améliorer vos compétences en programmation.
Sur cette page
Utilisez numpy.zeros() si chaque élément doit commencer à 0. Utilisez numpy.empty() si vous attribuerez une valeur à chaque élément avant de le lire. Malgré son nom, numpy.empty() crée bien le nombre d’éléments demandé ; elle ne définit simplement pas leurs valeurs initiales. L’argument shape décrit les dimensions du tableau : un entier seul, comme 5, crée un tableau à une dimension, tandis qu’un tuple comme (3, 4) crée trois lignes et quatre colonnes.
Créer un tableau rempli de zéros avec numpy.zeros()
numpy.zeros() alloue un tableau et initialise tous ses éléments à 0. Passez un entier pour créer un tableau à une dimension, ou un tuple pour en spécifier plusieurs. Par défaut, NumPy utilise un type de données à virgule flottante ; les valeurs affichées peuvent donc comporter des décimales. Passez dtype=int si vous préférez des éléments entiers. Choisissez cette fonction lorsqu’une valeur initiale connue est utile, par exemple si des calculs ultérieurs ne modifient que certaines positions et que les autres doivent rester à 0.
Cet exemple crée un tableau à une dimension ainsi qu’un tableau d’entiers à deux dimensions, puis modifie une position. Il affiche les valeurs et le tuple renvoyé par l’attribut shape du tableau.
Exécutez cet exemple :
import numpy as np
values = np.zeros(5)
matrix = np.zeros((3, 4), dtype=int)
values[2] = 7
print(values)
print(matrix.shape)
[0. 0. 7. 0. 0.]
(3, 4)
Comme numpy.zeros() initialise chaque position, cette fonction convient aussi lorsque vous prévoyez de remplir le tableau progressivement. Le type de données initial a son importance : un tableau d’entiers stocke des valeurs entières, tandis qu’un tableau à virgule flottante peut représenter des fractions. Le paramètre shape indique toujours les dimensions ; il ne désigne pas nécessairement des « lignes et colonnes ». Une forme à un seul élément, comme 5, correspond à une dimension, et (3, 4) en correspond à deux.
Créer un tableau non initialisé avec numpy.empty()
Pour les types de données numériques courants, numpy.empty() crée un tableau de la forme demandée sans initialiser ses éléments ; leurs valeurs initiales ne sont donc pas spécifiées. Le type objet constitue un cas différent : par exemple, np.empty(2, dtype=object) initialise les deux éléments à None. Attribuez une valeur valide à chaque élément avant de le lire et ne vous fiez pas au contenu initial des tableaux numériques.
Utilisez cette fonction si votre programme peut remplir immédiatement tous les éléments et si éviter l’étape d’initialisation est utile pour sa charge de travail. Le gain de temps éventuel dépend de la taille du tableau, des affectations qui suivent, du matériel et des opérations environnantes ; il n’existe pas d’avantage universel en matière de vitesse. Si vous avez besoin de valeurs initiales fiables ou ne modifiez que certaines positions, utilisez plutôt numpy.zeros().
L’exemple suivant attribue une valeur à chaque position avant de lire le tableau. Vous pouvez modifier les dimensions ou le type de données tout en respectant la même règle : affectez une valeur à tous les éléments avant de les utiliser.
import numpy as np
values = np.empty((2, 3), dtype=int)
values[:] = [[1, 2, 3], [4, 5, 6]]
print(values)
[[1 2 3]
[4 5 6]]
Pour un tableau à une dimension, la même méthode consiste à écrire values = np.empty(5, dtype=int), puis à attribuer une valeur aux cinq positions avant toute lecture. Un tuple permet de procéder de la même manière avec plusieurs dimensions. Le nom numpy.empty() désigne l’absence d’initialisation, et non un tableau sans éléments : sa forme et son nombre d’éléments sont toujours déterminés par l’argument fourni.