Description
Return missing expected and unexpected reported tokens, and complete when no expected week is missing.
Epidemiological shares depend on who or what enters each denominator. Tests, distinct people, known-status records and eligible contacts describe different populations; a ratio computed from them is not automatically population risk or an individual diagnosis.
Return missing expected and unexpected reported tokens, and complete when no expected week is missing.
When to use this tool
Use Sentinel Report Missing Week Mask when you need a stated surveillance or screening count summary.
How to use the tool and how it works
- Enter reportedWeeks, expectedWeeks. Keep parallel arrays aligned. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read missingWeeks, unexpectedWeeks, complete. Inspect complete before interpreting the associated values.
Require unique reported/expected integer week IDs. Return missing expected and unexpected reported tokens, and complete when no expected week is missing.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| reportedWeeks | Unique integer week IDs, not parsed calendar-week strings. | Required. Array of safe integer; maximum items 256. |
| expectedWeeks | Unique expected integer week IDs under the same convention. | Required. Array of safe integer; maximum items 256. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| missingWeeks | Missing Weeks | Required. Array of safe integer; maximum items 256. |
| unexpectedWeeks | Unexpected Weeks | Required. Array of safe integer; maximum items 256. |
| complete | Complete | Required. Boolean. |
{
"input": {
"reportedWeeks": [
1,
3,
5
],
"expectedWeeks": [
1,
2,
3
]
},
"output": {
"missingWeeks": [
2
],
"unexpectedWeeks": [
5
],
"complete": false
}
}Limitations and assumptions
- Unexpected weeks do not make complete false. Week IDs are not parsed as actual dates and reporting validity or disease surveillance quality is not verified.
- Inputs must satisfy both the field types and the cross-field conditions above. Invalid input causes an error; a successful false flag or documented placeholder is a different result.
Alternative or Complementary methods
Use the appropriate study design and verified case definitions for health interpretation. Address ascertainment, repeated records, missing status, selection and uncertainty before generalizing a descriptive proportion.
References
Similar or alternative tools
- Surveillance Week Origin Gap
Subtract safe numeric day indexes with exact integer arithmetic, return decimal day gap and integer quotient, and aligned when the remainder is zero.
- Vaccination Coverage Known Status Base
Return vaccinated/known and vaccinated/all-records coverage.