import_exposures()

Action for the meta agent to select a number of agents for exposure.

Synopsis

import_exposures(condition-name, expression)

Description

The first argument must be the name of declared condition. The expression is evaluated, and the meta agent selects the specified number of agents from the population without replacement. Each of the selected agents is exposed to the condition with a probability equal to that agent’s susceptibility to the condition.

Parameters

condition-name

A name of a delcared condition in the model.

expression

An expression that evaluates to the number of agents selected to be exposed by the meta agent.

Examples

The meta agent will select ten agents for exposure to INFLUENZA with:

import_exposures(INFLUENZA, 10)

Errors

A run-time error occurs if the expression evaluates to a negative number or a number greater than the population size.

A run-time error occurs if the action is executed by a non-meta agent.

See Also