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

pwd — Return the current working folder.

pwd returns the active runtime environment's current working folder as a character row vector.

Syntax

folder = pwd

Returns

folder
Type
StringScalar
Description
Current working folder as a character row vector.
NameTypeDescription
folderStringScalarCurrent working folder as a character row vector.

Errors

RunMat:pwd:TooManyInputs
When
One or more input arguments are provided.
Message
pwd: too many input arguments
RunMat:pwd:CurrentDirectoryUnavailable
When
The current working directory cannot be resolved.
Message
pwd: unable to determine current directory
RunMat:pwd:TooManyOutputs
When
More than one output is requested.
Message
pwd: too many output arguments
IdentifierWhenMessage
RunMat:pwd:TooManyInputsOne or more input arguments are provided.pwd: too many input arguments
RunMat:pwd:CurrentDirectoryUnavailableThe current working directory cannot be resolved.pwd: unable to determine current directory
RunMat:pwd:TooManyOutputsMore than one output is requested.pwd: too many output arguments

Working-folder query

pwd returns the current working folder as a character row vector. The path uses the active platform's native representation and separators.

A successful cd call changes the value returned by subsequent pwd calls. Reading the folder does not change workspace values, the search path, or the working folder itself.

Execution and placement

The runtime asks its filesystem environment for the current directory. Native hosts query the process environment; browser hosts query the virtual filesystem environment supplied to the WebAssembly runtime.

pwd is a host operation and does not invoke an accelerator provider, gather device values, or participate in fusion.

Examples

Read the current working folder

current = pwd;
assert(ischar(current));
assert(size(current, 1) == 1);
disp(current)

Expected output:

The absolute path of the current working folder.

Restore a folder after completing work

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

Use the previous folder returned by cd

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

Print the folder where a script starts

folder = pwd;
fprintf('Script started in %s\n', folder)

Expected output:

Script started in <current folder>

Write the working folder to a log

current = pwd;
fid = fopen('run.log', 'w');
fprintf(fid, 'Working folder: %s\n', current);
fclose(fid);
contents = fileread('run.log');
assert(contains(contents, current));

Handle an unavailable working folder

try
    location = pwd;
    assert(ischar(location));
catch err
    disp(err.message);
end

Expected output:

Returns a path or reports why the host could not resolve it.

Using pwd with coding agents

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

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

FAQ

Why does pwd return a character vector instead of a string scalar?⌄

The compatible return type is a character row vector. Use string(pwd) when a string scalar is more convenient.

Does pwd reflect changes made with cd?⌄

Yes. Each call reads the current folder from the active runtime environment.

Can pwd fail?⌄

Yes. The host can report that the current directory is unavailable, for example after an external process removes it. RunMat returns a structured runtime error containing the host detail.

Does pwd normalize the path?⌄

RunMat returns the path supplied by the active filesystem environment. Platform-native separators and representation are preserved.

Does pwd affect GPU-resident values?⌄

No. It has no data inputs and performs no accelerator operation or transfer.

Related Io functions

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

  • View the source for pwd 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
  • Returns
  • Errors
  • Working-folder query
  • Execution and placement
  • Examples
  • Read the current working folder
  • Restore a folder after completing work
  • Use the previous folder returned by cd
  • Print the folder where a script starts
  • Write the working folder to a log
  • Handle an unavailable working folder
  • Using pwd 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