readall

R2026b

Read all data in MDF datastore

collapse all in page

Syntax

data = readall(mdfds)
data = readall(mdfds,UseParallel=ParOnOff)

Description

data = readall(mdfds) reads all the data in the MDF datastore specified by mdfds, and returns a timetable.

After the readall function returns all the data, it resets mdfds to point to the beginning of the datastore.

If all the data in the datastore does not fit in memory, then readall returns an error.

example

data = readall(mdfds,UseParallel=ParOnOff) specifies to use a parallel pool to read all of the data. You can specify to always use a pool ("on"), never use a pool ("off"), or possibly use a pool depending on conditions ("auto").

example

Examples

collapse all

Read all the data from a multiple file MDF datastore into a timetable.

mdfds = mdfDatastore({"CANape1.MF4","CANape2.MF4","CANape3.MF4"});
data = readall(mdfds);

Use a parallel pool if possible, to read all the data from the datastore into a timetable.

mdfds = mdfDatastore({"CANape1.MF4","CANape2.MF4","CANape3.MF4"});
data = readall(mdfds,UseParallel="auto");

Input Arguments

collapse all

MDF datastore, specified as an MDF datastore object.

Example: mdfds = mdfDatastore("CANape.MF4")

You can control when to use a parallel pool to run the readall (Vehicle Network Toolbox) function. Its UseParallel name-value argument accepts the following values with their described actions:

  • UseParallel="off" (default) — Does not use a parallel pool.

  • UseParallel="on" — Uses existing parallel pool or starts a pool. If a pool cannot be used, returns an error.

  • UseParallel="auto" — Uses or starts a pool if possible, otherwise runs without using a parallel pool.

Example: mdfds = mdfDatastore("CANape.MF4",UseParallel="auto")

Data Types: char | string

Output Arguments

collapse all

Output data, returned as a timetable of MDF records.

Version History

Introduced in R2017b

expand all

See Also

Functions