writeall
ファイルへのデータストアの書き込み
説明
writeall( は、入力データストア ds,outputLocation)ds のデータを outputLocation で指定された場所の出力ファイルに書き込みます。出力ファイルの数は、データストアが参照するファイルの数と同じです。
writeall( は、1 つ以上の名前と値のペアの引数で指定された追加のオプションを使用してデータを書き込みます。たとえば、ds,outputLocation,Name,Value)'OutputFormat' と 'csv' などのファイル拡張子を指定すると、writeall で作成されるファイルの種類を指定できます。
例
データストアをディスクに書き込み、書き込んだファイルの新しいデータストアを作成します。このプロセスは、作業内容を保存したり、データストアを同僚と共有したりするために役立ちます。
airlinesmall.csv データ セットのデータストアを作成し、'NA' 値を欠損データとして扱います。変数 Year、Month および Carrier のみを選択します。
ds = datastore('airlinesmall.csv'); ds.TreatAsMissing = 'NA'; ds.SelectedVariableNames = {'Month','Year','UniqueCarrier'};
データストアをプレビューします。
preview(ds)
ans=8×3 table
Month Year UniqueCarrier
_____ ____ _____________
10 1987 {'PS'}
10 1987 {'PS'}
10 1987 {'PS'}
10 1987 {'PS'}
10 1987 {'PS'}
10 1987 {'PS'}
10 1987 {'PS'}
10 1987 {'PS'}
このデータストアを C:\ ディスクの ExampleData という名前の新規フォルダーに保存します (特に Windows® コンピューターを使用していない場合は、異なる書き込み先を指定することが可能)。'FolderLayout' を 'flatten' として指定して、サブフォルダーを作成せずにデータストア ファイルをターゲット フォルダーに直接配置します。
location = 'C:\ExampleData'; writeall(ds,location,'Folderlayout','flatten')
作業ディレクトリから ds をクリアします。ディスクからデータストアを復元するには、新しいデータストアを作成し、データが書き込まれていた同じフォルダーを参照します。
clear ds
ds2 = datastore(location);データストアをファイルに書き込む際に、'FolderLayout' パラメーターを設定して、フォルダー構造を複製するかフラットにするかを選択できます。入力場所からイメージ データストアを作成し、そのデータストアをファイルに書き出します。次に、フォルダー レイアウトを複製してファイルを出力場所に書き込みます。最後に、ファイルを出力場所にフラット リストとして書き込みます。
自動車と電車のイメージがいくつか格納されている場所 'C:\input\' からイメージ データストアを作成します。
imds = imageDatastore('C:\input\','IncludeSubfolders',true);
このフォルダー構造は一例です。ご使用のマシンでイメージ ファイルが格納されているフォルダー構造に対してこの機能を試すことができます。
入力データセットへの完全修飾パスを含む入力データストアの Folders プロパティを確認します。
imds.Folders
ans =
1×1 cell array
{'C:\input\'}データストアを出力場所 'C:\output\' に書き込みます。'FolderLayout' パラメーターの既定値は 'duplicate' です。したがって、関数 writeall は、入力データストアの Folders プロパティに含まれるすべてのフォルダーを複製し、ファイルを対応する出力フォルダーに書き込みます。
writeall(imds,'C:\output\');
次に、'FolderLayout' を 'flatten' に設定して、データストアのファイルを出力場所 'C:\output\' にフラット リストとして書き込みます。この場合、関数 writeall は入力フォルダー レイアウトを保持せず、代わりにすべてのファイルをフラットな出力場所に書き込みます。
writeall(imds,'C:\output\','FolderLayout','flatten');
詳細については、FolderLayout を参照してください。
FilenamePrefix パラメーターと FilenameSuffix パラメーターを使用して、出力ファイル名の先頭または末尾にテキストを追加できます。入力場所からイメージ データストアを作成します。データストアをファイルに書き出し、ファイル名の先頭にテキストを追加します。次に、データストアを再度書き込み、ファイル名の末尾にテキストを追加します。
自動車と電車のイメージがいくつか格納されている場所 'C:\input\' からイメージ データストアを作成します。
imds = imageDatastore('C:\input\','IncludeSubfolders',true);
このフォルダー構造は一例です。ご使用のマシンでイメージ ファイルが格納されているフォルダー構造に対してこの機能を試すことができます。
次に、ファイルを出力場所に書き込みます。FilenamePrefix の値を 'png_' として指定して、そのテキストを各出力ファイル名の先頭に追加します。
writeall(imds,'C:\output\','FilenamePrefix','png_');
ファイルを別の出力場所に書き込みます。FilenameSuffix の値を '_image' として指定して、そのテキストを各出力ファイル名の末尾に追加します。
writeall(imds,'C:\output2\','FilenameSuffix','_image');
入力引数
名前と値の引数
拡張機能
バージョン履歴
R2020a で導入
参考
tabularTextDatastore | imageDatastore | spreadsheetDatastore | parquetDatastore | audioDatastore (Audio Toolbox) | write
