Understanding Units & Quarterization
Overview
This guide explains how Daloopa represents financial values across fiscal periods, why the raw value disclosed by a company may differ from the value we surface, and how to interpret the relationship between them.
Every data point in a series carries two values:
| Field | Definition |
|---|---|
value_raw | The value extracted directly from the document disclosed by the company, exactly as reported. |
value_normalized | The quarterized value computed internally by Daloopa to isolate a single quarter's contribution. |
These two values can differ because companies do not all disclose their financials on the same basis. Some report a clean quarterly figure; others report a cumulative year-to-date (YTD) or full-year figure. The span field tells you which basis a given value_raw was reported on, and therefore how value_normalized was derived.
Key principle: To reconcile any difference between
value_rawandvalue_normalized, always start with thespanfield.
The span field
span fieldspan describes the reporting basis of value_raw and depends entirely on how the company chose to disclose that specific series for that period.
span value | Meaning |
|---|---|
| Quarterly | value_raw already represents a single quarter in isolation. |
| Year to date | value_raw is cumulative from the start of the fiscal year through the reported quarter. |
| Annual | value_raw is the full fiscal-year cumulative figure. |
How span maps to fiscal periods
span maps to fiscal periodsThe available span values depend on the fiscal period:
| Fiscal period | Possible span values | Notes |
|---|---|---|
| Q1 | Quarterly | Always quarterly — for Q1 there is no difference between a quarterly value and a YTD value. |
| Q2 | Quarterly or Year to date | Depends on company disclosure. |
| Q3 | Quarterly or Year to date | Depends on company disclosure. |
| Q4 | Quarterly or Annual | Depends on company disclosure. |
| FY | Annual | Always annual. |
How value_normalized is calculated
value_normalized is calculatedWhen span = Quarterly
span = QuarterlyNo quarterization is required. The disclosed figure is already a single-quarter value:
value_normalized = value_raw
When span = Year to date or Annual
span = Year to date or AnnualDaloopa needs to strip out the prior periods' cumulative contribution to isolate the quarter. The general principle is:
value_normalized = (current period cumulative raw) − (prior period cumulative value)
Applied per fiscal period, the explicit rules are:
| Fiscal period | span | Normalization formula |
|---|---|---|
| Q1 | Quarterly | value_normalized = value_raw (may differ in scale only) |
| Q2 | Year to date | value_normalized = Q2 value_raw − Q1 value_normalized |
| Q3 | Year to date | value_normalized = Q3 value_raw − Q2 value_raw |
| Q4 | Annual | value_normalized = Q4 value_raw − Q3 value_raw |
Note: Each quarter subtracts the immediately preceding period's cumulative value. Because Q1's raw and normalized values are equal, the Q2 calculation can reference either — the result is the same.
Worked example — AAPL
Series: series_id = 1914880 | Unit: Million
This series illustrates a full fiscal year where each quarter after Q1 is disclosed on a cumulative basis. The headline difference — 2017Q4 showing value_raw = 627 against value_normalized = 93 — resolves cleanly once the spans are applied.
| Fiscal period | span | value_raw | value_normalized | Calculation |
|---|---|---|---|---|
| 2017Q1 | Quarterly | $178M | $178M | First quarter of the fiscal year — the raw value is the quarterly value. |
| 2017Q2 | Year to date | $225M (cumulative YTD) | $47M | $225M − $178M (Q1) = isolated Q2 |
| 2017Q3 | Year to date | $534M (cumulative YTD) | $309M | $534M − $225M (Q2 YTD) = isolated Q3 |
| 2017Q4 | Annual | $627M (full-year) | $93M | $627M − $534M (Q3 YTD) = isolated Q4 |
The $627M figure is the full-year cumulative total; the $93M normalized figure is Q4 in isolation.
Quick reference
value_raw= as disclosed by the company.value_normalized= quarterized by Daloopa.- Always check
spanfirst to understand any difference. - Quarterly span → the two values match (
value_raw = value_normalized). - Year to date / Annual span →
value_normalized= current cumulative raw minus the prior period's cumulative value. - Q1 is always quarterly; FY is always annual.
- A difference that is not a clean power of ten is usually a quarterization effect (cumulative vs. isolated), not a units/scale effect.
A note on units & scale
value_raw is reported in the unit the company disclosed (e.g., Million), captured in the unit field. value_normalized is expressed on a consistent internal basis, so for Q1 the two values may be identical in magnitude but differ only in scale (for example, units vs. thousands vs. millions).
When diagnosing a value_raw vs. value_normalized discrepancy, distinguish the two causes:
- Scale differences appear as clean powers of ten (×10, ×1,000, ×1,000,000).
- Quarterization differences appear as non-power-of-ten ratios (e.g., the 6.74× ratio in the AAPL Q4 example above), reflecting cumulative-to-isolated conversion rather than a unit change.
Updated about 16 hours ago