Stella Primer

Stella opens with a graphic menu that contains a number of icons.

The first four are the main building blocks for your model.
The rectangles are to represent the state variables, which are also called "Stocks" in Stella. They are to describe the elements in your system. These are the quantities that change in the system, that you analyze and report as a result of the modeling exercise. For each of the state variable a differential (difference) equation is to be created in Stella.
The flows represent the processes in which materials (or quantities) are taken from one state variable and added to another. The cloud is used to show that material is exchanged with the outside of the system.
Circles represent parameters or auxiliary variables (also called "Converters" in Stella. These are all the quantities that are either constant in the model or will be calculated based on the values of the state variables.
Lines with arrows are to show what depends upon what. They are to feed the value from one Stella icon into another. They cannot move material or quantities, they only convey information.

To build a model using these tools you first click on the State variable icon and then click somewhere in the window, where this variable will be located on the diagram. The variable appears with a "Noname" name. You click on this title and type the name that you want this variable to have.

Next you click on the Flow icon and choose where you want to draw the flow that will go into of from the state variable. Then you hold on the mouse button and drag the cursor from where the flow starts to where it goes. If you want a state variable to receive a flow or to be drained by a flow make sure that the State variable icon gets highlighted as you put the cursor on top of it. If it does then it will get attached to the flow. If it does not then it will not be associated with the flow and this might create a problem in the future if you do not notice that there is a cloud placed somewhere on top of your State variable or right next to it. You will be thinking that the flow is there, while in reality it is not.

As you drag the flow from one element to another, you can make it angle if you hit the Shift key. This is useful to keep the diagram tidy and clear. You then give a name to the "Noname" flow similarly to the above.

You may now need to add an auxiliary variable. In a similar way now you choose the circle icon and place it somewhere on your diagram. You give it a name. If you click and hold on any of the names of the elements in the diagram you can drag the name around the icon that it belongs to. This is useful to keep your diagram tidy.

Finally you use the connector arrows to link variables, flows and state variables. Just like with flows after you choose the connector icon you click the mouse on the origin of information and then drag the arrow to connect it with the recipient of the information.

By drawing this diagram you have already formulated one differential (or rather difference) equation that will go into your model:

Next you need to specify the actual size of FLOW and the initial condition for S_VARIABLE. Before you go any further you need to switch the model from the so-called "Mapping Mode" to the "Modeling Mode". This is done by clicking on the button on the left hand side. You may notice that "?" will appear on all elements in the diagram that need further definition.

If you double-click on the parameter icon, you get this dialogue window:

Even though it requires that you "place the right hand side of equation here" in reality all you need to do is give the value for the parameter that you want to use in your model. Suppose the rate we want to use in 0.01. We simply type that value in instead of the highlighted words and click on the "OK" button (or hit the "Enter" key). If for some reason you prefer only to click you can also use the numerical pad offered in the dialogue box. You can also use some arithmetic expressions, like 1/100, or choose some of the built-in functions that are listed there.

Next we double click on the flow icon and open this dialogue box:

Now indeed you are to "place the right hand side of equation here". The required inputs are listed above and if you click on any of them they will be copied into the equation field. Let us describe the flow as a product of the available stock in S_VARIABLE and the rate coefficient that we have already specified in PARAMETER:
PARAMETER*S_VARIABLE goes into the equation field.

We click "OK" and similarly double click on the State variable icon. This opens the dialogue window to specify the initial conditions.

The list of "Allowable Inputs" may be somewhat confusing, because it would be only on a rare occasion that you would need any of the flows or other state variables to specify the initial conditions. In most cases you will simply type a constant, say 10. Or you may store this constant as a parameter and then refer to it in this box.

Note that there is a check-box that says "Non-negative". By default all state variables come checked as non-negative. This can turn out to be quite misleading. You want the flows in your model to make sense and to work in such a way that the Stocks do not get depleted and negative. By clamping them with this check-box, you loose track of what is really happening in your model. You may well be generating some totally crazy behavior that is supposed to make a stock negative, however you will not even notice that if that variable is clamped. It is recommended that you keep this box unchecked, unless you really know what you are doing and have a clear understanding of the effect of various flows on the state variable.

Now that all the question marks are gone, your model is ready to run. You can also check out the equations that you have generated by clicking on the downward arrow in the upper left corner:

The equation here describes the exponential growth model that we have analyzed before:

Before you start running the model you need to specify how you want the output to look like. Let us go back to the other icons on top of the window. The next group of three are mostly for convenience and are not essential to create models. The first one allows you to place buttons in the diagram. This may be handy for navigation or for model runs. Instead of going through menus you can get something done by simply pressing a button right in the diagram. The next icon allows you to group certain variables and processes into sectors. This is useful to put some more order into the diagram. It also allows you to run only certain parts of the model. The third icon is to wrap certain details about processes and display them as one icon in the diagram. Also mostly serves esthetic purposes.

The next group of 4 are the Output Tools.
You click on the Graph icon, choose a place on the diagram and click again. A new window is open to display the graphs. Double click anywhere in that window and a dialogue box is open. By double clicking on any of the values in the left hand side you add them to the list of variables on the right hand side. These will be graphed (no more than 5 per graphic). You can check out the different buttons and options available. The most useful one is the scaling that is controlled by highlighting (clicking once) a variable among the selected ones and then clicking on the arrow to the right of it. Then you can change the minimal and maximal values for this variable that will define the scale in the graph.

In a very similar way you can define a Table to output values that variables take during the course of the simulation. Choose the Table icon, click anywhere in the diagram and a Table window opens. Double click anywhere in that window and a dialogue box opens.

Once again you choose the variables that you want to display and specify some of the characteristics of your Table. Also in a similar way you can generate output for an individual variable. In this case you will get the value that it attains by the end of the simulation.

As a result for the model that we were building we can design the output and run the model by choosing "Run" from the Run menu, or pressing Command-R (on a Mac) or Ctrl-R (in Windows). In this case we display the graphic of exponential growth quite similar to the one we have seen before.

Finally we can look at the Editing Tools presented by the fourth group of icons.
The navigation cursor (the hand) is the one you would be mostly using to open and close windows and to arrange elements of your diagram. The paintbrush icon is to add some colors to the diagram. You can color individual elements or change the color of your graphics. The icon that is supposed to look like dynamite is to delete things in the diagram. Be careful - there is no undo in Stella! If you blow something up - it is gone. To use this tool click on the dynamite icon, then choose the element you want to delete and click on it. What is to be blown away will be highlighted. Do not release the mouse button until you verify that what is to be deleted is what you really want to get rid of.

The ghost is very useful when you need to connect elements that are very far apart in the diagram. In that case the diagram gets too busy if you do all the connections directly. Click on the ghost icon, then click on any of the elements in the diagram you want to ghost. A copy of it will be created that can be put anywhere else in the diagram you need.

This brief overview covers only some of the basics of Stella. However it may be sufficient as a starter, since most of the dialogue boxes and menu options are quite self-explanatory and may be mastered by the good old trial and error method. Please note that:

  • You cannot connect two Stocks with an information flow. Only material Flows can change a Stock. The information about a Stock can affect a Flow, but not the information flow.
  • A material Flow is assumed positive. If it becomes negative Stella will clamp it to zero. A negative Inflow is actually an Outflow. Therefore since you specify the direction of your Flow, the sign matters, and Stella makes sure that all Flows are positive. If you need a Flow that can become negative, use the Biflow option. A Biflow can go in both directions. Make sure that you have the positive flow associated with the direction in which you first drew the Biflow. The negative flow will then go in the opposite direction.
  • You cannot connect auxiliary variables with material Flows. Only information flows are appropriate in this case.
Also please note the following rules of good style, when building your models:
  • Try to keep your diagram tidy. Avoid long connectors and confusing names. Avoid criss-crossing flows. The easier it is to read your diagram the less errors you will be making, the more appealing it will be to anyone else you need to explain the model to.
  • There is no such thing as too much documentation. Every variable or flow in Stella has a Document option, which is useful to record your ideas and comments about what you are modeling and the assumptions you are making. It is extremely important both for the model developer and the model user.

Copyright note: This course presentation is copyrighted material by Dr. Alexey Voinov, and all models, images and layouts are by Alexey Voinov unless specified otherwise. This material must be properly acknowledged just as if it were presented in a printed format e.g.: Voinov A. (1999). Simulation Modeling, Online Course.