HOWTO · Python

Écrire un tableau dans un fichier texte en Python

Ce tutoriel montre comment enregistrer un tableau dans un fichier texte en python

Sur cette page

Python peut écrire les valeurs d’un tableau dans un fichier texte afin de les consulter plus tard, de les partager ou de les charger comme données numériques. Choisissez l’écriture classique dans un fichier lorsque vous maîtrisez la mise en forme du texte, un gestionnaire de contexte pour fermer automatiquement le fichier, et les fonctions texte de NumPy lorsque vous avez besoin d’un format numérique défini qui pourra être rechargé. Les exemples ci-dessous utilisent des chemins temporaires et peuvent donc être exécutés sans laisser de fichiers derrière eux.

Écrire un tableau dans un fichier texte avec open()

Utilisez open() avec le mode "w" pour créer un fichier ou remplacer son contenu existant. Ce mode est réservé à l’écriture : rouvrez le fichier avec le mode "r" pour vérifier son contenu. Le guide des modes d’ouverture de fichiers en Python décrit les autres modes, notamment le mode ajout "a" et le mode lecture-écriture "w+". Comme "w" remplace l’ancien contenu, utilisez plutôt "a" si vous souhaitez ajouter le nouveau texte à la fin du fichier.

Pour une séquence à une dimension, convertissez les valeurs en texte et choisissez des séparateurs adaptés à la lecture. Exécutez cet exemple. Les libellés affichés dans le résultat restent en anglais, conformément au code inchangé :

from pathlib import Path
from tempfile import TemporaryDirectory

values = [23, 22, 24, 25]
rows = [[23, 22, 24, 25], [13, 14, 15, 19]]

with TemporaryDirectory() as folder:
    path = Path(folder) / "sample.txt"
    file = open(path, "w", encoding="utf-8")
    file.write("[" + " ".join(map(str, values)) + "]")
    file.close()

    file = open(path, "r", encoding="utf-8")
    contents = file.read()
    file.close()
    print("Array contents in sample.txt:", contents)

    matrix_path = Path(folder) / "matrix.txt"
    file = open(matrix_path, "w", encoding="utf-8")
    file.write("\n".join(" ".join(map(str, row)) for row in rows))
    file.close()

    file = open(matrix_path, "r", encoding="utf-8")
    matrix_contents = file.read()
    file.close()
    print("Rows in matrix.txt:")
    print(matrix_contents)

Cet exemple écrit une séquence à une dimension sur une seule ligne et une séquence à deux dimensions avec une ligne par rangée. Chaque appel à write() accepte du texte : les valeurs numériques doivent donc d’abord être converties ou mises en forme sous forme de chaînes. L’appel à close() vide le texte en attente et libère le fichier. Il faut ensuite l’ouvrir de nouveau, car un fichier ouvert avec "w" ne peut pas être lu au moyen du même descripteur.

Écrire str(array) est pratique pour afficher rapidement un tableau, mais cette représentation est conçue pour la présentation et peut varier selon le type de tableau et les paramètres d’affichage. Ne la considérez pas comme un format d’échange stable pour des données numériques.

Écrire un tableau avec un gestionnaire de contexte

Une instruction with gère le descripteur de fichier et le ferme lorsque le bloc indenté se termine, même si l’exécution quitte le bloc prématurément. Vous conservez ainsi la même mise en forme explicite du texte sans avoir à appeler manuellement close(). L’exemple traite les deux formes de tableau, puis lit les fichiers une fois les blocs d’écriture terminés. Les libellés affichés dans le résultat restent en anglais, conformément au code inchangé :

from pathlib import Path
from tempfile import TemporaryDirectory

values = [23, 25, 27, 29, 30]
rows = [[23, 25, 27, 29], [30, 31, 32, 34]]

with TemporaryDirectory() as folder:
    one_dimensional_path = Path(folder) / "values.txt"
    with open(one_dimensional_path, "w", encoding="utf-8") as file:
        file.write(" ".join(map(str, values)))

    two_dimensional_path = Path(folder) / "rows.txt"
    with open(two_dimensional_path, "w", encoding="utf-8") as file:
        file.write("\n".join(" ".join(map(str, row)) for row in rows))

    with open(one_dimensional_path, "r", encoding="utf-8") as file:
        print("Values:", file.read())
    with open(two_dimensional_path, "r", encoding="utf-8") as file:
        print("Rows:")
        print(file.read())

Le fichier est fermé à la fin de chaque bloc with ; les lectures suivantes n’ont donc lieu qu’une fois l’écriture terminée. Définissez encoding="utf-8" pour rendre l’encodage du texte explicite, en particulier si les valeurs contiennent des caractères non ASCII. Une mise en page avec des espaces ou des retours à la ligne est facile à consulter, mais sa lecture ultérieure suppose que vous vous soyez mis d’accord sur cette mise en page.

Enregistrer et recharger des tableaux numériques avec NumPy

Pour les données numériques, NumPy fournit numpy.savetxt() et numpy.loadtxt() pour écrire et analyser un format texte documenté. Définissez le délimiteur et le format numérique lors de l’enregistrement, puis utilisez le même délimiteur au chargement. Contrairement à la représentation imprimée d’un tableau, les lignes délimitées obtenues sont conçues pour l’échange de données numériques. Consultez la référence de numpy.loadtxt() pour découvrir d’autres options de chargement.

Cet exemple enregistre un tableau à une dimension et un tableau à deux dimensions. Le format entier évite la notation scientifique pour ces valeurs, et la virgule rend les colonnes explicites. Les libellés affichés dans le résultat restent en anglais, conformément au code inchangé :

from pathlib import Path
from tempfile import TemporaryDirectory

import numpy as np

values = np.array([23, 24, 25, 26, 28])
matrix = np.array([[23, 24, 25], [34, 45, 46]])

with TemporaryDirectory() as folder:
    values_path = Path(folder) / "values.csv"
    matrix_path = Path(folder) / "matrix.csv"

    np.savetxt(values_path, values, delimiter=",", fmt="%d")
    np.savetxt(matrix_path, matrix, delimiter=",", fmt="%d")

    loaded_values = np.loadtxt(values_path, delimiter=",", dtype=int)
    loaded_matrix = np.loadtxt(matrix_path, delimiter=",", dtype=int)

    print("Values match:", np.array_equal(values, loaded_values))
    print("Matrix matches:", np.array_equal(matrix, loaded_matrix))

Choisissez un format qui conserve la précision nécessaire : "%d" convient aux entiers, mais supprimerait les parties fractionnaires s’il était appliqué à des nombres à virgule flottante. Pour les décimales, choisissez un format flottant adapté, par exemple "%.8f". Le délimiteur doit être identique lors de l’enregistrement et du chargement. Un tableau à une dimension est rechargé sous forme de résultat à une dimension ; un fichier comportant plusieurs lignes donne un résultat à deux dimensions. Les fichiers texte sont lisibles et portables, mais, pour les grands tableaux numériques, ils sont plus volumineux et plus lents à analyser que les formats binaires de NumPy.