data.copy — Copy a dataset directory to a new path.
tf = data.copy(fromPath, toPath) recursively copies a dataset directory and returns true after completion.
Syntax
tf = data.copy(fromPath, toPath)Inputs
fromPath- Type
StringScalar- Required
- Yes
- Default
- —
- Description
- Source dataset path.
toPath- Type
StringScalar- Required
- Yes
- Default
- —
- Description
- Destination dataset path.
Returns
ok- Type
LogicalArray- Description
- Logical result flag.
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
Stored representation
The call copies manifest, indexes, and chunk payload bytes through one captured filesystem provider. It does not decode and recast numeric arrays, so declared integer dtypes and wide integer payload bits are preserved. Source and destination relative paths share the same captured current directory. The copy is not an atomic transaction across the entire directory.
Example
Copy a dataset
schema = struct(); schema.arrays = struct();
data.create('source.data', schema);
ok = data.copy('source.data', 'copy.data');
found = data.exists('copy.data');Using data.copy with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how data.copy changes the result.
Run a small data.copy example, explain the result, then change one input and compare the output.
FAQ
Does copy convert stored integer arrays?⌄
No. Dataset files are copied as stored bytes; each array's declared dtype remains in the copied manifest.
Related Io functions
Data
commit · 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
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.copy is executed, line by line, in Rust.
- View the source for data.copy 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.