KB article
Units, Currency, and Time: The Hidden Semantics That Cause Bad Answers
Units, currency, and time basis are often implicit, but AI needs them explicit.
arf-kbsemantic-integrityunit-semanticscurrency-normalizationdefault-aggregation
TL;DR
- Hidden units create wrong comparisons.
- Make units and time basis explicit in names and metadata.
The problem
- Measures can represent dollars, percentages, or counts without stating which.
- Currency conversions or time windows are embedded in logic.
Why it matters
- AI may compare incompatible values or summarize incorrectly.
- Business decisions rely on correct unit semantics.
Symptoms
- Percentages treated as counts in explanations.
- Global revenue compared to local currency costs.
Root causes
- Unit details captured in documentation, not in the model.
- Currency normalization done inconsistently.
What good looks like
- Units and currencies encoded in measure names.
- Time windows explicitly documented and standardized.
How to fix
- Append unit and currency suffixes (e.g., Revenue_USD).
- Standardize time windows in metric definitions.
- Add metadata notes about conversion rules.
Pitfalls
- Assuming the visualization implies the unit.
- Mixing multiple time windows in one calculation.
Checklist
- Every KPI includes unit and currency in metadata.
- Time windows are explicit and documented.
- Conversions are centralized.
Framework placement
Primary ARF layer: Semantic Integrity. Diagnostic bridge: semantic-reliability, change-reliability.