Surveillance Followup Years
Schedule surveillance calendar years using caller-defined offsets after treatment completion.
Description
Post-intervention follow-up schedules are often expressed as years after completion.
Post-intervention follow-up schedules are often expressed as years after completion. Converting offsets into calendar years makes an existing surveillance plan easier to review.
The tool returns scheduledFollowupYears (scheduled followup years). Input measurements and model parameters are supplied by the caller; the tool computes the stated summary rather than acquiring those measurements.
When to use Surveillance Followup Years
Use Surveillance Followup Years when you already have treatmentCompletionYear, followupYearOffsets and want scheduledFollowupYears. This is useful for checking a supplied calculation, documenting a measurement convention, or comparing observations prepared on the same basis.
How to use Surveillance Followup Years and understand its results
- Enter treatmentCompletionYear, followupYearOffsets using the field table below. Match the units, ordering and data boundaries described in the calculation.
- Run the tool after checking the stated bounds and matching paired observations or categories. A malformed request gives a tool error rather than a usable measurement.
- Read scheduledFollowupYears. Use the calculation and interpretation below to distinguish amounts, ratios, signs and decision flags where applicable.
- Review the supplied parameters and assumptions before using the result in a report or comparing it with another observation.
| Input field | Meaning | Value type and bounds | Requirement |
|---|---|---|---|
| treatmentCompletionYear | Treatment completion year | integer | Required |
| followupYearOffsets | Followup year offsets | list of number | Required |
Require a nonnegative integer completion year and a nonempty, strictly increasing list of positive integer offsets. Preserve the offset order in the returned years.
followupYear[i] = completionYear + yearOffset[i] The symbols refer to the supplied quantities or generated values described above; unit conversions and comparison boundaries follow the stated implementation.
{
"input": {
"treatmentCompletionYear": 2026,
"followupYearOffsets": [
1,
3,
5
]
},
"output": {
"scheduledFollowupYears": [
2027,
2029,
2031
]
}
}Limitations and assumptions
This implements the supplied schedule; it does not select surveillance intervals or assign exact visit dates.
Numerical inputs must be finite. The tool checks its declared input shape and calculation constraints; those checks do not verify the quality, calibration or representativeness of the supplied observations.
Alternative or Complementary methods
Sentinel Annual Recheck: Schedule annual sentinel-site rechecks, clamping leap-day anniversaries to the target month end. Gametocyte Clearance Followup: Track first observed zero gametocyte count and subsequent rebound in an ordered follow-up series.
Methodological background: Monitoring drug coverage for preventive chemotherapy.1
References
-
Monitoring drug coverage for preventive chemotherapy — World Health Organization
Similar or alternative tools
- Sentinel Annual Recheck
Schedule annual sentinel-site rechecks, clamping leap-day anniversaries to the target month end.
- Gametocyte Clearance Followup
Track first observed zero gametocyte count and subsequent rebound in an ordered follow-up series.