Reactive Systems logo
Reactis for C API V2021

Reactis for C API:
Reactis Report Configuration

rcReportConfigCreate a report configuration.
rcReportConfigCloseClose a report configuration.
rcReportConfigGetItemsGet items included in coverage report configuration.
rcReportConfigGetSummaryMetricsGet summary metrics included in coverage report configuration.
rcReportConfigGetDetailMetricsGet detail metrics included in coverage report configuration.
rcReportConfigGetDetailStatusGet detail status included in coverage report configuration.
rcReportConfigSetItemsSet items included in coverage report configuration.
rcReportConfigSetSummaryMetricsSet summary metrics included in coverage report configuration.
rcReportConfigSetDetailMetricsSet detail metrics included in coverage report configuration.
rcReportConfigSetDetailStatusSet detail metrics included in coverage report configuration.


rcReportConfig

Create a report configuration.

Syntax

cfgId = rcReportConfig()
cfgId = rcReportConfig(items, summaryMetrics, detailMetrics, detailStatus)

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:

CoveredInclude covered targets.
UncoveredInclude uncovered targets.
UnreachableInclude unreachable targets.
AllInclude all of the above.
DefaultInclude all of the above.

cfgId is a scalar integer valued double that identifies the report configuration when calling other rsReport* API functions.

Examples

rptid = rcReportConfig('Default', ...
                       {'Condition', 'Decision', 'Branch'}, ...
                       {'Condition', 'Decision', 'Branch'}, ...
                       'Default');

See Also

rcSimRunSuite, rcTester, rcTesterStart, rcReportConfigClose, rcReportConfigGetItems, rcReportConfigSetItems, rcReportConfigGetSummaryMetrics, rcReportConfigSetSummaryMetrics rcReportConfigGetDetailMetrics, rcReportConfigSetDetailMetrics, rcReportConfigGetDetailStatus, rcReportConfigSetDetailStatus


rcReportConfigClose

Close a report configuration.

Syntax

rcReportConfigClose(cfgId)

Description

rcReportConfigClose(cfgId) closes the report configuration identified by cfgId and releases any memory allocated with it.

See Also

rcReportConfig


rcReportConfigGetItems

Get items included in coverage report configuration.

Syntax

items = rcReportConfigGetItems(cfgId)

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.

See Also

rcReportConfig, rcReportConfigClose, rcReportConfigSetItems, rcReportConfigGetSummaryMetrics, rcReportConfigSetSummaryMetrics rcReportConfigGetDetailMetrics, rcReportConfigSetDetailMetrics rcReportConfigGetDetailStatus, rcReportConfigSetDetailStatus


rcReportConfigGetSummaryMetrics

Get summary metrics included in coverage report configuration.

Syntax

metrics = rcReportConfigGetSummaryMetrics(cfgId)

Description

metrics = rcReportConfigGetSummaryMetrics(cfgId) returns a cell array of strings listing the summary metrics included in coverage report configuration cfgId.

See Also

rcReportConfig, rcReportConfigClose, rcReportConfigGetItems, rcReportConfigSetItems, rcReportConfigSetSummaryMetrics, rcReportConfigGetDetailMetrics, rcReportConfigSetDetailMetrics, rcReportConfigGetDetailStatus, rcReportConfigSetDetailStatus


rcReportConfigGetDetailMetrics

Get detail metrics included in coverage report configuration.

Syntax

metrics = rcReportConfigGetDetailMetrics(cfgId)

Description

metrics = rcReportConfigGetDetailMetrics(cfgId) returns a cell array of strings listing the detail metrics included in coverage report configuration cfgId.

See Also

rcReportConfig, rcReportConfigClose, rcReportConfigGetItems, rcReportConfigSetItems, rcReportConfigGetSummaryMetrics, rcReportConfigSetSummaryMetrics, rcReportConfigSetDetailMetrics, rcReportConfigGetDetailStatus, rcReportConfigSetDetailStatus


rcReportConfigGetDetailStatus

Get detail status included in coverage report configuration.

Syntax

status = rcReportConfigGetDetailStatus(cfgId)

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.

See Also

rcReportConfig, rcReportConfigClose, rcReportConfigGetItems, rcReportConfigSetItems, rcReportConfigGetSummaryMetrics, rcReportConfigSetSummaryMetrics, rcReportConfigGetDetailMetrics, rcReportConfigSetDetailMetrics, rcReportConfigSetDetailStatus


rcReportConfigSetItems

Set items included in coverage report configuration.

Syntax

rcReportConfigSetItems(cfgId, items)

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.

See Also

rcReportConfig, rcReportConfigClose, rcReportConfigGetItems, rcReportConfigGetSummaryMetrics, rcReportConfigSetSummaryMetrics, rcReportConfigGetDetailMetrics, rcReportConfigSetDetailMetrics, rcReportConfigGetDetailStatus, rcReportConfigSetDetailStatus


rcReportConfigSetSummaryMetrics

Set summary metrics included in coverage report configuration.

Syntax

rcReportConfigSetSummaryMetrics(cfgId, metrics)

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).

See Also

rcReportConfig, rcReportConfigClose, rcReportConfigGetItems, rcReportConfigSetItems, rcReportConfigGetSummaryMetrics, rcReportConfigGetDetailMetrics, rcReportConfigSetDetailMetrics, rcReportConfigGetDetailStatus, rcReportConfigSetDetailStatus


rcReportConfigSetDetailMetrics

Set detail metrics included in coverage report configuration.

Syntax

rcReportConfigSetDetailMetrics(cfgId, metrics)

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).

See Also

rcReportConfig, rcReportConfigClose, rcReportConfigGetItems, rcReportConfigSetItems, rcReportConfigGetSummaryMetrics, rcReportConfigGetDetailMetrics, rcReportConfigSetDetailMetrics, rcReportConfigGetDetailStatus, rcReportConfigSetDetailStatus


rcReportConfigSetDetailStatus

Set detail metrics included in coverage report configuration.

Syntax

rcReportConfigSetDetailStatus(cfgId, status)

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:

CoveredInclude covered targets in the details section.
UncoveredInclude uncovered targets in the details section.
UnreachableInclude unreachable targets in the details section.
AllInclude all of the above.
DefaultInclude all of the above.

See Also

rcReportConfig, rcReportConfigClose, rcReportConfigGetItems, rcReportConfigSetItems, rcReportConfigGetSummaryMetrics, rcReportConfigSetSummaryMetrics, rcReportConfigGetDetailMetrics, rcReportConfigSetDetailMetrics, rcReportConfigGetDetailStatus