Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Code for "Intrinsically Motivated Collective Motion"

Update: paper has now been published in PNAS: Note that the code here is only for the discrete sensor version of the model, using the ballistic heuristic for the future trajectories of the other agents.

This is example code for the collective motion model I've been working on during my PhD. Running it as it is will run using the default parameters for 1000 timesteps.

Example Results (click images below to watch video):

Visualizing the Model:

I made some apps in D3.js to help understand what's going on.

Visual State Definition (click image below to open app):

Each agent (or "bird") has a visual state which is defined in terms of the projection of the other birds onto its angular field of view. This is then divided up into a discrete number if sensors which read either a 1 or a 0 depending on whether or not they are more than half filled.

Future State Maximization (click image below to open app):

Each bird has five decisions available to it at each time step. It can continue to move in its current direction at v0, v0+dv or v0-dv, or it can move at v0 but change its orientation by +/- dTheta. To make this decision the agent models a tree of possible futures for each move that it currently has available to it whilst (by default) modelling the other agents as moving in a straight line (although we also experiment with different future models). Each of these leads to a branch of different possible future states that each has a visual state (a vector of 1s and 0s) associated with it and the agent chooses the move which leads to the largest number of unique future visual states. Each agent chooses how to update itself in exactly the same way.

Training a Neural Network to Mimic This Model

The full model requires modelling a large number of future trajectories for each bird at each timestep. This is clearly very computationally intense (especially the further into the future we look) and not at all realistic for a biological organism. As such, we decided to see if it would be possible to train a neural network to give qualitatively similar results to the full model but using only the current visual state (and it turns out to be necessary to include the previous state too). We do this by running the full model and recording the visual states when each decision is made, as well as recording each decision and using this as a target for the neural network to fit. A comparison with the full model is shown below:

and we see it works very nicely (albeit not quite perfectly)!


Main code for the collective motion model I've been working on during my PhD. Includes some apps made using D3.js to help describe the model.






No releases published


No packages published