Vita Genetic Programming Framework
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.

README.md

VITA

Overview

Vita is a scalable, high performance genetic programming / algorithms framework.

It's suitable for classification, symbolic regression, content base image retrieval, data mining and agent control. Main features:

  • flexible, fast and clean design
  • easy integration with other systems
  • simple addition of features and modules
  • fast experimentation with detailed run-log
  • modern, standard ISO C++14 source code
  • more

It's distributed under the Mozilla Public License v2.0 (see the accompanying LICENSE file for more details).

This software was originally developed by EOS without open source in mind. Later (early 2011) the code has been commented, restructured, documented and released as open source.

Although the core development team is still anchored at EOS, Vita is now open source and we would like it to be run by an international team of AI enthusiasts.

Build requirements

Vita is designed to have fairly minimal requirements to build and use with your projects, but there are some. Currently, we support Linux and Windows. We will also make our best effort to support other platforms (e.g. Mac OS X, Solaris, AIX). However, since core members of the Vita project have no access to these platforms, Vita may have outstanding issues there. If you notice any problems on your platform, please use the issue tracking system; patches for fixing them are even more welcome!

Mandatory

  • A C++14-standard-compliant compiler (or, at least, partially compatible: e.g. gcc v5.3.x or newer, clang 3.8 or newer)
  • CMake

Optional

Getting the source

There are two ways of getting Vita's source code: you can download a stable source release in your preferred archive format or directly clone the source from a repository.

Cloning a repository requires a few extra steps and some extra software packages on your system, but lets you track the latest development and make patches much more easily, so we highly encourage it.

Run the following command:

git clone https://github.com/morinim/vita.git

The Vita distribution

This is a sketch of the resulting directory structure:

vita/
  CHANGELOG.md.............Don't let your friends dump git logs into changelogs
  CODE_OF_CONDUCT.md.......Standards for how to engage in this community
  CONTRIBUTING.md
  LICENSE
  README.md
  copyright
  contributors/
  doc/
  misc/
  src/
    CMakeLists.txt
    build/ ................Built executables
    examples/ .............Various examples
      forex/ ..............Forex example
      sr/ .................Symbolic regression and classification utility
    kernel/ ...............Vita kernel (core library)
    test/ .................Test-suite
    third_party/ ..........Third party libraries
    utility/ ..............Support libraries / files
  tools/ ..................C++ lint checker and other tools

Setting up the build

cd vita/src
mkdir -p build
cd build/
cmake ..

To suggest a specific compiler you can write:

CXX=clang++ cmake ..

You're now ready to build using the traditional make system:

  • everything: make
  • kernel library (libvita.a): make vita
  • sr tool: make sr
  • tests: make tests
  • the ABC example: make ABC
  • for the list of the valid targets: make help

All the output files will be stored in subdirectories of build/ (out of source builds).

Windows may need various expedients about which you can read in the Windows walkthrough.