Home > Modeling Tips > Methods for Using Arrays Effectively, Part 1

## Methods for Using Arrays Effectively, Part 1

This is the first installment of a four-part series. The remaining three parts can be accessed by clicking on the links below.
Modeling a Watershed with Arrays
Modeling Customers Switching Between Brands
Modeling Customers Switching Between Brands – The General Case

Using arrays can be quite intimidating for most people. Many times, it is difficult to discover the correct way to formulate a problem in terms of arrays, especially when trying to do so in terms of single equations that can be applied to all elements of the array.

Consider the case where you might wish to count the number of occurrences of a value in an array. This can arise in many applications that need to track attributes, but is prevalent in spatially-explicit business applications. In such an application, you may associate a product code with a location and then want a count of the products of a given type. The following examples demonstrate a common way to extract conditional information from an array.

Finding the Number of Stations with a Given Status

Imagine you have a two-dimensional grid of fire stations in a city, called Stations, that stores one of four statuses:

0: no station in this sector
2: away on a call
3: refitting

You consider the number of fire stations ready at any given moment to be an important metric. To calculate this, connect Stations to another two-dimensional array of the same size called ready stations. This will have a one in an array element if the station for that quadrant is ready and a zero otherwise. Its equation is:

IF Stations[Y, X] = 1 THEN 1 ELSE 0 { station ready? }

Note this equations uses dimension names (i.e., Stations[Y, X]) rather than element names (e.g., Stations[1, 2]). This allows you to create just one equation for the entire array (with “Apply to All” turned on), rather than a separate equation for each individual array element (with “Apply to All” turned off). When “Apply to All” is turned on, the equation for each element of the array is automatically generated by substituting that element’s dimensions for the dimension name in the given equation. All of the examples in this post use dimension names.

The total number of ready stations is now just the sum of all of the elements in the array ready stations. This is easily calculated by connecting ready stations to a scalar converter named total ready stations that has the equation

The model is shown below and can be downloaded by clicking here.

This general method can be used anytime we need to count the number of elements in an array based on some condition. First, create an array that has its elements set to one if the array-based condition is met and zero otherwise (IF condition THEN 1 ELSE 0). Then create a converter to sum the elements of this new array (using ARRAYSUM). Remember to turn “Apply to All” on and use dimension names in the condition rather than element names.

Finding the Number of Stations with Each Status

We can extend this method to map data from an array indexed by one attribute (or dimension), say location, to another array indexed by a different attribute, say status. Imagine now that instead of just counting how many stations are ready, you want to know how many stations have each status.

One way to do this is to extend the structure above to separately count the number of stations in each status, as shown below.

In this case, away stations and refitting stations have the following formulas, respectively:

IF Stations[Y, X] = 2 THEN 1 ELSE 0 { station away? }
IF Stations[Y, X] = 3 THEN 1 ELSE 0 { station refitting? }

Walking Through a Specific Example

Let’s look at what happens in this model if array of fire stations is only one-dimensional, Stations[Location], and each location is named. This eliminates the “no station in this sector” status. Consider a five-location fire department with the following statuses in each location, held in the array Stations:

 Location Status North 1 (ready) South 3 (refitting) Central 1 (ready) East 2 (away) West 1 (ready)

The structure above would generate the following values in the three separate arrays ready stations, away stations, and refitting stations. Their respective sums, in the three corresponding “total status stations” converters, are shown at the bottom.

 Location ready stations away stations refitting stations North 1 0 0 South 0 0 1 Central 1 0 0 East 0 1 0 West 1 0 0 total status stations 3 1 1

While this method works, it does not have a very flexible structure. It requires structural changes whenever a new status is added (or removed) and also needs to be customized for every individual application. There are also applications (for example, tracking products) where it is necessary to move between arrays that are indexed by location, as Stations is, and arrays that are indexed by the data within the location, in this case by status.

A More General Solution

If we define another array dimension called Status, with element names Ready, Away, and Refitting that correspond to the numeric statuses 1, 2, and 3, we can represent this same solution in one two-dimensional array station map[Location, Status]:

 Location Ready Away Refitting North 1 0 0 South 0 0 1 Central 1 0 0 East 0 1 0 West 1 0 0

The array station map allows us to map stations directly to their statuses. Each row of the map represents one station. By definition, there can only be one “1″ in each row because a station can only have one status. The sum of each row is the number of statuses that are assigned to that station, which must always be one. Each column of the map represents one status. Multiple “1″s can appear in the columns because many stations can have the same status. The sum of each column is the number of stations assigned to that status, the value we are trying to determine.

Note the similarity between this two-dimensional array and the preceding table that shows the contents of the individual one-dimensional arrays ready stations, away stations, and refitting stations. Each column of station map corresponds to one of these one-dimensional arrays.

The model for this more general solution is shown below and can be downloaded by clicking here.

The equation for station map[Location, Status], which will map Stations as illustrated above, is

IF Stations[Location] = ARRAYIDX(2) THEN 1 ELSE 0

Note the use of ARRAYIDX() to parameterize the status we are interested in for this array element. The parameter to ARRAYIDX, 2, gives the index of the second dimension for this array element, i.e., the index that corresponds to Status. Since Apply to All is on, this will become the desired status for each array element.

The number of stations with each status is calculated in the one-dimensional converter station totals[Status] using the equation

ARRAYSUM(station_map[*, Status])

This equation sums the columns of station map. For the above example, station totals will be filled with the values 3 (Ready), 1 (Away), and 1 (Refitting). Note we have used an intermediate two-dimensional array, station map, to properly map our data from a one-dimensional array indexed by the attribute Location to another one-dimensional array indexed by the attribute Status.

Next time, I will expand this concept to create general routing structures.

If you enjoyed this post, make sure you subscribe to my RSS feed!
Categories: Modeling Tips Tags:
• Paula

Good afternoon:
I have to sum the rows of a one dimension array, but I don’t find any function that works… Can you help me?
Thank you

• http://blog.iseesystems.com Jeremy Merritt

Hi Paula. You can do this using the ARRAYSUM function. This is the description from the Help file:

ARRAYSUM()
The ARRAYSUM Builtin calculates the sum of all the elements in a given one or two dimensional Array. The calculation can be done in either an arrayed or a non-arrayed variable.

When using the ARRAYSUM Builtin to report the sum across a one-dimensional arrayed variable, you must choose [*] from the secondary dialog, which indicates that you want the sum across all the elements within the variable.

When using the ARRAYSUM Builtin to report the sum across a two-dimensional arrayed variable, it is possible to calculate it in three ways:

To report the sum across both dimensions of the arrayed input variable, select [*,*] in the secondary dialog. You can report the arrayed variable’s sum in either an arrayed or a non-arrayed converter or flow.

Example:

Total Salary for All Employees = Salaries[*,*]

With this Builtin, you can also report a value across one dimension of the arrayed input variable, or roll up a value across (or down) one dimension of a two-dimensional arrayed variable into a one-dimensional arrayed variable.

• Franco_lezcano_91

Hello. First of all, sorry for my bad english, i am from peru, and I`m working with Stella, doing some proyects for the university. I`d like to know how to get the sum of a flow element in diferent time.
Iam planning to use an array, but the thing is that i dont kwno how to use it, wolud you help whit some basic example

thanks!!