Cartesian Genetic Programming (CGP) implemented in Julia.
Julia Shell
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
examples
src
test
.gitignore
.travis.yml
AUTHORS
LICENSE.md
README.md
REQUIRE
Vagrantfile
runtests.sh

README.md

CartesianGP.jl

Build Status

CartesianGP.jl is a library for using Cartesian Genetic Programming in Julia. It is being developed at the University of Montana in Missoula, MT for use in simulating the evolution of technology, though there is nothing specific to that application in the library so it is (will be) perfectly suitable for other applications as well.

Note that the code should be considered pre-alpha at the moment, though we are making rapid progress. We will tag a release when we feel it is useful. Until then, feel free to take a look at the code and send us questions or submit pull requests (though you might want to consult with us first just to make sure you aren't duplicating effort).

If you have questions or comments, please contact one of the authors (see AUTHORS).

Examples

The examples/ directory contains (or will soon contain) some examples of using CartesianGP.jl to evolve actual circuits. These can be used as blueprints for implementing your own simulations. Right now the example code is pretty rough, but it will improve over time and will eventually include comments and documentation to help with getting started.

Development

Tests

You can run the test suite against the code currenting in the working directory of the repository by running the runtests.sh script. If you want to test the library once you have installed it through Julia's package manager (using Pkg.clone(...) or otherwise) you can use Pkg.test("CartesianGP") from within the Julia REPL. This will not, however, test any modifications you have made to the code that have not been committed, use the script for that.

Vagrant

There is a Vagrant configuration file (called Vagrantfile) in the repository root that will provide two properly configured development and test-running environments (using Virtualbox behind the scenes). One will run the release version of Julia, and the other will run the nightly version. This is especially helpful for Mac and Windows users for whom keeping Julia up-to-date can be a bit of a challenge.

Additionally, this method protects the developer's system Julia packages, which is ideal for people who are both using and developing CartesianGP.jl.

Once Vagrant is installed, bring up the VMs with the following command:

$ vagrant up

Optionally, and this applies to most of the vagrant commands, you can include either "releases" or "nightlies" after the command to apply the action to only one of the machines. So to bring up just the "releases" machine you would do:

$ vagrant up releases

An SSH session can then be opened with vagrant ssh <releases|nightlies>. However, the tests can be run on the VM without doing this. Just use ./runtests.sh <releases|nightlies|all>. The VM must be running already for this to work.

To shut down the VMs:

$ vagrant halt

To destroy the VMs (and free the hard drive space used to store their disk images:

$ vagrant destroy