Installing CCMSuite

CCMSuite is currently undergoing rapid development. This means that the software is changing on a daily basis. To make sure that you have the very latest version, this page describes how you can install CCMSuite in such a way as to allow you to quickly download all the latest changes as they occur.

The software we use to do this is called Subversion. This system allows files to be synchronized across different computers. By giving your computer a single command, it can connect to the main CCMSuite website and update every file that has changed since you last downloaded the system.

The process for doing this is different depending on which operating system your computer uses. Please follow the instructions below that best describe your situation.

Windows (Option 1, for people who prefer graphical user interfaces):

  • Install TortoiseSVN from http://downloads.sourceforge.net/tortoisesvn/TortoiseSVN-1.4.8.12137-win...
  • Restart your computer
  • Click here: svn://rob.ccmlab.ca/ccmlab/CCMSuite
  • Right-click on CCMSuite
  • Select Checkout...
  • In the box labelled Checkout directory, choose the folder you wish to put the CCMSuite source code into (for example, C:\CCMSuite).
  • Press OK.
  • Your computer will now download the latest version of the software to C:\CCMSuite.
  • Whenever you wish to re-download the system to ensure you have the latest version, go to C:\, right-click on CCMSuite, and select SVN Update.

Windows (Option 2, for people who prefer using the command line):

Mac OS X:

  • Install http://metissian.com/downloads/macosx/subversion/subversion-client-1.3.1...
  • Run the following command in Terminal:
    /usr/local/bin/svn checkout svn://rob.ccmlab.ca/ccmlab/CCMSuite ~/CCMSuite
    • you can change ~/CCMSuite to some other directory if you wish. If you leave it like this, it will create a directory called CCMSuite in your home directory.
  • Whenever you wish to re-download the system to ensure you have the latest version, run
    /usr/local/bin/svn update ~/CCMSuite

Linux:

  • Subversion is most likely already installed. If not, use whatever package manager your Linux distribution uses to install subversion. This is often done with a command like
    apt-get install subversion
  • Run
    svn checkout svn://rob.ccmlab.ca/ccmlab/CCMSuite ~/CCMSuite
    • you can change ~/CCMSuite to some other directory if you wish
  • Whenever you wish to re-download the system to ensure you have the latest version, run
    svn update ~/CCMSuite

Running CCMSuite Models

If you have used Subversion to install CCMSuite, Python needs to know where you installed it to so that it can find it. The easiest way to do this is to just put all of your programs in the CCMSuite directory. All programs run from there will automatically find all of the code in the ccm directory, and everything will work fine.

If you wish to be able to run programs that use CCMSuite from anywhere, you need to tell Python where to find it. The most general way to do this is to add a small file into the site-packages directory. On windows, this will be in some location like C:\Python24\Lib\site-packages, but this location may vary depending on where it has been installed. A similar directory will be found for OS X and Linux. You should make a file in this directory called CCMSuite.pth. The contents of the file should be the directory you have put CCMSuite into. For example, if you installed it to C:\CCMSuite, as suggested above for windows, you would make a text file (using Notepad or some other text editor) with the following contents:

C:\CCMSuite