Main Content

mdfWrite

Write timetable data to MDF-file

    Description

    example

    mdfWrite(mdfFile,mdfData) writes a timetable of MDF data to a new channel group appended at the end of the specified MDF-file. The timetable can also contain channel group and channel metadata, which you can add using the function mdfAddChannelGroupMetadata before performing the write operation. If the file does not exist, the function creates it.

    mdfWrite(mdfFile,mdfData,GroupNumber=chanGrpNum) writes data to the specified channel group index. If unspecified, data is written to a new channel group appended to the end of existing channel groups.

    Examples

    collapse all

    Write data from a timetable to a specific channel group index in an MDF-file.

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

    Input Arguments

    collapse all

    MDF-file name to write to, specified as a string or character vector. The file name can be a relative or absolute path. The name must include the extension .dat, .mdf, or .mf4. If the file does not exist, the function creates it.

    Example: "MDF_25Dec.mf4"

    Data Types: char | string

    Data, specified as a timetable, to write to the MDF-file.

    Data Types: timetable

    Limitations

    • The mdfWrite function does not support writing array channels or structure channels.

    • When overwriting an existing channel, use a timetable that was created by the read function with the option IncludeMetadata=true. Do not remove any timetable custom properties returned by the read function.

    • When overwriting an existing channel, the ChannelReadOption property in the timetable custom properties is used internally to keep track of the kind of conversion rule applied during the read. Do not modify this custom property in the timetable.

    • When writing a new channel to an MDF-file, the mdfWrite function does not support writing data with conversion rules. Only raw values can be written to new channels.

    Version History

    Introduced in R2022a