data.open — Open a stored dataset by path.
ds = data.open(path) validates a dataset manifest and returns its Dataset handle and current version facts.
Syntax
ds = data.open(path)Inputs
path- Type
StringScalar- Required
- Yes
- Default
- —
- Description
- Dataset path (.data).
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
Handle and storage
The manifest is read through the captured filesystem provider and current directory. The returned Dataset object presents the public path, dataset ID, and version token while retaining a private lease for that exact provider and resolved root; later Dataset and DataArray calls use that owner even if the ambient provider or directory changes. Arrays are not decoded by opening the handle.
Example
Reopen a dataset
schema = struct(); schema.arrays = struct();
data.create('work.data', schema);
ds = data.open('work.data');
id = Dataset.id(ds);Using data.open with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how data.open changes the result.
Run a small data.open example, explain the result, then change one input and compare the output.
FAQ
Does opening load array payloads?⌄
No. It validates and reads the manifest; use Dataset.array and DataArray.read to access stored arrays.
Related Io functions
Data
commit · data.copy · data.create · data.delete · data.exists · data.export · data.import · data.inspect · data.list · data.move · 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.open is executed, line by line, in Rust.
- View the source for data.open 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.