sldvmergeharness

Merge test cases and initializations into one harness model

Note

sldvmergeharness replaces sldvharnessmerge.

Syntax

status = sldvmergeharness(name, models, initialization_commands)

Description

status = sldvmergeharness(name, models, initialization_commands) collects the test data and initialization commands from each test harness model in models. The function saves the data and initialization commands in name, which is a handle to the new model.

If name does not exist, sldvmergeharness creates name as a copy of the first model in models. sldvmergeharness then merges the data from other models listed in models into this model. If you create name from a previous sldvmergeharness run, subsequent runs of sldvmergeharness for name maintains the structure and initialization from the earlier run. If name matches an existing Simulink^® model, sldvmergeharness merges the test data from models into name.

sldvmergeharness assumes that name and the rest of the models in models have only one Signal Builder block on the top level. If a model in models has more than one Signal Builder block on the top level or its top-level Signal Builder block does not have the same number of signals as the top-level Signal Builder block in name, sldvmergeharness does not merge the model test data into name.

To combine the test cases that use different sets of parameter values, use sldvmergeharness with sldvgencov.

Examples

Merge the Two Test Harnesses

Analyze the sldvdemo_cruise_control model for decision objectives and full coverage, and then merge the two test harnesses.

Open the sldvdemo_cruise_control example model.

model = 'sldvdemo_cruise_control';
open_system(model)

Set the sldvoptions and collect decision coverage.

opts1 = sldvoptions;
opts1.Mode = 'TestGeneration';
opts1.ModelCoverageObjectives = 'Decision';
opts1.HarnessModelFileName = 'first_harness';
opts1.SaveHarnessModel = 'on';
sldvrun(model, opts1);

Set the sldvoptions and collect full coverage.

opts2 = sldvoptions;
opts2.Mode = 'TestGeneration';
opts2.ModelCoverageObjectives = 'ConditionDecision';
opts2.HarnessModelFileName = 'second_harness';
opts2.SaveHarnessModel = 'on';
sldvrun(model, opts2);

Merge the two harness files.

status = sldvmergeharness('new_harness_model', {'first_harness',...
		'second_harness'}); 

Input Arguments

name — Name of new harness model

character vector | string scalar

Name of the new harness model, which is stored in the default MATLAB^® folder.

models — Names of harness models

character vector | cell array of character vectors | string array

A cell array that represents harness model names.

initialization_commands — Parameter settings for test cases

character vector | cell array of character vectors | string array

A cell array of the same length as models. initialization_commands defines parameter settings for the test cases of each test harness model.

Output Arguments

status — Status of merge harness

boolean

If the merge works, sldvmergeharness returns a status of 1. Otherwise, it returns 0.

Version History

Introduced in R2010b