The Simulation Clock

The components here provide implementations of different kinds of simulation clocks for use in vivarium.

For more information about time in the simulation, see the associated concept note.

class vivarium.framework.time.SimulationClock

Defines a base implementation for a simulation clock.

property name

property time: Union[Timestamp, datetime, Number]

The current simulation time.

property stop_time: Union[Timestamp, datetime, Number]

The time at which the simulation will stop.

property step_size: Union[Timedelta, timedelta, Number]

The size of the next time step.

step_forward()

Advances the clock by the current step size.

Return type

None

step_backward()

Rewinds the clock by the current step size.

class vivarium.framework.time.SimpleClock

A unitless step-count based simulation clock.

configuration_defaults = {'time': {'end': 100, 'start': 0, 'step_size': 1}}

property name

setup(builder)

vivarium.framework.time.get_time_stamp(time)

class vivarium.framework.time.DateTimeClock

A date-time based simulation clock.

configuration_defaults = {'time': {'end': {'day': 2, 'month': 7, 'year': 2010}, 'start': {'day': 2, 'month': 7, 'year': 2005}, 'step_size': 1}}

property name

setup(builder)

class vivarium.framework.time.TimeInterface(manager)

Parameters

manager (SimulationClock) –

clock()

Gets a callable that returns the current simulation time.

Return type

Callable[[], Union[Timestamp, datetime, Number]]

step_size()

Gets a callable that returns the current simulation step size.

Return type

Callable[[], Union[Timedelta, timedelta, Number]]