mdfWrite

将时间表数据写入 MDF 文件

自 R2022a 起

语法

mdfWrite(mdfFileName,mdfData)

mdfWrite(mdfFileName,mdfData,GroupNumber=chanGrpNum)

说明

mdfWrite(mdfFileName,mdfData) 将一个 MDF 数据时间表写入追加在指定 MDF 文件末尾的一个新通道组。该时间表还可以包含通道组和通道元数据，您可以在执行写入操作之前使用函数 mdfAddChannelGroupMetadata 来添加这些元数据。如果该文件不存在，该函数将创建它。

mdfWrite(mdfFileName,mdfData,GroupNumber=chanGrpNum) 将数据写入指定的通道组索引。如果未指定，数据将写入追加到现有通道组末尾的一个新通道组。

示例

全部折叠

将数据写入 MDF 文件中的通道组

将一个时间表中的数据写入一个 MDF 文件中的特定通道组索引。

mdfWrite("MDFFile.mf4",mdfDataTT,GroupNumber=1)

输入参数

全部折叠

`mdfFileName` — MDF 文件名
字符串 | 字符

要写入的 MDF 文件名，指定为字符串或字符向量。文件名可以是相对或绝对路径。该名称必须包括扩展名 .dat、.mdf 或 .mf4。如果该文件不存在，该函数将创建它。

根据您要访问的位置，mdfFileName 可以采用以下形式之一。

位置

形式

当前文件夹或 MATLAB^® 路径

要访问当前文件夹或 MATLAB 路径中的文件，请在 filename 中指定文件名（包括文件扩展名）。

示例："myMdfFile.mf4"

其他文件夹

要访问当前文件夹以外的文件夹中的文件，请在 filename 中指定完整或相对路径名称。

示例："C:\myFolder\myMdfFile.mf4"

示例："\dataDir\myMdfFile.mf4"

远程位置

要访问远程位置的文件，filename 必须包含指定为统一资源定位器 (URL) 形式的文件的完整路径：

scheme://path_to_file/myMdfFile.mf4

根据远程位置，scheme 可以是下表中的值之一。

远程位置	`scheme`
Amazon S3™	`s3`
Windows Azure^® Blob 存储	`wasb`, `wasbs`
HDFS™	`hdfs`

有关详细信息，请参阅处理远程数据。

示例："s3://bucketname/path_to_file/myMdfFile.mf4"

示例: "MDF_25Dec.mf4"

数据类型: char | string

`mdfData` — 要写入的 MDF 数据的时间表
时间表

要写入 MDF 文件的数据，指定为时间表。时间表中支持的值数据类型有 int8、int16、int32、int64、uint8、uint16、uint32、uint64、single、double、string 和 cell。

数据类型: timetable

限制

mdfWrite 函数不支持写入数组通道或结构体通道。
当覆盖现有通道时，请使用由 mdfRead 函数和选项 IncludeMetadata=true 创建的时间表。不要删除由 mdfRead 函数返回的任何时间表自定义属性。
当覆盖现有通道时，时间表自定义属性中的 ChannelReadOption 属性在内部用于跟踪读取期间应用的转换规则的种类。不要在时间表中修改此自定义属性。
在将新通道写入 MDF 文件时，mdfWrite 函数不支持使用转换规则写入数据。只有原始值可以写入新通道。
MDF 标准不支持布尔数据类型，因此 mdfWrite 不支持 logical 数据类型。要解决此限制，请在写入 MDF 文件之前，将 logical 变量转换为 int8 或 uint8 数据类型。