• Software requirements
• Installation
• Optional software
• Supplied external software - See External software for references.
• Replacing external software

Software Requirements

Required:

It has been tested on:

	tar -xvf TCW_4.tar.gz

	Executables:		
		 execLoadLib     execAssm        execAnno
		 runAS           runDE           runSingleTCW    runMultiTCW
		 viewSingleTCW   viewSingleTCW
	Directories:
		 java/jars     Ext/mac    Ext/linux     doc
		 R-scripts     scripts    projects 
	Text files:
		 HOSTS.cfg     README     LICENSE
	

	mysql -h server -u username -p
	

Note:

• The user must have sufficient privileges to create a new database.
• If you will be using the optional assembly feature, Innodb table must be enabled.
• Execute "./runSingletTCW -v", which will check some variable that can influence execution times.
  Also see Trouble MySQL.

Step 3: Open the HOSTS.cfg file in an editor.

	DB_host=localhost
	DB_user=
	DB_password=
	

Step 4: Test external programs Check that the external programs have executable permissions. On linux, check Ext/linux; on MacOS, check Ext/mac. You may want to run the compiled programs at the command line to see if they execute, e.g.

	./diamond
	Error: Syntax: diamond COMMAND [OPTIONS]. To print help message: diamond help

Please read the section below on "Supplied external software.

Step 5: Run runAS (see Annotation Setup) to obtain UniProt files and GO database. Other annotation databases can also be used, but TCW provides GO support with UniProt.

RJava for DE

	>install.packages("rJava")

	#JPATH=/usr/lib64/R/library/rJava/jri
	#JPATH=Ext/linux/jri
	#echo Using Linux path

	#JPATH=Ext/mac/jri
	#JPATH=/Library/Frameworks/R.framework/Resources/library/rJava/jri
	#echo Using MAC-OS path

Step 3. You must set the R_HOME environment variable (confirm the path on your machine):

	setenv R_HOME /usr/lib64/R                              # for Linux using tcsh
	setenv R_HOME /Library/Frameworks/R.framework/Resources # for MacOS using tcsh

R packages for DE

	>if (!requireNamespace("biocManager", quietly=TRUE))
	>install.packages("BiocManager")
	>BiocManager::install(version = "3.11")
	>BiocManager::install("edgeR")
	>BiocManager::install("goseq")
	>BiocManager::install("DESeq2")

²MUSCLE and KaKs_Calculator in the /Ext/mac directory work for MacOS 10.15, but not for MacOS 10.9. For 10.9, move the MUSCLE and KaKS_Calculator from /Ext/mac0 to /Ext/mac, as these work. If your using MacOS 10.10 to 10.14, try them from the command line to see what works.

MacOS Verify Catalina and later versions require verification of external software. See (see Running Ext/mac external programs).

The references for all TCW external software are provided in external references

The only external source code supplied is MstatX because a file had to be changed for it to work.

Blast and Diamond

1. You can define where the executables are in the HOSTS.cfg file using the blast_path and diamond_path parameters, e.g.

   	blast_path = /Users/cari/Workspace/bin/blast
   	diamond_path = /Users/cari/Workspace/bin/diamond
   

2. Use the default ones in /Ext.

3. If you have Blast and/or Diamond in a bin that is accessed by your PATH environmental variable, and want to use them, just remove the existing directory from /Ext/linux or /Ext/mac.

	blast_path = /Users/cari/Workspace/TCW_4/Ext/mac/blast

	./runSingleTCW -v

Go to top