dsave

ワークスペースの分散配列と Composite オブジェクトを保存する

構文

dsave filename

dsave filename variables

dsave(filename)

説明

dsave filename は、分散配列と Composite オブジェクトを含めて、現在のワークスペースにあるすべての変数を filename で指定された名前のファイルに保存します。filename の拡張子を指定しない場合、関数は拡張子を .mat とみなします。

dsave filename variables は、指定された変数を filename で指定された名前のファイルに保存します。

この関数は、ワイルドカードや -regexp オプションをサポートしていません。

dsave(filename) は、dsave filename と同じ操作を実行します。

たとえば、以下の関数呼び出しは同等です。

dsave("test.mat")

dsave test.mat

dsave(filename,variables) は、dsave filename variables と同じ操作を実行します。

例

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

ワークスペースで変数をリストします。

whos

  Name             Size                Bytes  Class          Attributes

  Constant       500x500             2000000  double                   
  client        1000x1000            8000000  double                   
  filename         1x1                   166  string                   
  scores          34x26                45886  distributed              
  worker           1x6                   713  Composite                

分散配列と Composite オブジェクトを含めて、ワークスペースにあるすべての変数を fname という名前の MAT ファイルに保存します。

dsave fname.mat

filename が変数の場合は、構文の関数形式を使用できます。

filename = "fname.mat";
dsave(filename)

fname 内の変数をリストします。

whos -file fname.mat

  Name                  Size                Bytes  Class     Attributes

  Constant            500x500             2000000  double              
  DMAT_MANIFEST         1x1                 13259  struct              
  client             1000x1000            8000000  double              
  filename               -                    166  string              
  scores               34x26                 3536  uint32              
  worker                1x6                 46510  cell                

特定の変数の保存

いくつかの変数を作成して、mydatafile という名前の MAT ファイルに保存します。

分散配列を作成します。

D = rand(1000,"distributed");

Starting parallel pool (parpool) using the 'Processes' profile ...
Connected to parallel pool with 6 workers.

クライアント上で Composite オブジェクトを作成し、データをワーカー 1 に割り当てます。

C = Composite;            
C{1} = magic(20);   

クライアント ワークスペースに配列を作成します。

X = rand(40);

3 つのすべての変数を mydatafile という名前のファイルに保存し、そのファイルをフォルダー C:\myFolder\myFile に格納します。

dsave C:\myData\mydatafile D C X

入力引数

filename — 保存するファイルの名前

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

保存するファイルの名前。string スカラーまたは文字ベクトルとして指定します。filename を指定しない場合、関数 dsave はワークスペース変数を matlab という名前の MAT ファイルに保存します。

filename の拡張子を指定しない場合、関数 dsave は名前が filename で拡張子が .mat のファイルを作成します。

filename に絶対パスが含まれていない場合、関数 dsave はそのファイルを現在のフォルダーに保存します。ファイルを別のフォルダーに保存するには、そのフォルダーへの絶対パスまたは相対パスを filename に指定します。ファイルの書き込み権限が必要です。

例: "myFile.mat2 は、ファイル名を指定します。

例: C:\myFolder\myFile.mat は、フォルダーへの絶対パスを指定します。

データ型: char | string

variables — 保存する変数の名前

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

保存する変数の名前。1 つ以上の string スカラーまたは文字ベクトルとして指定します。

関数 dsave は、ワイルドカードや -regexp オプションをサポートしていません。

データ型: char | string

制限

• dsave は、スパース分散配列の保存をサポートしていません。

バージョン履歴

R2010a で導入

参考

save | Composite | distributed | dload | parpool