Skip to content

contact_rate

Syntax

place <place-name> {
    contact_rate = <number>
    contact_rate_for_<condition_name> = <number>
}

network <network-name> {
    contact_rate = <number>
    contact_rate_for_<condition_name> = <number>
}

Description

Network and place property that sets the hourly rate at which agents contact each other in a given mixing group.

One of two contact modes in mixing groups; the other is contact_prob. In contact_rate, each transmissible agent has a fixed number of contacts with other agents within any given hour that the mixing group is in operation. In this mode, the total number of potential transmission contacts for a given condition in a mixing group during its open hours on a given day is given by the formula:

contacts = (hourly contact rate of group) * (number of transmissible agents) * (transmissibility of the condition) * (duration of the meeting in the group)

To select transmission by contact_rate, the definition of the Place or Network type includes the following properties:

place <place-name> {
    contact_rate = <number>
    contact_rate_for_<condition_name> = <number>
}

network <network-name> {
    contact_rate = <number>
    contact_rate_for_<condition_name> = <number>
}

The contact_rate property specifies the contact rate per hour for all conditions.

If the contact_rate_for_<condition_name> property is present, it overrides the first property for the named condition.

The conversion from contact_rate to contact_prob for an equal number of contacts is:

contact_prob = contact_rate / (number of members of the place - 1)

The group agent for individual mixing groups can change the effective contact rate using the adjust_contacts action.

Examples

The contact rate of a places such as households can be set at the start of the simulation with:

place Household {
    contact_rate = 0.16692
}

See Also