View source: R/mensalize-sidra-series.R
| mensalize_sidra_series | R Documentation |
Transforms SIDRA rolling quarterly averages into exact monthly values using the mathematical relationship between consecutive rolling quarters.
mensalize_sidra_series(
rolling_quarters,
starting_points = NULL,
series = "all",
compute_derived = TRUE,
verbose = TRUE
)
rolling_quarters |
data.table from |
starting_points |
Optional data.table with precomputed starting points
(y0 values). If NULL (default), uses bundled |
series |
Character vector of series names to mensalize, or "all" (default) for all series in the input data (except price indices). |
compute_derived |
Logical. Compute derived series (rates, aggregates)? Default TRUE. |
verbose |
Logical. Print progress messages? Default TRUE. |
The algorithm exploits the mathematical property of rolling quarterly averages:
RQ_t - RQ_{t-1} = (Month_t - Month_{t-3}) / 3
This means exact 3-month variations can be extracted from consecutive rolling quarters. By accumulating these variations separately for each month-position (1, 2, or 3), we build cumulative variation series. The only unknown is the starting level for Jan, Feb, and Mar 2012.
Starting points are estimated by:
Computing monthly estimates from calibrated microdata (z_ variables)
Calculating cumulative variations from SIDRA (cum_ variables)
Backprojecting: e0 = z_ - cum_ over calibration period (2013-2019)
Averaging e0 by month position to get y0_ for each position
Final adjustment ensures the average of 3 consecutive mensalized values equals the original rolling quarter value.
A data.table with columns:
Integer. YYYYMM exact month
Numeric. Mensalized value for each series (one column per series)
If providing custom starting points, the data.table must have columns:
series_name: Character. Series name matching rolling_quarters columns
mesnotrim: Integer (1, 2, or 3). Month position in quarter
y0: Numeric. Starting point value
The mensalization algorithm proceeds in steps:
Calculate d3 = 3 * (RQ_t - RQ_t-1)
Separate d3 by month position: d3m1, d3m2, d3m3
Cumulate separately: cum1, cum2, cum3
Apply starting points: y = y0 + cum
Final adjustment for rolling quarter consistency
fetch_sidra_rolling_quarters to obtain input data
compute_series_starting_points for custom calibration
rq <- fetch_sidra_rolling_quarters(
series = c("taxadesocup", "popocup", "popdesocup")
)
monthly <- mensalize_sidra_series(rq)
head(monthly)
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.