|
|
| Installing Topographica using SubversionSubversion (SVN) is the version control system used for managing Topographica development. SVN keeps track of every change made to any file, and can reconstruct the state of the software from any date and time in the history of Topographica development since 2004. The Topographica SVN repository is hosted by SourceForge.net. The essentials for using SVN at SourceForge are described below; see the SourceForge SVN documentation for more details or if you have any difficulties. You will need to run at least SVN 1.4 on your machine; SVN clients 1.3 and below will complain that they are too old to communicate with our repository. If you don't need the very latest updates, you can simply download a released version instead of using SVN. In the instructions below, you will need to choose whether you want the very most recent version, with changes made daily, or only the most recent stable version. The very most recent version will be called "bleeding-edge" (or "trunk") below, while the stable version will be called LATEST_STABLE. Developers will want the very most recent version, as will those working closely with developers. Others will probably want to stick to the LATEST_STABLE version except to fix specific problems. Downloading via SubversionThe SVN installation instructions differ on the various platforms, as outlined below. Regardless of platform, please note that the Topographica repository contains some very large files, and the SVN download process may appear to hang or freeze at various times while these files are downloaded. Unfortunately, SVN does not provide any sort of feedback that this is occurring, so please just be patient when downloading. Such pauses should be rare after the first SVN download, unless one of the large files has been updated.The location (URL) of the Topographica repository is: https://topographica.svn.sourceforge.net/svnroot/topographicaIn commands given on this page, $TOPOROOT is used to
represent that URL, so please replace it in commands you enter. (For
instance, linux users might first type
export TOPOROOT=https://topographica.svn.sourceforge.net/svnroot/topographica,
and then $TOPOROOT will be substituted for them in the
commands below.)
Linux/UNIX:Most Linux and other UNIX platforms already have all of the necessary programs and libraries required for Topographica. But if your distribution does not includesvn
or php by default, first obtain versions of those programs
for your system and install them.
The Topographica files can be checked out by using the command: svn co $TOPOROOT/tags/LATEST_STABLE/topographica topographica This will create a To get the bleeding-edge (trunk) version, replace The checkout process will likely take several minutes (probably appearing to hang at certain points), as there are some extremely large files involved. Mac OS X:Topographica can be built on Mac OS X (or later) using the Linux instructions above, but you will likely first need to install several packages required by Topographica. These instructions also assume that you will be using Mac OS X 10.4 (Tiger); other OS X versions may require small changes to this procedure, to make sure that compatible libraries are available. On that version of the system, you would do:
If you have trouble running Once these programs are installed, simply follow the Linux instructions above. Windows:Please note that we have only recently moved from an older revision control system (CVS) to SVN, and the SVN setup on Windows is not yet complete. To get the SVN version to build on Windows as of 1/2008, you will probably need to update some of the included external packages. Under Windows, we recommend installing TortoiseSVN (tested 01/2008 using TortoiseSVN 1.4.7), which comes as an easy-to-install executable. In general, TortoiseSVN users can easily translate commandline SVN instructions (e.g. those we give for linux users) by right clicking in an SVN-controlled directory and choosing the appropriate command from the TortoiseSVN submenu. After installing TortoiseSVN if you do not already have it, open
the Windows directory where you want the Topographica files to be
located on your machine (you might first wish to create a
'topographica' folder), then right click, select https://topographica.svn.sourceforge.net/svnroot/topographica/tags/LATEST_STABLE/topographicaEnsure that the Checkout directory shows the location
into which you want the files to be placed (e.g. c:\Documents
and Settings\username\My Documents\topographica), then
click OK. As the files download, you will be informed of
the transfer speed and amount transferred; the total as of 01/2008 is
about 85 MBytes.
Following this step, it is necessary to obtain the Windows versions
of Topographica's support tools. In the folder that contains your
new https://topographica.svn.sourceforge.net/svnroot/topographica/tags/LATEST_STABLE/topographica-winAfter clicking OK, you will have to wait longer
than last time, since the Windows support tools are distributed as
binaries (the total as of 01/2008 is about 125 MBytes).
Once the transfer has completed, move
the Now that you have TortoiseSVN installed, and the SVN version of Topographica, you can return to instructions for building Topographica. Cygwin:Cygwin is a set of Unix commands and libraries that make it possible to compile most Unix programs under Windows. In principle, it should be possible to use Topographica under Cygwin, because all of the core Topographica files are platform independent. However, some of the external packages included with Topographica (e.g. python's Tkinter) automatically detect that they are running under Windows, and install non-Cygwin versions of themselves. Users interested in modifying these makefiles so that Topographica can be installed under Cygwin should contact Jim for more details. Updating using SubversionLinux/UNIX/Mac users who have Topographica checked out via SVN can update their copy of Topographica by changing to the directory containing the Topographica files and then doing:svn update make If you previously checked out the LATEST_STABLE version of Topographica, this will update to the current LATEST_STABLE code. If you previously checked out the bleeding-edge (trunk) version of Topographica, this will update to the absolute most recent version of the code. If you wish, you can switch your copy of Topographica to a different version of the code. For instance, if you currently have the trunk version, you can switch to the LATEST_STABLE version by typing: svn switch $TOPOROOT/tags/LATEST_STABLE/topographicaTo switch from the LATEST_STABLE version to the trunk version, replace tags/LATEST_STABLE with trunk. (Note that
before deciding whether to update to the bleeding-edge (trunk)
version, you can check its
status.)
Alternatively, to switch to a separate branch named 'some-branch', replace
tags/LATEST_STABLE with branches/some-branch
You can discover if your copy is from the trunk or a particular
branch or tag by typing Windows TortoiseSVN users can right click in the topographica
directory and select Note that updating the external/ subdirectory sometimes takes a long time, if some of the external packages have been upgraded, and in that case "make" can also take some time to build. |
|