double — Convert supported values to double-precision storage.
double(X) converts supported scalars and arrays to IEEE binary64 while preserving shape and documented storage, domain, and residency behavior.
Syntax
Y = double(X)
Y = double(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
- Double-precision output value.
Errors
RunMat:double:InvalidArgument- When
- Optional arguments are malformed or unsupported, or more than one output is requested.
- Message
double: invalid argument
RunMat:double:InvalidInput- When
- Input value or prototype cannot be converted to double.
- Message
double: invalid input
RunMat:double:GpuUnsupported- When
- GPU output via "like" is requested but no compatible binary64 storage provider is active.
- Message
double: gpu output not supported
RunMat:double:Internal- When
- Internal conversion, gather, or provider upload failed.
- Message
double: internal error
Behavior
Y = double(X) converts supported values to IEEE binary64 while preserving shape. Real and complex numeric input retains its real or complex domain; logical values become zero or one; characters become Unicode code points.
All eight fixed-width integer classes convert from authoritative native storage. Binary64 cannot represent every int64 or uint64 value exactly, so values outside its consecutive-integer range may round.
String scalars and arrays are parsed elementwise after trimming whitespace; text that is not one numeric value produces NaN. Sparse input retains CSC structure with double stored values. Unsupported cells, structs, objects, handles, and foreign values return a typed conversion error.
double(X, "like", prototype) is a RunMat extension that keeps the output class fixed as double while selecting host or compatible provider residency from the prototype.
GPU execution
A provider with true binary64 conversion support keeps real or complex input on its owning device. The result is a new double-precision handle with the original shape.
If the owner cannot produce binary64, RunMat gathers through that exact owner and returns authoritative host storage. A GPU "like" prototype requires a live compatible owner; RunMat does not silently substitute a different provider or a lower-precision buffer.
Examples
Preserve character matrix order
codes = double(['ab'; 'cd']);Convert integers to double precision
ints = int32([1 2 3]);
doubles = double(ints)Expected output:
doubles = [1 2 3]Promote a logical mask for arithmetic
mask = logical([0 1 0 1]);
weights = double(mask)Expected output:
weights = [0 1 0 1]Convert characters to Unicode code points
codes = double('RunMat')Expected output:
codes = [82 117 110 77 97 116]Preserve complex values while promoting precision
z = [1+2i 3-4i];
result = double(z)Expected output:
result = [1+2i 3-4i]Convert provider-resident single data to double
G = single(gpuArray([1 2; 3 4]));
H = double(G);
host = gather(H)Expected output:
host = [1 2; 3 4]Preserve sparse structure while converting values
S = sparse([1 3], [1 2], [4 -1], 3, 2);
A = double(S)Expected output:
A is a 3-by-2 double sparse matrix with two stored valuesSelect host output residency with a prototype
prototype = single(0);
out = double([pi 0], "like", prototype)Expected output:
out = [3.1416 0]Promote a matrix without changing shape
A = single([1.5 2.25; 3.75 4.5]);
B = double(A)Expected output:
B = [1.5 2.25; 3.75 4.5]Using double with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how double changes the result.
Run a small double example, explain the result, then change one input and compare the output.
FAQ
Does double change values already stored as double?⌄
No numeric conversion is required, although ordinary value ownership rules still apply.
How are logical inputs handled?⌄
Logical false and true become double zero and one.
What happens to NaN or infinity?⌄
IEEE NaN, positive and negative infinity, and signed zero are preserved.
Can double convert strings?⌄
Yes. Each string element is parsed as one numeric value; invalid text produces NaN. Character arrays instead become Unicode code points.
What happens to sparse input?⌄
CSC structure is retained and each stored value is converted to double.
Will double keep results on the GPU?⌄
Yes when the owning provider supports true binary64 output. Otherwise ordinary conversion gathers to host through the exact owner.
Does double allocate new memory?⌄
Conversion produces authoritative double storage. Fusion may eliminate a safe intermediate.
Can I request GPU residency with "like"?⌄
In RunMat mode, double(X, "like", prototype) selects compatible host or GPU residency while the output class remains double.
How does double handle complex input?⌄
Both components are retained and converted to double precision.
Related Math functions
Elementwise
abs · angle · besselj · bsxfun · complex · conj · 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 · single · 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 double is executed, line by line, in Rust.
- View the source for double 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.