RunMat
  • Pricing
RunMat
GitHub
GitHub
Sign inTry in browser
DesktopRuntimePhysicsCADAdministrationAgent

Get RunMat updates

New releases, guides and examples.

Product+
  • Runtime
  • GPU
  • Parallel
  • Compile
  • Interop and MEX
  • Simulation
  • MCAD
  • ECAD
  • Enterprise
  • AI integrations
  • Pricing
  • Download
Math+
  • Signal processing
  • Linear algebra
  • Statistics
  • Curve fitting
  • Differential equations
  • Control systems
  • Optimization
  • Finance
  • Data and tables
  • Plotting
Physics+
  • Simulation overview
  • Structural
  • Thermal
  • Electromagnetic
  • Joule heating
  • Thermal stress
  • Acoustics
  • Fluid flow
  • Conjugate heat transfer
  • Fluid–structure
  • What is FEA
Industries+
  • Aerospace
  • Automotive and transportation
  • Defense
  • Electronics and semiconductors
  • Energy
  • Industrial machinery
  • Life sciences
  • Quantitative finance
Learn+
  • Guides
  • Docs
  • Function reference
  • Language reference
  • Migration guide
  • Changelog
  • MATLAB Online
  • MATLAB AI agent
  • For students
Compare+
  • RunMat vs MATLAB
  • RunMat vs Ansys
  • RunMat vs SOLIDWORKS
  • RunMat vs Altium
  • RunMat vs Cadence
  • RunMat vs COMSOL
  • RunMat vs Python
  • RunMat vs Julia
  • RunMat vs Physics AI
  • RunMat vs Octave
  • Benchmarks
  • MATLAB alternatives
  • All comparisons
Company+
  • About
  • Blog
  • Contact
  • Source code↗
  • License
  • Privacy
  • Terms

Product

  • Runtime
  • GPU
  • Parallel
  • Compile
  • Interop and MEX
  • Simulation
  • MCAD
  • ECAD
  • Enterprise
  • AI integrations
  • Pricing
  • Download

Math

  • Signal processing
  • Linear algebra
  • Statistics
  • Curve fitting
  • Differential equations
  • Control systems
  • Optimization
  • Finance
  • Data and tables
  • Plotting

Physics

  • Simulation overview
  • Structural
  • Thermal
  • Electromagnetic
  • Joule heating
  • Thermal stress
  • Acoustics
  • Fluid flow
  • Conjugate heat transfer
  • Fluid–structure
  • What is FEA

Industries

  • Aerospace
  • Automotive and transportation
  • Defense
  • Electronics and semiconductors
  • Energy
  • Industrial machinery
  • Life sciences
  • Quantitative finance

Learn

  • Guides
  • Docs
  • Function reference
  • Language reference
  • Migration guide
  • Changelog
  • MATLAB Online
  • MATLAB AI agent
  • For students

Compare

  • RunMat vs MATLAB
  • RunMat vs Ansys
  • RunMat vs SOLIDWORKS
  • RunMat vs Altium
  • RunMat vs Cadence
  • RunMat vs COMSOL
  • RunMat vs Python
  • RunMat vs Julia
  • RunMat vs Physics AI
  • RunMat vs Octave
  • Benchmarks
  • MATLAB alternatives
  • All comparisons

Company

  • About
  • Blog
  • Contact
  • Source code↗
  • License
  • Privacy
  • Terms
GitHubXLinkedIn

© Dystr, Inc. · RunMat v0.7.1, Nov 17, 2026

RunMat® is a registered trademark of Dystr, Inc. MATLAB® is a registered trademark of The MathWorks, Inc. RunMat is not affiliated with, endorsed by, or sponsored by The MathWorks, Inc.

/
See all docs
Builtin Reference
    • 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
    • single
    • sqrt
    • times
    • typecast
    • uint16
    • uint32
    • uint64
    • uint8

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.
NameTypeRequiredDefaultDescription
AAnyYes—Single, double, or complex-floating first component; integer, logical, and character forms are RunMat extensions.
BAnyYes—Second component with a size compatible for implicit expansion.

Returns

C
Type
NumericArray
Description
Nonnegative element-wise Euclidean norm with the broadcasted input shape.
NameTypeDescription
CNumericArrayNonnegative 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
IdentifierWhenMessage
RunMat:hypot:InvalidInputAn operand cannot be converted to a supported numeric representation.hypot: invalid input
RunMat:hypot:SizeMismatchOperands are not broadcast-compatible.hypot: size mismatch
RunMat:hypot:InternalInternal conversion, allocation, provider execution, or residency restoration fails.hypot: internal error
RunMat:hypot:TooManyOutputsMore than one output is requested.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 = 5

Expand 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+308

Retain 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 = 65

Keep 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

Bitwise

bitand · bitcmp · bitget · bitor · bitset · bitshift · bitxor · swapbytes

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

Rounding

ceil · fix · floor · mod · rem · round

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

Solve

cond · det · inv · linsolve · norm · null · pinv · rank · rcond · rref · vecnorm

Ops

cross · ctranspose · dot · mldivide · mpower · mrdivide · mtimes · pagemtimes · pagetranspose · trace · transpose

Symbolic

digits · int · limit · piecewise · sym · syms · vpa

Discrete

factor · factorial · gcd · isprime · lcm · primes

Fft

fft · fft2 · fftn · fftshift · ifft · ifft2 · ifftn · ifftshift

Interpolation

griddedInterpolant · griddedInterpolant.subsref · interp1 · interp1q · interp2 · pchip · ppval · spline

Integer Division

idivide

Ode

ode15s · ode23 · ode45 · odeset

Poly

poly · polyder · polyfit · polyint · polyval · roots

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.

Getting started · Benchmarks · Pricing

Download RunMat

Download RunMat for full performance, or use RunMat in your browser for zero setup.

Download RunMatOpen Sandbox
On this page
  • Syntax
  • Inputs
  • Returns
  • Errors
  • Stable element-wise norms
  • Classes and shapes
  • Accelerated, fused, and distributed execution
  • Examples
  • Find a triangle hypotenuse
  • Expand a scalar across a vector
  • Combine complex magnitudes
  • Avoid intermediate overflow
  • Retain all-single precision
  • Use a character code point in RunMat mode
  • Keep matching operands resident
  • Using hypot with coding agents
  • FAQ
  • Related Math functions
  • Elementwise
  • Optim
  • Trigonometry
  • Reduction
  • Structure
  • Bitwise
  • Signal
  • Rounding
  • Factor
  • Solve
  • Ops
  • Symbolic
  • Discrete
  • Fft
  • Interpolation
  • Integer Division
  • Ode
  • Poly
  • Source you can read
  • About RunMat