User Guide: CLI: Matrix Operation Commands


DV8 Console Commands - Matrix Operation Commands

Matrix Operation Commands

The following commands allow users to manipulate DSM matrices, including:

Merging multiple matrices;

Splitting a matrix into sub-matrices based on selected design rules;

Separating a large matrix into sub-matrices based on specified folders or files

Merge Multiple Matrices

This command merges two or more matrices into one new matrix.

Usage

dv8-console core:merge-matrix [-h] -outputFile <OUTPUTFILE> MATRIX_NAME1 MATRIX_NAME2...

Input

The input consists of multiple DSM files (*.dv8-dsm) generated by DV8.

Options

outputFile: Specifies the output file to create (*.dv8-dsm).

Example

dv8-console core:merge-matrix -outputFile merged-dsm.dv8-dsm structure-dsm.dv8-dsm history-dsm.dv8-dsm

Generate Sub-matrices that Depend on Selected Design Rules

This command splits a matrix into one or more sub-matrices based on selected design rules.

Usage

dv8-console dr-hier:dr-split [-h] -outputFile <OUTPUTFILE> -rule <RULES...> INPUT_FILE

Input

The input is a DSM file (*.dv8-dsm) generated by DV8.

Options

outputFile: Specifies the output dependency matrix file to create (*.dv8-dsm).

rule: Design rules separated by spaces. If multiple rules are given, they should be wrapped in double quotes.

Example

dv8-console dr-hier:dr-split -outputFile pdfbox-split.dv8-dsm -rule debugger.src.main.java.org.apache.pdfbox.debugger.hexviewer.HexChangeListener_java structure-dsm.dv8-dsm

Generate Sub-matrices for Selected Folders or Files

This command separates a large matrix into one or more sub-matrices based on specified folders or files.

Usage

dv8-console core:split-subsystem -delimiter <DELIMITER> [-h] -outputFile <OUTPUTFILE> -subsystem <SUBSYSTEMS...> INPUT_FILE

Input

The input is a DSM file (*.dv8-dsm) generated by DV8.

Options

delimiter: Specifies the delimiter for splitting (e.g., path separator or package separator).

outputFile: Specifies the output file to create (*.dv8-dsm).

subsystem: Subsystems separated by spaces. If multiple subsystems are given, they should be wrapped in double quotes.

Example

dv8-console core:split-subsystem -delimiter . -outputFile pdfbox-split.dv8-dsm -subsystem debugger.src.main.java.org.apache.pdfbox.debugger.hexviewer.HexChangeListener_java structure-dsm.dv8-dsm