DV8 Console Commands - Understand File Commands

Understand File Commands

The DV8 Console provides file conversion commands, such as converting a Cytoscape dependency file into a dependency matrix file (*.dv8-dsm).

Usage

dv8-console cytoscape:convert-matrix [-dependPath <MAPPING_FILE>] [-h] [-outputFile <OUTPUTFILE>] INPUT_FILE

Input

The input file must be a Cytoscape dependency file. You can use Understand as a preprocessor to export the Cytoscape file from analyzed source code.

Options

(1)

dependPath:

Specifies the location of a custom dependency type mapping file. This option is not mandatory, as DV8 provides a default dependency mapping covering the most common dependency types. However, if a missing dependency type is encountered during processing, you will need to supply a custom dependency mapping file. A sample mapping file is available in

dv8-console\samples\dv8-dependency.mapping

. (2)

outputFile:

Specifies the output file to be created in the format

*.dv8-dsm

. (3)

Dextended.config:

Resolves inconsistencies between file path prefixes in the dependency and revision history files. This option requires an extended configuration file. For example, a file path in the dependency file might look like

"C:\pdfbox\pdfbox\src\main\java\org\apache\pdfbox\pdmodel\PageMode.java"

, while in the revision history file it may appear as

"pdfbox\src\main\java\org\apache\pdfbox\pdmodel\PageMode.java"

. To fix this discrepancy, you can specify the prefix to be excluded by editing the

<value>

block in the configuration file

dv8-extended-config.xml

. Enclose the path to be excluded in quotation marks (required in some terminals, like Windows PowerShell). The sample configuration file is available in

dv8-console\samples\dv8-extended-config.xml

.

In the extended configuration file, multiple prefix strings can be excluded using multiple <value> blocks.

Example

dv8-console cytoscape:convert-matrix -outputFile pdfbox_structure.dv8-dsm -dependPath dv8-dependency.mapping "-Dextended.config=dv8-extended-config.xml" cytoscape.xml