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

DataArray.read — Read a full stored array or a selected slice.

X = DataArray.read(arr, sliceSpec) decodes stored chunks through the handle's pinned provider and returns a host numeric tensor; omitting the slice reads the full array.

Syntax

X = DataArray.read(arr, sliceSpec)

Inputs

arr
Type
Any
Required
Yes
Default
—
Description
Managed DataArray receiver.
sliceSpec
Type
Any
Required
No
Default
—
Description
Optional cell slice specification or ':' text.
NameTypeRequiredDefaultDescription
arrAnyYes—Managed DataArray receiver.
sliceSpecAnyNo—Optional cell slice specification or ':' text.

Returns

X
Type
NumericArray
Description
Numeric tensor result.
NameTypeDescription
XNumericArrayNumeric tensor result.

Errors

RUNMAT:Data:Error
When
A Dataset family receiver, argument, manifest, payload, or filesystem operation fails.
Message
data: operation failed
RunMat:data:ManifestConflict
When
A transaction's expected manifest sequence no longer matches the stored manifest.
Message
data: manifest conflict
RunMat:data:TransactionNotFound
When
The transaction is absent from the process-local registry.
Message
data: transaction not found
IdentifierWhenMessage
RUNMAT:Data:ErrorA Dataset family receiver, argument, manifest, payload, or filesystem operation fails.data: operation failed
RunMat:data:ManifestConflictA transaction's expected manifest sequence no longer matches the stored manifest.data: manifest conflict
RunMat:data:TransactionNotFoundThe transaction is absent from the process-local registry.data: transaction not found

Class and slice

The declared f64, f32, or integer class and real/paired-complex representation are preserved. A slice specification is a cell of one-based scalar indices, inclusive two-endpoint ranges, or ':' entries; the current implementation may decode the full payload before extracting a slice, so a small slice is not a certified bounded-memory read.

Example

Read a stored integer array

schema = struct(); schema.arrays.sample = struct('dtype', 'uint64', 'shape', [1 2]);
ds = data.create('read.data', schema);
arr = Dataset.array(ds, 'sample');
X = DataArray.read(arr);

Using DataArray.read with coding agents

Open a RunMat example with live inputs, then ask the agent to explain how DataArray.read changes the result.

Run a small DataArray.read example, explain the result, then change one input and compare the output.

FAQ

Is the result resident on the GPU?⌄

No. This dataset read returns a host tensor in the declared numeric class.

Related Io functions

Data

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.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 DataArray.read is executed, line by line, in Rust.

  • View the source for DataArray.read 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
  • Class and slice
  • Example
  • Read a stored integer array
  • Using DataArray.read 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