Operating System: DisCVR runs on both Windows and Linux platforms. To use DisCVR, the users need first to download the appropriate folder for their operating system.
Java: 64-bit Java (1.8 or above) must be installed and the full path to the jre/bin folder should be included in the system variables. Java can be downloaded from: Link to Oracle
DisCVR.jar: After downloading the DisCVR zipped folder, it is recommended to use a tool, such
as 7-zip, to unzip the Windows OS version and extract all files to a local directory. For Linux
and Mac version, open a command prompt and move to the location of the zipped folder.
Type the following commands to unzip the folder:
tar -xzvf DisCVR_Linux.tar.gz
This creates a folder, called DisCVR. The contents of DisCVR consists of one jar: DisCVR.jar and a lib folder which are used to run the classification. The script file: downloadDataAndRefSeq.sh and the folders: bin, customisedDB, and TestData which are needed to build a customised database.
Dependencies: DisCVR uses external libraries such as KAnalyze, for k-mers counting, and JFreechart packages, for graphs plotting. It makes use of Tanoti, a Blast-based tool for reference assembly. These are 10 files in total and they are in the lib folder. It is important not to alter the lib folder or its contents and to ensure that it is in the same path as the jar file.
Compiling the source code: The easiest way to compile the source codes is to use the Ant Apache build tool
which is a free software and easy to install (https://ant.apache.org). The build.xml file is included with the source codes
which is used to compile all the files before creating the jar. Once the Ant tool is installed you need to add the build.xml
file to the same path as the source code and use the command:
ant`
Ant will take care of compiling all the files and sorting out dependencies on external libraries.
In that sense, you only need to modify the build.xml file to achieve your goals from compiling the source codes.
The Customised Database section in the operating manual has a detailed example of how to compile and
create the GUI using your own database.
To test if the tools are installed properly, open a command prompt and type the following:
java –version
. This should state java version 1.8.0_<some number>
java
. If the jre/bin is not added to the path, you will see the following message:
java is not recognized as an internal or external command, operable program or batch file
.