Skip to main content.

How to use the interface


Learn how to open and run a simulation here.

Learn how to write your own simulation here.

View a demonstration of a simulation where the particles change state

Template Builder

Here you can define the template objects.

Instance Builder

Here you define the initial positions of instances of the objects that were described in the Template Builder.


To use the Simulator there must first be a template file (.tmpl) open in the Template Builder and a corresponding instance file (.obj) open in the Instance Builder.

Template Builder

Rule Template

The RuleTemplate component defines a single rule governing the behaviour of bonds.
A unique identifying name for this template.
Select one of When the rule is applied to a bond, it should either add a bond, block a bond from forming or drop an existing bond when the 'if ' condition is met.
If clauses
A list of conditions. Conditions are of the form:
arg1 comparator arg2 There must be a space between the arguments and the comparator. where comparator is one of ==, !=, <, <=, > and >= and arg2 is either a number or an id. arg2 can also be "null" (nothing there) or "*" (something there). arg1 is a path which starts with either this (the current bond), or that (the bond being tested). The item referenced by the path can be altered by appending any of the following onto the end of it with a full stop (e.g. this.particle): particle : get the particle containing the current bond (append to a bond only) object : get the object containing the current particle (particle only) particle-x : get the xth particle of the current object (object only) bond-x : get the xth bond of the current particle (particle only) connected : get the bond paired with this one (bond only) numConnected : get the number of bonds associated with this element (particle and object)
A probability of the bond occuring. The Probablity takes effect at the time specified by the corresponding Time. timeVal A time in seconds from the start of the simulation at which the associated probability takes effect.