Documentation to construct and simulate grains models.



With Centyllion, create simulation with grains. A grain is an object in the simulation that evolve according to the behaviours. A grain has a name, a color, an icon and a half life property Crystal . It's able to move in the simulation space. A behaviour describes a possible change in the simulation depending on present grains. As a chimical reaction, some combinations of reactives will produce products . In addition to the reactives and products, a behaviour contains a name and a speed.

A model contains all the grains and behaviours for a simulation. It's the equivalent of the rules of a board game. A simulation is a space where are placed the grains to interact. It's the equivalent of on going game. For each simulation step, Centyllion collects all grains in contact that forms the reactives of a behaviour. All selected behaviours are filtered to avoid the use of the same grain twice and to conforms the behaviour speed. When all are applied, the grains moved, changed or disappeared and a new step can start. Each step, the behaviours selection is done randomly. The same simulation ran twice won't have the same result.

Centyllion is a multi agent system (Wikipédia).


In this section, we'll see how to edit a model with Centyllion. This first model simulate the creation of dendrites (Wikipédia) from liquid crystalisation. A version of this model is here.

To build the model, click on in the Home page. Now, you're on the edition page with an empty model. The header contains the model's name, description and a set of tools:

by me


Let's add two grains to our simulation:
  • One grain for the crystals Cristal ,
  • One grain for the solution Soluble .


Grains list





Add the crystalisation behaviour to the model: . When a Solution grain touches a Crystal, it will also crystalize.


Behaviours list





On the left, we select the reactives, ie the grains that triggers the reaction. In the center we have the products, which are the result of the reaction. On the right, we can select a product to a given source of the reaction so the grain will inherite the source's age. A grain produced with no source will be created with an age of 0.


Here will see how to prepare a simulation with the model created in the previous section. We'll put around 1000 Solution distributed in the simulation and one Crystal in the center. From this one Crystal, all Solutions will crystalise in a dendrite shape.

The Simulation tab, above the board, there are the controls:
Under the board, the edition tools allows to draw grains on the simulation board:

With the tool, the size and the grain , spray around 1000 Soluble over all the simulation board.

With the tool, the size and the grain , place on Crystal in the center of the board.

You can now run the simulation.

Initial simulation state
The result after 4000 steps
Contact us