Roundup Source Coverage
Measure source-category coverage in a roundup.
Description
A roundup can be checked for coverage of required source labels.
A roundup can be checked for coverage of required source labels. This calculation treats labels as case-insensitive sets.1
Measure source-category coverage in a roundup.
When to use Roundup Source Coverage
Use this tool to measure source-category coverage in a roundup.
Prepare the text, recorded observations, aligned figures or editorial criteria requested. Confirm what each label, count, timestamp or supplied flag represents before interpreting the result.
How to use Roundup Source Coverage and understand its results
- Prepare the text, recorded observations, aligned figures or editorial criteria requested. Confirm what each label, count, timestamp or supplied flag represents before interpreting the result.
- Enter requiredSourceCategories, representedSourceCategories using the field table and calculation rules, then run the tool.
- Read requiredCategoryCount, representedRequiredCount, missingCategories, coveragePercent. The explanation below defines the units, signs, ordering and any flags or placeholder values.
- If the tool reports an input issue, correct the values and run it again. Apply the stated assumptions when interpreting a successfully returned result.
| Input field | Meaning | Value type; see rules below | Requirement |
|---|---|---|---|
| requiredSourceCategories | Required source categories | list of string | Required |
| representedSourceCategories | Represented source categories | list of string | Required |
Trim and lowercase both lists, discard blank labels and deduplicate. Require at least one remaining required label. Return required count, covered count, missing normalized labels in required order and percentage.
coverage%=100×coveredRequired/uniqueRequired Units, indexing, boundary conditions and exceptional cases are defined in the calculation rules above.
| Output field | Meaning | Value type |
|---|---|---|
| requiredCategoryCount | Required category count | integer; minimum: 0 |
| representedRequiredCount | Represented required categories | integer; minimum: 0 |
| missingCategories | Missing source categories | list of string |
| coveragePercent | Source-category coverage (%) | number; minimum: 0; maximum: 100 |
{
"input": {
"requiredSourceCategories": [
"official",
"resident",
"expert"
],
"representedSourceCategories": [
"official",
"expert"
]
},
"output": {
"requiredCategoryCount": 3,
"representedRequiredCount": 2,
"missingCategories": [
"resident"
],
"coveragePercent": 66.66666666666666
}
}Limitations and assumptions
No source quality, independence, identity or article content is checked.
Numeric inputs must be finite. Follow the calculation-specific rules for overflow, underflow and exceptional cases. Lists are limited to 100,000 entries; the rules above may require smaller limits. Missing required fields, extra fields, wrong value types and violations of the calculation rules are input errors.
Alternative or Complementary methods
Use Community Source Corroboration: Check community-source and independent-corroboration counts against supplied minimums. For a complementary task, use Beat Source Coverage: Compare caller-supplied requirements and observations for beat source coverage.
References
-
Roundup Source Coverage — tool.io
Similar or alternative tools
- Community Source Corroboration
Check community-source and independent-corroboration counts against supplied minimums.
- Beat Source Coverage
Compare caller-supplied requirements and observations for beat source coverage.