save

ワークスペース変数をファイルに保存

構文

save(filename)

save(filename,variables)

save(filename,variables,fmt)

save(filename,variables,version)

save(filename,variables,version,'-nocompression')

save(filename,variables,'-append')

save(filename,variables,'-append','-nocompression')

save filename

説明

save(filename) は、現在のワークスペースにあるすべての変数を、filename という名前の MATLAB^® 形式のバイナリ ファイル (MAT ファイル) に保存します。filename が存在する場合、save はこのファイルを上書きします。

save(filename,variables) は、variables で指定された構造体配列の変数またはフィールドのみを保存します。

save(filename,variables,fmt) は、fmt で指定されたファイル形式で保存します。variables 引数はオプションです。variables を指定しない場合、関数 save はワークスペースのすべての変数を保存します。

save(filename,variables,version) は、version で指定された MAT ファイルのバージョンに保存します。variables 引数はオプションです。

save(filename,variables,version,'-nocompression') は圧縮せずに変数を MAT ファイルに保存します。'-nocompression' フラグは MAT ファイル Version 7 (既定) および Version 7.3 のみをサポートします。そのため、version を '-v7' または '-v7.3' に指定しなければなりません。variables 引数はオプションです。

save(filename,variables,'-append') は、既存のファイルに新しい変数を追加します。変数が MAT ファイルに既に存在する場合、save はワークスペース内の値を使用してこれを上書きします。

ASCII ファイルの場合、'-append' はファイルの末尾にデータを追加します。

Version 6 MAT ファイルに追加するには、入力引数として '-v6' も含めなければなりません。

save(filename,variables,'-append','-nocompression') は、圧縮せずに既存のファイルに新しい変数を追加します。既存のファイルは MAT ファイル Version 7 (既定) または 7.3 でなければなりません。

save filename は、構文のコマンド形式です。コマンド形式では、必要な特殊文字が少なくなります。かっこを入力したり、入力を一重引用符または二重引用符で囲んだりする必要はありません。入力は、コンマではなく空白を使用して区切ります。

たとえば、test.mat という名前のファイルを保存する場合、以下のステートメントは等価です。

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

前述の構文で説明したいずれかの入力を含めることができます。たとえば、X という名前の変数を保存するには、次のコマンドを入力します。

save test.mat X       % command form
save('test.mat','X')  % function form

filename など、入力のいずれかが変数または string である場合は、コマンド形式を使用しないでください。

例

MAT ファイルへのすべてのワークスペース変数の保存

ワークスペースからすべての変数を、バイナリ MAT ファイル test.mat に保存します。filename が変数である場合は、関数構文を使用します。

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

それ以外の場合は、コマンド構文を使用することもできます。

save test.mat

ワークスペースから変数を削除し、関数 load でデータを取得します。

clear
load('test.mat')

MAT ファイルへの特定の変数の保存

p と q の 2 つの変数を作成し、pqfile.mat というファイルに保存します。

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

MATLAB® は、現在のフォルダーにあるファイル pqfile.mat に変数を保存します。

コマンド構文を使用して、変数 p と q を保存することもできます。

save pqfile.mat p q

ASCII ファイルへのデータの保存

2 つの変数を作成し、ASCII ファイルに保存してからファイルの内容を表示します。

p = rand(1,10);
q = ones(10);
save('pqfile.txt','p','q','-ascii')
type('pqfile.txt')

関数 type は、ファイルの内容を表示します。

または、save の操作のコマンド構文を使用します。

save pqfile.txt p q -ascii

構造体フィールドの個別変数としての保存

a、b および c の 3 つのフィールドを含む構造体 s1 を作成します。

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

構造体 s1 の各フィールドを、個別の変数として newstruct.mat という名前のファイルに保存します。

save('newstruct.mat','-struct','s1');

関数 whos を使用して、ファイルの内容をチェックします。

disp('Contents of newstruct.mat:')

Contents of newstruct.mat:

whos('-file','newstruct.mat')

  Name      Size            Bytes  Class     Attributes

  a         1x1                 8  double              
  b         1x2               246  cell                
  c         1x6                12  char                

Version 7.3 MAT ファイルへの変数の保存

2 つの変数を作成し、example.mat という Version 7.3 MAT ファイルに保存します。

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

save の操作のコマンド構文を使用することもできます。

save example.mat A B -v7.3

圧縮なしでの MAT ファイルへの変数の保存

2 つの変数を作成し、圧縮なしで myFile.mat という Version 7 または 7.3 の MAT ファイルに保存します。

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

または、save の操作のコマンド構文を使用します。

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

'-nocompression' フラグを使用すると、2 GB より大きい変数や、圧縮による利点がない変数の保存が高速化されます。

MAT ファイルへの変数の追加

2 つの変数を MAT ファイルに保存します。次に、3 番目の変数を同じファイルに追加します。

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

MAT ファイルの内容を表示します。

whos('-file','test.mat')

  Name       Size            Bytes  Class     Attributes

  p          1x10               80  double              
  q         10x10              800  double              

新しい変数 a を作成し、MAT ファイルに追加します。

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

MAT ファイルの内容を表示します。

whos('-file','test.mat')

  Name       Size            Bytes  Class     Attributes

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

変数 a が test.mat に追加されます。前述の変数 p と q は上書きされません。

メモ

Version 6 MAT ファイルに追加するには、'-v6' と '-append' の両方を指定します。たとえば、変数 a をファイル test.mat に保存するには、次の関数を呼び出します。

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

圧縮なしでの MAT ファイルへの変数の追加

2 つの変数を MAT ファイルに保存します。次に、3 番目の変数を圧縮なしで同じファイルに追加します。

2 つの変数 A と B を作成し、MAT ファイル Version 7 または 7.3 に保存します。既定では、関数 save は変数 A および B を、myFile.mat に保存する前に圧縮します。

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

MAT ファイルの内容を表示します。

whos('-file','myFile.mat')

  Name       Size            Bytes  Class     Attributes

  A          5x5               200  double              
  B         10x10              800  double              

新しい変数 C を作成して、圧縮なしで myFile.mat に追加します。

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

MAT ファイルの内容を表示します。

whos('-file','myFile.mat')

  Name       Size            Bytes  Class     Attributes

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

入力引数

filename — ファイルの名前

'matlab.mat' (既定値) | 文字ベクトル | string スカラー

ファイルの名前。文字ベクトルまたは string スカラーとして指定します。filename を指定しないと、関数 save は matlab.mat というファイルに保存します。

filename に拡張子がなく (つまり、テキストが後に続くピリオドがない)、format の値が指定されていない場合、MATLAB は .mat を追加します。filename に絶対パスが含まれない場合、MATLAB は現在のフォルダーに保存します。ファイルの書き込み権限をもっていなければなりません。

コマンド形式の save を使用する場合は、入力を一重引用符で囲む必要はありません。ただし、filename にスペースが含まれる場合、引数を一重引用符で囲まなければなりません。たとえば、save 'filename withspace.mat' のようになります。

メモ

filename が string の場合は、コマンド形式を使用しないでください。

ワークスペース変数をリモートの場所にある MAT ファイルに保存するには、filename に次の形式の Uniform Resource Locator (URL) を指定します。

scheme_name://path_to_file/my_file.mat

リモートの場所に基づいて、scheme_name には次の表の値のいずれかを指定できます。

リモートの場所	scheme_name
Amazon S3™	s3
Windows Azure® Blob Storage	wasb, wasbs

関数 save でリモートの場所への保存がサポートされるのは、Version 7.3 の MAT ファイルのみです。

オンライン ストレージ サービスにアクセスするための MATLAB の設定の詳細については、リモート データの操作を参照してください。

例: 'myFile.mat'

例: 's3://bucketname/path_to_file/my_file.mat'

variables — 保存する変数の名前

文字ベクトル | string スカラー

保存する変数の名前。文字ベクトルまたは string スカラーとして指定します。コマンド形式の save を使用する場合は、入力を一重引用符で囲む必要はありません。

メモ

variables が string の場合は、コマンド形式を使用しないでください。

variables は、次のいずれかの形式にできます。

入力 variables の形式	保存する変数
var1,...,varN	個別の文字ベクトルまたは string として指定された、リストされた変数を保存します。 パターンを一致させるには、ワイルドカード '*' を使用します。たとえば、save('filename.mat','A*') は、ファイル内の A で始まるすべての変数を保存します。
'-regexp',expr1,...,exprN	文字ベクトルまたは strings として指定された、正規表現に一致する名前をもつ変数のみを保存します。たとえば、save('filename.mat','-regexp','^Mon','^Tues') は、名前が Mon または Tues で始まるファイルの変数だけを保存します。
'-struct',structName	structName で指定されたスカラー構造体のフィールドをファイルの個別変数として格納します。たとえば、save('filename.mat','-struct','S') はスカラー構造体 S を保存します。
'-struct',structName,field1,...,fieldN	指定されたスカラー構造体の指定されたフィールドをファイルの個別変数として格納します。たとえば、save('filename.mat','-struct','S','a','b') はフィールド S.a と S.b を保存します。
'-struct',structName,'-regexp',expr1,...,exprN	文字ベクトルまたは string として指定された、正規表現に一致する名前をもつフィールドのみを保存します。

fmt — ファイル形式

'-mat' (既定値) | '-ascii' | '-ascii','-tabs' | '-ascii','-double' | '-ascii','-double','-tabs'

ファイル形式。以下のいずれかとして指定します。コマンド形式の save を使用する場合は、save myFile.txt -ascii -tabs のように、入力を一重引用符または二重引用符で囲む必要はありません。

fmt の値	ファイル形式
'-mat'	バイナリ MAT ファイル形式
'-ascii'	8 桁の精度のテキスト形式
'-ascii','-tabs'	8 桁の精度のタブ区切りテキスト形式
'-ascii','-double'	16 桁の精度のテキスト形式
'-ascii','-double','-tabs'	16 桁の精度のタブ区切りテキスト形式

MAT ファイルの場合、1 台のマシンに保存され、別のマシンで読み込まれるデータは、異なるマシンの浮動小数点書式によって可能な限りの精度と範囲を維持します。

いずれかのテキスト形式を使用して、MATLAB の数値をテキスト ファイルに保存します。この場合、

• 各変数は、2 次元の double 配列でなければなりません。

• 出力には、複素数の実数部のみが含まれます。

• MATLAB は、各変数からのデータを順番にファイルに書き込みます。関数 load を使用してファイルを読み取ることを計画する場合、すべての変数の列数が同じでなければなりません。関数 load は、ファイルから単一変数を作成します。

テキスト形式を指定し、変数が 2 次元の文字配列である場合、MATLAB は文字を対応する内部 ASCII コードに変換します。たとえば、'abc' はテキスト ファイルで次のように表示されます。

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

リモートの場所に保存する場合、save でサポートされる fmt の指定値は '-mat' のみです。

データ型: char | string

version — MAT ファイルのバージョン

'-v7' (既定値) | '-v7.3' | '-v6' | '-v4'

MAT ファイルのバージョン。以下のいずれかとして指定します。コマンド形式の save を使用する場合は、入力を一重引用符または二重引用符で囲む必要はありません。

version の値	読み込まれる MATLAB のバージョン	サポート機能	圧縮	各変数の最大サイズ
'-v7.3'	7.3 (R2006b) 以降	変数の一部の読み込みまたは保存、および Version 7 のすべての機能。Version 7.3 では、'-nocompression' オプションを使用して、圧縮せずに変数を保存することができます。	あり (既定値)	64 ビット コンピューターで 2 GB 以上
'-v7'	7.0 (R14) 以降	既定の文字エンコード スキームが異なるシステム間でファイル共有を可能にする Unicode® 文字エンコード、および Version 6 のすべての機能Version 7 では、'-nocompression' オプションを使用して、圧縮せずに変数を保存することができます。	あり (既定値)	1 変数あたり 2^31 バイト
'-v6'	5 (R8) 以降	N 次元配列、cell 配列、構造体配列、長さが 19 文字を超える変数名および Version 4 のすべての機能	なし	1 変数あたり 2^31 バイト
'-v4'	すべて	2 次元の double 配列、文字配列およびスパース配列。	なし	1 配列あたり 100,000,000 要素、1 変数あたり 2^31 バイト

データ項目に、指定されたバージョンでサポートされていない機能が必要になる場合、MATLAB はこれらの項目を保存せずに、警告を表示します。MATLAB ソフトウェアの現在のバージョンより新しいバージョンを指定することはできません。

メモ

Version 7.3 MAT ファイルで使用される HDF5 ベースの形式には、ファイル内容を記述するためのオーバーヘッド ストレージが必要になります。cell 配列、構造体配列または異種混合のデータ型を格納できるその他のコンテナーの場合、Version 7.3 の MAT ファイルは Version 7 の MAT ファイルよりも大きくなることがあります。

MAT ファイルの既定のバージョンを表示または設定するには、[ホーム] タブに移動し、[環境] セクションで [基本設定] をクリックします。[MATLAB] 、 [一般] 、 [MAT ファイル] を選択してから、[MAT ファイルの保存形式] オプションを選択します。

データ型: char | string

制限

• 関数 save でリモート データを操作する場合:

  • HDFS™ への保存はサポートされていません。

  • MAT ファイル以外の形式でのワークスペース変数の保存はサポートされていません。

ヒント

• より柔軟に ASCII ファイルを作成するには、fprintf を使用します。

• 関数 save でグラフィックス オブジェクトを保存すると、オブジェクトの再生成に必要なすべての情報がファイルに含まれるため、大きなファイルが作成される可能性があります。

• 関数 save を使用して Figure を保存しないでください。代わりに関数 savefig を使用します。R2014b 以降で save を使用して Figure を保存すると、それより前のバージョンの MATLAB で MAT ファイルにアクセスできなくなります。save を使用して Figure を保存すると、関数から警告メッセージが表示されます。save を使用する前に、すべての Figure を削除してください。Figure は直接ワークスペース内に存在しない場合があることに注意してください。たとえば、構造体や、コールバック関数のワークスペース内に保存されている可能性があります。

バージョン履歴

R2006a より前に導入

参考

clear | hgsave | load | matfile | regexp | saveas | whos

トピック

• 変数の作成と編集
• ワークスペース変数の保存と読み込み
• テキスト ファイルへのデータの書き込み
• 正規表現

×

例を開く

この例の変更されたバージョンがあります。編集された方の例を開きますか?

いいえ、変更されたバージョンを上書きします。 はい