The “populator” application is built to be as intuitive as possible, so the best way to learn how to operate it, is to simply load and use it.
The “populator” app. is best viewed with the latest “Google Chrome”, but it has also been tested and is fully operational in the latest versions of “Mozilla Firefox”, “Apple’s Safari” and in “Microsoft Internet Explorer” version 9 or later.
Also, javascript has to be enabled in order for the “populator” to work.

1 Main Features

The screen of the app. is divided into two parts: the configurations panel and the view area (see figure 1↓, or just load the app. and try it).
figure man_screen.png
Figure 1 The “populator” initial screen.

Under “Potential properties”, one can choose the type of potential well that’s wanted and its dimension.
Particles list” is a list of predefined particles, that one can choose to populate the potential well with. Each particle line has a drawing (which is simply a legend), a quantity input field and other information about that particle. The quantity field only accepts integers in the range of [0, 50].
Custom particles can be added in the “Custom particles” part of the configurations, as explained below.
At last, to present the chosen configurations, one has to click on the “populate!” button.

2 Add Custom Particles

To add custom particles simply click on the “add custom particle” link, as many times as needed. Each click will add a new line to the custom particles list (see figure 2↓, or just load the app. and try it).
figure man_custom.png
Figure 2 Custom particles list

Each particle line has the following input fields:
The “Symbol & Color” (Sym.) field, allows one to choose a color and a symbol to help recognize the particle in the resulting diagram. There is no limitation on the symbols one can choose, but it is recommended to use no more than two letters for it.
The next field is the “quantity” (Qty.) field, which as before, can be any integer in the range [0, 50].
Next, there’s the “Name” field, which allows one to better describe the custom particle.
At last, there’s the “Spin” field, which lets one choose the spin property of the particle, out of a list of available spins (ranging from 0 to (7)/(2)).
To remove an unwanted custom particle, simply click on the “remove” link, at the right side of its line.

3 Additional Features

In the view area, the requested information is presented (after clicking on “populate!”) in a most minimalistic manner. Still, some additional information can be viewed by hovering with the mouse cursor over some points of interest (see figure 3↓, or just load the app. and try it).
figure man_tooltip.png
Figure 3 A result of some population configurations, with the tooltip window, showing some additional information about a particle.

In the tooltip window, when hovering over a particle in the view area, one can see the full name of the particle and its spin quantum number’s value (ms).

4 That’s All

It is as simple as that.