data.create — Create a typed dataset at a .data path.
ds = data.create(path, schema) writes a new manifest and zero-filled, chunked arrays, returning a Dataset handle.
Syntax
ds = data.create(path, schema)Inputs
path- Type
StringScalar- Required
- Yes
- Default
- —
- Description
- Dataset path (.data).
schema- Type
Any- Required
- Yes
- Default
- —
- Description
- Dataset schema structure.
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
Schema and integer controls
schema.arrays is a structure keyed by array name. Each array may specify dtype (default f64), shape (default [0 0]), chunk, and codec. Supported dtypes are f64, f32, and all eight signed/unsigned fixed-width integer classes. Shapes and chunks accept exact typed integers or integral single/double dimensions; invalid, negative, overflowing, or rank-mismatched dimensions are rejected before array publication.
Filesystem authority
The call uses one captured filesystem provider and current directory for its manifest and all chunk payloads. Relative paths are resolved against that directory. This is host filesystem work, not a GPU kernel; nested resident numeric values are not accepted as schema dimensions without their documented structural conversion.
Example
Create an empty dataset
schema = struct();
schema.arrays = struct();
ds = data.create('empty.data', schema);
found = data.exists('empty.data');Using data.create with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how data.create changes the result.
Run a small data.create example, explain the result, then change one input and compare the output.
FAQ
Can I create an integer array?⌄
Yes. Set dtype to an integer class such as uint64; shape and chunk controls are checked without reducing wide integers through double.
Related Io functions
Data
commit · data.copy · data.delete · data.exists · data.export · data.import · 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.create is executed, line by line, in Rust.
- View the source for data.create 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.