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
    • 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

cd — Query or change the current working folder.

cd returns the current folder or changes it and returns the previous folder.

Syntax

folder = cd
previous = cd(folder)

Inputs

folder
Type
StringScalar
Required
Yes
Description
Target folder as a character vector or string scalar.
NameTypeRequiredDefaultDescription
folderStringScalarYes—Target folder as a character vector or string scalar.

Returns

folder
Type
StringScalar
Description
Current folder for query form or previous folder for mutation form, as a character row vector.
NameTypeDescription
folderStringScalarCurrent folder for query form or previous folder for mutation form, as a character row vector.

Errors

RunMat:cd:TooManyInputs
When
More than one input is provided.
Message
cd: too many input arguments
RunMat:cd:InvalidFolder
When
The folder is not a character row vector or string scalar.
Message
cd: folder name must be a character vector or string scalar
RunMat:cd:EmptyFolder
When
The folder text is empty.
Message
cd: folder name must not be empty
IdentifierWhenMessage
RunMat:cd:TooManyInputsMore than one input is provided.cd: too many input arguments
RunMat:cd:InvalidFolderThe folder is not a character row vector or string scalar.cd: folder name must be a character vector or string scalar
RunMat:cd:EmptyFolderThe folder text is empty.cd: folder name must not be empty
RunMat:cd:ChangeFailedThe target folder cannot be entered.cd: unable to change directory
RunMat:cd:CurrentDirectoryUnavailableThe current folder cannot be resolved.cd: unable to determine current directory

Query or change the working folder

cd with no input returns the current working folder as a character row vector. cd(folder) changes the working folder and returns the previous folder, which can be passed back to cd when the work is complete.

The folder may be a character row vector or string scalar. Relative paths are resolved from the current folder. ~ and ~/... expand from the user's home folder when that environment value is available.

Runtime environment

Native execution updates the process working folder. Browser and embedded execution update the current folder maintained by the active virtual filesystem provider. Later relative file and source lookups observe the change.

Folder text is host data. cd does not accept accelerator-resident numeric buffers, launch a device kernel, or participate in fusion.

Examples

Read the current folder

current = cd;
assert(ischar(current));
assert(size(current, 1) == 1);

Work in a project subfolder and restore the original folder

project_root = pwd;
mkdir('data');
mkdir(fullfile('data', 'logs'));
old = cd(fullfile('data', 'logs'));
assert(strcmp(old, project_root));
cd(old);
assert(strcmp(pwd, project_root));

Navigate to the parent folder

start_dir = pwd;
old = cd('..');
assert(strcmp(old, start_dir));
cd(old);
assert(strcmp(pwd, start_dir));

Use command syntax

project_root = pwd;
mkdir('scratch');
cd scratch
cd ..
assert(strcmp(pwd, project_root));

Change to the home folder

start_dir = pwd;
old = cd('~');
assert(strcmp(old, start_dir));
cd(old);

Capture and restore the previous folder

start_dir = pwd;
mkdir('results');
old = cd('results');
assert(strcmp(old, start_dir));
cd(old);
assert(strcmp(pwd, start_dir));

Handle a missing folder

caught = false;
try
    cd('missing-folder');
catch err
    caught = true;
    assert(~isempty(err.message));
end
assert(caught);

Using cd with coding agents

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

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

FAQ

Does cd return the new folder or the previous folder?⌄

With an input, it returns the previous folder. Without an input, it returns the current folder.

Can cd accept accelerator-resident values?⌄

No. Folder arguments are character row vectors or string scalars, both of which are host values.

Is tilde expansion supported?⌄

Yes. ~ and paths beginning with ~/ or ~\ use the current user's home folder when it can be resolved.

How are relative paths resolved?⌄

They are resolved from the current folder maintained by the active filesystem environment.

What happens if the target does not exist?⌄

RunMat raises a structured error containing the requested folder and the underlying filesystem detail.

Can folder names contain spaces?⌄

Yes. Pass the complete name as a string scalar or character row vector.

Related Io functions

Repl Fs

addpath · 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

Net

accept · read · readline · tcpclient · tcpserver · write

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

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.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

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

Source you can read

Every RunMat function's source is public. Read exactly how cd is executed, line by line, in Rust.

  • View the source for cd 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
  • Query or change the working folder
  • Runtime environment
  • Examples
  • Read the current folder
  • Work in a project subfolder and restore the original folder
  • Navigate to the parent folder
  • Use command syntax
  • Change to the home folder
  • Capture and restore the previous folder
  • Handle a missing folder
  • Using cd with coding agents
  • FAQ
  • Related Io functions
  • Repl Fs
  • Net
  • Tabular
  • Audio
  • Io
  • Data
  • Filetext
  • Archive
  • Hdf5
  • Import
  • Json
  • Mat
  • Http
  • Source you can read
  • About RunMat