unidrnd — Generate random integers from a discrete uniform distribution.
unidrnd(n) generates random integers from 1 through n. Size arguments can be supplied as separate dimensions or as a size vector.
Syntax
r = unidrnd(n)
r = unidrnd(n, sz)
r = unidrnd(n, sz1, sz2, ...)Inputs
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
n | Any | Yes | — | Population size or upper discrete uniform bound. |
sz | Any | Variadic | — | Output dimensions. |
Returns
| Name | Type | Description |
|---|---|---|
r | NumericArray | Discrete uniform random sample. |
Errors
| Identifier | When | Message |
|---|---|---|
RunMat:unidrnd:InvalidArgument | Inputs, dimensions, replacement flags, or weights are malformed. | sampling: invalid argument |
RunMat:unidrnd:Internal | Internal conversion or allocation fails. | sampling: internal error |
How unidrnd works
nmust contain positive integer-valued single or double values.- Native typed-integer
nis a RunMat extension. It is gated before gather and admitted only when every value is exactly representable at the binary64 sampling boundary. - Scalar
nbroadcasts over the requested output size. - Array
nrequires the requested size to match the shape ofn. - A single size argument creates a square matrix, following MATLAB random-size conventions.
- Documented size controls are single or double. Native typed-integer sizes are a separately gated RunMat extension and are decoded exactly as structural extents.
Examples
Scalar sample
r = unidrnd(10)Matrix sample
r = unidrnd(6, 3, 4)Using unidrnd with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how unidrnd changes the result.
Run a small unidrnd example, explain the result, then change one input and compare the output.
FAQ
What class does unidrnd return?⌄
RunMat returns double-precision numeric values, matching the common MATLAB numeric result shape.
Related Stats functions
Random
binornd · bootstrp · datasample · dividerand · exprnd · gamrnd · lhsdesign · mvnrnd · normrnd · random · randsample · rng · trnd · unifrnd · wblrnd
Ml
bayesopt · classify · confusionmat · crossvalind · cvpartition · fitclinear · fitctree · fitlm · kmeans · knnsearch · lasso · lassoglm · linkage · lscov · mnrfit · optimizableVariable · pdist · pdist2 · perfcurve · predict · regress · ridge · squareform · test · training · tsne
Summary
binocdf · boxplot · cdf · cdfplot · chi2cdf · corr · corrcoef · corrcov · cov · cov2corr · dummyvar · ecdf · filloutliers · fitdist · geomean · grpstats · harmmean · icdf · isoutlier · kstest · kurtosis · lsline · mad · mode · nanmax · normalize · normcdf · norminv · normpdf · onehotdecode · onehotencode · pdf · prctile · quantile · refline · rmse · skewness · tabulate · tcdf · tiedrank · tinv · tpdf · ttest2 · wblinv
Hist
Open-source implementation
Unlike proprietary runtimes, every RunMat function is open-source. Read exactly how unidrnd is executed, line by line, in Rust.
- View the source for unidrnd in Rust on GitHub
- Learn how the RunMat runtime works
- Found a bug? Open an issue with a minimal reproduction.
About RunMat
RunMat is an open-source runtime that executes MATLAB-syntax code blazing on any GPU. It is licensed under the Apache 2.0 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.