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
    • binornd
    • bootstrp
    • datasample
    • dividerand
    • exprnd
    • gamrnd
    • gpurng
    • lhsdesign
    • mvnrnd
    • normrnd
    • random
    • randsample
    • rng
    • trnd
    • unidrnd
    • unifrnd
    • wblrnd

bootstrp — Bootstrap samples and evaluate a statistic.

bootstrp(nboot,bootfun,d) draws nboot bootstrap samples with replacement from d and applies bootfun to each sample. bootstrp(nboot,bootfun,d1,...,dN) resamples rows jointly across nonscalar data arguments while scalar arguments are passed through unchanged. [bootstat,bootsam] = bootstrp(...) also returns one-based bootstrap sample indices.

Syntax

bootstat = bootstrp(nboot, bootfun, d)
bootstat = bootstrp(nboot, bootfun, d1, ..., dN)
[bootstat, bootsam] = bootstrp(___)

Inputs

nboot
Type
IntegerScalar
Required
Yes
Description
Number of bootstrap samples.
bootfun
Type
Any
Required
Yes
Description
Function handle applied to each bootstrap sample.
data
Type
Any
Required
Variadic
Description
Data arrays and name-value options.
NameTypeRequiredDefaultDescription
nbootIntegerScalarYes—Number of bootstrap samples.
bootfunAnyYes—Function handle applied to each bootstrap sample.
dataAnyVariadic—Data arrays and name-value options.

Returns

bootstat
Type
NumericArray
Description
Bootstrap statistics, one bootstrap replicate per row.
bootsam
Type
NumericArray
Description
One-based bootstrap sample indices.
NameTypeDescription
bootstatNumericArrayBootstrap statistics, one bootstrap replicate per row.
bootsamNumericArrayOne-based bootstrap sample indices.

Returned values from bootstrp depend on how many outputs the caller requests.

Errors

RunMat:bootstrp:InvalidArgument
When
Inputs, dimensions, replacement flags, or weights are malformed.
Message
sampling: invalid argument
RunMat:bootstrp:Internal
When
Internal conversion or allocation fails.
Message
sampling: internal error
IdentifierWhenMessage
RunMat:bootstrp:InvalidArgumentInputs, dimensions, replacement flags, or weights are malformed.sampling: invalid argument
RunMat:bootstrp:InternalInternal conversion or allocation fails.sampling: internal error

Behavior

Each row of bootstat contains one bootstrap replicate. Nonscalar bootfun outputs are flattened into one row per replicate.

A single vector input is sampled along its first nonsingleton dimension; multiple nonscalar inputs are sampled by rows and must have matching row counts.

bootfun can be a function handle or an empty array. Empty bootfun skips callback evaluation and returns an empty double bootstat with bootsam available as the second output; a text function name is a gated RunMat extension.

"Weights",w samples rows proportionally to nonnegative weights with at least one positive value.

"Options",opts accepts a statset-style options struct for compatibility. Parallel execution options are accepted but currently evaluated serially.

Public numeric controls, data, and weights are single or double; logical, string, char, and cell sample data is also supported. Integer nboot, integer sample data, integer weights, logical nboot, and logical weights are independently gated RunMat extensions.

Integer sample data is indexed without floating conversion. Homogeneous numeric or logical callback output determines bootstat class, including native single and every integer class; bootsam is always double.

Interactive gpuArray input is independently gated and gathered only after compatibility admission.

Execution and residency

Interactive gpuArray input is a RunMat-only extension. After compatibility admission, RunMat gathers exact host storage before resampling and callback evaluation; outputs remain host-resident.

Random state and fusion

Random generation and RNG state control are stateful boundaries and are not fused into elementwise kernels.

Storage precision

Supported sample/storage class declaration: integer. See the distribution, integer-extension, and residency rules above.

Storage precision

Supported sample/storage class declaration: f32. See the distribution, integer-extension, and residency rules above.

Storage precision

Supported sample/storage class declaration: f64. See the distribution, integer-extension, and residency rules above.

Current implementation limits

Options may accept parallel controls, but bootstrap callback execution remains serial.

Examples

Bootstrap a mean

rng(0);
x = (1:20)';
b = bootstrp(1000, @mean, x)

Return sample indices

rng(0);
x = (1:20)';
[b,bootsam] = bootstrp(200, @median, x)

Bootstrap a two-input statistic

rng(0);
x = (1:20)'; y = 2*x + 3;
b = bootstrp(500, @corr, x, y)

Retain the callback's native integer class

rng(0); base = bitshift(uint64(1),53); X = base + uint64([1;3;5]); [B,I] = bootstrp(uint8(4),@max,X);

Using bootstrp with coding agents

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

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

FAQ

Does bootstrp use the global random stream?⌄

Yes. It uses RunMat's global random stream, like datasample and randsample.

Does bootstrp run callbacks in parallel?⌄

No. RunMat accepts the Options name-value for MATLAB compatibility, but callback evaluation is currently serial.

Can bootstrp sample integer arrays?⌄

In RunMat mode, yes: all eight integer classes are sampled exactly and the callback receives the same class. MATLAB-compatible mode rejects this extension because the public nongrouping numeric data domain is single or double.

What class does bootstat use?⌄

The callback's homogeneous numeric or logical output class determines bootstat, while bootsam is double. Inconsistent callback output sizes or classes raise an error.

Related Stats functions

Random

binornd · datasample · dividerand · exprnd · gamrnd · gpurng · lhsdesign · mvnrnd · normrnd · random · randsample · rng · trnd · unidrnd · unifrnd · wblrnd

Summary

anova1 · binocdf · binscatter · boxplot · cdf · cdfplot · chi2cdf · corr · corrcoef · corrcov · cov · cov2corr · dummyvar · ecdf · filloutliers · fitdist · geomean · grpstats · harmmean · icdf · isoutlier · ksdensity · kstest · kurtosis · lsline · mad · mode · nanmax · normalize · normcdf · norminv · normpdf · onehotdecode · onehotencode · pca · pdf · prctile · qqplot · quantile · refline · rmse · scatterhist · skewness · tabulate · tcdf · tiedrank · tinv · tpdf · ttest · ttest2 · wblinv

Ml

bayesopt · classify · confusionmat · crossvalind · cvpartition · fitclinear · fitctree · fitlm · kmeans · knnsearch · lasso · lassoglm · linkage · lscov · mnrfit · nlparci · optimizableVariable · pdist · pdist2 · perfcurve · predict · regress · ridge · squareform · test · training · tsne

Hist

histc · histcounts · histcounts2

Options

statget · statset

Source you can read

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

  • View the source for bootstrp 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
  • Behavior
  • Execution and residency
  • Random state and fusion
  • Storage precision
  • Storage precision
  • Storage precision
  • Current implementation limits
  • Examples
  • Bootstrap a mean
  • Return sample indices
  • Bootstrap a two-input statistic
  • Retain the callback's native integer class
  • Using bootstrp with coding agents
  • FAQ
  • Related Stats functions
  • Random
  • Summary
  • Ml
  • Hist
  • Options
  • Source you can read
  • About RunMat