Ratio Narrative Check

Compare caller-supplied expected and observed records for ratio narrative check.

Description

A ratio narrative connects a metric to a comparison, cause and implication.

A ratio narrative connects a metric to a comparison, cause and implication. Coverage identifies missing expected components without validating the explanation.^[1]

Compare caller-supplied expected and observed records for ratio narrative check.

When to use Ratio Narrative Check

Use this tool to compare caller-supplied expected and observed records for ratio narrative check.

Prepare the documented facts, aligned totals or expected/observed evidence labels requested. Choose applicable requirements and thresholds separately before interpreting a planning screen.

How to use Ratio Narrative Check and understand its results

Prepare the documented facts, aligned totals or expected/observed evidence labels requested. Choose applicable requirements and thresholds separately before interpreting a planning screen.
Enter requiredElements, presentElements using the field table and calculation rules, then run the tool.
Read coveragePercent, matched, missing, unexpected. 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
requiredElements	Required narrative elements	list of string	Required
presentElements	Present narrative elements	list of string	Required

Enter nonempty requiredElements and presentElements, which may be empty. Trim and compare en-US lowercase labels, reject blanks and collapse duplicates. Return matched/missing expected labels and unexpected observed labels; preserve first occurrence order and last duplicate spelling.

coverage%=100matchedUnique/expectedUnique

Units, indexing, boundary conditions and exceptional cases are defined in the calculation rules above.

Output field	Meaning	Value type
coveragePercent	Coverage (%)	number; minimum: 0; maximum: 100
matched	Matched items	list of string
missing	Missing items	list of string
unexpected	Unexpected items	list of string

json

{
  "input": {
    "requiredElements": [
      "ratio",
      "comparison",
      "cause",
      "implication"
    ],
    "presentElements": [
      "ratio",
      "comparison",
      "cause"
    ]
  },
  "output": {
    "coveragePercent": 75,
    "matched": [
      "ratio",
      "comparison",
      "cause"
    ],
    "missing": [
      "implication"
    ],
    "unexpected": []
  }
}

Limitations and assumptions

Requirements are caller-supplied and equally weighted. No ratio arithmetic, cause or supporting evidence is verified.

Numeric inputs, where present, 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 Variance Explanation Check: Compare caller-supplied expected and observed records for variance explanation check. For a complementary task, use Final Analytics Reconciliation: Recheck final analytical consistency after recorded corrections.

References

Ratio Narrative Check — tool.io

Similar or alternative tools

Variance Explanation Check
Compare caller-supplied expected and observed records for variance explanation check.
Final Analytics Reconciliation
Recheck final analytical consistency after recorded corrections.