10. Reactis Report Configuration#
10.1. rcReportConfig#
Create a report configuration.
10.1.1. Syntax#
cfgId = rcReportConfig()
cfgId = rcReportConfig(items, summaryMetrics, detailMetrics, detailStatus)
10.1.2. Description#
- cfgId = rcReportConfig()
creates a report configuration using all default settings.
- cfgId = rcReportConfig(items, summaryMetrics, detailMetrics, detailStatus)
creates a report configuration using the given settings.
items is a cell array of strings containing any combination of the following items:
ExportDate |
Include current date. |
FilePaths |
Include full paths for all files. |
TableOfContents |
Include a table of contents. |
Summary |
Include summary statistics for each test: test number, test name, number of steps, errors, warnings, differences. |
Coverage |
Include coverage information. |
FunctionCalls |
Include function call count for C functions. |
ExcludedTargets |
Include a list of excluded coverage targets. |
SimParameters |
Include a list of simulation control parameters. |
InputPlots |
Include plots of inputs for all tests. |
OutputDiffPlots |
Include plots of outputs for tests with differences. |
OutputNoDiffPlots |
Include plots of outputs for tests without any differences. |
StepToCoveredTargetMap |
Include a table listing the targets that were covered on each test step. |
StoreTestsInSeparateFiles |
Create a separate HTML file for each test. |
All |
Include all of the above. |
Default |
Include ExportDate, FilePaths, TableOfContents, Summary, Coverage, FunctionCalls, ExcludedTargets and SimParameters. |
summaryMetrics specifies a list of coverage metrics to be included in the summary section of the report.
detailMetrics specifies a list of coverage metrics to be included in the detail section of the report. Note that metrics included in the detail section will automatically be included in the summary section.
summaryMetrics and detailMetrics are cell arrays of strings containing any combination of the following metrics: CStatement, Decision, Condition, MCDC, MCC, Boundary, UserTarget, Assertion, CFunction, CFunctionCall or the special names All (includes all metrics) or Default (includes all but MCC).
detailStatus is a cell array of strings containing any combination of the following items:
Covered |
Include covered targets. |
Uncovered |
Include uncovered targets. |
Unreachable |
Include unreachable targets. |
All |
Include all of the above. |
Default |
Include all of the above. |
cfgId is a scalar integer valued double that identifies the report configuration when calling other rsReport* API functions.
10.1.3. Examples#
rptid = rcReportConfig('Default', ...
{'Condition', 'Decision', 'Branch'}, ...
{'Condition', 'Decision', 'Branch'}, ...
'Default');
10.1.4. See Also#
rcSimRunSuite, rcTester, rcTesterStart, rcReportConfigClose, rcReportConfigGetItems, rcReportConfigSetItems, rcReportConfigGetSummaryMetrics, rcReportConfigSetSummaryMetrics, rcReportConfigGetDetailMetrics, rcReportConfigSetDetailMetrics, rcReportConfigGetDetailStatus, rcReportConfigSetDetailStatus
10.2. rcReportConfigClose#
Close a report configuration.
10.2.1. Syntax#
rcReportConfigClose(cfgId)
10.2.2. Description#
- rcReportConfigClose(cfgId)
closes the report configuration identified by cfgId and releases any memory allocated with it.
10.2.3. See Also#
10.3. rcReportConfigGetItems#
Get items included in coverage report configuration.
10.3.1. Syntax#
items = rcReportConfigGetItems(cfgId)
10.3.2. Description#
- items = rcReportConfigGetItems(cfgId)
returns a cell array of strings listing all items included in coverage report configuration cfgId. The possible items are:
ExportDate |
Include current date. |
FilePaths |
Include full paths for all files. |
TableOfContents |
Include a table of contents. |
Summary |
Include summary statistics for each test: test number, test name, number of steps, errors, warnings, differences. |
Coverage |
Include coverage information. |
FunctionCalls |
Include function call count for C functions. |
ExcludedTargets |
Include a list of excluded coverage targets. |
SimParameters |
Include a list of simulation control parameters. |
InputPlots |
Include plots of inputs for all tests. |
OutputDiffPlots |
Include plots of outputs for tests with differences. |
OutputNoDiffPlots |
Include plots of outputs for tests without any differences. |
StepToCoveredTargetMap |
Include a table listing the targets that were covered on each test step. |
StoreTestsInSeparateFiles |
Create a separate HTML file for each test. |
10.3.3. See Also#
rcReportConfig, rcReportConfigClose, rcReportConfigSetItems, rcReportConfigGetSummaryMetrics, rcReportConfigSetSummaryMetrics, rcReportConfigGetDetailMetrics, rcReportConfigSetDetailMetrics, rcReportConfigGetDetailStatus, rcReportConfigSetDetailStatus
10.4. rcReportConfigGetSummaryMetrics#
Get summary metrics included in coverage report configuration.
10.4.1. Syntax#
metrics = rcReportConfigGetSummaryMetrics(cfgId)
10.4.2. Description#
- metrics = rcReportConfigGetSummaryMetrics(cfgId)
returns a cell array of strings listing the summary metrics included in coverage report configuration cfgId.
10.4.3. See Also#
rcReportConfig, rcReportConfigClose, rcReportConfigGetItems, rcReportConfigSetItems, rcReportConfigSetSummaryMetrics, rcReportConfigGetDetailMetrics, rcReportConfigSetDetailMetrics, rcReportConfigGetDetailStatus, rcReportConfigSetDetailStatus
10.5. rcReportConfigGetDetailMetrics#
Get detail metrics included in coverage report configuration.
10.5.1. Syntax#
metrics = rcReportConfigGetDetailMetrics(cfgId)
10.5.2. Description#
- metrics = rcReportConfigGetDetailMetrics(cfgId)
returns a cell array of strings listing the detail metrics included in coverage report configuration cfgId.
10.5.3. See Also#
rcReportConfig, rcReportConfigClose, rcReportConfigGetItems, rcReportConfigSetItems, rcReportConfigGetSummaryMetrics, rcReportConfigSetSummaryMetrics, rcReportConfigSetDetailMetrics, rcReportConfigGetDetailStatus, rcReportConfigSetDetailStatus
10.6. rcReportConfigGetDetailStatus#
Get detail status included in coverage report configuration.
10.6.1. Syntax#
status = rcReportConfigGetDetailStatus(cfgId)
10.6.2. Description#
- status = rcReportConfigGetDetailStatus(cfgId)
returns a cell array of strings showing items of which status (Covered/Uncovered/Unreachable) will be included in the details section of the coverage report.
10.6.3. See Also#
rcReportConfig, rcReportConfigClose, rcReportConfigGetItems, rcReportConfigSetItems, rcReportConfigGetSummaryMetrics, rcReportConfigSetSummaryMetrics, rcReportConfigGetDetailMetrics, rcReportConfigSetDetailMetrics, rcReportConfigSetDetailStatus
10.7. rcReportConfigSetItems#
Set items included in coverage report configuration.
10.7.1. Syntax#
rcReportConfigSetItems(cfgId, items)
10.7.2. Description#
- rcReportConfigSetItems(cfgId, items)
sets items to include in coverage report to items. items is a cell array of strings containing any combination of the following:
ExportDate |
Include current date. |
FilePaths |
Include full paths for all files. |
TableOfContents |
Include a table of contents. |
Summary |
Include summary statistics for each test: test number, test name, number of steps, errors, warnings, differences. |
Coverage |
Include coverage information. |
FunctionCalls |
Include function call count for C functions. |
ExcludedTargets |
Include a list of excluded coverage targets. |
SimParameters |
Include a list of simulation control parameters. |
InputPlots |
Include plots of inputs for all tests. |
OutputDiffPlots |
Include plots of outputs for tests with differences. |
OutputNoDiffPlots |
Include plots of outputs for tests without any differences. |
StepToCoveredTargetMap |
Include a table listing the targets that were covered on each test step. |
StoreTestsInSeparateFiles |
Create a separate HTML file for each test. |
All |
Include all of the above. |
Default |
Include ExportDate, FilePaths, TableOfContents, Summary, Coverage, FunctionCalls, ExcludedTargets and SimParameters. |
10.7.3. See Also#
rcReportConfig, rcReportConfigClose, rcReportConfigGetItems, rcReportConfigGetSummaryMetrics, rcReportConfigSetSummaryMetrics, rcReportConfigGetDetailMetrics, rcReportConfigSetDetailMetrics, rcReportConfigGetDetailStatus, rcReportConfigSetDetailStatus
10.8. rcReportConfigSetSummaryMetrics#
Set summary metrics included in coverage report configuration.
10.8.1. Syntax#
rcReportConfigSetSummaryMetrics(cfgId, metrics)
10.8.2. Description#
- rcReportConfigSetSummaryMetrics(cfgId, metrics)
sets metrics to include in the summary of the coverage report to metrics. metrics is a cell array of strings containing any combination of the following metrics:
CStatement
, Decision
, Condition
, MCDC
, MCC
, Boundary
, UserTarget
,
Assertion
, CFunction
, CFunctionCall
or the special names All
(includes all metrics) or Default
(includes all but MCC).
10.8.3. See Also#
rcReportConfig, rcReportConfigClose, rcReportConfigGetItems, rcReportConfigSetItems, rcReportConfigGetSummaryMetrics, rcReportConfigGetDetailMetrics, rcReportConfigSetDetailMetrics, rcReportConfigGetDetailStatus, rcReportConfigSetDetailStatus
10.9. rcReportConfigSetDetailMetrics#
Set detail metrics included in coverage report configuration.
10.9.1. Syntax#
rcReportConfigSetDetailMetrics(cfgId, metrics)
10.9.2. Description#
- rcReportConfigSetDetailMetrics(cfgId, metrics)
sets metrics to include in the detail of the coverage report to metrics. metrics is a cell array of strings containing any combination of the following metrics:
CStatement
, Decision
, Condition
, MCDC
, MCC
, Boundary
, UserTarget
,
Assertion
, CFunction
, CFunctionCall
or the special names All
(includes all metrics) or Default
(includes all but MCC).
10.9.3. See Also#
rcReportConfig, rcReportConfigClose, rcReportConfigGetItems, rcReportConfigSetItems, rcReportConfigGetSummaryMetrics, rcReportConfigGetDetailMetrics, rcReportConfigSetDetailMetrics, rcReportConfigGetDetailStatus, rcReportConfigSetDetailStatus
10.10. rcReportConfigSetDetailStatus#
Set detail metrics included in coverage report configuration.
10.10.1. Syntax#
rcReportConfigSetDetailStatus(cfgId, status)
10.10.2. Description#
- rcReportConfigSetDetailStatus(cfgId, status)
sets status of item to include in the detail section of the coverage report.
status is a cell array of strings containing any combination of the following items:
Covered |
Include covered targets in the details section. |
Uncovered |
Include uncovered targets in the details section. |
Unreachable |
Include unreachable targets in the details section. |
All |
Include all of the above. |
Default |
Include all of the above. |
10.10.3. See Also#
rcReportConfig, rcReportConfigClose, rcReportConfigGetItems, rcReportConfigSetItems, rcReportConfigGetSummaryMetrics, rcReportConfigSetSummaryMetrics, rcReportConfigGetDetailMetrics, rcReportConfigSetDetailMetrics, rcReportConfigGetDetailStatus