Case Source Precision Gap Tool

Description

Among selected records return cases, coarserCases where sourceQuantum > referenceQuantum, and maximumExcessQuantum = max(0, selected quantum-referenceQuantum).

Epidemiological records have both an observation basis and a resolution. The share of at-risk time supported by observations differs from disease frequency, while a source's stated time quantum describes resolution rather than measured accuracy.

Among selected records return cases, coarserCases where sourceQuantum > referenceQuantum, and maximumExcessQuantum = max(0, selected quantum-referenceQuantum).

When to use this tool

Use Case Source Precision Gap when checking observation support or source resolution under an explicit selection mask.

How to use the tool and how it works

Enter sourceQuanta, selectedCases, referenceQuantum. 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 cases, coarserCases, maximumExcessQuantum. Use the output convention below.

Require equally long sourceQuanta and selectedCases, positive referenceQuantum and positive source quanta. Among selected records return cases, coarserCases where sourceQuantum > referenceQuantum, and maximumExcessQuantum = max(0, selected quantum-referenceQuantum). Quanta must describe resolution on the same unit basis.^[1]

Input field	Meaning and units	Accepted input
sourceQuanta	Source Quanta	Required. Array of finite number; maximum items 256.
selectedCases	Selected Cases	Required. Array of boolean; maximum items 256.
referenceQuantum	Reference Quantum	Required. Finite number; strictly above 0.

Output field	Interpretation	Returned shape
cases	Cases	Required. Safe integer.
coarserCases	Coarser Cases	Required. Safe integer.
maximumExcessQuantum	Maximum Excess Quantum	Required. Finite number.

json

{
  "input": {
    "sourceQuanta": [
      1,
      3,
      5
    ],
    "selectedCases": [
      true,
      true,
      false
    ],
    "referenceQuantum": 2
  },
  "output": {
    "cases": 2,
    "coarserCases": 1,
    "maximumExcessQuantum": 1
  }
}

Limitations and assumptions

An empty selection returns all zeros. This compares supplied precision labels, not measured accuracy, uncertainty distributions or source authenticity; selected records are not deduplicated.
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.
Numeric calculations use binary floating point unless exact decimal-integer arithmetic is explicitly stated. No hidden measurement tolerance or decimal rounding is added; nonfinite or out-of-contract results are rejected. Numeric signed-zero results are exported as zero.

Alternative or Complementary methods

Inspect the original follow-up and source records before treating coverage or precision summaries as evidence of unbiased surveillance.

References

Calculation and input contract: epidemiology/case-source-precision-gap — tool.io

Similar or alternative tools

Case Definition Version Match Pair
Compare caseVersion and requestedVersion literally, and test caseDate against the inclusive interval [validFrom,validThrough].
Surveillance Week Origin Gap Tool
Calculate surveillance week origin gap from explicit caller-supplied inputs.