RunMat
  • Pricing
RunMat
GitHub
GitHub
Sign inTry in browser
DesktopRuntimePhysicsCADAdministrationAgent

Get RunMat updates

New releases, guides and examples.

Product+
  • Runtime
  • GPU
  • Parallel
  • Compile
  • Interop and MEX
  • Simulation
  • MCAD
  • ECAD
  • Enterprise
  • AI integrations
  • Pricing
  • Download
Math+
  • Signal processing
  • Linear algebra
  • Statistics
  • Curve fitting
  • Differential equations
  • Control systems
  • Optimization
  • Finance
  • Data and tables
  • Plotting
Physics+
  • Simulation overview
  • Structural
  • Thermal
  • Electromagnetic
  • Joule heating
  • Thermal stress
  • Acoustics
  • Fluid flow
  • Conjugate heat transfer
  • Fluid–structure
  • What is FEA
Industries+
  • Aerospace
  • Automotive and transportation
  • Defense
  • Electronics and semiconductors
  • Energy
  • Industrial machinery
  • Life sciences
  • Quantitative finance
Learn+
  • Guides
  • Docs
  • Function reference
  • Language reference
  • Migration guide
  • Changelog
  • MATLAB Online
  • MATLAB AI agent
  • For students
Compare+
  • RunMat vs MATLAB
  • RunMat vs Ansys
  • RunMat vs SOLIDWORKS
  • RunMat vs Altium
  • RunMat vs Cadence
  • RunMat vs COMSOL
  • RunMat vs Python
  • RunMat vs Julia
  • RunMat vs Physics AI
  • RunMat vs Octave
  • Benchmarks
  • MATLAB alternatives
  • All comparisons
Company+
  • About
  • Blog
  • Contact
  • Source code↗
  • License
  • Privacy
  • Terms

Product

  • Runtime
  • GPU
  • Parallel
  • Compile
  • Interop and MEX
  • Simulation
  • MCAD
  • ECAD
  • Enterprise
  • AI integrations
  • Pricing
  • Download

Math

  • Signal processing
  • Linear algebra
  • Statistics
  • Curve fitting
  • Differential equations
  • Control systems
  • Optimization
  • Finance
  • Data and tables
  • Plotting

Physics

  • Simulation overview
  • Structural
  • Thermal
  • Electromagnetic
  • Joule heating
  • Thermal stress
  • Acoustics
  • Fluid flow
  • Conjugate heat transfer
  • Fluid–structure
  • What is FEA

Industries

  • Aerospace
  • Automotive and transportation
  • Defense
  • Electronics and semiconductors
  • Energy
  • Industrial machinery
  • Life sciences
  • Quantitative finance

Learn

  • Guides
  • Docs
  • Function reference
  • Language reference
  • Migration guide
  • Changelog
  • MATLAB Online
  • MATLAB AI agent
  • For students

Compare

  • RunMat vs MATLAB
  • RunMat vs Ansys
  • RunMat vs SOLIDWORKS
  • RunMat vs Altium
  • RunMat vs Cadence
  • RunMat vs COMSOL
  • RunMat vs Python
  • RunMat vs Julia
  • RunMat vs Physics AI
  • RunMat vs Octave
  • Benchmarks
  • MATLAB alternatives
  • All comparisons

Company

  • About
  • Blog
  • Contact
  • Source code↗
  • License
  • Privacy
  • Terms
GitHubXLinkedIn

© Dystr, Inc. · RunMat v0.7.1, Nov 17, 2026

RunMat® is a registered trademark of Dystr, Inc. MATLAB® is a registered trademark of The MathWorks, Inc. RunMat is not affiliated with, endorsed by, or sponsored by The MathWorks, Inc.

/
See all docs
Builtin Reference
    • commit
    • data.copy
    • data.create
    • 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

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.
NameTypeRequiredDefaultDescription
pathStringScalarYes—Dataset path (.data).
schemaAnyYes—Dataset schema structure.

Returns

ds
Type
Any
Description
Dataset handle object.
NameTypeDescription
dsAnyDataset 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
IdentifierWhenMessage
RUNMAT:Data:ErrorA path, schema, format, manifest, or filesystem operation fails during the requested data call.data: operation failed
RunMat:Placement:InsufficientResourceEvidenceA finite resource budget is active but no complete dataset-path host-effect bound is certified before filesystem work.data: complete-call resource evidence is unavailable
RunMat:Placement:StaleResourceAuthorityThe certifying host-effect resource authority is revoked before result publication.data: resource authority changed
RunMat:Placement:ResourceLimitA certified complete-call demand exceeds the available placement resources.data: placement resource limit was exceeded
RunMat:Placement:UnavailableThe installed placement service cannot select an admitted host-effect route.data: placement route is unavailable
RunMat:Placement:InvalidRevisionThe selected host-effect revision does not belong to the certifying authority.data: placement revision is invalid
RunMat:Placement:InvalidDecisionPlacement returns a route other than the admitted dataset-path host effect.data: placement decision is invalid
RunMat:CancelledThe invocation is cancelled before the dataset-path result is published.data invocation was cancelled

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

Net

accept · read · readline · tcpclient · tcpserver · 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

Audio

audioinfo · audioread

Io

clc · diary · disp · display · format · input

Filetext

fclose · feof · fgetl · fgets · fileread · filewrite · fopen · fprintf · fread · frewind · fwrite · readlines · writelines

Archive

gunzip · gzip · unzip

Hdf5

h5disp · h5info · h5read · h5write · h5writeatt · hdf5info · hdf5read · hdf5write

Import

importdata · textscan

Json

jsondecode · jsonencode

Mat

load · matfile · matlab.io.MatFile.subsasgn · matlab.io.MatFile.subsref · save

Http

sendmail · urldecode · urlencode · weboptions · webread · websave · webwrite

Related guides

  • Datasets API

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.

Getting started · Benchmarks · Pricing

Download RunMat

Download RunMat for full performance, or use RunMat in your browser for zero setup.

Download RunMatOpen Sandbox
On this page
  • Syntax
  • Inputs
  • Returns
  • Errors
  • Schema and integer controls
  • Filesystem authority
  • Example
  • Create an empty dataset
  • Using data.create with coding agents
  • FAQ
  • Related Io functions
  • Data
  • Net
  • Repl Fs
  • Tabular
  • Audio
  • Io
  • Filetext
  • Archive
  • Hdf5
  • Import
  • Json
  • Mat
  • Http
  • Related guides
  • Source you can read
  • About RunMat