exp — Compute elementwise natural exponentials for real and complex values.
Y = exp(X) raises e to every element of a real or complex array. It preserves documented floating-point precision, handles complex values directly, and uses typed RunMat extensions for integer, logical, and character input.
Syntax
Y = exp(X)Inputs
X- Type
Any- Required
- Yes
- Description
- Single or double real/complex input; integer, logical, and character forms are RunMat-only extensions.
Returns
Y- Type
NumericArray- Description
- Elementwise exponential result.
Errors
RunMat:exp:InvalidInput- When
- Input cannot be interpreted as numeric, logical, char, or complex data.
- Message
exp: invalid input
RunMat:exp:Internal- When
- Internal tensor construction or provider interaction failed.
- Message
exp: internal error
Behavior
Y = exp(X) raises e to each element of X while preserving the shape. Real and complex single inputs return single; real and complex double inputs return double.
Complex values use the principal exponential identity exp(a + bi) = exp(a) * (cos(b) + i sin(b)).
Sparse floating-point input becomes dense because every implicit zero maps to one. Table and timetable input is mapped variable by variable only when each variable supports exp.
Fixed-width integer, logical, and character inputs are separate RunMat extensions. They produce double output and MATLAB compatibility mode rejects each extension with its corresponding structured compatibility error.
Integer extension inputs must lie in the inclusive interval [-2^53, 2^53]. RunMat rejects a wider integer before conversion rather than silently rounding it at the binary64 boundary.
GPU execution
Real floating-point tensors can remain on the owning provider through its unary exponential operation. Complex values and providers that explicitly report an unsupported operation use an owner-aware host fallback; other provider failures remain errors.
A host fallback restores the result to the original provider only when that provider supports the result precision. Explicit gpuArray and gather calls remain available when placement is part of the program.
Examples
Calculate the exponential of a scalar
y = exp(1)Expected output:
y = 2.7183Apply the exponential to a vector of growth rates
rates = [-1 -0.5 0 0.5 1];
factor = exp(rates)Expected output:
factor = [0.3679 0.6065 1 1.6487 2.7183]Exponentiate every element of a matrix
A = [0 1 2; 3 4 5];
B = exp(A)Expected output:
B = [1.0000 2.7183 7.3891; 20.0855 54.5982 148.4132]Compute exponentials of complex values
z = [1+2i, -1+pi*i];
w = exp(z)Expected output:
w = [-1.1312 + 2.4717i, -0.3679 + 0.0000i]Apply the exponential to provider-resident data
G = gpuArray([0 1; 2 3]);
out = exp(G);
result = gather(out)Expected output:
result = [1.0000 2.7183; 7.3891 20.0855]Exponentiate character code points in RunMat mode
C = 'ABC';
Y = exp(C)Expected output:
Y = [1.6949e+28 4.6072e+28 1.2524e+29]Using exp with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how exp changes the result.
Run a small exp example, explain the result, then change one input and compare the output.
FAQ
When should I use exp?⌄
Use exp for the natural exponential of a scalar or array, including growth, continuous compounding, and exponential model terms.
Does exp preserve shape?⌄
Yes. The result has the same shape as the input.
How are logical arrays handled?⌄
Logical arrays convert to double only in RunMat compatibility mode. MATLAB compatibility mode rejects that extension.
What happens with complex input?⌄
Complex scalars and arrays use the principal complex exponential and retain their floating-point precision.
What happens when a provider lacks its exponential operation?⌄
RunMat gathers through the owning provider and computes the same result on the host. It restores the result only when the provider supports the required precision.
Which precision does exp return?⌄
Single input returns single and double input returns double. Integer, logical, and character extension forms return double.
Related Math functions
Elementwise
abs · angle · besselj · bsxfun · complex · conj · double · eps · erf · erfcinv · 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 exp is executed, line by line, in Rust.
- View the source for exp 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.