hypot — Compute a stable element-wise Euclidean norm.
hypot combines two real or complex floating magnitudes without avoidable intermediate overflow or underflow, applies implicit expansion, and preserves supported execution residency.
Syntax
C = hypot(A, B)Inputs
A- Type
Any- Required
- Yes
- Description
- Single, double, or complex-floating first component; integer, logical, and character forms are RunMat extensions.
B- Type
Any- Required
- Yes
- Description
- Second component with a size compatible for implicit expansion.
Returns
C- Type
NumericArray- Description
- Nonnegative element-wise Euclidean norm with the broadcasted input shape.
Errors
RunMat:hypot:InvalidInput- When
- An operand cannot be converted to a supported numeric representation.
- Message
hypot: invalid input
RunMat:hypot:SizeMismatch- When
- Operands are not broadcast-compatible.
- Message
hypot: size mismatch
RunMat:hypot:Internal- When
- Internal conversion, allocation, provider execution, or residency restoration fails.
- Message
hypot: internal error
RunMat:hypot:TooManyOutputs- When
- More than one output is requested.
- Message
hypot: too many output arguments
Stable element-wise norms
hypot(A, B) computes sqrt(abs(A).^2 + abs(B).^2) element by element with a scaled algorithm that avoids avoidable overflow and underflow. Results are nonnegative. A NaN operand produces NaN even when the other operand is infinite, matching MATLAB's documented behavior.
Complex floating operands contribute their magnitudes. This is equivalent to combining the real Euclidean magnitudes without first forming potentially overflowing squares.
Classes and shapes
Documented inputs are single or double arrays, including complex values. Inputs use MATLAB-style implicit expansion. Two single operands return single; any other documented combination returns double. The result is always real and has the broadcasted shape. Sparse input is not currently supported.
RunMat mode also accepts all eight real fixed-width integer classes, logical arrays, and character arrays. Integer values must be exactly representable at the binary64 calculation boundary; logical values contribute zero or one and characters contribute their Unicode code points. These forms are rejected in MATLAB compatibility mode.
Accelerated, fused, and distributed execution
Shape-matched real floating operands owned by one provider can use its direct elem_hypot operation. RunMat validates the returned shape, real storage, precision, owner, device, and non-aliasing before accepting it. Only a typed unsupported result enters host fallback; provider and contract failures remain visible.
Broadcasting, complex values, mixed physical types, and admitted integer or logical storage gather through the exact owner, use the canonical host calculation, and restore the result when the owner supports its physical precision. Real floating expressions may also participate in element-wise fusion.
Distributed inputs currently use the declared materialization path before the same operation is applied. This avoids claiming partition-local behavior that is not yet provided by the execution service.
Examples
Find a triangle hypotenuse
C = hypot(3, 4)Expected output:
C = 5Expand a scalar across a vector
A = [-3 0 3];
C = hypot(A, 4)Expected output:
C = [5 4 5]Combine complex magnitudes
A = [1+2i 3-4i];
B = [2-1i -1+1i];
C = hypot(A, B)Expected output:
C = [3.1623 5.1962]Avoid intermediate overflow
C = hypot(1e308, 1e308)Expected output:
C = 1.4142e+308Retain all-single precision
C = hypot(single([3 5]), single([4 12]))Expected output:
C = single([5 13])Use a character code point in RunMat mode
C = hypot('A', 0)Expected output:
C = 65Keep matching operands resident
Ga = gpuArray([3 5; 8 7]);
Gb = gpuArray([4 12; 15 24]);
Gc = hypot(Ga, Gb);
C = gather(Gc)Expected output:
C = [5 13; 17 25]Using hypot with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how hypot changes the result.
Run a small hypot example, explain the result, then change one input and compare the output.
FAQ
Why use hypot instead of writing the square-root formula?⌄
The scaled implementation avoids intermediate overflow and underflow that can occur while squaring the operands.
Does hypot accept complex input?⌄
Yes. Each complex operand contributes its magnitude, and the result is real and nonnegative.
What happens for NaN and Inf?⌄
A NaN operand produces NaN, including a NaN paired with positive or negative infinity. Otherwise an infinite magnitude produces infinity.
How does implicit expansion work?⌄
Singleton dimensions expand to match the other operand. Incompatible non-singleton dimensions produce a size-mismatch error.
What class does hypot return?⌄
Two single operands return single. Other supported combinations return double; RunMat integer, logical, and character extensions also return double.
Can the result remain provider-resident?⌄
Yes. A valid direct result remains resident, while unsupported forms gather through the exact owner and restore when the result precision is supported.
How can I combine three components?⌄
Nest the operation, for example hypot(x, hypot(y, z)), to retain the stable pairwise calculation.
Related Math functions
Elementwise
abs · angle · besselj · bsxfun · complex · conj · double · eps · erf · erfcinv · exp · expm1 · flintmax · gamma · gammaln · heaviside · 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 hypot is executed, line by line, in Rust.
- View the source for hypot 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.