# Time scales

“How can I specify time scales?”

Specifying time scales is important, especially in multiscale models in which dynamics occur at multiple temporal scales.

In Morpheus, we distinguish three time scales:

**Global time**: defines the time frame of a simulation.**Monte Carlo time scale**: defines updating scheme of cells.**System time scale**: defines updating and dynamics of systems of (differential) equations.

## Global time

Each model must specify a **global time scheme** under `Time`

that runs from `StartTime`

to `StopTime`

. All other processes are scheduled within this time frame.

For **dimensionless models**, a sensible choice for the global time scheme would be from $0$ to $1$. For an example, see the cell cycle model (`Examples`

→ `MultiScale`

→ `CellCycle`

).

Alternatively, for **dimensional models**, time `units`

can be specified (`msec`

, `sec`

, `min`

, `hours`

, `days`

) such that one could define the global time to run from $20 \text{ hours}$ to $7 \text{ days}$. *Default interpretation is $1 \text{ sec}$.*

## Monte Carlo time scale (CPM)

The time scale of cellular Potts models can be specified using `CPM`

→ `MonteCarloSampler`

→ `MCSDuration`

. This defines the interval between Monte Carlo steps, in terms of global time scheme.

For example, if the global time is defined from $0 \rightarrow 1$, and `MCSDuration`

is set unitless to $1.0 \cdot 10^{−2}$, a total of $100$ Monte Carlo steps will be performed during the simulation.

Alternatively, if the global time is defined with dimenions from $0 \text{ hours}$ to $1 \text{ hours}$, and `MCSDuration`

is set to $1.0 \text{ sec}$, a total of $3600$ Monte Carlo steps will be performed during the simulation.

Note that changing the MCSDuration time scale directly affects the CPM dynamics such as cell motility and cell shape changes. In fact, it will affect all processes under `CellTypes`

→ `CellType`

, except the processes defined within Systems.

## System time scale (ODE/PDE)

**System dynamics**: setting the time scale of ODE model dynamics, relative to the global time.

To change the time scale of the dynamics of simulated ODE model, you can use the `System`

→ `time-scaling`

attribute. This scales the rates of dynamics, while maintaining the accuracy (by automatically scaling the `time-step`

). For an example, see the multi-scale cell cycle model or (`Examples`

→ `Multiscale`

→ `CellCycle`

).

Note that the time symbol within a scaled system thus represents system local time.