IQ-SCM / soie

Self-organization Interactive Evolution (SOIE) is a simulation interface, allowing the interactive exploration of self-organizing particle systems.

Self-organization Interactive Evolution (SOIE)

SOIE is a GUI application written in Python and C++ for the interactive exploration of simulations of self-organizing active particles. The associated paper is here.

Installation Guide

This software is written in Python 2.7 and requires pip and virtualenv to set up.

Prerequisites

• Check your Python version. Type in command line:

python -V

• Check that you have pip and virtualenv installed. Type in command line:

pip --version
virtualenv --version

Installing

• Install SOIE dependencies in virtualenv. In command line, go into the root folder of SOIE, set up a virtual environment, and install dependencies through pip:

cd [path to SOIE]
virtualenv venv
source venv/bin/activate
pip install -r requirements.txt

where [path to SOIE] is the location of the downloaded SOIE code, for example, ~/Downloads/soie-master.

Usage

If you have followed the installation guide, you are already inside a virtual environment. If that is the case,

• Launch the application directly by typing in command line:

python -m app

Otherwise,

• Activate the virtual environment first, and then launch the application:

source venv/bin/activate
python -m app

Tutorial

Applying genetic operators

Manually adjusting parameters

Importing from library and adjusting display settings

Changing permissible parameter range

Examples

Replicating the Vicsek model

Replicating the Social Differential Adhesion model

License

MIT License