Performance Testing Framework

Measure performance of MATLAB^®code

You can use the MATLAB performance testing framework to measure the performance of your MATLAB code. The framework includes performance measurement-oriented features such as running your code several times to warm it up and accounting for noise in the measurements.

The performance test interface leverages the script, function, and class-based unit testing interfaces. Therefore, you can perform qualifications within your performance tests to ensure correct functional behavior while measuring code performance. Also, you can run your performance tests as standard regression tests to ensure that code changes do not break performance tests.

To get started, seeOverview of Performance Testing Framework.

Functions

`runperf`	Run set of tests for performance measurement
`testsuite`	Create suite of tests

Classes

`matlab.perftest.TimeExperiment`	Interface for measuring execution time of code under test
`matlab.perftest.FixedTimeExperiment`	`TimeExperiment`that collects fixed number of measurements
`matlab.perftest.FrequentistTimeExperiment`	`TimeExperiment`that collects variable number of measurements
`matlab.perftest.TestCase`	Superclass of`matlab.perftest`performance test classes
`matlab.perftest.TimeResult`	Result from running time experiment
`matlab.unittest.measurement.DefaultMeasurementResult`	Default implementation of`MeasurementResult`class
`matlab.unittest.measurement.MeasurementResult`	Base class for classes holding measurement results
`matlab.unittest.measurement.chart.ComparisonPlot`	Visually compare two sets of time experiment results

Topics

Overview of Performance Testing Framework
The performance test interface leverages the unit testing interfaces. Perform qualifications within your performance tests to ensure correct functional behavior while measuring code performance. Run your performance tests as standard regression tests to ensure that code changes do not break performance tests.
Test Performance Using Scripts or Functions
This example shows how to create a script or function-based performance test.
Test Performance Using Classes
This example shows how to create a class-based performance test and regression test.
Measure Fast Executing Test Code
To automatically loop through fast test code, use thematlab.perftest.TestCase.keepMeasuringmethod.

Related Information

Performance and Memory