User Guide: CLI: Arch Root Commands
DV8 Console Commands - ArchRoot Commands
ArchRoot Commands
This command returns a number of DSMs that cover a given portion of target issues. For example, it can return the DSMs that cover 90% of files that were modified two or more times to fix bugs.
Usage
dv8-console arch-root:arch-root [-frequency <FREQUENCY>] [-h] -outputFolder <OUTPUTFOLDER> [-percentage <PERCENTAGE>] -targetlist <TARGETLIST> DSM_FILE
Input
The input is a DSM file (*.dv8-dsm
) generated by DV8. If the DSM file contains history data, the output root DSMs will also include history information.
Options
frequency:
Target frequency threshold to determine error-proneness. Default is 2
. Files that have changed fewer times than the threshold will be ignored. For example, if the target is bug issues, a frequency threshold of 2
means files changed fewer than two times for bug fixes will be ignored.
outputFolder:
Specifies the folder where the root list file will be exported.
percentage:
Specifies the percentage of target issues to be covered. Default is 0.8
.
targetlist:
The target issue list file.
Example
dv8-console arch-root:arch-root -frequency 2 -targetlist targetcommitfreqlist.csv -percentage 0.8 -outputFolder root\arch-root structure-dsm.dv8-dsm