log — Compute elementwise natural logarithms for real and complex values.
Y = log(X) computes the natural logarithm of each element, including principal-branch complex promotion and typed RunMat extensions for integer, logical, and character input.
Syntax
Y = log(X)Inputs
X- Type
Any- Required
- Yes
- Description
- Single or double real/complex input or a supported table; integer, logical, and character forms are RunMat-only extensions.
Returns
Y- Type
NumericArray- Description
- Elementwise natural-log result, promoted to complex for negative real input.
Errors
RunMat:log:InvalidInput- When
- Input cannot be interpreted as supported numeric, logical, character, or table data.
- Message
log: invalid input
RunMat:log:Internal- When
- Internal tensor construction, table mapping, or provider interaction fails.
- Message
log: internal error
RunMat:log:TooManyOutputs- When
- More than one output is requested.
- Message
log: too many output arguments
Behavior
Y = log(X) computes the natural logarithm elementwise and preserves the input shape. Real and complex single inputs return single; real and complex double inputs return double.
Zero maps to negative infinity. Negative real values promote to principal-branch complex results, and complex values use log(z) = log(abs(z)) + i*angle(z).
Tables and timetables are mapped variable by variable when each variable supports log.
Fixed-width integer, logical, and character inputs are separate RunMat extensions. They return double or complex double, and MATLAB compatibility mode rejects each extension with its structured compatibility error.
Integer extension inputs must lie in the inclusive exact binary64 interval [-2^53, 2^53]; RunMat rejects a wider value before conversion.
GPU execution
RunMat resolves the exact provider that owns a resident input. Supported real values can stay resident through provider minimum-reduction and unary-log operations. Every returned handle is validated for non-aliasing, shape, device, owner, storage, and precision.
Complex input, real-to-complex promotion, and typed unsupported operations gather through that owner and restore the result when the provider can represent its class and precision. Other provider failures remain errors. Explicit real gpuArray input that requires complex promotion is available only in RunMat compatibility mode.
log is not fused until fused execution can retain its complex-domain behavior.
Examples
Preserve single precision and array pages
input = reshape(single([1 exp(1)]), [1 1 2]);
result = log(input);Take the natural logarithm of a positive scalar
y = log(exp(3))Expected output:
y = 3Evaluate the logarithm at zero
value = log(0)Expected output:
value = -InfPromote negative real values to complex results
data = [-1 -2 -4];
result = log(data)Expected output:
result = [0.0000 + 3.1416i 0.6931 + 3.1416i 1.3863 + 3.1416i]Apply the logarithm to complex values
z = [1+2i -1+pi*i];
w = log(z)Expected output:
w = [0.8047 + 1.1071i 1.1920 + 1.8780i]Apply the natural logarithm to provider-resident data
G = gpuArray([1 2; 4 8]);
out = log(G);
result = gather(out)Expected output:
result = [0.0000 0.6931; 1.3863 2.0794]Use character code points in RunMat mode
C = 'ABC';
values = log(C)Expected output:
values = [4.1744 4.1897 4.2047]Using log with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how log changes the result.
Run a small log example, explain the result, then change one input and compare the output.
FAQ
When should I use log?⌄
Use log for natural logarithms, including exponential-growth linearization, likelihood calculations, and transformations from multiplicative to additive relationships.
What happens when the input contains zero?⌄
log(0) returns negative infinity. Arrays apply the same rule elementwise.
How are negative real values handled?⌄
Negative real values promote to principal-branch complex results: log(-x) is log(x) + i*pi for positive x.
What if floating-point noise produces a small negative value?⌄
Any negative real value, including a small rounding residual, promotes to a complex result. Clamp or transform the data explicitly when the application requires a real-only result.
How does GPU execution produce complex output?⌄
A real provider hook cannot create a complex result. RunMat gathers through the exact owner, computes on the host, and restores the result when that provider represents the required complex class. MATLAB compatibility mode rejects complex promotion from explicit real gpuArray input.
Does log accept complex input directly?⌄
Yes. Complex scalars and arrays use magnitude and phase on the principal branch.
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 · 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 log is executed, line by line, in Rust.
- View the source for log 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.