Modeling in Numerus

In Modeling 101 you were introduced to the various paradigms and concepts of computational modeling. Here we discuss how these are realized in Numerus.

Basic Model Design in Numerus

It is important to grasp the extent of the Numerus platform in order to implement powerful and complex dynamical system and spatial, agent-based and network models. As described above, Numerus provides an impressive range and versatility of components to effectively design and execute these models. In addition, Numerus has the capability to implement designs using specialized analysis like Perceptrons and other Neural Network prediction algorithms. To utilize Numerus's capabilities we must first understand the basics of Numerus's Chip component and Population Models.

Dynamical Systems Models in Numerus

Numerus implements several different types of state component. These are distinguished by the fact that they maintain their values across time steps, as opposed to functional components like Terms, which recompute their values at each step. The four state components are:

Stock

The standard DS state component to which one or more Flows can be attached. The Stock's value is updated at each time step based on the values of its Flows.

Stock+Flow

A version of the Stock component with a single incoming Flow. Appropriate for translating a differential equation into a model element.

Sequence

A special type of Stock with a single incoming Flow. The Flow value replaces rather than adds to the Sequence's value.

Store

A container for a value that is modified by code. No state change takes place unless required by the code. A Store acts like a global variable for the capsule.

In Numerus we use the Stock and Flow objects. Stocks represent a pool of what we are measuring: infected population, nitrogen in lake water, and so on. Flows represent the movement of what we are measuring from one stock to another. This would be the flow of people from uninfected to infected population, or nitrogen from lake water to the algae population. Flows can also represent a source or sink of our measured quantity. A Source flow could represent immigration and births adding people, while a Sink flow would could represent people's deaths. Similarly a Source for nitrogen could represent runoff from farmland.

Spatial Models in Numerus

Spatial models in Numerus use a CellMatrix to represent the landscape of the simulation. The Cell is the fundamental unit of analysis. A CellMatrix maintains an array of cells in either a Cartesian or Hexagonal lattice topology, in which individual cells are aware of both their location and their neighborhoods. Conway's Game of Life [citation] is an example of such a model, with the cells “alive” and “dead” depending on the state of each individual cell's neighbors. Each cell's behavior is individually programmed as a Capsule, which is then assigned to the CellMatrix.

Agent Based Models in Numerus

Agent based models in Numerus are models that make use of an AgentVector. The AgentVector contains the population of Agents, as well as their location. In addition, Numerus includes Simworlds and Networlds. A SimWorld combines an AgentVector with a CellMatrix that provides a landscape. The Networld component uses a NodeNetwork for the same purpose. The SIR model is an example of an agent vector, with agents moving about an open space in three possible states, Susceptible, Infected, and Recovered. The Antz model is a more complicated model that uses both an agent vector and a cell matrix in order to simulate how ants collect food and leave a path for other ants to follow in order to find the same food.

Numerus has a lot of tools that make agent based models simpler and more robust. In particular, it is very easy to have access to all agents and cells from each individual agent, and to incorporate a wide variety of local and global effects. It also makes it simple to set up multiple Sim Worlds in order to see various outcomes simultaneously. It is also built on arrays and methods, which makes it simple to work on a small level to tweak the model to the user’s liking. On the other hand, the visual side of Numerus makes it so that it is easy to quickly and efficiently set up the shell of an agent based model and immediately get down to the more important details involved in the model. A savvy Numerus programmer will begin an agent based model visually and slowly transition over to handling the methods and functions in a more programming heavy reference frame.

Chip Basics

As the Numerus Glossary states, a Chip is a Container component which contains a single Capsule instance. A Capsule is a prototype for a simulation unit. It contains base components and may contain other chips, inputs, and / or outputs. These definitions may appear a bit vague or broad, however, that is simply because Chips and Capsules are widely used in a variety of ways within Numerus.

Chip structure and usage in Numerus may best be understood through example. Click here for an example of using a preexisting model (from the Model Library) and manipulating the ideas of model layers and chips.

Population Model 101

See the Simple Population Model tutorial in the Model Library. This tutorial demonstrates fundamental Numerus usage, including how to operate the Graphical User Interface, or GUI, and its algorithmic and mathematical design. You will see basic usage of the Modeling Canvas and the Dashboard as well as Numerus's intuitive mathematical design.

• Jump into NumerusMB's Operational Semantics here.

• Get a run through of NumerusMB's GUI here.