data.import — Import a RunMat dataset directory.
ds = data.import(path, 'data', sourcePath) copies a stored dataset into path, validates the copied manifest, and returns a Dataset handle.
Syntax
ds = data.import(path, format, sourcePath)Inputs
path- Type
StringScalar- Required
- Yes
- Default
- —
- Description
- Dataset path (.data).
format- Type
StringScalar- Required
- Yes
- Default
- —
- Description
- Format token; currently data.
sourcePath- Type
StringScalar- Required
- Yes
- Default
- —
- Description
- Source dataset path.
Returns
ds- Type
Any- Description
- Dataset handle object.
Errors
RUNMAT:Data:Error- When
- A path, schema, format, manifest, or filesystem operation fails during the requested data call.
- Message
data: operation failed
RunMat:Placement:InsufficientResourceEvidence- When
- A finite resource budget is active but no complete dataset-path host-effect bound is certified before filesystem work.
- Message
data: complete-call resource evidence is unavailable
RunMat:Placement:StaleResourceAuthority- When
- The certifying host-effect resource authority is revoked before result publication.
- Message
data: resource authority changed
Format and effects
Only the case-insensitive data format token is currently supported. Unsupported formats fail before filesystem copying. Source and destination use the same captured provider and current directory; stored array payload bytes retain their declared numeric classes. If manifest validation fails after copying, the provider error is returned and the copied directory is not automatically rolled back.
Example
Import a dataset directory
schema = struct(); schema.arrays = struct();
data.create('source.data', schema);
ds = data.import('imported.data', 'data', 'source.data');
found = data.exists('imported.data');Using data.import with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how data.import changes the result.
Run a small data.import example, explain the result, then change one input and compare the output.
FAQ
Can I import an arbitrary MAT or CSV file?⌄
No. This form currently accepts another RunMat .data directory only.
Related Io functions
Data
commit · data.copy · data.create · data.delete · data.exists · data.export · data.inspect · data.list · data.move · data.open · DataArray.chunk_shape · DataArray.codec · DataArray.dtype · DataArray.fill · DataArray.name · DataArray.rank · DataArray.read · DataArray.resize · DataArray.shape · DataArray.write · Dataset.array · Dataset.arrays · Dataset.attrs · Dataset.begin · Dataset.get_attr · Dataset.has_array · Dataset.id · Dataset.path · Dataset.refresh · Dataset.set_attr · Dataset.set_attrs · Dataset.snapshot · Dataset.version · DataTransaction.abort · DataTransaction.commit · DataTransaction.create_array · DataTransaction.delete_array · DataTransaction.fill · DataTransaction.id · DataTransaction.resize · DataTransaction.set_attr · DataTransaction.set_attrs · DataTransaction.status · DataTransaction.write
Repl Fs
addpath · cd · copyfile · delete · dir · exist · fileattrib · fileparts · filesep · fullfile · genpath · getenv · getpref · isenv · isfile · isfolder · ispref · ls · matlabroot · memmapfile · memmapfile.subsasgn · memmapfile.subsref · 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
Tabular
arrayDatastore · csvread · csvwrite · detectImportOptions · dlmread · dlmwrite · fileDatastore · getvaropts · parquetDatastore · parquetinfo · parquetread · readcell · readmatrix · readtable · readtimetable · setvaropts · setvartype · spreadsheetImportOptions · writecell · writematrix · writetable · writetimetable · xlsread · xlswrite
Filetext
fclose · feof · fgetl · fgets · fileread · filewrite · fopen · fprintf · fread · frewind · fwrite · readlines · writelines
Import
Json
Related guides
Source you can read
Every RunMat function's source is public. Read exactly how data.import is executed, line by line, in Rust.
- View the source for data.import in Rust on GitHub
- Learn how the RunMat runtime works
- Found a bug? Open an issue with a minimal reproduction.
About RunMat
RunMat is a runtime that executes MATLAB-syntax code fast on any GPU. The runtime is free for individuals, including freelancers; students and faculty at an academic institution, for teaching or research there; contributors to an open-source project, for work on that project; organizations with 250 or fewer people and US$10M or less in annual revenue; and anyone, for non-production use. See runmat.com/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.