readtimetable — Read tabular data into a timetable.
readtimetable(filename, ...) imports column-oriented file data and designates the first datetime or duration variable as the timetable row times.
Syntax
B = tabularBuiltin(A, ...)Inputs
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
A | Any | Yes | — | Input value. |
args | Any | Variadic | — | Name-value options or conversion arguments. |
Returns
| Name | Type | Description |
|---|---|---|
out | Any | Result value. |
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 readtimetable works
- Text and spreadsheet options accepted by
readtableare forwarded, including exact native integer variable types and the documented all-eight-classVariableNamesLinecontrol. - Typed-integer values for otherwise floating-only import controls are RunMat-only extensions and are rejected in MATLAB compatibility mode before gathering or file access.
- The public contract infers row times from the first imported datetime or duration variable. RunMat extension mode additionally accepts a numeric
RowTimescolumn and preserves native integer values exactly. - If no datetime or duration variable exists, sequential numeric row times are generated only in RunMat extension mode; MATLAB-compatible mode reports the missing time source.
Examples
Reading A Timetable From A File
TT = readtimetable('measurements.csv')Expected output:
TT = timetable object using the first datetime or duration column as row timesImporting Native Integer Variables
TT = readtimetable('measurements.csv', VariableTypes=["datetime" "uint64"])Expected output:
TT = timetable with an exact uint64 data variableUsing readtimetable with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how readtimetable changes the result.
Run a small readtimetable example, explain the result, then change one input and compare the output.
Related Io functions
Tabular
arrayDatastore · csvread · csvwrite · detectImportOptions · dlmread · dlmwrite · fileDatastore · parquetDatastore · parquetinfo · parquetread · readcell · readmatrix · readtable · spreadsheetImportOptions · writecell · writematrix · writetable · writetimetable · xlsread · xlswrite
Repl Fs
addpath · cd · copyfile · delete · dir · exist · fileattrib · fileparts · fullfile · genpath · getenv · getpref · isenv · isfile · isfolder · ispref · ls · matlabroot · memmapfile · mkdir · movefile · open · opentoline · path · pathsep · pcode · pwd · readstruct · rehash · restoredefaultpath · rmdir · rmpath · run · savepath · setenv · setpref · system · tempdir · tempname · uigetdir · uigetfile · uiputfile · unsetenv · userpath · what · winqueryreg · xmlread · xmlwrite
Filetext
fclose · feof · fgetl · fgets · fileread · filewrite · fopen · fprintf · fread · frewind · fwrite · readlines · writelines
Import
Json
Open-source implementation
Unlike proprietary runtimes, every RunMat function is open-source. Read exactly how readtimetable is executed, line by line, in Rust.
- View the source for readtimetable 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.