Commands

The ucis root command accepts one of several sub-commands that operate on coverage data.

Manipulate UCIS coverage data

usage: ucis [-h]
            {convert,merge,list-db-formats,list-rpt-formats,report,show,view}
            ...

Sub-commands

convert

Converts coverage data from one format to another

ucis convert [-h] --out OUT [--input-format INPUT_FORMAT]
             [--output-format OUTPUT_FORMAT]
             input

Positional Arguments

input: Source database to convert

Named Arguments

--out, -o: Specifies the output of the conversion
--input-format, -if: Specifies the format of the input database. Defaults to ‘xml’
--output-format, -of: Specifies the format of the output database. Defaults to ‘xml’

merge

Merges coverage data from two or more databases into a single merged database

ucis merge [-h] --out OUT [--input-format INPUT_FORMAT]
           [--output-format OUTPUT_FORMAT] [--libucis LIBUCIS]
           [--squash-history] [--fast] [--workers WORKERS]
           db [db ...]

Positional Arguments

db

Named Arguments

--out, -o

Specifies the output of the merge

--input-format, -if

Specifies the format of the input databases. Defaults to ‘xml’

--output-format, -of

Specifies the format of the input databases. Defaults to ‘xml’

--libucis, -l

Specifies the name/path of the UCIS shared library

--squash-history

Collapse per-test history into a single summary node

Default: False

--fast

Use optimised merge path (SQLite-to-SQLite only)

Default: False

--workers, -j

Number of parallel reader threads for merge_fast (default: 4)

Default: 4

list-db-formats

Shows available database formats

ucis list-db-formats [-h]

list-rpt-formats

Shows available report filters

ucis list-rpt-formats [-h]

report

Generate a report (typically textual) from coverage data

ucis report [-h] [--out OUT] [--input-format INPUT_FORMAT]
            [--output-format OUTPUT_FORMAT]
            db

Positional Arguments

db: Path to the coverage database

Named Arguments

--out, -o: Specifies the output location for the report
--input-format, -if: Specifies the format of the input database. Defaults to ‘xml’
--output-format, -of: Specifies the output format of the report. Defaults to ‘txt’

show

Query and display coverage information from UCIS database

ucis show [-h]
          {summary,gaps,covergroups,bins,tests,hierarchy,metrics,compare,hotspots,code-coverage,assertions,toggle}
          ...

Positional Arguments

show_cmd: Possible choices: summary, gaps, covergroups, bins, tests, hierarchy, metrics, compare, hotspots, code-coverage, assertions, toggle

Sub-commands

summary

Display overall coverage summary

ucis show summary [-h] [--out OUT] [--input-format INPUT_FORMAT]
                  [--output-format {json,text,txt}]
                  db

Positional Arguments

db: Path to the coverage database

Named Arguments

--out, -o

Specifies the output location for the report

--input-format, -if

Specifies the format of the input database. Defaults to ‘xml’

--output-format, -of

Possible choices: json, text, txt

Specifies the output format. Defaults to ‘json’

Default: 'json'

gaps

Display coverage gaps (uncovered bins and coverpoints)

ucis show gaps [-h] [--out OUT] [--input-format INPUT_FORMAT]
               [--output-format {json,text,txt}] [--threshold THRESHOLD]
               db

Positional Arguments

db: Path to the coverage database

Named Arguments

--out, -o

Specifies the output location for the report

--input-format, -if

Specifies the format of the input database. Defaults to ‘xml’

--output-format, -of

Possible choices: json, text, txt

Specifies the output format. Defaults to ‘json’

Default: 'json'

--threshold, -t

Only show coverpoints with coverage below this threshold (0-100)

covergroups

Display detailed covergroup information

ucis show covergroups [-h] [--out OUT] [--input-format INPUT_FORMAT]
                      [--output-format {json,text,txt}] [--include-bins]
                      db

Positional Arguments

db: Path to the coverage database

Named Arguments

--out, -o

Specifies the output location for the report

--input-format, -if

Specifies the format of the input database. Defaults to ‘xml’

--output-format, -of

Possible choices: json, text, txt

Specifies the output format. Defaults to ‘json’

Default: 'json'

--include-bins, -b

Include detailed bin information

Default: False

bins

Display bin-level coverage details

ucis show bins [-h] [--out OUT] [--input-format INPUT_FORMAT]
               [--output-format {json,text,txt}] [--covergroup COVERGROUP]
               [--coverpoint COVERPOINT] [--min-hits MIN_HITS]
               [--max-hits MAX_HITS] [--sort {count,name}]
               db

Positional Arguments

db: Path to the coverage database

Named Arguments

--out, -o

Specifies the output location for the report

--input-format, -if

Specifies the format of the input database. Defaults to ‘xml’

--output-format, -of

Possible choices: json, text, txt

Specifies the output format. Defaults to ‘json’

Default: 'json'

--covergroup, -cg

Filter by covergroup name

--coverpoint, -cp

Filter by coverpoint name

--min-hits

Show only bins with at least this many hits

--max-hits

Show only bins with at most this many hits

--sort, -s

Possible choices: count, name

Sort bins by ‘count’ or ‘name’

tests

Display test execution information

ucis show tests [-h] [--out OUT] [--input-format INPUT_FORMAT]
                [--output-format {json,text,txt}]
                db

Positional Arguments

db: Path to the coverage database

Named Arguments

--out, -o

Specifies the output location for the report

--input-format, -if

Specifies the format of the input database. Defaults to ‘xml’

--output-format, -of

Possible choices: json, text, txt

Specifies the output format. Defaults to ‘json’

Default: 'json'

hierarchy

Display design hierarchy structure

ucis show hierarchy [-h] [--out OUT] [--input-format INPUT_FORMAT]
                    [--output-format {json,text,txt}] [--max-depth MAX_DEPTH]
                    db

Positional Arguments

db: Path to the coverage database

Named Arguments

--out, -o

Specifies the output location for the report

--input-format, -if

Specifies the format of the input database. Defaults to ‘xml’

--output-format, -of

Possible choices: json, text, txt

Specifies the output format. Defaults to ‘json’

Default: 'json'

--max-depth, -d

Maximum depth to traverse

metrics

Display coverage metrics and statistics

ucis show metrics [-h] [--out OUT] [--input-format INPUT_FORMAT]
                  [--output-format {json,text,txt}]
                  db

Positional Arguments

db: Path to the coverage database

Named Arguments

--out, -o

Specifies the output location for the report

--input-format, -if

Specifies the format of the input database. Defaults to ‘xml’

--output-format, -of

Possible choices: json, text, txt

Specifies the output format. Defaults to ‘json’

Default: 'json'

compare

Compare coverage between two databases

ucis show compare [-h] [--out OUT] [--input-format INPUT_FORMAT]
                  [--output-format {json,text,txt}]
                  db compare_db

Positional Arguments

db: Path to the baseline coverage database
compare_db: Path to the comparison database

Named Arguments

--out, -o

Specifies the output location for the report

--input-format, -if

Specifies the format of the input database. Defaults to ‘xml’

--output-format, -of

Possible choices: json, text, txt

Specifies the output format. Defaults to ‘json’

Default: 'json'

hotspots

Identify coverage hotspots and high-value targets

ucis show hotspots [-h] [--out OUT] [--input-format INPUT_FORMAT]
                   [--output-format {json,text,txt}] [--threshold THRESHOLD]
                   [--limit LIMIT]
                   db

Positional Arguments

db: Path to the coverage database

Named Arguments

--out, -o

Specifies the output location for the report

--input-format, -if

Specifies the format of the input database. Defaults to ‘xml’

--output-format, -of

Possible choices: json, text, txt

Specifies the output format. Defaults to ‘json’

Default: 'json'

--threshold, -t

Coverage threshold for low-coverage groups (default: 80)

Default: 80.0

--limit, -l

Maximum number of items to show per category (default: 10)

Default: 10

code-coverage

Display code coverage with support for LCOV/Cobertura formats

ucis show code-coverage [-h] [--out OUT] [--input-format INPUT_FORMAT]
                        [--output-format {json,text,txt,lcov,cobertura,jacoco,clover}]
                        db

Positional Arguments

db: Path to the coverage database

Named Arguments

--out, -o

Specifies the output location for the report

--input-format, -if

Specifies the format of the input database. Defaults to ‘xml’

--output-format, -of

Possible choices: json, text, txt, lcov, cobertura, jacoco, clover

Specifies the output format

Default: 'json'

assertions

Display assertion coverage information

ucis show assertions [-h] [--out OUT] [--input-format INPUT_FORMAT]
                     [--output-format {json,text,txt}]
                     db

Positional Arguments

db: Path to the coverage database

Named Arguments

--out, -o

Specifies the output location for the report

--input-format, -if

Specifies the format of the input database. Defaults to ‘xml’

--output-format, -of

Possible choices: json, text, txt

Specifies the output format

Default: 'json'

toggle

Display toggle coverage information

ucis show toggle [-h] [--out OUT] [--input-format INPUT_FORMAT]
                 [--output-format {json,text,txt}]
                 db

Positional Arguments

db: Path to the coverage database

Named Arguments

--out, -o

Specifies the output location for the report

--input-format, -if

Specifies the format of the input database. Defaults to ‘xml’

--output-format, -of

Possible choices: json, text, txt

Specifies the output format

Default: 'json'

view

Launch interactive Terminal UI for exploring coverage data

ucis view [-h] [--input-format INPUT_FORMAT] db

Positional Arguments

db: Path to the coverage database

Named Arguments

--input-format, -if: Specifies the format of the input database. Defaults to ‘xml’