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.
Returns
bootstat- Type
NumericArray- Description
- Bootstrap statistics, one bootstrap replicate per row.
bootsam- Type
NumericArray- Description
- One-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
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
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.