14. Reactis Info File - Coverage Metrics#

14.1. rsRsiGetCoverageEnabled#

Get enabled/disabled status of a coverage metric.

14.1.1. Syntax#

enabled = rsRsiGetCoverageEnabled(rsiId,metricName)

14.1.2. Description#

enabled = rsRsiGetCoverageEnabled(rsiId,metricName)

returns 1 if metric metricName is enabled and 0 otherwise. metricName may either be a coverage metric name as enumerated in the Coverage Metric Names section or an assertion category as enumerated in the Assertion Category Names section of the API documentation.

rsiId is the identifier of an .rsi file previously opened by rsRsiOpen.

14.1.3. Examples#

>> rsRsiGetCoverageEnabled(rsiId,'Branch')
ans = 
    1

14.1.4. See Also#

rsRsiOpen, rsRsiSetCoverageEnabled

14.2. rsRsiSetCoverageEnabled#

Set enabled/disabled status of a coverage metric.

14.2.1. Syntax#

rsRsiSetCoverageEnabled(rsiId,metricName,enab)

14.2.2. Description#

rsRsiSetCoverageEnabled(rsiId,metricName,enab)

disables tracking for metric metricName if enab is 0, otherwise tracking is enabled. Valid metric names are Coverage Metric Names and Assertion Category Names.

rsiId is the identifier of an .rsi file previously opened by rsRsiOpen. rsRsiSave must be called to save modifications to .rsi file in order for them to be used by subsequent calls to rsSimOpen or rsTester. Updates to .rsi file are not propagated to any running Simulator or Tester sessions.

14.2.3. Examples#

rsRsiSetCoverageEnabled(rsiId,'Branch',1)

14.2.4. See Also#

rsRsiOpen, rsRsiSave, rsRsiGetCoverageEnabled

14.3. rsRsiGetSystemCoverageTracking#

Get coverage tracking status of a subsystem.

14.3.1. Syntax#

rsRsiGetSystemCoverageTracking(rsiId, systemPath)

14.3.2. Description#

Reactis lets you disable coverage tracking for all targets in a given subsystem of the model. See Section Excluding a Subsystem of the Reactis User’s Guide for a description of how this feature works. This API function lets you query whether or not coverage tracking for a given subsystem is enabled.

rsRsiGetSystemCoverageTracking(rsiId,systemPath)

takes rsiId (the identifier of an .rsi file previously opened by rsRsiOpen) and systemPath as input and returns:

disabled

If coverage tracking for systemPath is disabled.

enabled

If coverage tracking for systemPath is enabled.

inherited

If coverage tracking for systemPath is inherited from its parent

14.3.3. Examples#

>> rsRsiGetSystemCoverageTracking(rsiId,'cruise/CruiseMain/CruiseMDL/DesiredSpeed')
ans =
    inherited

14.3.4. See Also#

rsRsiOpen, rsRsiSetSystemCoverageTracking

14.4. rsRsiSetSystemCoverageTracking#

Set coverage tracking status of a subsystem.

14.4.1. Syntax#

rsRsiSetSystemCoverageTracking(rsiId, systemPath, enab)

14.4.2. Description#

Reactis lets you disable coverage tracking for all targets in a given subsystem of the model. See Section Excluding a Subsystem of the Reactis User’s Guide for a description of how this feature works. This API function lets you set whether or not coverage tracking for a given subsystem is enabled.

rsRsiSetSystemCoverageTracking(rsiId, systemPath, enab)

will change the coverage tracking setting for system systemPath. rsiId is the identifier of an .rsi file previously opened by rsRsiOpen. Valid values for enab are:

disabled

Set coverage tracking for systemPath to disabled

enabled

Set coverage tracking for systemPath to enabled

inherited

If coverage tracking for systemPath is inherited from its parent

rsiId is the identifier of an .rsi file previously opened by rsRsiOpen. rsRsiSave must be called to save modifications to .rsi file in order for them to be used by subsequent calls to rsSimOpen or rsTester. Updates to .rsi file are not propagated to any running Simulator or Tester sessions.

14.4.3. Examples#

rsRsiSetSystemCoverageTracking(rsiId,'cruise/CruiseMain/CruiseMDL/DesiredSpeed',
                               'disabled')

14.4.4. See Also#

rsRsiOpen, rsRsiSave, rsRsiGetSystemCoverageTracking

14.5. rsRsiSetCumulativeCoverage#

Enable/Disable cumulative coverage tracking for a library system or referenced model.

14.5.1. Syntax#

rsRsiSetCumulativeCoverage(rsiId, systemPath, setting)

14.5.2. Description#

rsRsiSetCumulativeCoverage(rsiId, systemPath, setting)

changes cumulative coverage setting for systemPath. systemPath is the referenced system’s path, i.e. if a model named refmodel should be cumulatively covered then refmodel should be passed in as systemPath. For library systems, use the full path of the system within the library, including the library’s name.

rsiId is the identifier of an .rsi file previously opened by rsRsiOpen. rsRsiSave must be called to save modifications to .rsi file in order for them to be used by subsequent calls to rsSimOpen or rsTester. Updates to .rsi file are not propagated to any running Simulator or Tester sessions.

14.5.3. See Also#

rsRsiOpen, rsRsiSave, rsRsiIsCumulativeCoverage, rsRsiGetCumulativeCoverage

14.6. rsRsiIsCumulativeCoverage#

Query cumulative coverage tracking status for a library system or referenced model.

14.6.1. Syntax#

rsRsiIsCumulativeCoverage(rsiId, systemPath)

14.6.2. Description#

rsRsiIsCumulativeCoverage(rsiId, systemPath)

queries cumulative coverage setting for systemPath. systemPath is the referenced system’s path.

14.6.3. See Also#

rsRsiOpen, rsRsiSetCumulativeCoverage, rsRsiGetCumulativeCoverage

14.7. rsRsiGetCumulativeCoverage#

Get a list of systems for which cumulative coverage is enabled.

14.7.1. Syntax#

rsRsiGetCumulativeCoverage(rsiId)

14.7.2. Description#

rsRsiGetCumulativeCoverage(rsiId)

returns a cell array of strings, listing all systems for which cumulative coverage is enabled.

14.7.3. See Also#

rsRsiOpen, rsRsiIsCumulativeCoverage, rsRsiSetCumulativeCoverage