User Guide: CLI: Matrix Operation Commands
Matrix Operation Commands
The following commands allow users to manipulate DSM matrices, including:
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