# Time-varying values

#### 2019-10-22

In more complex Markov models state values or transition probabilities can vary with time. These models are called non-homogeneous or time-inhomogeneous Markov models. A further distinction can be made depending on whether state values or transition probabilities:

1. depend on how long the entire model has been running (model-time dependency);
2. depend on how long an individual has been in a given state (state-time dependency).

These two situations can be modelled using the `model_time` (or its alias `markov_cycle`) and `state_time` variables, respectively.

## How to specifiy time-dependency

These variables takes increasing values with each cycles, starting from 1. For example the age of individuals at any moment can be defined as `Initial age + model_time`. The time an individual spends in a state is equal to `state_time`.

Both variables can be used in `define_parameters()`, `define_state()`, or `define_transition()`:

    define_parameters(
      mr = exp(- state_time * lambda),
      age = 50 + model_time
    )

    ## 2 unevaluated parameters.
    ##
    ## mr = exp(-state_time * lambda)
    ## age = 50 + model_time

    define_state(
      cost = 100 - state_time,
      effect = 10
    )

    ## A state with 2 values.
    ##
    ## cost = 100 - state_time
    ## effect = 10

    f <- function(x) abs(sin(x))

    define_transition(
      C,  f(state_time),
      .1, .9
    )

    ## No named state -> generating names.

    ## A transition matrix, 2 states.
    ##
    ##   A   B
    ## A C   f(state_time)
    ## B 0.1 0.9

## Details

Using `model_time` in a model does not change the execution speed of the analysis. On the other hand adding `state_time` may slow down the analysis, especially if the model is run for many cycles and a transition probability depends on `state_time`.1

To mitigate this drawback it is possible to limit the number of state expansion with `state_time_limit`. Because most time-varying values reach an asymptotic value quite fast, it is unnecessary to expand the states any further. The last cycle value is repeated until the end.

The limit can be defined globally, per state, or per model and state. In the following example probabilities are kept constant after 10 cycles for state B and 20 cycles for state D in strategy I, and 15 cycles in state B in strategy II.

    run_model(
      I =  strat_1,
      II = strat_2,
      cycles = 100,
      state_time_limit = list(
        I = c(B = 10, D = 20),
        II = c(B = 15)
      )
    )

1. In this situation the complexity is proportional to the square of the number of cycles.↩