Time index details

Analytica User GuideDynamic SimulationTime index details

Reference to earlier time

Time - k in the expression var[Time - k] refers to the position of the elements in the Time index, not values of Time.

For example, if Time equals [1990, 1994, 1998, 2002, 2006], then the value of Gasprice[Time - 3] in year 2006 would refer to the price of gasoline in 1994, not 2003. When you refer to the Time variable directly, not as an index, the expression refers to the values of Time. For example, the expression (Time - 3) in 2006 is 2003.

The offset, k, can be an expression, and might even be indexed by Time. When k is indexed by Time, then the offset varies at different points in Time. However, Slice(k, Time, t) must be between 1 and t - 1. It must be positive since the expression is not allowed to depend on values in the future (that have not yet been computed). It must be less than t - 1 since the expression cannot depend on values “before the beginning of time.”

Defining time

There are three ways to define the Time index, each of which has different advantages:

Sequence (the preferred method)
List (numeric)
List of labels (text)

Time as a sequence

Using the Sequence() function is the easiest way to define Time with equal intervals (see “Expression view” on page 172 and “Defining a variable as an edit table” on page 178). The numeric values for Time can be used in other expressions.

Example:

Time as a list (numeric)

When Time is defined as a numeric list, it usually consists of increasing numbers. The intervals between entries can be unequal, and the values for Time can be used in other expressions.

Example: Time

When you use time periods that differ by a value other than 1, typing (Time-1) won’t provide the value of the previous time period. You can use the syntax x[Time-1] if you want to utilize a variable indexed by Time, but if you want to perform an operation that depends on the difference in time between the current time period and the last one, you must first create a node that uncumulates the Time index.

YearsPassed: Uncumulate(Time)

Now you can include this node in a dynamic expression that depends on the time between time periods. The following definition is equivalent to the Dynamic() definition on page 323 but allows for changes in time period increments.

Gasprice := Dynamic(1.2, Gasprice[Time - 1]*1.05 ^ YearsPassed) →

Time as a list of labels (text)

When Time is defined as a list of labels, Time values cannot be used in other expressions as numbers.

The resulting graph of any Dynamic() function, with the x-axis set to Time, shows the labels at equal x-axis intervals.

Example: Time

Gasprice := Dynamic(1.2, Gasprice[Time-1]*1.05) →

Using Time in a model

You can use Time like any index variable; you can change only its title and definition. To include the Time node on a diagram:

Open the Object window for Time by selecting Edit Time from the Definition menu.
Select Make Alias from the Object menu (see “An alias is like its original” on page 51).

When the Time node displays on a diagram, arrows from Time to all dynamic variables display by default.