主要内容

reliteall.

将数据存储写入文件

描述

例子

writeall (DS.输出位置从输入数据存储中写下数据DS.中指定的位置输出文件输出位置.输出文件的数量与数据存储引用的文件数相同。

例子

writeall (DS.输出位置名称,价值用一个或多个名称值对参数指定的附加选项写入数据。例如,您可以指定'OutputType'和一个文件扩展名,如“csv”指定文件的类型reliteall.创造。

例子

全部折叠

将数据存储写入磁盘,然后为写入的文件创建一个新的数据存储。这个过程对于保存您的工作或与同事共享数据存储非常有用。

创建一个数据存储airlinesmall.csv数据集,治疗“NA”值作为丢失的数据。只选择了,航空公司变量。

ds =数据存储(“airlinesmall.csv”);ds。TreatAsMissing =“NA”;ds。SelectedVariableNames = {'月''年'“UniqueCarrier”};

预览数据存储。

预览(ds)
ans =8×3表月年UniqueCarrier  _____ ____ _____________ 1987 1987{“PS”}{“PS”}1987{“PS”}1987{“PS”}1987{“PS”}1987{“PS”}1987{“PS”}1987{“PS”}

将此数据存储区保存到名为的新文件夹ExampleDataC: \磁盘。(您可以指定不同的写入位置,特别是如果您未使用Windows®计算机。)指定'flocklayout'作为'扁平'要将数据存储区文件直接放在目标文件夹中,而无需创建子文件夹。

位置='c:\ exampledata';writeall (ds、位置“Folderlayout”'扁平'

清晰的DS.来自您的工作目录。要从磁盘恢复数据存储,请创建一个新的数据存储,引用编写数据的相同文件夹。

清晰的DS.ds2 =数据存储(位置);

将数据存储写入文件时,可以通过设置'flocklayout'参数。从输入位置创建一个图像数据存储,然后将该数据存储写到文件中。接下来,通过复制文件夹布局在输出位置写入文件。最后,将文件以平面列表的形式写入输出位置。

从该位置创建一个图像数据存储'输入C: \ \ ',里面有一些汽车和火车的图像:

imds = imageageatastore('输入C: \ \ '“IncludeSubfolders”,真正的);

这个文件夹结构只是一个例子。您可以在您的机器上使用包含图像文件的文件夹结构来尝试该功能。

检查文件夹属性,该属性包含到输入数据集的完全限定路径。

洛桑国际管理发展学院。文件夹
ans = 1×1 cell array {'C:\input\'}

将数据存储区写入输出位置“C: \ \输出”.的默认值'flocklayout'参数是'复制'.因此,reliteall.函数重复所有包含的文件夹文件夹属性,然后将文件写入相应的输出文件夹。

writeall (imd,“C: \ \输出”);

现在,将文件从数据存储区写入输出位置“C: \ \输出”通过设置作为平面列表'flocklayout''扁平'.在这种情况下,reliteall.函数不保留输入文件夹布局,而是将所有文件写入扁平输出位置。

writeall (imd,“C: \ \输出”'flocklayout''扁平');

有关更多信息,请参见folderlayout.

你可以使用FilenamePrefixFilenameSuffix参数将文本添加到输出文件名的开头或结尾。从输入位置创建一个图像数据存储。将数据存储写入文件,并将文本追加到文件名的开头。然后再次写入数据存储并将文本附加到文件名的末尾。

从该位置创建一个图像数据存储'输入C: \ \ ',里面有一些汽车和火车的图像:

imds = imageageatastore('输入C: \ \ '“IncludeSubfolders”,真正的);

这个文件夹结构只是一个例子。您可以在您的机器上使用包含图像文件的文件夹结构来尝试该功能。

现在,将文件写入输出位置。指定的值FilenamePrefix作为“png_”将该文本追加到每个输出文件名的开头。

writeall (imd,“C: \ \输出”“FilenamePrefix”“png_”);

将文件写入不同的输出位置。指定的值FilenameSuffix作为“_image”将该文本追加到每个输出文件名的末尾。

writeall (imd,“C: \ output2 \”“FilenameSuffix”“_image”);

输入参数

全部折叠

输入数据存储。您可以使用这些数据存储作为输入reliteall.

您还可以使用这些数据存储reliteall.如果你提供“OutputFormat”“WriteFcn”名称-值对:

要写入数据的文件夹位置,指定为字符向量或字符串标量。输出位置可以指定完整或相对路径。

例子:outputLocation = '../../ dir /数据的

例子:outputLocation = " C: \ \名字\用户桌面”

数据类型:字符|字符串

名称-值对的观点

指定可选的逗号分离对名称,价值参数。的名字是参数名称和价值为对应值。的名字必须出现在引号内。可以以任意顺序指定多个名称和值对参数Name1, Value1,…,的家

例子:writeall(DS,OutputLocation,'folderLayout','flatten')
一般选择

全部折叠

输出文件格式,指定为逗号分隔对组成“OutputFormat”和一个字符矢量或字符串标量。

根据输入数据存储的类型DS.,为输出文件选择其中一个值。您可以为下面列出的任何表格数据存储选择任何表格输出格式。

输入数据存储

输出格式

TabulartextDatastoreSpreadsheetDatastore.帕奎特adatastore. “三”“csv”“xlsx”“xls”'镶木地板',或“parq”
imageageAtastore. “png”“jpg”'jpeg''tif',或'tiff'
AudioDatastore “wav”“ogg”“flac”“mp4”,或“m4a格式”
FileDatastoreTransformedDatastoreCombinedDatastore 支持所有输出格式。万博1manbetx

对于某些输出格式,还可以使用其他的名称-值对来细化写入操作。

输出格式 名称-值对

JPEG.jpg

“质量”

wavflac

'bitspersample'

mp4m4a格式

'比特率'

三种csv

“WriteVariableNames”

'delimiter'

'编码'

“QuoteStrings”

xlsXLSX.

“表”

数据类型:字符|字符串

输出文件夹中的文件布局,指定为逗号分隔对,由'flocklayout',要么'复制''扁平'

  • '复制'- - -reliteall.函数将包含在输入数据位置中的文件夹结构复制到指定的输出位置。输入数据位置包含文件夹输入数据存储的属性。

  • '扁平'- - -reliteall.函数将所有文件从输入写入指定的输出文件夹,而不包含任何子文件夹。

数据类型:字符|字符串

文件名的前缀,指定为逗号分隔的对,由“FilenamePrefix”和一个字符矢量或字符串标量。

reliteall.函数将指定的前缀添加到输出文件名。例如,此代码从数据存储区中添加了今天的所有输出文件名的日期:

prefixtext = string(datetime('今天​​') writeall (imd,“C: \ myFolder”“FilenamePrefix”,prefixtext);

数据类型:字符|字符串

后缀到文件名,指定为逗号分隔对,由“FilenameSuffix”和一个字符矢量或字符串标量。

reliteall.函数将指定的后缀添加到输出文件名。例如,此代码添加了描述性文本“jpeg_70per”到数据存储中所有输出文件名的末尾:

writeall (imd,“C: \ myFolder”“FilenameSuffix”“jpeg_70per”);

数据类型:字符|字符串

指标并行写入,指定为逗号分隔对'使用指平行',要么错误的真正的0.1).

默认情况下reliteall.在系列中写道。如果你设置使用指α.真正的, 然后reliteall.将写操作分成单独的组,并在以下情况下并行运行:

  • 已安装并行计算工具箱™。

  • 存在一个开放的并行池,或者在parallel Preferences中启用了自动创建池。

否则,reliteall.不论值为什么,都以串行方式写入使用指α.

reliteall.不支持通过本地线程万博1manbetx并行写入。

笔记

不支持并行写万博1manbetxCombinedDatastore对象或数据存储变换应用于CombinedDatastore

数据类型:逻辑

自定义写函数,指定为逗号分隔对组成“WriteFcn”和一个函数句柄。指定的函数负责创建输出文件。

你可以使用“WriteFcn”名称-值对参数以各种格式写入数据,即使reliteall.不直接支持输出格式。万博1manbetx

函数签名

自定义写入函数必须接受至少三个输入参数,数据writeinfo.,outputType

函数myWriteFcn(数据、writeInfo outputType)
该函数还可以在前三个必需的输入之后接受额外的输入,如名称-值对。

  • 数据的输出方法在数据存储上运行。

  • writeinfo.是一种类型的对象matlab.io.datastore.WriteInfo使用表中列出的字段。

    场地 描述 类型
    ReadInfo 第二个输出方法 塑造
    SuggestedOutputName 一个完全限定的、全局唯一的文件名,满足位置和命名要求 字符串
    位置 位置参数传递给Datastore Write 字符串
  • outputType是否要写入的输出格式,例如“文本”“csv”

例子函数

从数据存储写入parquet文件的写函数是:

函数myParquetWriteFcn(数据、writeInfo outputType)如果Strcmp(OutputType,“镶木地板”)ParqueTwrite(writeInfo.suggestedOutputPutname,Data)结尾结尾
调用myparquetwritefcn.作为数据存储的写入函数DS.,使用这些命令:
ds = parquetDatastore(位置);outputLocation =“C: / tmp / MyData”;WRITEALL(DS,OutputLocation,“WriteFcn”,@ myparquetwritefcn);

数据类型:function_handle.

选项JPEG.jpg输出

全部折叠

jpeg压缩文件的质量,指定为逗号分隔对组成“质量”并且在[0,100]范围内的标量,其中0是较低的质量和更高的压缩,100质量更高,压缩更低。

例子:“质量”,25岁

选项wavflac输出

全部折叠

每个样本的输出位数,由逗号分隔的对组成'bitspersample'8.162432,或64

仅限FLAC文件8.16,或24支持每个样本的比特。万博1manbetx

例子:“BitsPerSample”,32

选项mp4m4a格式输出

全部折叠

用于压缩音频文件的每秒千比特数(kbit/s),由逗号分隔的对组成'比特率'6496128160192256,或320.在窗户®7.或更高版本,唯一有效的值是:96128160,192

一般来说,一个更大的比特率值会导致更高的压缩质量。

例子:'比特率',96

选项三种csv输出

全部折叠

将变量名写成列标题的指示符,指定为逗号分隔对,由“WriteVariableNames”,要么真正的错误的

指标

行为

真正的

write函数包含变量名作为输出的列标题。这是默认行为。

错误的

写入函数在输出中不包含变量名。

字段分隔符,指定为逗号分隔对,由'delimiter'以及包含以下说明符之一的字符向量或字符串标量:

说明符

字段分隔符

”、“

'逗号'

逗号。这是默认行为。

' '

“空间”

空间

' \ t '

“标签”

选项卡

“;”

“半”

分号

“|”

“酒吧”

竖线

你可以使用'delimiter'名称-值对仅用于带分隔符的文本文件。

例子:'delimiter','space'

数据类型:字符|字符串

与文件相关联的字符编码方案,指定为包含的逗号分隔对'编码'“系统”或标准字符编码方案名称,如此表中的其中一个值。当您未指定任何编码或指定编码时“系统”,写入函数使用系统默认编码来写入文件。

“繁体”

“iso - 8859 - 1”

“windows - 874”

“Big5-HKSCS”

“iso - 8859 - 2”

'Windows-949'

“CP949”

“iso - 8859 - 3”

“windows - 1250”

'euc-kr'

“iso - 8859 - 4”

“windows - 1251”

'euc-jp'

“iso - 8859 - 5”

“windows - 1252”

“EUC-TW”

“iso - 8859 - 6”

“windows - 1253”

“GB18030”

“iso - 8859 - 7”

“windows - 1254”

'GB2312'

“iso - 8859 - 8”

“windows - 1255”

“GBK”

“iso - 8859 - 9”

“windows - 1256”

“IBM866”

“iso - 8859 - 11”

“windows - 1257”

“KOI8-R”

'ISO-8859-13'

“windows - 1258”

“KOI8-U”

“iso - 8859 - 15”

“us - ascii”

“麦金塔”

“utf - 8”

'shift_jis'

例子:“utf - 8”

数据类型:字符|字符串

用于书写引用文本的指示符,指定为逗号分隔对,由“QuoteStrings”,要么错误的真正的.如果“QuoteStrings”真正的,则writing函数将文本用双引号括起来,并用两个双引号字符替换作为该文本一部分的任何双引号字符。

你可以使用“QuoteStrings”名称-值对仅用于分隔文本文件。

选项xlsXLSX.输出

全部折叠

要写入的工作表,指定为逗号分隔对,由“表”以及包含工作表名称或指示工作表索引的正整数的字符向量或字符串标量。工作表名称不能包含冒号().若要确定电子表格文件中的工作表名称,请使用表= sheetnames(文件名).有关更多信息,请参见sheetnames

按名称或索引指定要写入的工作表:

  • name—如果指定的工作表名称在文件中不存在,则写入函数将在工作表集合的末尾添加一个新的工作表。

  • 索引 - 如果指定的纸张索引是索引大于工作表的数量,则写入函数追加空工作表,直到工作簿中的工作表数量等于纸张索引。写入功能还生成警告,指示它已添加新工作表。

你可以使用“表”名称-值对仅适用于电子表格文件。

例子:“表”2

例子:“表”“MySheetName”

数据类型:字符|字符串|||int8|int16|int32|int64|uint8|uint16|uint32|uint64

扩展功能

在R2020A中介​​绍