CarthaGene installation procedure depends on the operating system you are using. Please select your system below:

• Linux
• Microsoft® Windows™

To install CarthaGene on Windows, you must do the following:

• Installing ActiveTcl

  1. Download the aActiveState ActiveTcl 8.4 from mirror.
     

  2. Execute this program and follow the on-screen instructions until it completes. WARNING : to install this package you must be a privileged user (Windows XP, 2000 or NT) or the rest of the installation will fail.

     For Windows Vista, you can either execute the installer as administrator (right-click on the file and select the corresponding entry, this will install the package for all users on the computer) or execute it as an unprivileged user (double click on the file, this will install the package on your account only).

  3. You now have a working version of ActiveTcl installed on your computer.

• Installing CarthaGène

  1. Run the Carthagene-1.2.R-win32.exe executable you downloaded.
  2. When asked if the carthagene executables must be set in "user" or "system" path, choose "system" (or "user" if you aim at a user standalone installation)
  3. This is it. You can now directly execute CarthaGene from the Windows "Start" menu.
  4. If the user interface doesn't start, check the contents of the C:\Program Files\CarthaGene 1.2.*\tcl\cgwlog*.txt file for error messages.
     The actual path depends on the version of CarthaGène that you installed (1.2.0 or 1.2.R) and the actual filename is cgwlog followed by a number that varies each time you run CarthaGène followed by .txt.

If you don't want to use the graphical interface but only the Shell interface, simply select the CarthaGene console item in the Start menu.

Installing CarthaGène

If you are using a Debian-based distribution, you can simply install the .deb package you just downloaded for a system-wide installation.

Otherwise, read further...

Dependencies

CarthaGene relies upon the following packages to run (names may slightly differ from a distribution to another):

• tcl
• tk
• tcllib
• tklib
• itcl
• itk
• bwidget
• iwidgets
• blt
• tclreadline or tclx (prefer tclreadline if available; command history is not available when using tclx.)

Alternatively, you can install ActiveTcl (at least 8.4).

System-wide installation

We provide DEB packages for both 32 bits and 64 bits architectures.

1. Select the package corresponding to your distribution and architecture (32 bits users must use the i386 package, 64 bits users must use the x86_64 package).
2. Use your favorite package manager to install CarthaGene.

Local installation

We provide self-extracting shell scripts (.sh) for both 32 bits and 64 bits architectures.

1. Download the archive corresponding to your architecture (32 bits users must use the i386 package, 64 bits users must use the x86_64 package).
2. Go in the directory where you want to install the software and run the script from there.
3. Once you have accepted the licence, the installer will offer you to install either directly in the current directory or (by default) in a subdirectory named CarthaGene-VERSION-Linux-ARCH (currently VERSION is 1.2 or nonfree-1.2 and ARCH is one of i386 or x86_64).
4. After the script finishes executing, source your shell's rc file to update your environment or start a new session.
5. CarthaGene is then ready to use.

NOTE: you can use the .sh package to perform a system-wide installation. Just run the script from /usr (as superuser) and anwser "no" to install in the current directory instead of the CarthaGene subdirectory.

Example: installing CarthaGene with LKH code (version nonfree-1.2) in a subdirectory in your $HOME on a 32 bits system

% cd
% /path/where/you/downloaded/carthagene-nonfree-i386.sh
  - read and accept the licence
  - answer Y to install in a subdirectory named carthagene-nonfree-1.2-i386
Then update your environment
% source ~/.cshrc	# for csh and tcsh users
% source ~/.bashrc	# for bash users
	

Running CarthaGene

• To start the command-line interface (CarthaGene shell), run

  % carthagene

• To start the graphical interface, run

  % carthagene -i

• To run a script in non-interactive mode, run

  % carthagene my_script

  or

  % cat my_script | carthagene

  or

  % carthagene < my_script