{ "_id": "6a1fcdbcb401979e73433388", "Package": "PNADCperiods", "Title": "Identify Reference Periods in Brazil's PNADC Survey Data", "Version": "0.1.2", "Date": "2026-04-27", "Authors@R": "c(\nperson(\"Rogerio\", \"Barbosa\", email = \"rogerio.barbosa@iesp.uerj.br\", role = c(\"aut\", \"cre\"),\ncomment = c(ORCID = \"0000-0002-6796-4547\",\ncontribution = \"R package, dashboard, and website\")),\nperson(\"Marcos\", \"Hecksher\", email = \"mdhecksher@gmail.com\", role = c(\"aut\"),\ncomment = c(ORCID = \"0000-0003-2992-1252\",\ncontribution = \"Mensalization methodology\"))\n)", "Description": "Identifies reference periods (months, fortnights, and\nweeks) in Brazil's quarterly PNADC (Pesquisa Nacional por\nAmostra de Domicilios Continua) survey data and computes\ncalibrated weights for sub-quarterly analysis. The core\nalgorithm uses IBGE (Instituto Brasileiro de Geografia e\nEstatistica) 'Parada Tecnica' (technical break) rules combined\nwith respondent birthdates to determine which temporal period\neach survey observation refers to. Period identification\nfollows a nested hierarchy enforced by construction: fortnights\nrequire months, weeks require fortnights. Achieves\napproximately 97% monthly determination rate with the full\nseries (2012-2025). Strict fortnight and week rates are\napproximately 9% and 3% respectively, as they cannot leverage\ncross-quarter panel aggregation. Experimental strategies\n(probabilistic assignment and UPA (Primary Sampling Unit)\naggregation) further improve these determination rates. The\npackage provides adaptive hierarchical weight calibration\n(4/2/1 cell levels for month/fortnight/week) with\nperiod-specific smoothing to produce survey weights calibrated\nto SIDRA (Sistema IBGE de Recuperacao Automatica) population\ntotals. Also includes a SIDRA mensalization module that\nconverts 86+ official rolling quarter series from the IBGE\nSIDRA API (Application Programming Interface) into exact\nmonthly estimates, without requiring access to microdata.\nHecksher and Barbosa (2026)\n.", "License": "MIT + file LICENSE", "Language": "en-US", "Encoding": "UTF-8", "LazyData": "true", "Roxygen": "list(markdown = TRUE)", "RoxygenNote": "7.3.2", "Config/testthat/edition": "3", "VignetteBuilder": "knitr", "URL": "https://antrologos.github.io/PNADCperiods/,\nhttps://github.com/antrologos/PNADCperiods", "BugReports": "https://github.com/antrologos/PNADCperiods/issues", "Config/pak/sysreqs": "libicu-dev libxml2-dev libssl-dev", "Repository": "https://antrologos.r-universe.dev", "Date/Publication": "2026-05-04 20:35:47 UTC", "RemoteUrl": "https://github.com/antrologos/pnadcperiods", "RemoteRef": "HEAD", "RemoteSha": "34d35ba3dfad3d96ae78acffe356b69c8b583bcd", "NeedsCompilation": "no", "Packaged": { "Date": "2026-06-03 06:41:25 UTC", "User": "root" }, "Author": "Rogerio Barbosa [aut, cre] (ORCID:\n, contribution: R package,\ndashboard, and website),\nMarcos Hecksher [aut] (ORCID: ,\ncontribution: Mensalization methodology)", "Maintainer": "Rogerio Barbosa ", "MD5sum": "252957acb6bf600b5fe0c41b331f4bc7", "_user": "antrologos", "_type": "src", "_file": "PNADCperiods_0.1.2.tar.gz", "_fileid": "19d27ef69a9abd05f099e952901b8404c4b990456921a9c17c47849048981b63", "_filesize": 5154921, "_sha256": "19d27ef69a9abd05f099e952901b8404c4b990456921a9c17c47849048981b63", "_created": "2026-06-03T06:41:25.000Z", "_published": "2026-06-03T06:46:20.686Z", "_distro": "noble", "_jobs": [ { "job": 79236818131, "time": 242, "config": "linux-devel-x86_64", "r": "4.7.0", "check": "OK", "artifact": "7377546068" }, { "job": 79236818147, "time": 247, "config": "linux-release-x86_64", "r": "4.6.0", "check": "OK", "artifact": "7377547709" }, { "job": 79236818123, "time": 181, "config": "macos-oldrel-arm64", "r": "4.5.3", "check": "OK", "artifact": "7377527833" }, { "job": 79236818237, "time": 207, "config": "macos-release-arm64", "r": "4.6.0", "check": "OK", "artifact": "7377535656" }, { "job": 79236344289, "time": 212, "config": "source", "r": "4.6.0", "check": "OK", "artifact": "7377475516" }, { "job": 79236818128, "time": 127, "config": "wasm-release", "r": "4.6.0", "check": "OK", "artifact": "7377512754" }, { "job": 79236818153, "time": 184, "config": "windows-devel", "r": "4.7.0", "check": "OK", "artifact": "7377529759" }, { "job": 79236818149, "time": 175, "config": "windows-oldrel", "r": "4.5.3", "check": "OK", "artifact": "7377526554" }, { "job": 79236818151, "time": 179, "config": "windows-release", "r": "4.6.0", "check": "OK", "artifact": "7377527788" } ], "_buildurl": "https://github.com/r-universe/antrologos/actions/runs/26868092351", "_status": "success", "_host": "GitHub-Actions", "_upstream": "https://github.com/antrologos/pnadcperiods", "_commit": { "id": "34d35ba3dfad3d96ae78acffe356b69c8b583bcd", "author": "Rogerio Barbosa ", "committer": "Rogerio Barbosa ", "message": "docs: cite Hecksher & Barbosa (2026) preprint as primary methodology reference\n\n- Add SocArXiv preprint as primary methodology citation in CITATION,\n DESCRIPTION, README, R/PNADCperiods-package.R @references, and the\n References section of all 7 vignettes\n- Move the 3 IPEA 2020 references (Nota Tecnica Disoc n. 62 and n. 87,\n Carta de Conjuntura v. 47) under \"Earlier formulations of the\n methodology\"\n- Fix development-version install instructions: ref = \"dev\" is required\n because master mirrors CRAN\n- Bump cited package version 0.1.1 -> 0.1.2 across CITATION/README/vignettes\n- Regenerate man/ (incl. drift in fetch_monthly_population.Rd and\n fetch_sidra_rolling_quarters.Rd) and pkgdown site\n", "time": 1777926947 }, "_maintainer": { "name": "Rogerio Barbosa", "email": "rogerio.barbosa@iesp.uerj.br", "orcid": "0000-0002-6796-4547" }, "_registered": true, "_dependencies": [ { "package": "R", "version": ">= 4.1.0", "role": "Depends" }, { "package": "data.table", "version": ">= 1.14.0", "role": "Imports" }, { "package": "checkmate", "version": ">= 2.0.0", "role": "Imports" }, { "package": "sidrar", "version": ">= 0.2.9", "role": "Imports" }, { "package": "lubridate", "version": ">= 1.9.4", "role": "Imports" }, { "package": "dplyr", "role": "Suggests" }, { "package": "fst", "role": "Suggests" }, { "package": "haven", "role": "Suggests" }, { "package": "testthat", "version": ">= 3.0.0", "role": "Suggests" }, { "package": "knitr", "role": "Suggests" }, { "package": "rmarkdown", "role": "Suggests" }, { "package": "pkgdown", "role": "Suggests" }, { "package": "ggplot2", "role": "Suggests" }, { "package": "scales", "role": "Suggests" } ], "_owner": "antrologos", "_selfowned": true, "_usedby": 0, "_updates": [ { "week": "2026-02", "n": 26 }, { "week": "2026-03", "n": 34 }, { "week": "2026-04", "n": 33 }, { "week": "2026-05", "n": 31 }, { "week": "2026-06", "n": 22 }, { "week": "2026-11", "n": 1 }, { "week": "2026-15", "n": 2 }, { "week": "2026-16", "n": 2 }, { "week": "2026-17", "n": 2 }, { "week": "2026-18", "n": 7 }, { "week": "2026-19", "n": 1 } ], "_tags": [ { "name": "v0.1.0", "date": "2026-04-15" }, { "name": "v0.1.1", "date": "2026-04-15" }, { "name": "v0.1.2", "date": "2026-04-27" } ], "_stars": 10, "_contributors": [ { "user": "antrologos", "count": 161, "uuid": 7207815 } ], "_userbio": { "uuid": 7207815, "type": "user", "name": "Rogerio J Barbosa", "description": "PhD in Sociology, professor at the Institute for Social and Political Studies (Instituto de Estudos Sociais e Políticos - IESP-UERJ)" }, "_downloads": { "count": 485, "source": "https://cranlogs.r-pkg.org/downloads/total/last-month/PNADCperiods" }, "_devurl": "https://github.com/antrologos/pnadcperiods", "_pkgdown": "https://antrologos.github.io/PNADCperiods/", "_searchresults": 0, "_rbuild": "4.6.0", "_assets": [ "extra/citation.cff", "extra/citation.html", "extra/citation.json", "extra/citation.txt", "extra/contents.json", "extra/NEWS.html", "extra/NEWS.txt", "extra/PNADCperiods.html", "extra/readme.html", "extra/readme.md", "manual.pdf" ], "_homeurl": "https://github.com/antrologos/pnadcperiods", "_realowner": "antrologos", "_cranurl": true, "_releases": [ { "version": "0.1.1", "date": "2026-04-21" }, { "version": "0.1.2", "date": "2026-04-28" } ], "_exports": [ "clear_sidra_cache", "compute_series_starting_points", "compute_starting_points_from_microdata", "compute_z_aggregates", "fetch_monthly_population", "fetch_sidra_rolling_quarters", "get_sidra_series_metadata", "mensalize_sidra_series", "pnadc_apply_periods", "pnadc_experimental_periods", "pnadc_identify_periods", "validate_pnadc" ], "_datasets": [ { "name": "pnadc_series_starting_points", "title": "Starting Points for SIDRA Series Mensalization", "object": "pnadc_series_starting_points", "class": [ "data.table", "data.frame" ], "fields": [ "series_name", "mesnotrim", "y0" ], "rows": 216, "table": true, "tojson": true } ], "_help": [ { "page": "clear_sidra_cache", "title": "Clear All SIDRA Caches", "topics": [ "clear_sidra_cache" ] }, { "page": "compute_series_starting_points", "title": "Compute Starting Points from Microdata", "topics": [ "compute_series_starting_points" ] }, { "page": "compute_starting_points_from_microdata", "title": "Compute Starting Points from Raw PNADC Microdata", "topics": [ "compute_starting_points_from_microdata" ] }, { "page": "compute_z_aggregates", "title": "Compute z_ Aggregates from Monthly Microdata", "topics": [ "compute_z_aggregates" ] }, { "page": "fetch_monthly_population", "title": "Fetch Monthly Population from SIDRA", "topics": [ "fetch_monthly_population" ] }, { "page": "fetch_sidra_rolling_quarters", "title": "Fetch Rolling Quarter Series from SIDRA", "topics": [ "fetch_sidra_rolling_quarters" ] }, { "page": "get_sidra_series_metadata", "title": "Get SIDRA Series Metadata", "topics": [ "get_sidra_series_metadata" ] }, { "page": "mensalize_sidra_series", "title": "Convert Rolling Quarters to Exact Monthly Series", "topics": [ "mensalize_sidra_series" ] }, { "page": "pnadc_apply_periods", "title": "Apply Reference Period Crosswalk to PNADC Data", "topics": [ "pnadc_apply_periods" ] }, { "page": "pnadc_experimental_periods", "title": "Experimental Period Identification Strategies", "topics": [ "pnadc_experimental_periods" ] }, { "page": "pnadc_identify_periods", "title": "Identify Reference Periods in PNADC Data", "topics": [ "pnadc_identify_periods" ] }, { "page": "pnadc_series_starting_points", "title": "Starting Points for SIDRA Series Mensalization", "topics": [ "pnadc_series_starting_points" ] }, { "page": "validate_pnadc", "title": "Validate PNADC Input Data", "topics": [ "validate_pnadc" ] } ], "_readme": "https://github.com/antrologos/pnadcperiods/raw/HEAD/README.md", "_rundeps": [ "askpass", "backports", "checkmate", "cli", "cpp11", "curl", "data.table", "generics", "glue", "httr", "jsonlite", "lifecycle", "lubridate", "magrittr", "mime", "openssl", "pillar", "pkgconfig", "R6", "rjson", "rlang", "rvest", "selectr", "sidrar", "stringi", "stringr", "sys", "tibble", "timechange", "utf8", "vctrs", "xml2" ], "_vignettes": [ { "source": "applied-examples.Rmd", "filename": "applied-examples.html", "title": "Applied Examples: Monthly vs Quarterly Labor Market Analysis", "engine": "knitr::rmarkdown", "headings": [ "Introduction", "Prerequisites", "Preparing the Data", "Step 1: Load and Mensalize Your Data", "Step 2: Create Labor Market Variables", "Step 3: Create Quarterly Series", "Step 4: Create Monthly Series", "1. COVID-19 Unemployment: The True Peak", "2. The 2014-2017 Recession: Tracking Month-by-Month Deterioration", "3. Minimum Wage Adjustments: Validating Mensalization", "Preparing the Minimum Wage Data", "The Smoking Gun: January 2013 Transition", "A Harder Test: The 2020 Double Adjustment", "The Full Picture: 2012-2025", "Summary: What Monthly Data Reveals", "4. Beyond Monthly: Fortnightly and Weekly Analysis", "Determination Rates and Experimental Strategies", "Sub-Monthly Calibration Workflow", "Example: COVID-19 Lockdown at Fortnightly Resolution", "Example: Carnival Week Labor Market Effects", "Practical Guidelines", "See Also", "References" ], "created": "2026-01-09 20:01:44", "modified": "2026-05-04 20:35:47", "commits": 25 }, { "source": "complex-survey-design.Rmd", "filename": "complex-survey-design.html", "title": "Complex Survey Design with Monthly Weights", "engine": "knitr::rmarkdown", "headings": [ "Introduction", "Why Standard Errors Matter", "Prerequisites", "Loading and Preparing Data", "Strategy 1: Linearization with Strata and PSU", "Setting Up a Survey Design", "Monthly Time Series with Confidence Intervals", "Strategy 2: Replication Weights", "Comparing Strategies", "Practical Example: Gender Gap in Labor Force Participation", "Computing the Gender Gap", "Visualizing the Results", "Practical Tips", "Singleton Strata", "Subpopulation Analysis", "Summary", "References", "Further Reading" ], "created": "2026-01-14 02:10:47", "modified": "2026-05-04 20:35:47", "commits": 8 }, { "source": "download-and-prepare.Rmd", "filename": "download-and-prepare.html", "title": "Download and Prepare PNADC Data", "engine": "knitr::rmarkdown", "headings": [ "Introduction", "Prerequisites", "Required Packages", "System Requirements", "Understanding PNADC Data", "Step 1: Set Up Your Environment", "Step 2: Define Which Quarters to Download", "Step 3: Download the Data", "Step 4: Stack the Quarterly Files", "Step 5: Apply Mensalization", "Step 6: Explore the Results", "Step 7: Save and Use the Results", "Memory and Performance Tips", "File Size Reference", "Extending to Full History", "Troubleshooting", "Next Steps", "References" ], "created": "2026-01-11 15:55:04", "modified": "2026-05-04 20:35:47", "commits": 16 }, { "source": "sidra-mensalization.Rmd", "filename": "sidra-mensalization.html", "title": "From Rolling Quarters to Monthly Estimates: SIDRA Mensalization Guide", "engine": "knitr::rmarkdown", "headings": [ "Overview", "Why Rolling Quarters Are Problematic", "Quick Start", "Understanding the Output", "Discovering Available Series", "Data Flow", "Step 1: Fetching Rolling Quarter Data", "Step 2: The Mensalization Transform", "Step 3: Using Monthly Estimates", "Population Data for Weighting", "Working with Series", "Fetching by Theme", "Fetching Specific Series", "Excluding Derived Series", "Selecting Output Columns", "The Mensalization Methodology", "The Core Concept", "The Mensalization Formula", "The Role of Starting Points ($y_0$)", "Assumptions and Limitations", "Practical Considerations", "API Caching", "Common Errors", "Data Quality Notes", "Custom Starting Points", "Option A: All-in-One Function", "Option B: Step-by-Step", "Validating Custom Starting Points", "Case Study: COVID-19 Unemployment", "Series Naming Conventions", "Function Reference", "References", "Further Reading" ], "created": "2026-02-04 14:53:56", "modified": "2026-05-04 20:35:47", "commits": 6 }, { "source": "getting-started.Rmd", "filename": "getting-started.html", "title": "Get Started with PNADCperiods", "engine": "knitr::rmarkdown", "headings": [ "Overview", "Installation", "Microdata Mensalization", "Required Columns", "Step 1: Build the Crosswalk", "Step 2: Apply Crosswalk and Calibrate Weights", "Step 3: Compute Monthly Estimates", "Build Once, Apply Many", "Monthly Series from SIDRA — No Microdata Needed", "Quick Start", "Discovering Available Series", "Visualizing Monthly vs Rolling Quarter Data", "Improving Determination Rates", "Annual Data", "Function Overview", "Next Steps", "References" ], "created": "2026-01-07 14:19:41", "modified": "2026-05-04 20:35:47", "commits": 25 }, { "source": "how-it-works.Rmd", "filename": "how-it-works.html", "title": "How PNADCperiods Works", "engine": "knitr::rmarkdown", "headings": [ "Introduction", "Why Stacked Data Matters", "The Algorithm Explained", "Shared Computation (Steps 1-3)", "Step 1: Valid Interview Saturdays (IBGE Rules)", "Step 2: Birthday Constraints", "Step 3: Date to Period Position", "Month Identification Pipeline (Steps 4-7)", "Step 4: UPA-Panel Aggregation", "Step 5: Cross-Quarter Aggregation", "Step 6: Dynamic Exception Detection", "Step 7: Final Assignment", "Fortnight and Week Identification", "Experimental Strategies", "Probabilistic Strategy", "UPA Aggregation Strategy", "Output Columns", "Caveats", "Weight Calibration", "1. Fetches Monthly Population from SIDRA API", "2. Applies Hierarchical Rake Weighting", "3. Calibrates to Monthly Population Totals", "Weight Smoothing", "Handling Indeterminate Observations", "Performance", "Benchmarks", "Determination Rates by Year", "Tips and Best Practices", "Further Reading", "References" ], "created": "2026-01-13 19:46:29", "modified": "2026-05-04 20:35:47", "commits": 18 }, { "source": "annual-poverty-analysis.Rmd", "filename": "annual-poverty-analysis.html", "title": "Monthly Poverty Analysis with Annual PNADC Data", "engine": "knitr::rmarkdown", "headings": [ "Introduction", "Prerequisites", "Complete Workflow", "Step 1: Create Mensalization Crosswalk", "Step 2: Load Annual PNADC Data", "Step 2b: Standardize Column Names", "Step 3: Apply Crosswalk and Calibrate Weights", "Step 4: Construct Per Capita Income", "Step 5: Apply Deflation", "Step 6: Define Poverty Line", "Analysis Examples", "Helper Functions", "Example 1: Monthly FGT Poverty Measures", "Summary", "Further Reading", "References" ], "created": "2026-01-14 20:58:40", "modified": "2026-05-04 20:35:47", "commits": 14 } ], "_score": 6.585460729508501, "_indexed": true, "_nocasepkg": "pnadcperiods", "_universes": [ "antrologos" ], "_binaries": [ { "r": "4.7.0", "os": "linux", "version": "0.1.2", "date": "2026-06-03T06:43:59.000Z", "distro": "noble", "commit": "34d35ba3dfad3d96ae78acffe356b69c8b583bcd", "fileid": "eea313d69717f46cf1bb989df0a4e5eeef581b5772a5e620c2d0b49a985562bf", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/antrologos/actions/runs/26868092351" }, { "r": "4.6.0", "os": "linux", "version": "0.1.2", "date": "2026-06-03T06:43:53.000Z", "distro": "noble", "commit": "34d35ba3dfad3d96ae78acffe356b69c8b583bcd", "fileid": "b2c567cc2b917fa8e5ece2b8fa27e73802c8d338d7a8ec0700b537c99e9f9c5e", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/antrologos/actions/runs/26868092351" }, { "r": "4.5.3", "os": "mac", "version": "0.1.2", "date": "2026-06-03T06:43:46.000Z", "commit": "34d35ba3dfad3d96ae78acffe356b69c8b583bcd", "fileid": "740e88bc4e32719b8f605ca65761370adabf778a59212180e9f908223c7439f2", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/antrologos/actions/runs/26868092351" }, { "r": "4.6.0", "os": "mac", "version": "0.1.2", "date": "2026-06-03T06:43:59.000Z", "commit": "34d35ba3dfad3d96ae78acffe356b69c8b583bcd", "fileid": "317bff70c2596f97f88de7aa476f6847e83dfcb774a371da4e1d47a7e7501b9f", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/antrologos/actions/runs/26868092351" }, { "r": "4.6.0", "os": "wasm", "version": "0.1.2", "date": "2026-06-03T06:43:52.000Z", "commit": "34d35ba3dfad3d96ae78acffe356b69c8b583bcd", "fileid": "519590016640d365ca334c2e664e8d0be13fe68b667e0b5fccd7eab31b82cad1", "status": "success", "buildurl": "https://github.com/r-universe/antrologos/actions/runs/26868092351" }, { "r": "4.7.0", "os": "win", "version": "0.1.2", "date": "2026-06-03T06:42:53.000Z", "commit": "34d35ba3dfad3d96ae78acffe356b69c8b583bcd", "fileid": "ade23c51e223493eac7f1d1eadd8f094249dfc432d7ae7b0dd404392ab70bab7", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/antrologos/actions/runs/26868092351" }, { "r": "4.5.3", "os": "win", "version": "0.1.2", "date": "2026-06-03T06:42:56.000Z", "commit": "34d35ba3dfad3d96ae78acffe356b69c8b583bcd", "fileid": "b9ea36dacf3bcb7ad9c644d4ccb33a082de7a875704fc558f82f7dc0ba260276", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/antrologos/actions/runs/26868092351" }, { "r": "4.6.0", "os": "win", "version": "0.1.2", "date": "2026-06-03T06:42:42.000Z", "commit": "34d35ba3dfad3d96ae78acffe356b69c8b583bcd", "fileid": "63594cc67c4031d2e639bdf4275c4ecf6f27682f1fd21f7b442c73477b08e74d", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/antrologos/actions/runs/26868092351" } ] }