RFC 20130107: New Vaccination Ring Creation Options - NAVADMC/ADSM GitHub Wiki

Applies to: Model description v1.0.0

Type of change: New feature, for next minor revision of the software.

Summary: This RFC changes the way ADSM specifies how large a vaccination ring is created, and which production types within it are vaccinated.

Justification: The existing vaccination ring creation options were insufficiently flexible.

Discussion

In version 1.0 of the model, creation of a vaccination ring is separated from choosing which production types are vaccinated.

As an example, the modeler can currently say:

• “When a cattle unit is detected as diseased, create a 3km vaccination ring around it”
• “When a swine unit is detected as diseased, create a 10km vaccination ring around it”

And then the modeler can say:

• “Within a vaccination ring, vaccinate the following production types: dairy, beef, etc.”

But notice what the modeler cannot say:
“When a cattle unit is detected as diseased, vaccinate dairy cattle within 10 km and sow operations within 25 miles.”
This rule cannot be expressed in the current model, so the current model cannot capture the strategy described in the document Vaccination Questions Styles 19DEC2011.

To fix this, this RFC proposes eliminating the current way ADSM specifies the creation of vaccination rings:

When a unit of type A is detected, create a x km ring
When a unit of type B is detected, create a y km ring
etc.
Within a ring, units of types B, C, D are vaccinated

and instead creating a system where the modeler creates any number of rules of this form:

When a unit of one of these production types: [A] is detected, vaccinate units of these production types: [B] within a x km circle
When a unit of one of these production types: [A] is detected, vaccinate units of these production types: [C] within a y km circle
When a unit of one of these production types: [B,C] is detected, vaccinate units of these production types: [D,E,F] within a ring with inner radius u km and outer radius v km
etc.

With a system like this, the modeler could easily re-create the vaccination patterns they used in older versions of the model, but they could also create more flexible vaccination patterns like those described in the document Vaccination Questions Styles 19DEC2011.