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
    • eq
    • ge
    • gt
    • isequal
    • isequaln
    • le
    • lt
    • ne

eq — Compare values for element-wise equality.

eq(A,B) and A == B compare compatible operands element by element or construct symbolic equations.

Syntax

tf = eq(A, B)

Inputs

A
Type
Any
Required
Yes
Description
Left operand.
B
Type
Any
Required
Yes
Description
Right operand.
NameTypeRequiredDefaultDescription
AAnyYes—Left operand.
BAnyYes—Right operand.

Returns

tf
Type
LogicalArray
Description
Logical equality result, or a symbolic equation for symbolic operands.
NameTypeDescription
tfLogicalArrayLogical equality result, or a symbolic equation for symbolic operands.

Errors

RunMat:eq:InvalidInput
When
Operands contain unsupported types or mix numeric and text domains.
Message
eq: mixing numeric and string inputs is not supported
RunMat:eq:SizeMismatch
When
Operands are not broadcast-compatible.
Message
eq: array sizes are not compatible for broadcasting
RunMat:gpu:ProviderOwnershipMismatch
When
Resident operands do not have one exact owning provider.
Message
eq: resident operands must have one exact owning provider
RunMat:eq:GpuUploadFailed
When
An explicitly resident logical result cannot be restored to its provider.
Message
eq: failed to preserve explicit gpuArray residency
IdentifierWhenMessage
RunMat:eq:InvalidInputOperands contain unsupported types or mix numeric and text domains.eq: mixing numeric and string inputs is not supported
RunMat:eq:SizeMismatchOperands are not broadcast-compatible.eq: array sizes are not compatible for broadcasting
RunMat:gpu:ProviderOwnershipMismatchResident operands do not have one exact owning provider.eq: resident operands must have one exact owning provider
RunMat:eq:GpuUploadFailedAn explicitly resident logical result cannot be restored to its provider.eq: failed to preserve explicit gpuArray residency

Comparison semantics

eq(A,B) and A == B compare corresponding elements after implicit expansion. Numeric, logical, character, string, categorical, complex, and supported object operands follow their domain comparison rules. Complex values are equal only when both components match; NaN is unequal to itself.

All eight fixed-width integer classes compare without first converting authoritative values to double. Character data compares by code point against numeric data and as text against string data. Handle-like values compare by runtime identity rather than structural content.

Symbolic and accelerated execution

A symbolic operand produces a symbolic equation with the broadcast result shape. Ordinary nonsymbolic operands produce logical values.

Compatible resident operands use the exact provider's equality operation when available. Validated results remain resident; unsupported routes use the exact host comparison and restore explicitly requested residency. Compatible elementwise expressions may fuse.

Examples

Compare scalars

tf = eq(42, 42)

Expected output:

tf = true

Compare arrays element by element

A = [1 2 3 4];
B = [1 0 3 5];
tf = eq(A, B)

Expected output:

tf = [true false true false]

Use implicit expansion

A = [1; 2];
B = [1 2 3];
tf = eq(A, B)

Expected output:

tf = [true false false; false true false]

Compare both complex components

tf = eq([1+2i 1+3i], 1+2i)

Expected output:

tf = [true false]

Compare character code points

tf = eq(['A' 'B' 'C'], 65)

Expected output:

tf = [true false false]

Compare string values

names = ["alice" "bob" "alice"];
tf = eq(names, "alice")

Expected output:

tf = [true false true]

Construct a symbolic equation

syms Y(X)
condition = eq(Y(0), 0)

Expected output:

condition = Y(0) == 0

Keep an equality result resident

A = gpuArray([1 2 3]);
B = gpuArray([1 0 3]);
gtf = eq(A, B);
tf = gather(gtf)

Expected output:

gtf remains a gpuArray and tf = [true false true]

Using eq with coding agents

Open a RunMat example with live inputs, then ask the agent to explain how eq changes the result.

Run a small eq example, explain the result, then change one input and compare the output.

FAQ

What class does eq return?⌄

Nonsymbolic comparisons return logical values. Symbolic operands construct symbolic equations.

How does eq compare NaN?⌄

NaN == NaN is false.

How are complex values compared?⌄

Both real and imaginary components must match.

How are handles compared?⌄

Handle-like values compare by identity.

Does implicit expansion apply to strings?⌄

Yes. Compatible string-array shapes expand in the same way as other elementwise comparisons.

Are wide integers rounded?⌄

No. Mixed integer comparisons retain exact fixed-width values.

Does a GPU comparison gather?⌄

A supported same-owner operation stays resident. Exact fallback restores explicitly requested residency.

Related Logical functions

Rel

ge · gt · isequal · isequaln · le · lt · ne

Tests

allfinite · iscell · iscellstr · isfinite · isgpuarray · isinf · islogical · isnan · isnumeric · isreal · issparse · isstruct

Bit

and · not · or · xor

Logical

logical

Source you can read

Every RunMat function's source is public. Read exactly how eq is executed, line by line, in Rust.

  • View the source for eq 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
  • Comparison semantics
  • Symbolic and accelerated execution
  • Examples
  • Compare scalars
  • Compare arrays element by element
  • Use implicit expansion
  • Compare both complex components
  • Compare character code points
  • Compare string values
  • Construct a symbolic equation
  • Keep an equality result resident
  • Using eq with coding agents
  • FAQ
  • Related Logical functions
  • Rel
  • Tests
  • Bit
  • Logical
  • Source you can read
  • About RunMat