Contenu principal

save

R2026b

Enregistrer les variables de l’espace de travail dans un fichier

Description

save(filename) enregistre toutes les variables de l’espace de travail courant dans un fichier MATLAB® binaire (fichier MAT) nommé filename. Si filename existe déjà, save remplace le fichier.

exemple

save(filename,variables) enregistre uniquement les variables ou champs d’un tableau de structure spécifiés par variables.

exemple

save(filename,variables,fmt) enregistre les variables au format de fichier spécifié par fmt. L’argument variables est facultatif. Si vous ne spécifiez pas variables, la fonction save enregistre toutes les variables de l’espace de travail.

exemple

save(filename,variables,version) enregistre les variables dans la version de fichier MAT spécifiée par version. L’argument variables est facultatif.

exemple

save(filename,variables,version,"-nocompression") enregistre les variables dans le fichier MAT sans compression. L’option "-nocompression" supporte uniquement les fichiers MAT de version 7 (par défaut) et 7.3. Vous devez donc spécifier version en tant que "-v7" ou "-v7.3". L’argument variables est facultatif.

exemple

save(filename,variables,"-append") ajoute les nouvelles variables à un fichier existant. Si une variable existe déjà dans un fichier MAT, save la remplace par la valeur de l’espace de travail.

Pour les fichiers ASCII, "-append" ajoute les données à la fin du fichier.

Pour ajouter des données à un fichier MAT de version 6, vous devez également spécifier version en tant que "-v6".

exemple

save(filename,variables,"-append","-nocompression") ajoute les nouvelles variables à un fichier existant sans compression. Le fichier existant doit être un fichier MAT de version 7 (par défaut) ou 7.3.

exemple

save filename utilise la syntaxe sous forme de commande. L’utilisation sous forme de commande nécessite moins de caractères spéciaux. Il n’est pas nécessaire de saisir des parenthèses ni de placer l’entrée entre guillemets simples ou doubles. Séparez les entrées par des espaces au lieu de virgules. Si une entrée contient des espaces, placez-la entre guillemets simples.

Par exemple, pour enregistrer un fichier nommé test.mat, les instructions suivantes sont équivalentes :

save test.mat    % command form
save("test.mat") % function form

Vous pouvez inclure n’importe quelle entrée décrite dans les syntaxes précédentes. Par exemple, pour enregistrer la variable X dans un fichier nommé my file.mat :

save 'my file.mat' X    % command form, using single quotes
save("my file.mat","X") % function form, using double quotes

N’utilisez pas la syntaxe de commande lorsqu’une ou plusieurs des entrées, par exemple filename, sont des variables.

exemple

Exemples

réduire tout

Enregistrez toutes les variables de l’espace de travail dans un fichier MAT binaire nommé test.mat. Si filename est une variable, utilisez une syntaxe de fonction.

filename = "test.mat";
save(filename)

Sinon, vous pouvez également utiliser une syntaxe de commande.

save test.mat

Supprimez les variables de l’espace de travail, puis récupérez les données avec la fonction load.

clear
load("test.mat")

Créez deux variables p et, q et enregistrez-les dans un fichier nommé pqfile.mat.

p = rand(1,10);
q = ones(10);
save("pqfile.mat","p","q")

La fonction save enregistre les variables dans le fichier pqfile.mat dans le dossier courant.

Vous pouvez également utiliser une syntaxe de commande pour enregistrer les variables p et q.

save pqfile.mat p q

Créez deux variables, enregistrez-les dans un fichier ASCII, puis affichez le contenu du fichier.

p = rand(1,3);
q = ones(3);
save("pqfile.txt","p","q","-ascii")
type("pqfile.txt")
   8.1472369e-01   9.0579194e-01   1.2698682e-01
   1.0000000e+00   1.0000000e+00   1.0000000e+00
   1.0000000e+00   1.0000000e+00   1.0000000e+00
   1.0000000e+00   1.0000000e+00   1.0000000e+00

Vous pouvez également utiliser une syntaxe de commande pour l’opération save.

save pqfile.txt p q -ascii

Créez une structure contenant trois champs.

s1.a = 12.7;
s1.b = {"abc",[4 5; 6 7]};
s1.c = "Hello!";

Enregistrez les champs de la structure s1 sous forme de variables distinctes dans un fichier nommé newstruct.mat.

save("newstruct.mat","-struct","s1")

Vérifiez le contenu du fichier avec la fonction whos.

whos("-file","newstruct.mat")
  Name      Size            Bytes  Class     Attributes

  a         1x1                 8  double              
  b         1x2               438  cell                
  c         1x1               166  string              

Créez deux variables et enregistrez-les dans un fichier MAT de version 7.3 nommé example.mat.

A = rand(5);
B = magic(10);
save("example.mat","A","B","-v7.3")

Vous pouvez également utiliser une syntaxe de commande pour l’opération save.

save example.mat A B -v7.3

Créez deux variables et enregistrez-les sans compression dans un fichier MAT de version 7.3 nommé myFile.mat.

A = rand(5);
B = magic(10);
save("myFile.mat","A","B","-v7.3","-nocompression")

Vous pouvez également utiliser une syntaxe de commande pour l’opération save.

save myFile.mat A B -v7.3 -nocompression

L’option "-nocompression" permet d’accélérer l’enregistrement.

Enregistrez deux variables dans un fichier MAT. Ajoutez ensuite une troisième variable à ce même fichier.

p = rand(1,10);
q = ones(10);
save("test.mat","p","q")

Affichez le contenu du fichier MAT.

whos("-file","test.mat")
  Name       Size            Bytes  Class     Attributes

  p          1x10               80  double              
  q         10x10              800  double              

Créez une nouvelle variable a et ajoutez-la au fichier MAT.

a = 50;
save("test.mat","a","-append")

Affichez le contenu du fichier MAT.

whos("-file","test.mat")
  Name       Size            Bytes  Class     Attributes

  a          1x1                 8  double              
  p          1x10               80  double              
  q         10x10              800  double              

La fonction save ajoute la variable a au fichier test.mat sans remplacer les variables précédentes p et q.

Remarque : Pour ajouter des données à un fichier MAT de version 6, spécifiez à la fois "-v6" et "-append". Par exemple, pour ajouter la variable a au fichier MAT de version 6 nommé test.mat, exécutez le code suivant :

save("test.mat","a","-v6","-append")

Enregistrez deux variables dans un fichier MAT. Ajoutez ensuite une troisième variable sans compression à ce même fichier.

Créez deux variables A et B et enregistrez-les dans un fichier MAT de version 7.3. Par défaut, la fonction save compresse les variables avant de les enregistrer dans myFile.mat.

A = rand(5);
B = magic(10);
save("myFile.mat","A","B","-v7.3")

Affichez le contenu du fichier MAT.

whos("-file","myFile.mat")
  Name       Size            Bytes  Class     Attributes

  A          5x5               200  double              
  B         10x10              800  double              

Créez une nouvelle variable C et ajoutez-la sans compression au fichier myFile.mat.

C = 5;
save("myFile.mat","C","-append","-nocompression")

Affichez le contenu du fichier MAT.

whos("-file","myFile.mat")
  Name       Size            Bytes  Class     Attributes

  A          5x5               200  double              
  B         10x10              800  double              
  C          1x1                 8  double              

Créez plusieurs variables et utilisez une syntaxe de commande pour les enregistrer dans un fichier nommé myMat.mat.

a = 1;
b = 2;
c = 7;
d = 4;
save myMat.mat a c

Modifiez la variable c.

c = 3;

Enregistrez uniquement les variables de l’espace de travail qui existent déjà dans myMat.mat.

existingVars = whos("-file","myMat.mat");
save("myMat.mat",existingVars.name)

Arguments d'entrée

réduire tout

Nom du fichier, spécifié sous forme de scalaires de chaîne de caractères (string scalars) ou de vecteur de caractères. Si vous ne spécifiez pas filename, la fonction save enregistre les données dans un fichier nommé matlab.mat.

Si filename n’a pas d’extension (autrement dit, s’il ne finit pas par un point suivi de texte) et que la valeur de fmt n’est pas spécifiée, la fonction save ajoute .mat à filename. Si filename ne contient pas de chemin d’accès complet, la fonction save enregistre le fichier dans le dossier courant. Vous devez disposer d’une autorisation en écriture sur le fichier.

Pour enregistrer les variables de l’espace de travail dans un fichier MAT stocké à un emplacement distant, spécifiez filename sous forme d’URL (Uniform Resource Locator) au format suivant :

schemeName://pathToFile/fileName.mat

Selon l’emplacement distant concerné, schemeName peut être l’une des valeurs du tableau suivant.

Emplacement distantschemeName
Amazon S3™s3
Windows Azure® Blob Storagewasb, wasbs

Pour plus d’informations sur la configuration de MATLAB pour accéder à un service de stockage en ligne, consultez Work with Remote Data.

Lorsque vous utilisez save sous forme de commande, il n’est pas nécessaire de placer l’entrée entre guillemets simples ou doubles. Toutefois, si filename contient un espace, vous devez placer l’argument entre guillemets simples. Par exemple, save 'filename withspace.mat'.

Exemple : "myFile.mat"

Exemple : "s3://myBucket/myPath/myFile.mat"

Noms des variables à enregistrer, spécifiés sous forme d’un ou plusieurs string scalars ou vecteurs de caractères. Lorsque vous utilisez save sous forme de commande, il n’est pas nécessaire de placer l’entrée entre guillemets simples.

variables peut avoir l’un des formats suivants.

Format de l’entrée variablesVariables à enregistrer
var1,var2,...,varNEnregistrez les variables répertoriées, spécifiées sous forme de string scalars ou de vecteurs de caractères individuels. Utilisez le caractère de remplacement "*" pour mettre en correspondance des patterns. Par exemple, save("filename.mat","A*") ou save filename.mat A* enregistre toutes les variables de l’espace de travail dont le nom commence par A.
"-regexp",expr1,expr2,...,exprNEnregistrez uniquement les variables dont le nom correspond aux expressions régulières spécifiées sous forme de string scalars ou de vecteurs de caractères. Par exemple, save("filename.mat","-regexp","^Mon","^Tues") ou save filename.mat -regexp ^Mon ^Tues enregistre uniquement les variables de l’espace de travail dont le nom commence par Mon ou Tues.
"-struct",structNameEnregistrez les champs de la structure scalaire spécifiée par structName sous forme de variables distinctes dans le fichier. Par exemple, save("filename.mat","-struct","S") enregistre les champs de la structure scalaire S.
"-struct",structName,field1,field2,...,fieldNEnregistrez les champs indiqués de la structure scalaire spécifiée sous forme de variables distinctes dans le fichier. Par exemple, save("filename.mat","-struct","S","a","b") enregistre les champs S.a et S.b.
"-struct",structName,"-regexp",expr1,expr2,...,exprNEnregistrez uniquement les champs dont le nom correspond aux expressions régulières spécifiées sous forme de string scalars ou de vecteurs de caractères.
"-fromstruct",struct(var1,value1,var2,value2,...,varN,valueN)Enregistrez uniquement les variables avec les noms et valeurs indiqués à partir de la structure spécifiée. Par exemple, save("filename.mat","-fromstruct",struct("x",5,"y",int32(10),"z","hello")) enregistre la variable x avec la valeur 5, la variable y avec la valeur 10 de type int32 et la variable z avec la valeur "hello".

Format de fichier, spécifié sous forme de l’une des valeurs du tableau suivant.

Valeur de fmtFormat de fichier
"-mat"

Format de fichier MAT binaire

"-ascii"

Format texte avec 8 chiffres de précision

"-ascii","-tabs"

Format texte délimité par des tabulations avec 8 chiffres de précision

"-ascii","-double"

Format texte avec 17 chiffres de précision

"-ascii","-double","-tabs"

Format texte délimité par des tabulations avec 17 chiffres de précision

Lorsque vous utilisez save sous forme de commande, il n’est pas nécessaire de placer l’entrée entre guillemets simples ou doubles. Par exemple, save myFile.txt -ascii -tabs.

Pour les fichiers MAT, les données enregistrées sur une machine et chargées sur une autre conservent la plus grande précision et la plus grande plage de valeurs permises par les formats virgule flottante de ces machines.

Utilisez l’un des formats texte pour enregistrer des valeurs numériques MATLAB dans des fichiers texte. Dans ce cas :

  • Chaque variable doit être un tableau 2D double.

  • La sortie contient uniquement la partie réelle des nombres complexes.

  • La fonction save écrit les données de chaque variable de manière séquentielle dans le fichier. Si vous comptez utiliser la fonction load pour lire le fichier, toutes les variables doivent comporter le même nombre de colonnes. La fonction load crée une seule variable à partir du fichier.

Si vous spécifiez un format texte et que l’une des variables est un tableau de caractères, la fonction save convertit les caractères vers les codes ASCII internes correspondants. Par exemple, 'abc' se présente comme suit dans un fichier texte :

  9.7000000e+001  9.8000000e+001  9.9000000e+001

En cas d’enregistrement à un emplacement distant, save supporte la spécification de fmt avec la valeur "-mat" uniquement.

Types de données : string | char

Version du fichier MAT, spécifiée sous forme de l’une des valeurs du tableau suivant. Lorsque vous utilisez save sous forme de commande, il n’est pas nécessaire de placer l’entrée entre guillemets simples ou doubles.

Valeur de versionVersions MATLAB pouvant charger les donnéesFonctionnalités supportéesCompressionTaille maximale de chaque variable
"-v7.3"7.3 (R2006b) ou version ultérieure

Enregistrement de parties de variables ainsi que toutes les fonctionnalités de la version 7.

Oui (par défaut)≥ 2 Go sur les ordinateurs 64 bits
"-v7"7.0 (R14) ou version ultérieure

Codage de caractères Unicode® permettant de partager des fichiers entre des systèmes qui n’utilisent pas le même schéma de codage de caractères par défaut, ainsi que toutes les fonctionnalités de la version 6. La version 7 supporte également l’enregistrement de variables sans compression avec l’option "-nocompression".

Oui (par défaut)231 octets par variable
"-v6"5 (R8) ou version ultérieure

Enregistrement de tableaux N-D, de cell arrays et de tableaux de structure, noms de variables de longueur supérieure à 19 caractères ainsi que toutes les fonctionnalités de la version 4.

Non231 octets par variable
"-v4"Toutes

Enregistrement de tableaux 2-D double, de tableaux de caractères et de tableaux sparse double.

Non100 000 000 éléments par tableau et 231 octets par variable

Si des éléments de données nécessitent des fonctionnalités non supportées par la version spécifiée, la fonction save ne les enregistre pas et génère un avertissement. Vous ne pouvez pas spécifier une version ultérieure à votre version actuelle du logiciel MATLAB.

Remarque

Les fichiers MAT de version 7.3 utilisent un format basé sur HDF5 qui nécessite du stockage supplémentaire pour décrire le contenu du fichier. Pour les cell arrays, les tableaux de structure ou les autres conteneurs pouvant stocker des types de données hétérogènes, les fichiers MAT de version 7.3 sont parfois plus volumineux que ceux de version 7.

Remarque

Les fichiers MAT de version 6 et de version 4 supportent uniquement le codage de caractères ASCII.

Pour consulter ou définir la version par défaut des fichiers MAT, accédez à l’onglet Home et dans la section Environment, sélectionnez Settings. Sélectionnez MATLAB > General > MAT Files, puis choisissez une option MAT file save format.

Types de données : string | char

Limitations

  • La tentative d’enregistrement des données de deux sessions MATLAB distinctes en même temps dans le même fichier peut entraîner la corruption du fichier.

Conseils

  • Pour bénéficier d’une plus grande flexibilité lors de la création de fichiers ASCII, utilisez fprintf.

  • L’enregistrement d’objets graphiques avec la fonction save peut produire un fichier volumineux, car celui-ci contient toutes les informations requises pour régénérer l’objet.

  • Il est déconseillé d’utiliser la fonction save pour enregistrer des figures. Utilisez plutôt la fonction savefig. Si vous utilisez save pour enregistrer une figure dans les versions R2014b ou ultérieures, le fichier MAT est inaccessible dans les versions antérieures de MATLAB. Si vous utilisez save pour enregistrer une figure, la fonction affiche un message d’avertissement. Supprimez toutes les figures avant d’utiliser save. N’oubliez pas qu’il se peut que les figures ne se trouvent pas directement dans votre espace de travail, mais qu’elles soient stockées dans une structure ou dans l’espace de travail d’une fonction de rappel, par exemple.

  • L’argument filename peut être n’importe quel nom valide sur la plateforme actuelle. Toutefois, pour garantir que la fonction load pourra accéder au fichier sur n’importe quelle plateforme, n’utilisez pas les caractères suivants dans filename : \ (antislash), / (slash vers l’avant), : (deux-points), * (astérisque), ? (point d’interrogation), " (guillemet double), < (signe inférieur à), > (signe supérieur à), | (barre verticale), ' (apostrophe) ou ; (point-virgule).

Capacités étendues

développer tout

Historique des versions

Introduit avant R2006a

développer tout