array2timetable — Convert an array into a timetable.
array2timetable(X, timingName, timingValue) splits a homogeneous two-dimensional array into timetable variables by column. Native integer columns preserve the exact class and values of X.
Syntax
TT = array2timetable(X, "RowTimes", rowTimes)
TT = array2timetable(X, "SampleRate", Fs)
TT = array2timetable(X, "TimeStep", dt)
TT = array2timetable(X, nameValuePairs...)Inputs
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
X | Any | Yes | — | Homogeneous array to split into timetable variables by column. |
rowTimes | Any | Yes | — | Datetime or duration column vector labeling the rows. |
Fs | NumericScalar | Yes | — | Positive sample rate in samples per second. |
dt | Any | Yes | — | Positive duration or calendarDuration scalar time step. |
nameValuePairs | Any | Variadic | — | Timing, StartTime, VariableNames, or DimensionNames options. |
Returns
| Name | Type | Description |
|---|---|---|
TT | Any | Timetable whose variables are the columns of X. |
Errors
| Identifier | When | Message |
|---|---|---|
RunMat:table:InvalidArgument | Arguments or table metadata are invalid. | table: invalid argument |
RunMat:table:InvalidIndex | Table indexing is invalid. | table: invalid index |
RunMat:table:InvalidVariable | A table variable name or value is invalid. | table: invalid variable |
RunMat:readtable:IOError | readtable cannot open or read the requested file. | readtable: file read failed |
RunMat:readtable:UnsupportedFileType | readtable receives a file type outside the text or spreadsheet import backends. | readtable: unsupported file type |
How array2timetable works
- Exactly one of
"RowTimes","SampleRate", or"TimeStep"is required. Explicit row times must be an M-by-1 datetime or duration vector. "StartTime"applies to"SampleRate"and"TimeStep"; a calendar-duration step requires a datetime start."VariableNames"and"DimensionNames"follow current table naming rules, while"RowNames"is not anarray2timetableoption.- All eight integer classes are preserved exactly when supplied as
Xand are accepted as positive scalar sample rates. - Interactive resident GPU arguments are mode-gated RunMat extensions. They gather exact typed storage before timetable construction and reject in MATLAB-compatible mode.
Example
Create a timetable at two samples per second
TT = array2timetable(int16([10;20]), 'SampleRate', 2)Expected output:
TT = 2x1 timetableUsing array2timetable with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how array2timetable changes the result.
Run a small array2timetable example, explain the result, then change one input and compare the output.
Related Table functions
array2table · categorical · cell2table · dictionary · groupsummary · head · height · iscategorical · isordinal · istable · istimetable · ordinal · pivot · rowfilter · struct2table · table · table2array · table2cell · table2struct · table2timetable · timerange · timetable · timetable2table · uitable · vartype · width
Open-source implementation
Unlike proprietary runtimes, every RunMat function is open-source. Read exactly how array2timetable is executed, line by line, in Rust.
- View the source for array2timetable in Rust on GitHub
- Learn how the RunMat runtime works
- Found a bug? Open an issue with a minimal reproduction.
About RunMat
RunMat is an open-source runtime that executes MATLAB-syntax code blazing on any GPU. It is licensed under the Apache 2.0 license.
- RunMat automatically optimizes your math for GPU execution on Apple, Nvidia, and AMD hardware. No code changes needed. Simulations that took hours now take minutes.
- Start running code in seconds. RunMat runs in the browser, on the desktop, or from the CLI. No license server, no IT ticket.