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
    • matlab.unittest.TestCase.assertEqual
    • matlab.unittest.TestCase.assertThat
    • matlab.unittest.TestCase.assertTrue
    • matlab.unittest.TestCase.assumeEqual
    • matlab.unittest.TestCase.assumeTrue
    • matlab.unittest.TestCase.fatalAssertTrue
    • matlab.unittest.TestCase.verifyEmpty
    • matlab.unittest.TestCase.verifyEqual
    • matlab.unittest.TestCase.verifyFalse
    • matlab.unittest.TestCase.verifyGreaterThan
    • matlab.unittest.TestCase.verifyLessThan
    • matlab.unittest.TestCase.verifyNotEmpty
    • matlab.unittest.TestCase.verifyNotEqual
    • matlab.unittest.TestCase.verifyThat
    • matlab.unittest.TestCase.verifyTrue

matlab.unittest.TestCase.assertThat — Assert that a value satisfies a supported constraint.

assertThat(testCase, actual, constraint) evaluates a supported Constraint object and aborts the active test if it is not satisfied.

Syntax

assertThat(testCase, actual, constraint, diagnostic...)

Inputs

testCase
Type
Any
Required
Yes
Default
—
Description
A TestCase object or subclass.
actual
Type
Any
Required
Yes
Default
—
Description
Value being qualified.
constraint
Type
Any
Required
Yes
Default
—
Description
A compatible matlab.unittest.constraints.Constraint object.
diagnostic
Type
Any
Required
Variadic
Default
—
Description
Optional diagnostics; the first scalar text or Diagnostic message replaces the default failure text.
NameTypeRequiredDefaultDescription
testCaseAnyYes—A TestCase object or subclass.
actualAnyYes—Value being qualified.
constraintAnyYes—A compatible matlab.unittest.constraints.Constraint object.
diagnosticAnyVariadic—Optional diagnostics; the first scalar text or Diagnostic message replaces the default failure text.

Returns

result
Type
Any
Description
Empty double matrix on success; failures stop or filter the current test.
NameTypeDescription
resultAnyEmpty double matrix on success; failures stop or filter the current test.

Errors

RunMat:Testing:InvalidTestCase
When
The receiver is not a TestCase object or subclass.
Message
first argument must be a matlab.unittest.TestCase
RunMat:Testing:InvalidConstraint
When
assertThat receives a value that is not a compatible Constraint object.
Message
expected a matlab.unittest.constraints.Constraint
RunMat:Testing:UnsupportedConstraint
When
assertThat receives a compatible Constraint subclass without a supported satisfaction hook.
Message
constraint requires an unsupported custom satisfaction hook
RunMat:Test:AssertionFailed
When
An assertion fails; the active test is aborted after diagnostic recording, or an error is returned outside a test.
Message
assertion failed
IdentifierWhenMessage
RunMat:Testing:InvalidTestCaseThe receiver is not a TestCase object or subclass.first argument must be a matlab.unittest.TestCase
RunMat:Testing:InvalidConstraintassertThat receives a value that is not a compatible Constraint object.expected a matlab.unittest.constraints.Constraint
RunMat:Testing:UnsupportedConstraintassertThat receives a compatible Constraint subclass without a supported satisfaction hook.constraint requires an unsupported custom satisfaction hook
RunMat:Test:AssertionFailedAn assertion fails; the active test is aborted after diagnostic recording, or an error is returned outside a test.assertion failed

Supported constraints

RunMat currently evaluates IsEqualTo, IsTrue, and IsFalse. Compatible custom Constraint subclasses without a supported satisfaction hook return RunMat:Testing:UnsupportedConstraint; non-constraints return RunMat:Testing:InvalidConstraint. IsEqualTo uses the current RunMat constraint comparator and is not a claim of complete MATLAB comparator parity.

Result and diagnostics

A passing call returns an empty double matrix. A failed assertion records a diagnostic and aborts the active test. Only the first supported optional diagnostic supplies a custom message.

Examples

Assert a built-in constraint

testCase = matlab.unittest.TestCase();
constraint = matlab.unittest.constraints.IsTrue();
result = assertThat(testCase, true, constraint);

Reject a non-constraint value

testCase = matlab.unittest.TestCase();
assertThat(testCase, true, 1);

Using matlab.unittest.TestCase.assertThat with coding agents

Open a RunMat example with live inputs, then ask the agent to explain how matlab.unittest.TestCase.assertThat changes the result.

Run a small matlab.unittest.TestCase.assertThat example, explain the result, then change one input and compare the output.

Related Testing functions

Qualifications

matlab.unittest.TestCase.assertEqual · matlab.unittest.TestCase.assertTrue · matlab.unittest.TestCase.assumeEqual · matlab.unittest.TestCase.assumeTrue · matlab.unittest.TestCase.fatalAssertTrue · matlab.unittest.TestCase.verifyEmpty · matlab.unittest.TestCase.verifyEqual · matlab.unittest.TestCase.verifyFalse · matlab.unittest.TestCase.verifyGreaterThan · matlab.unittest.TestCase.verifyLessThan · matlab.unittest.TestCase.verifyNotEmpty · matlab.unittest.TestCase.verifyNotEqual · matlab.unittest.TestCase.verifyThat · matlab.unittest.TestCase.verifyTrue

Testing

functiontests · matlab.unittest.TestCase · matlab.unittest.TestRunner.addPlugin · matlab.unittest.TestRunner.run · matlab.unittest.TestRunner.withTextOutput · testsuite

Constraints

matlab.unittest.constraints.IsEqualTo · matlab.unittest.constraints.IsFalse · matlab.unittest.constraints.IsTrue

Diagnostics

matlab.unittest.diagnostics.StringDiagnostic · matlab.unittest.TestCase.log

Fixtures

matlab.unittest.fixtures.PathFixture · matlab.unittest.fixtures.TemporaryFolderFixture · matlab.unittest.TestCase.addTeardown · matlab.unittest.TestCase.applyFixture

Plugins

matlab.unittest.plugins.CodeCoveragePlugin.forFolder · matlab.unittest.plugins.TestRunnerPlugin

Source you can read

Every RunMat function's source is public. Read exactly how matlab.unittest.TestCase.assertThat is executed, line by line, in Rust.

  • View the source for matlab.unittest.TestCase.assertThat 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
  • Supported constraints
  • Result and diagnostics
  • Examples
  • Assert a built-in constraint
  • Reject a non-constraint value
  • Using matlab.unittest.TestCase.assertThat with coding agents
  • Related Testing functions
  • Qualifications
  • Testing
  • Constraints
  • Diagnostics
  • Fixtures
  • Plugins
  • Source you can read
  • About RunMat