Tree [ed6c05] master /
History



File Date Author Commit
contrib 2012-02-29 antolikjan antolikjan [4f5ce1] renamed push pull model to have .ty ending
debian 2011-10-01 ceball ceball [290eb3] Added optional overall timing option to runtest...
doc 2012-03-02 jbednar jbednar [6ef4c0] Fixed comment
etc 2012-02-13 jbednar jbednar [0dbed9] Updated for SVN; not tested exhaustively
examples 2012-02-05 Dobromir Stefanov Dobromir Stefanov [e5af2f] Replace usage of .basic in contrib/, doc/ and e...
external 2012-01-27 dstefanov dstefanov [658a40] Upgrade IPython to version 0.12
images 2011-10-01 ceball ceball [290eb3] Added optional overall timing option to runtest...
osx 2011-10-01 ceball ceball [290eb3] Added optional overall timing option to runtest...
param 2012-02-20 Dobromir Stefanov Dobromir Stefanov [42e533] API cleanup for param and topo.base
sounds 2011-10-01 ceball ceball [290eb3] Added optional overall timing option to runtest...
topo 2012-03-09 Dobromir Stefanov Dobromir Stefanov [ed6c05] Fix scriptrepr test and missing imports from -a
ChangeLog.txt 2011-10-20 jbednar jbednar [20ccf7] Fixed spacing
LICENSE.txt 2011-10-01 ceball ceball [290eb3] Added optional overall timing option to runtest...
MANIFEST.in 2011-10-05 ceball ceball [8cecbe] Include lissom snapshot (test data) in packages.
Makefile 2012-02-20 Dobromir Stefanov Dobromir Stefanov [62c84b] Show UAC prompt on Windows from exe installer i...
README.setup.txt 2011-10-01 ceball ceball [290eb3] Added optional overall timing option to runtest...
README.txt 2011-10-01 ceball ceball [290eb3] Added optional overall timing option to runtest...
create_topographica_script.py 2012-01-19 ceball ceball [46b359] Instead of 'make PYTHON=/path/to/python topogra...
setup.py 2011-10-05 ceball ceball [8cecbe] Include lissom snapshot (test data) in packages.
topographica.ico 2011-10-01 ceball ceball [290eb3] Added optional overall timing option to runtest...
windows_postinstall.py 2012-01-19 ceball ceball [46b359] Instead of 'make PYTHON=/path/to/python topogra...

Read Me

Topographica is a general-purpose neural simulator focusing on
topographic maps.  The simulator is under continuous development, and 
scripts developed for one version are likely to need modification to
run with subsequent versions.  Saved snapshot files will often
continue to work with new versions, but they are not guaranteed to do
so. 

This program is free, open-source software available under the BSD
license (see LICENSE.txt).


This document describes how to start with Topographica from the
complete set of source code, which includes source code packages for
all its dependencies.  Most users will instead want to start with the
pre-packaged distributions available for most platforms; see
topographica.org/Downloads for links and instructions.

Before you start, make sure that you have a copy of Topographica in a
directory where you have at least 1200MB of disk space available.


BUILDING DOCUMENTATION

To read more about Topographica before trying to build it, you can
build the documentation separately from compiling Topographica itself.
If PHP4, m4, bibtex, convert, and fig2dev are installed on your system
(as in most Linux distributions), just change to the topographica
directory and type "make doc reference-manual".  (This step is only
necessary when building from SVN; released versions include the
documentation already built.)  

Once the documentation has been built, load doc/index.html into your
web browser.  If there are any problems generating or reading the
local copy, you can instead use the web-based documentation at
www.topographica.org.  (The doc/ directory is just a copy of the
www.topographica.org site, although the web site will not necessarily
match this particular copy of Topographica.)

Alternatively, for each <file>.html you can simply read the
corresponding source file <file>_text.php in a text editor.


BUILDING TOPOGRAPHICA

The topographica directory includes the files necessary to build
Topographica from source code on most platforms.  All non-standard
external libraries are included and for most platforms are built from
source.  This approach makes the initial compilation time longer and
the simulator directory larger, but it minimizes the changes necessary
for specific platforms and operating system versions.

For specific instructions, see the "Build all Topographica's
dependencies" and "Building Topographica" sections in
doc/Developer_Manual/installation.html.


USING TOPOGRAPHICA

See doc/Tutorials/index.html for examples of getting started with
Topographica, and doc/index.html for all of the documentation.  You
can also get online help from the Topographica command line using
help(), or from the shell command line using "./bin/pydoc some-text".