テスト反復

テストケースの反復を使用して、同じテストケースを異なるデータやコンフィギュレーションセットで実行できます。反復で使用する次の内容を変えることができます。

パラメーター
外部入力
コンフィギュレーションセット
Signal Editor シナリオ
Test Sequence シナリオ
ベースラインデータ
シミュレーションモード

反復はテストケースの [反復] セクションで設定します。テストマネージャーの [反復] セクションでテーブルを使用するか、スクリプトを使用してして反復を作成できます。

反復でテストシーケンスシナリオを使用するには、まず、[入力] セクションの [Test Sequence ブロック] を、シナリオを含むブロックに設定します。次に、[シナリオでオーバーライド] からシナリオを選択し、そのシナリオを各反復の既定として使用します。シナリオを選択しない場合、Test Sequence ブロックのアクティブなシナリオが既定として使用されます。テーブルの [テストシーケンスシナリオ] 列を使用して反復のシナリオを変更します。詳細については、Use Test Sequence Scenarios in the Test Sequence Editor and Test Managerを参照してください。

ノーマルやソフトウェアインザループ (SIL) など、ベースラインテストまたはシミュレーションテストに別のシミュレーションモードを使用するには、最初にテストケースを設定します。次に、[反復] のテーブルで [自動生成] をクリックします。[反復の自動生成] ダイアログボックスで、[シミュレーションモード] と 1 つ以上の他のオプションを選択します。作成される反復の数はオプションごとに 2 倍になります。1 つがモデルのモード用、もう 1 つが SIL モード用です。

テストで Simulink^® Coverage™ を使用してカバレッジを収集する場合、テストケースのすべての反復に同じカバレッジ設定が適用されます。

テーブルによる反復とスクリプトによる反復のどちらを使用する場合でも、[反復を表示] ボタンをクリックしてテストケースの反復を参照できます。

テーブルによる反復の作成

[テーブルによる反復] を使用すると、モデルまたはテストケースの項目に基づいて反復を迅速に追加できます。テーブルで反復を作成するには、まず該当する列が表示されるようにします。

[反復]、[テーブルによる反復] のセクションを展開します。
テーブルでボタンをクリックしてリストから項目を選択し、列を追加または削除します。たとえば、パラメーターセットとコンフィギュレーションセットを表示するように選択するには、[パラメーターセット] と [コンフィギュレーションセット] の項目を選択します。

手動での反復の追加

手動で反復を追加するには、[追加] をクリックします。テーブルに新しい反復の行が表示されます。
反復に名前を割り当て、反復の項目を選択します。たとえば、次のテストケースには 4 つの反復があります。各反復は、外部入力とベースラインデータの異なる組み合わせを使用しています。

テーブルによる反復の生成

テストケースとモデルのデータから反復を自動的に生成することもできます。

[自動生成] ボタンをクリックします。
反復を生成する項目を選択します。
テストシーケンスシナリオの場合、[入力] セクションの [Test Sequence ブロック] で選択したブロックのシナリオごとに反復が生成されます。
複数の項目を選択すると、順番にペアにして反復が作成されます。以下に例を示します。
- モデル sldemo_autotrans には、Coasting、Gradual_Acceleration、Hard_braking、および Passing_Maneuver のラベルが付いた 4 つの信号シナリオをもつ Signal Editor ブロックがあり、それぞれのシナリオに Throttle と Brake の信号があります。このモデルを開くには、コマンドラインで「openExample('sldemo_autotrans')」と入力します。信号エディターを表示するには、ManeuversGUI ブロックをクリックして [ブロックパラメーター] ダイアログを開きます。次に、[信号プロパティ] にある信号エディターの起動ボタンをクリックします。
- テストケースには、P1、P2、および P3 のラベルが付いた 3 つのパラメーターセットがあります。
- Signal Editor シナリオとパラメーターセットから反復を自動的に生成すると、3 つの反復になります。反復は 3 つのパラメーターセットで制限されます。各反復には 1 つの Signal Editor シナリオと 1 つのパラメーターセットが含まれます。Signal Editor シナリオとパラメーターセットは、Signal Editor ブロックとパラメーターセットのセクションにリストされた順序で対応付けられます。
反復についてのオプションの命名規則を指定します。[反復命名規則] ボックスに、次を使用して規則を入力します。
- 名前に使用する各設定の名前 (スペースは削除)
- 各設定を区切るアンダースコアまたはスペース
たとえば、パラメーターセットの名前、コンフィギュレーションセットの名前、およびベースラインのファイル名を含める場合は、「ParameterSet_ConfigurationSet_Baseline」と入力します。

セクションのオプション	目的
信号エディターシナリオ	指定した [信号エディターシナリオ] に対するシミュレーション、ベースライン、または等価性のテストケースの [入力] セクションに適用されます。それぞれの信号エディターシナリオを使用して反復が生成されます。
パラメーターセット	シミュレーション、ベースライン、または等価性のテストケースの [パラメーターのオーバーライド] セクションに適用されます。それぞれのパラメーターオーバーライドセットを使用して反復が生成されます。
外部入力	指定した [外部入力] セットに対するシミュレーション、ベースライン、または等価性のテストケースの [入力] セクションに適用されます。それぞれの外部入力セットを使用して反復が生成されます。
コンフィギュレーションセット	シミュレーション、ベースライン、または等価性のテストケースの [コンフィギュレーション設定のオーバーライド] セクションに適用されます。指定したコンフィギュレーション設定が各反復で使用されます。
ログ記録された信号セット	シミュレーション、ベースライン、または等価性のテストケースの [ログ] セクションに適用されます。それぞれのログに記録された信号セットを使用して反復が生成されます。
ベースライン	ベースラインテストケースタイプにのみ適用されます。具体的には、ベースラインテストケースの [ベースライン基準] セクションに適用されます。それぞれのベースライン基準セットを使用して反復が生成されます。
テストシーケンスシナリオ	指定した [Test Sequence ブロック] に対するシミュレーション、ベースライン、または等価性のテストケースの [入力] セクションに適用されます。それぞれのテストシーケンスシナリオを使用して反復が生成されます。
シミュレーションモード	シミュレーションまたはベースラインのテストケースの [反復] のテーブルセクションに適用されます。[反復の自動生成] ダイアログボックスで選択した他のテスト設定ごとに、モデルの現在のシミュレーションモードの反復と SIL の反復が作成されます。
シミュレーション 1 または 2	等価性テストケースタイプにのみ適用されます。[反復の自動生成] ダイアログボックスの上部に [シミュレーション 1] または [シミュレーション 2] のメニューがあります。これらのセクションは、等価性テストケース内の 2 つのシミュレーションセクションに対応します。

スクリプトによる反復の作成

[スクリプトによる反復] セクションでは、スクリプトを使用してカスタムの反復セットを実行できます。たとえば、カスタムの反復を使用して、パラメーターセットを定義したり反復の順序をカスタマイズしたりできます。スクリプトによる反復はテストの実行時に生成され、モデルの読み込み前に実行されます。

Code for scripted iterations

反復スクリプトのコンポーネント

反復スクリプトには、特定のコンポーネントが含まれている必要があります。最も基本的な反復スクリプトに含まれる要素は次の 3 つです。

反復オブジェクト (sltestiteration を使用して作成)。
反復設定 (setTestParam を使用して設定)。
反復登録 (addIteration を使用して追加)。

たとえば、次のスクリプトは Signal Editor ブロックから 1 つの信号シナリオを実行する反復を作成します。

%% Iterate Using a Signal Editor Scenario
 
% Set up a new iteration object
testItr = sltestiteration;

% Set iteration setting using Signal Editor scenario
setTestParam(testItr,'SignalEditorScenario',...
   sltest_signalEditorScenarios{1});

% Add the iteration to run in this test case
% The predefined sltest_testCase variable is used here
addIteration(sltest_testCase,testItr);

テスト反復クラスの詳細については、sltest.testmanager.TestIteration を参照してください。Signal Editor やテストシーケンスのシナリオなど、複数の項目を反復できます。基本の反復スクリプトをループに含めることで、ブロックの Signal Editor または Test Sequence のすべてのシナリオを反復できます。

%% Iterate Over All Signal Editor Scenarios

% Determine the number of possible iterations
numSteps = length(sltest_signalEditorScenarios);
 
% Create each iteration
for k = 1 : numSteps
    % Set up a new iteration object
    testItr = sltestiteration;
 
    % Set iteration settings
    setTestParam(testItr,'SignalEditorScenario',...
      sltest_signalEditorScenarios{k});
 
    % Add the iteration to run in this test case
    % You can pass in an optional iteration name
    addIteration(sltest_testCase,testItr);
end

事前定義された変数

反復スクリプトの記述には、事前定義された変数を使用できます。事前定義された変数の一覧をテストマネージャーで参照するには、[テスト反復作成のヘルプ] セクションを展開します。[スクリプトによる反復] セクション内のスクリプトボックスで反復スクリプトを記述します。スクリプトボックスは関数ワークスペースです。つまり、MATLAB^® ベースワークスペースではスクリプトボックスからの情報にアクセスできません。スクリプトボックスで変数を定義している場合、その変数を他のワークスペースで使用することはできません。

事前定義された変数は次のとおりです。

sltest_bdroot — テストケースでシミュレートされるモデル。string として定義されます。
sltest_sut — テスト対象システム。string として定義されます。
sltest_isharness — sltest_bdroot がハーネスモデルの場合に true。logical として定義されます。
sltest_externalInputs — 外部入力の名前。string の cell 配列として定義されます。
sltest_parameterSets — パラメーターオーバーライドセットの名前。string の cell 配列として定義されます。
sltest_configSets — コンフィギュレーション設定の名前。string の cell 配列として定義されます。
sltest_signalEditorScenarios — 信号エディターシナリオの名前。文字ベクトルの 2 次元 cell 配列として定義されます。
sltest_loggedSignalSets — ログに記録された信号セットの名前。文字ベクトルの 2 次元 cell 配列として定義されます。
sltest_testSequenceScenarios — テストシーケンスシナリオの名前。文字ベクトルの 2 次元 cell 配列として定義されます。
sltest_baselines — ベースライン基準の名前 (ベースラインテストのみ)。文字ベクトルの cell 配列として定義されます。
sltest_tableIterations — 反復のテーブルで作成される反復オブジェクト。sltest.testmanager.TestIteration オブジェクトの cell 配列として定義されます。
sltest_testCase — 現在のテストケースオブジェクト。sltest.testmanager.TestCase オブジェクトとして定義されます。

スクリプトによる反復のテンプレート

Signal Editor シナリオ、パラメーターセット、外部入力、コンフィギュレーションセット、およびベースライン設定 (ベースラインテストケースを使用する場合) のテンプレートを使用して、テストケースの反復を迅速に生成できます。スクリプトによる反復のテンプレートは、テスト設定のロックステップの順序とペアリングに従います。ロックステップの順序の詳細については、テーブルによる反復の作成を参照してください。

たとえば、スクリプトによる反復ですべての信号エディターシナリオを実行する場合は次のようにします。

[反復テンプレート] をクリックします。
反復するテストケース設定を選択します。[OK] をクリックします。
スクリプトが生成され、スクリプトボックスの既存のすべてのスクリプトの下に追加されます。
テストケースを実行したときの反復のプレビューを示すテーブルを生成するには、[反復を表示] をクリックします。

一連のパラメーターのスイープ

一連のパラメーターをスイープすることで、スクリプトによる反復をモデルのテストに使用できます。次のスクリプトを使用して、モデル sltestCar のモデルワークスペースパラメーター Iei とモデルパラメーター UpperSaturationLimit について、さまざまな値を試すことができます。[反復] 、 [スクリプトによる反復] でスクリプトを追加します。

%% Iterate over Iei parameter

% Set up the parameter values to sweep over
IeiValues = [0.021,0.022,0.022,0.023];
UprSatValues = [2000,3000,4000,5000];
numSteps = length(IeiValues);

% Create each iteration
for k = 1 : numSteps
    % Set up a new iteration object
    testItr = sltestiteration;
    
    % Set value of lei (parameter in model workspace)
    setVariable(testItr,'Name','Iei','Source','model workspace',...
                'Value',IeiValues(k));

    % Set value of UpperSaturationLimit model parameter
    testItr.setModelParam('sltestCar/Engine/Integrator',...
                 'UpperSaturationLimit',UprSatValues(k));
 
    % Add the iteration to run in this test case
    addIteration(sltest_testCase,testItr); 
end