single — Convert supported values to single-precision storage.
single(X) converts supported scalars and arrays to native IEEE binary32 while preserving shape and documented storage, domain, and residency behavior.
Syntax
Y = single(X)
Y = single(X, "like", prototype)Inputs
X- Type
Any- Required
- Yes
- Description
- Input scalar or array value to convert.
like- Type
StringScalar- Required
- Yes
- Description
- Literal string "like".
prototype- Type
LikePrototype- Required
- Yes
- Description
- Output residency prototype; the conversion class remains fixed.
Returns
Y- Type
NumericArray- Description
- Single-precision output value.
Errors
RunMat:single:InvalidArgument- When
- Optional arguments are malformed or unsupported, or more than one output is requested.
- Message
single: invalid argument
RunMat:single:InvalidInput- When
- Input value or prototype cannot be converted to single.
- Message
single: invalid input
RunMat:single:GpuUnsupported- When
- GPU output via "like" is requested but no compatible binary32 storage provider is active.
- Message
single: gpu output not supported
RunMat:single:Internal- When
- Internal conversion, gather, or provider upload failed.
- Message
single: internal error
Behavior
Y = single(X) converts supported values to IEEE binary32 and preserves shape. Real and complex numeric input retains its domain; logical values become zero or one; characters become Unicode code points.
All fixed-width integers convert directly from native integer storage to binary32. Values are rounded to the nearest representable single-precision value without an intermediate binary64 materialization.
Sparse input retains CSC structure with single stored values. String, cell, struct, object, handle, and foreign input is rejected with a typed conversion error. Empty arrays retain their exact dimensions.
single(X, "like", prototype) is a RunMat extension that keeps the output class fixed as single while selecting host or compatible provider residency from the prototype.
GPU execution
Supported providers convert real input on its owning device and keep the result resident as native binary32. Complex conversion and unsupported provider operations use the typed owner-aware fallback.
Fallback gathers through the exact owner, converts the real or complex storage, and re-uploads to the source owner before optional prototype adaptation. A host output prototype gathers the converted result and releases its temporary resident allocation. Provider errors remain visible; only typed unsupported-operation errors select fallback.
Examples
Preserve character matrix order
codes = single(['ab'; 'cd']);Convert a matrix to single precision
A = [1 2 3; 4 5 6];
B = single(A)Expected output:
B is a 2-by-3 single matrixConvert a scalar to single precision
pi_single = single(pi)Expected output:
pi_single = single(3.1416)Convert complex numbers to single precision
z = [1+2i 3-4i];
single_z = single(z)Expected output:
single_z is a 1-by-2 complex single vectorConvert characters to single-precision code points
codes = single('ABC')Expected output:
codes = single([65 66 67])Keep provider-resident input on the GPU
G = gpuArray([0 3; 1 4; 2 5]);
H = single(G);
host = gather(H)Expected output:
host is a 3-by-2 single matrixConvert a logical mask to single precision
mask = logical([0 1 0 1]);
weights = single(mask)Expected output:
weights = single([0 1 0 1])Using single with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how single changes the result.
Run a small single example, explain the result, then change one input and compare the output.
FAQ
Why can single change a numeric value?⌄
Binary32 has about seven decimal digits of precision, so values are rounded to the nearest representable result.
Does single accept integer classes?⌄
Yes. Every fixed-width integer class converts directly from its native storage to binary32.
Can single convert strings?⌄
No. String input returns a typed conversion error; convert text intentionally before calling single.
What about structs, cells, or user objects?⌄
Unsupported container and object inputs return a conversion error. Extract the numeric value first.
Does single support complex numbers?⌄
Yes. Both real and imaginary components convert to native single precision.
How does single handle empty arrays?⌄
Empty arrays remain empty and retain all dimensions and orientation.
Will GPU input stay on the GPU?⌄
Supported providers cast on device. Typed fallback returns the converted result to the original owner unless an explicit output prototype requests different residency.
What do class and isa report?⌄
Host and gathered results own native binary32 storage, so their class is single; this is not a label over a double buffer.
Do NaN and infinity survive the cast?⌄
Yes. IEEE NaN, positive and negative infinity, and signed zero are retained subject to binary32 precision.
Can a prototype select output residency?⌄
In RunMat mode, single(X, "like", prototype) selects compatible host or GPU residency while output class remains single.
Related Math functions
Elementwise
abs · angle · besselj · bsxfun · complex · conj · double · eps · erf · erfcinv · exp · expm1 · flintmax · gamma · gammaln · heaviside · hypot · imag · int16 · int32 · int64 · int8 · intmax · intmin · ldivide · log · log10 · log1p · log2 · minus · nextpow2 · plus · pow2 · power · rdivide · real · realmax · realmin · realsqrt · rescale · sign · sqrt · times · typecast · uint16 · uint32 · uint64 · uint8
Optim
acceptancesa · annealingboltz · annealingfast · coneprog · crossoverarithmetic · crossoverheuristic · crossoverintermediate · crossoverlaplace · crossoverscattered · crossoversinglepoint · crossovertwopoint · eqnproblem · EquationProblem.solve · EquationProblem.subsasgn · EquationProblem.subsref · evaluate · fgoalattain · fitscalingprop · fitscalingrank · fitscalingshiftlinear · fitscalingtop · fminbnd · fmincon · fminimax · fminsearch · fminunc · fseminf · fsolve · fzero · ga · gacreationlinearfeasible · gacreationnonlinearfeasible · gacreationsobol · gacreationuniform · gacreationuniformint · gaplotbestf · gaplotbestindiv · gaplotdistance · gaplotexpectation · gaplotgenealogy · gaplotmaxconstr · gaplotrange · gaplotscorediversity · gaplotscores · gaplotselection · gaplotstopping · integerConstraint · integral · intlinprog · linprog · lsqcurvefit · lsqlin · LsqlinWarmStart.subsasgn · LsqlinWarmStart.subsref · lsqnonlin · lsqnonneg · mutationadaptfeasible · mutationgaussian · mutationpositivebasis · mutationpower · mutationuniform · optimexpr · optimget · OptimizationConstraint.evaluate · OptimizationConstraint.subsasgn · OptimizationConstraint.subsref · OptimizationExitflag.double · OptimizationExitflag.eq · OptimizationExitflag.ne · OptimizationExitflag.string · OptimizationExpression.acos · OptimizationExpression.acosh · OptimizationExpression.acot · OptimizationExpression.acoth · OptimizationExpression.acsc · OptimizationExpression.acsch · OptimizationExpression.asec · OptimizationExpression.asech · OptimizationExpression.asin · OptimizationExpression.asinh · OptimizationExpression.atan · OptimizationExpression.atanh · OptimizationExpression.cat · OptimizationExpression.cos · OptimizationExpression.cosh · OptimizationExpression.cot · OptimizationExpression.coth · OptimizationExpression.csc · OptimizationExpression.csch · OptimizationExpression.ctranspose · OptimizationExpression.cumprod · OptimizationExpression.cumsum · OptimizationExpression.diag · OptimizationExpression.diff · OptimizationExpression.dot · OptimizationExpression.eq · OptimizationExpression.evaluate · OptimizationExpression.exp · OptimizationExpression.ge · OptimizationExpression.horzcat · OptimizationExpression.ldivide · OptimizationExpression.le · OptimizationExpression.log · OptimizationExpression.mean · OptimizationExpression.minus · OptimizationExpression.mldivide · OptimizationExpression.mpower · OptimizationExpression.mrdivide · OptimizationExpression.mtimes · OptimizationExpression.norm · OptimizationExpression.plus · OptimizationExpression.power · OptimizationExpression.prod · OptimizationExpression.rdivide · OptimizationExpression.reshape · OptimizationExpression.sec · OptimizationExpression.sech · OptimizationExpression.sin · OptimizationExpression.sinh · OptimizationExpression.sqrt · OptimizationExpression.subsasgn · OptimizationExpression.subsref · OptimizationExpression.sum · OptimizationExpression.tan · OptimizationExpression.tanh · OptimizationExpression.times · OptimizationExpression.trace · OptimizationExpression.transpose · OptimizationExpression.uminus · OptimizationExpression.uplus · OptimizationExpression.vertcat · OptimizationExpression.zeros · OptimizationExpression.zerosLike · OptimizationProblem.solve · OptimizationProblem.subsasgn · OptimizationProblem.subsref · OptimizationVariable.subsasgn · OptimizationVariable.subsref · optimoptions · optimplotconstrviolation · optimplotfirstorderopt · optimplotfunccount · optimplotfval · optimplotfvalconstr · optimplotmilp · optimplotstepsize · optimplotx · optimproblem · optimset · optimvar · optimwarmstart · particleswarm · patternsearch · psplotbestf · psplotbestx · psplotfuncount · psplotmaxconstr · psplotmeshsize · pswcreationuniform · pswplotbestf · quad · quadprog · QuadprogWarmStart.subsasgn · QuadprogWarmStart.subsref · saplotbestf · saplotbestx · saplotf · saplotstopping · saplottemperature · saplotx · savemilpsolutions · secondordercone · selectionremainder · selectionroulette · selectionstochunif · selectiontournament · selectionuniform · simulannealbnd · solve · surrogateopt · surrogateoptplot · temperatureboltz · temperatureexp · temperaturefast
Trigonometry
acos · acosd · acosh · acotd · acscd · asecd · asin · asind · asinh · atan · atan2 · atan2d · atand · atanh · cos · cosd · cosh · cospi · deg2rad · pol2cart · rad2deg · sin · sind · sinh · sinpi · tan · tand · tanh
Reduction
all · any · bounds · cummax · cummin · cumprod · cumsum · cumtrapz · diff · gradient · max · maxk · mean · median · min · mink · movmax · movmean · movmedian · movmin · movprod · movstd · movsum · movvar · nnz · prod · rms · std · sum · trapz · var
Structure
bandwidth · isdiag · ishermitian · issymmetric · istril · istriu · symrcm
Signal
blackman · butter · buttord · cheb2ord · conv · conv2 · deconv · downsample · envelope · filter · filtfilt · fir1 · freqz · gauspuls · hamming · hann · hilbert · periodogram · pulstran · pwelch · rectpuls · resample · sawtooth · sinc · spectrogram · square · tripuls · unwrap · upsample · zplane
Factor
chol · decomposition · decomposition.ctranspose · decomposition.mldivide · decomposition.mrdivide · decomposition.mtimes · decomposition.rdivide · decomposition.subsref · decomposition.times · decomposition.uminus · decomposition.uplus · eig · eigs · gmres · ichol · ilu · lu · ordeig · ordqz · ordschur · pcg · qr · qz · rsf2csf · schur · svd
Ops
cross · ctranspose · dot · mldivide · mpower · mrdivide · mtimes · pagemtimes · pagetranspose · trace · transpose
Interpolation
griddedInterpolant · griddedInterpolant.subsref · interp1 · interp1q · interp2 · pchip · ppval · spline
Integer Division
Source you can read
Every RunMat function's source is public. Read exactly how single is executed, line by line, in Rust.
- View the source for single 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.