How to use Vaccination in ADSM - NAVADMC/ADSM GitHub Wiki
Vaccination in ADSM has several recent additions to functionality. These additions provide added flexibility but require some additional steps to complete the simulation parameters. Some questions that might come up include:
Which production types will be vaccinated?
How is vaccination started and can it be stopped?
How long does immunity last and can a secondary dose be implemented?
How do I vaccinate a ring around a detected unit?
Who is vaccinated first and how can I designate priority?
How many units can I vaccinate in a given time?
Can I vaccinate units that were detected before the vaccination program was triggered?
The following sequence of parameters will help navigate through the many possibilities in a vaccination program. While a specific sequence is not required, some options may be dependent on other options and not show as available. Navigate down the tabs to find these pages.
Controls page – The Control page expects a name for the series of events that will be planned.
Control Protocol page – Control Protocols assign a specific set of actions to a given production type. To use Vaccination, create a New Control Protocol and provide a context-specific name (e.g., Dairy Vaccination). When the Dairy Vaccination protocol is expanded, check the vaccination box in addition to any other parameter options that are needed. It is necessary to perform detection in order to implement any other portions of the Control Protocol strategy.
Clicking on Vaccination provides four parameter options to describe how the strategy works on a given production type. First is the Yes/No parameter to vaccinate detected units. A check indicates Yes, and blank indicates No. Minimum time between vaccinations allows a number of days to describe when vaccination should be repeated. A default of 99,999 days has been set to inhibit a secondary vaccination. To enact secondary vaccination, replace the default 99,999 days with the appropriate number of days between primary and secondary vaccinations. Days to immunity sets the number of days until the vaccination has a response to change the disease state of the unit from susceptible (S) to vaccine immune (V), which will block an adequate exposure. The Daily states are in a supplemental file. The vaccine immune period is described by a Probability density functions.
Clicking on Cost Accounting allows specific costs related to vaccination to be included in results. These include a cost for vaccination setup per unit, cost of baseline vaccination per animal, number of animals that can be vaccinated before the cost increases, and the cost of additional animals over the baseline.
Vaccination Triggers page – Triggers describe the events that will start a vaccination program and are assigned to one or more production types. A combination of triggers may be set, but vaccination starts as soon as any one of the possible conditions is met. There are six reasons for a trigger to begin, and the same six reasons can restart vaccination again at a different capacity when vaccination has been stopped. These triggers include: Number of new disease detections – set with a number of units Rate of new detections – set with a number of units with a number of days Estimated dissemination rate – set with a ratio and a number of days to describe the window size Spread between groups – set with a number of groups, created until the Production Type Panel and the addition of those groups. This trigger is intended to represent a spread between industry types. Time from first detection – set with the number of days that will count from first detection Destruction wait time – set with the number of days that represents waiting for a destruction program to be implemented or catch up to the expected capacity.
All of these triggers can be set as “Restart only,” which become active only if the Stop Trigger has been activated. The Stop Trigger is set as a rate of new detections per day. To make the trigger a restart trigger, check the Restart Only option.
Vaccination Rings page – A ring description is needed to determine which undetected units will be vaccinated. A ring is started by one or more production types triggering vaccination, and it acts on one or more production types. All rings are radial and have an outer radius. An inner radius is optional, to vaccinate in a donut shape.
Vaccination Global page – Several settings act across all production types, and these parameters are on the vaccination global page. A priority of Vaccination can be set by dragging options into a preferred order for both the primary order and the secondary order. The vaccination capacity and the restart capacity are described by separate Probability density functions. Retrospective vaccination is a strategy that allows vaccination around units that were detected a specific number of days prior to vaccination trigger activation.
Additional reading on the concepts behind vaccination is available in these wiki topics:
RFC 20121029: New Vaccination Triggers