addBaselineCriteria

クラス: sltest.testmanager.TestCase
名前空間: sltest.testmanager

テスト ケースへのベースライン基準の追加

このページをすべて展開する

構文

base = addBaselineCriteria(tc,file)
base = addBaselineCriteria(tc,file,'RefreshIfExists',true)
base = addBaselineCriteria(tc,excel,'SeparateBaselines',false)
base = addBaselineCriteria(tc,excel,'Sheets',sheets,Name,Value)

説明

base = addBaselineCriteria(tc,file) は、ベースライン テスト ケースに MAT ファイル、シミュレーション データ インスペクター (SDI) MLDATX ファイル、または Microsoft® Excel® ファイルをベースライン基準として追加します。file が複数のシートを持つ Excel ファイルの場合、各シートが個別のベースライン セットとしてテスト ケースに追加されます。

例

base = addBaselineCriteria(tc,file,'RefreshIfExists',true) はベースライン基準をテスト ケースに追加し、テスト ケースに既にベースライン基準がある場合は置換します。

例

base = addBaselineCriteria(tc,excel,'SeparateBaselines',false) は、Excel ファイル内のすべてのシートを単一のベースライン セットとして追加します。

例

base = addBaselineCriteria(tc,excel,'Sheets',sheets,Name,Value) は、ベースライン基準に含める Excel のシートを指定し、1 つ以上の Name,Value ペアの引数で指定された追加オプションを使用します。

例

入力引数

すべて展開する

ベースライン基準を追加するテスト ケース。sltest.testmanager.TestCase オブジェクトとして指定します。

ベースライン基準ファイルのファイルとパス名。文字ベクトルとして指定します。MAT ファイル、シミュレーション データ インスペクター MLDATX ファイル、または Microsoft Excel ファイルを指定できます。

例: 'C:\MATLAB\baseline_API.mat'

ベースライン基準として使用する Excel ファイルのファイルとパス名。文字ベクトルとして指定します。

例: 'C:\MATLAB\baseline.xlsx'

追加する Excel ファイルのシートの名前。文字ベクトル、string、または string の配列として指定します。

例: 'signals', ["Heater","Plant"]

名前と値の引数

すべて展開する

オプションの引数のペアを Name1=Value1,...,NameN=ValueN として指定します。ここで、Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後に指定しなければなりませんが、ペアの順序は重要ではありません。

R2021a より前では、コンマを使用して名前と値をそれぞれ区切り、Name を引用符で囲みます。

例: 'Ranges','B1:C4','RefreshIfExists',false

ベースライン基準として追加するシートのセルの範囲。文字ベクトル、string、または string の配列として指定します。指定する範囲は、指定するシートに対応していなければなりません。たとえば、シートを 1 つ指定する場合は 1 つの範囲を指定します。シートの cell 配列を指定する場合は、'Ranges' の cell 配列の各値が 'Sheets' の cell 配列の 1 つのシートと対応している必要があります。シート全体を使用するには、空の範囲を指定します。

例: 'B2:C30', "D2:E30", ["B2:C30", "D2:E30", "B2:C30"], ["B2:C30","","D2:E30"]

テスト ケースのベースライン基準を置換するオプション。boolean として指定します。false を使用すると、テスト ケースに既にベースライン基準がある場合にエラーを返します。つまり、ベースラインが上書きされるのを防ぎます。true を使用すると、ベースライン基準が追加され、既存のベースラインが置換されます。

'Sheets' 引数で指定された各シートを個別のベースラインとして使用するオプション。true または false として指定します。

出力引数

すべて展開する

テスト ケースに追加されるベースライン基準。sltest.testmanager.BaselineCriteria オブジェクトまたは sltest.testmanager.BaselineCriteria オブジェクトの配列として返されます。

例

すべて展開する

% Open the model for this example
openExample('sldemo_absbrake');

% Create the test file, test suite, and test case structure
tf = sltest.testmanager.TestFile('API Test File');
ts = createTestSuite(tf,'API Test Suite');
tc = createTestCase(ts,'baseline','Baseline API Test Case');

% Remove the default test suite
tsDel = getTestSuiteByName(tf,'New Test Suite 1');
remove(tsDel);

% Assign the system under test to the test case
setProperty(tc,'Model','sldemo_absbrake');

% Add baseline criteria from file
baseline = addBaselineCriteria(tc,'C:\MATLAB\baseline_API.mat');

Excel ファイルをベースラインとして使用し、テスト ケースの既存のベースラインを上書きします。

% Open the model for this example
openExample('sldemo_absbrake');

% Create the test file, test suite, and test case structure
tf = sltest.testmanager.TestFile('Excel Test File');
ts = createTestSuite(tf,'Excel Test Suite');
tc = createTestCase(ts,'baseline','Baseline Excel Test Case');

% Remove the default test suite
tsDel = getTestSuiteByName(tf,'New Test Suite 1');
remove(tsDel);

% Assign the system under test to the test case
setProperty(tc,'Model','sldemo_absbrake');

% Add baseline criteria from file
baseline = addBaselineCriteria(tc,...
   'C:\MATLAB\myexcel.xlsx','RefreshIfExists',true);

Excel ファイルをベースラインとして使用し、Excel ファイルに複数のシートがある場合でも 1 つのベースラインを作成します。

% Open the model for this example
openExample('sldemo_absbrake');

% Create the test file, test suite, and test case structure
tf = sltest.testmanager.TestFile('Excel Test File');
ts = createTestSuite(tf,'Excel Test Suite');
tc = createTestCase(ts,'baseline','Baseline Excel Test Case');

% Remove the default test suite
tsDel = getTestSuiteByName(tf,'New Test Suite 1');
remove(tsDel);

% Assign the system under test to the test case
setProperty(tc,'Model','sldemo_absbrake');

% Add baseline criteria from file
baseline = addBaselineCriteria(tc,...
   'C:\MATLAB\myexcel.xlsx','SeparateBaselines',false);

Excel ファイルから 3 つのシートを選択して、ベースラインとして使用します。シートごとにセルの範囲を指定します。 

% Open the model for this example
openExample('sldemo_absbrake');

% Create the test file, test suite, and test case structure
tf = sltest.testmanager.TestFile('Excel Test File');
ts = createTestSuite(tf,'Excel Test Suite');
tc = createTestCase(ts,'baseline','Baseline Excel Test Case');

% Remove the default test suite
tsDel = getTestSuiteByName(tf,'New Test Suite 1');
remove(tsDel);

% Assign the system under test to the test case
setProperty(tc,'Model','sldemo_absbrake');

% Create sheets and ranges arrays
sheets = ["HotTemp", "ColdTemp", "NominalTemp"];
ranges = ["B2:C30", "D2:E30", "B2:C30"];

% Add baseline criteria from file, using the sheets and cell ranges specified
baseline = addBaselineCriteria(tc,...
   'C:\MATLAB\myexcel.xlsx','Sheets',sheets,'Ranges',ranges);

バージョン履歴

R2015b で導入

参考

トピック