matlab.perftest.FrequentistTimeExperiment 类

包： matlab.perftest
超类： matlab.perftest.TimeExperiment

TimeExperiment，用于收集不定数量的测量值

全页展开

描述

FrequentistTimeExperiment 是 TimeExperiment 类的子类，该类用于收集不定数量的测量值。测试框架会采集不定数量的测量值，以达到指定置信水平的指定相对误差界限。

要创建 FrequentistTimeExperiment 实例，请使用 matlab.perftest.TimeExperiment.limitingSamplingError 静态方法。

属性

全部展开

`NumWarmups` — 预备测量值的数量
5 （默认） | 非负整数

预备测量值的数量，指定为非负整数。NumWarmups 定义框架运行测试代码进行预备的次数。

`MinSamples` — 最小样本数
4 （默认） | 大于 1 的整数

最小样本测量值数，指定为大于 1 的整数。MinSamples 定义框架在 NumWarmups 之后运行测试代码的最小次数。该框架至少将测试代码执行 MinSamples 次，而不管试验是否满足统计目标。

`MaxSamples` — 最大样本数
256 （默认） | 大于或等于 `MinSamples` 的整数

最大样本测量值数，指定为大于或等于 MinSamples 的整数。MaxSamples 定义框架在 NumWarmups 之后运行测试代码的最大次数。该框架将在进行 MaxSamples 次采样之后停止，即使试验不满足统计目标也是如此。

`RelativeMarginOfError` — 样本的目标相对误差界限
0.05 （默认） | 正数

样本的目标相对误差界限，指定为正数。

框架使用以下方程计算样本 X 的相对误差界限：

$relMoE = \frac{T * std(X)}{mean(X) * \sqrt{length(X)}}$

其中 T 是使用指定的 ConfidenceLevel 和 length(X)-1 自由度从 Student T 分布中获得的 T 分数。

`ConfidenceLevel` — 要在相对误差界限内的样本的置信水平
0.95 （默认） | 介于 0 和 1 之间的数字

要在相对误差界限内的样本的置信水平，指定为介于 0 和 1 之间的数字。

复制语义

句柄。要了解句柄类如何影响复制操作，请参阅复制对象。

版本历史记录

在 R2016a 中推出

全部展开

R2023a: 预备测量值的默认次数已增加

框架在不定次计时试验中对测试代码进行预备的默认次数从 4 次增加到 5 次。这种变化通常会导致满足目标相对误差界限所需的样本更少。

如果希望使用以前的默认值，请在代码中显式指定该值。下表显示如何更新使用四个预备测量值运行测试的代码示例。

更新前	更新后
import matlab.perftest.TimeExperiment experiment = TimeExperiment.limitingSamplingError; results = run(experiment,mySuite);	import matlab.perftest.TimeExperiment experiment = TimeExperiment.limitingSamplingError("NumWarmups",4); results = run(experiment,mySuite);

更新前

更新后

import matlab.perftest.TimeExperiment
experiment = TimeExperiment.limitingSamplingError;
results = run(experiment,mySuite);

import matlab.perftest.TimeExperiment
experiment = TimeExperiment.limitingSamplingError("NumWarmups",4);
results = run(experiment,mySuite);

另请参阅

matlab.perftest.TimeExperiment | matlab.unittest.measurement.MeasurementResult

matlab.perftest.FrequentistTimeExperiment 类

描述

属性

NumWarmups — 预备测量值的数量 5 （默认） | 非负整数

MinSamples — 最小样本数 4 （默认） | 大于 1 的整数

MaxSamples — 最大样本数 256 （默认） | 大于或等于 MinSamples 的整数

RelativeMarginOfError — 样本的目标相对误差界限 0.05 （默认） | 正数

ConfidenceLevel — 要在相对误差界限内的样本的置信水平 0.95 （默认） | 介于 0 和 1 之间的数字