MATLAB ベースの Simulink テストを使用したカバレッジの収集

この例では次を使用します。

この例では、MATLAB® ベースの Simulink® テストを使用してテストハーネスでモデルのカバレッジを収集し、MATLAB Test フレームワークを使用して結果をテストマネージャーに取り込む方法を説明します。MATLAB ベースの Simulink テストは、sltest.TestCase から継承された MATLAB コード (.m) ファイルのテストケースクラス定義です。

MATLAB ベースの Simulink テストファイル

この例には、ここで使用するために作成された MATLAB ベースの Simulink テストファイルである TestHarnessWithModelCoverage.m が提供されています。このテストファイルには 2 つのテスト関数が含まれています。それぞれに、入力データを駆動してサブシステム TestHarnessWithModelCoverage/Subsystem1 をテストし、対応するベースラインと比較するためのハーネスモデルがあります。このテストは、モデルのシミュレーションを実行する際に、Simulink.SimulationOutput オブジェクトを使用します。

classdef TestHarnessWithModelCoverage < sltest.TestCase

   methods (Test)
      function testOne(testCase)
          in = testCase.createSimulationInput('simpleSwitchWithSubsystemIn',...
             'WithHarness','simpleSwitchWithSubsystemIn_Harness1');
          simOut = testCase.simulate(in);
          testCase.verifySignalsMatch(simOut,'baselineOne.mat');
      end
      function testTwo(testCase)
          in = testCase.createSimulationInput('simpleSwitchWithSubsystemIn',...
             'WithHarness','simpleSwitchWithSubsystemIn_Harness2');
          simOut = testCase.simulate(in);
          testCase.verifySignalsMatch(simOut,'baselineTwo.mat');
      end
   end

end

TestRunner とテストスイートの作成

sltest_ratelim モデルを実行するために TestRunner を作成します。

import matlab.unittest.TestRunner;
runner = TestRunner.withTextOutput;

TestRunner と共に使用する TestSuite を作成します。

suite = testsuite('TestHarnessWithModelCoverage');

テストランナーの構成

プラグインメソッドを使用して、sltest.TestCase からのテスト結果をテストマネージャーに追加するように TestRunner を構成します。TestRunnerPlugin を TestRunner に追加します。

import sltest.plugins.MATLABTestCaseIntegrationPlugin;
runner.addPlugin(MATLABTestCaseIntegrationPlugin);

DiagnosticsOutputPlugin および ToTestManagerLog は、sltest.TestCase の実行からの診断を、Test Manager の TestCaseResults のログにストリーミングします。診断には、パスしたテストのパスした診断情報が含まれます。DiagnosticsOutputPlugin および ToTestManagerLog を TestRunner に追加します。

import sltest.plugins.ToTestManagerLog;
import matlab.unittest.plugins.DiagnosticsOutputPlugin;
streamOutput = ToTestManagerLog();
diagnosticsOutputPlugin = DiagnosticsOutputPlugin...
    (streamOutput,'IncludingPassingDiagnostics',true);
runner.addPlugin(diagnosticsOutputPlugin);

Simulink モデルのカバレッジ収集の構成

simulate メソッドを使用してシミュレートされた sltest.TestCase 内のモデルは、カバレッジを収集できます。カバレッジメトリクスの収集を構成するには、ModelCoveragePlugin を使用します。この例では、MCDC カバレッジを収集します。ModelCoveragePlugin を TestRunner に追加します。

import sltest.plugins.coverage.CoverageMetrics;
import sltest.plugins.ModelCoveragePlugin;
mcdcMetrics = CoverageMetrics('MCDC',true);
runner.addPlugin(ModelCoveragePlugin('Collecting',mcdcMetrics));

代わりに、テストマネージャーでカバレッジ収集をオンにしてカバレッジメトリクスを設定することもできます。この代替方法を使用する場合、カバレッジのプラグインを runner にインポートしたり追加したりする必要はありません。

カバレッジの収集と、テストマネージャーへのカバレッジおよびテスト結果の追加

これで、TestRunner が完全に構成されたので、run 関数を使用して、カバレッジを収集し、カバレッジとテスト結果をテストマネージャーに追加します。

run(runner,suite);

Setting up ResultSetFixture
Done setting up ResultSetFixture
__________

Running TestHarnessWithModelCoverage
..
Done TestHarnessWithModelCoverage
__________

Coverage Report for simpleSwitchWithSubsystemIn/Subsystem1
    /tmp/Bdoc25b_2988451_599513/tpdfd27f0d_f4f0_4469_aaec_616a3ee03fa3.html
Tearing down ResultSetFixture
Done tearing down ResultSetFixture
__________

run は、実行されたテストスイートの累積カバレッジを含むレポートも生成します。レポートを表示するには、Coverage Report for sltest_ratelim リンクを使用します。

テストマネージャーを開きます。