Skip to content

aopdata

1.2.0Package record

Data from the 'Access to Opportunities Project (AOP)'

0packages depend
7.2Kdownloads / year
97.8%test coverage
13/13flavors OK

Overview

About
Maintained by Rafael H. M. PereiraCRAN page ↗GitHub ↗Website ↗Issues ↗Declared funder: Ipea - Institute for Applied Economic Research

Download data from the 'Access to Opportunities Project (AOP)'. The 'aopdata' package brings annual estimates of access to employment, health, education and social assistance services by transport mode, as well as data on the spatial distribution of population, jobs, health care, schools and social assistance facilities at a fine spatial resolution for all cities included in the project. More info on the 'AOP' website https://www.ipea.gov.br/acessooportunidades/en/.

Changes in 1.2.0

**Major changes**

  • Data files are now downloaded with {httr2}. If a file can't be downloaded from the Ipea server, that file is downloaded from the GitHub mirror, so a single unavailable file or server no longer makes the whole request fail. When several files are downloaded at once, the progress bar counts files; when only one file is downloaded, it shows the amount of data downloaded.
  • aopdata now requires R >= 4.1.0 (a requirement of {httr2}).

**Bug fixes**

  • HTTP errors (e.g. 404 pages) are no longer saved and read as data.
  • Interrupted or corrupted downloads are no longer reused from the session cache: files are saved only once they are complete, and a cached file that can't be read is removed.
  • Downloads that stall are now stopped instead of hanging the R session.
  • The metadata file is now downloaded with the same downloader as the data files (GitHub release first, Ipea server as fallback), and cached only once it has been read successfully. A broken cached metadata file is downloaded again instead of making every later call in the session fail.
  • Grids (geometry = TRUE or read_grid()) of several cities now have a bounding box that covers all the cities, and are a plain sf data frame. Previously the bounding box covered only the first city, so maps of several cities could be cropped.
  • When a download fails, the user now sees one message that says what failed. Previously the functions could print "No internet connection." up to three times, even when only one file was unavailable.

**Minor changes**

  • Documentation corrected to match the data: the years and cities of each transport mode, the off-peak window, time thresholds, the TMI indicators, the defaults of read_population(year) and read_grid(showProgress), and return types.
Show all changes in 1.2.0Hide the rest of the changes in 1.2.0
  • Typos fixed in the documentation and vignettes; the package citation (citation("aopdata")) now lists the two Ipea discussion papers as technical reports, with their DOIs.
  • City codes and names can now be mixed, in any capitalisation and with or without accents, in every function (e.g. city = c('nat', 'São Paulo')). Previously a mix returned NULL or a misleading error, and only read_access() accepted upper-case city codes and 'ALL'.
  • Invalid inputs now give a clear error before any data is downloaded: city missing, NULL, NA or not text; an unknown city (the error names it and lists the valid codes and names); and a mode that a requested city doesn't have (the error names the city and lists the cities with that mode).
  • peak, geometry and showProgress must be a single TRUE or FALSE. showProgress = 1/0 is no longer accepted, and NA or vectors give an error instead of a base R error. A vector year also gives a clear error; one year per call is supported.
  • Which cities have public transport is now taken from the metadata instead of lists hard-coded in read_access().
  • aopdata_dictionary() now only accepts lang = "en" or "pt"; values such as "english" were accepted before and silently did nothing.
  • All messages and errors now use {cli}. Errors have the condition class aopdata_error, and messages about failed downloads have the class aopdata_network, so they can be caught with tryCatch() or withCallingHandlers(). Download failure messages are now rlang_messages (previously cliMessage). The wording of the errors for invalid arguments, mode and showProgress changed, so match on the condition class rather than on the message text.
  • The "Downloading ... data" messages are now only shown when showProgress = TRUE. The "Using mode" message was removed.

From NEWS.md in the release

Install

Health

CRAN checks
13OK
Slowest check: 2.3 min · r-oldrel-macos-x86_64
Status changes
  • OK13 OK2026-09-08
  • ERROR12 OK, 1 ERROR2026-09-07
  • OK13 OK2026-08-05
  • NOTE12 OK, 1 NOTE2026-08-01
  • OK14 OK2026-03-10
Advisories

none known

Documentation

In release 1.2.0
READMEYes · 634 wordsVignettesYes · 7 · evaluation depends on the environmentNEWSYes · 100% structured · mentions 1.2.0Citation fileYes · cites a publicationWebsiteYes · pkgdown
Help pages
22 (17 internal)includes a package overview page
Examples that run
83%5 run in a plain check (5 of them under a condition) · 1 never run
Exported functions with examples
100%
Documented parameters
100%
Return-value docs
100%
Help pages citing references
0%

Downloads

7.2K
CRAN downloads in the past year
Rank #5,337 · ~20/day · ~598/mo
Daily download trend is not available in this view yet.
56830 days
1.6K90 days
7.2K1 year
Compare downloads with other packages →
Also on111 r2u58 autocran

Repository

ipea/aopdata ↗Organization: ipea
16Stars
4Forks
4Open issues
0Open PRs
13Releases
311Commits
9Commit identities
transport-planningtransport-accessibilitydatartransport
311 commits · Last activity 2026-10-19
Responsiveness
How these are sampled
PRs merged (all time)
100%
Median days to close, 50 most recently updated closed issues
2
Median days to close, 50 most recently updated closed PRs
0

Stars over time

2025-10-14 · 152026-10-19 · 16
Earlier repositories
PracticesBeta

5 development-tooling and community-health practices detected across 3 families in the upstream repository

Checks run against github.com/ipea/aopdata on 2026-10-21.

Continuous integration (2)
GitHub ActionsR CMD check workflow

The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel

Docs source (2)

GitHub Pages site last deployed 2026-10-19 · The repository has a site deploy workflow

pkgdown site last built 2026-10-19

Coverage (1)
Coverage reporting
How this is detected·Detection ruleset v4 (2026-10-20)
AI coding toolsBeta

This repository shows signs of AI coding tools.

  • Claude Codefirst seen 2026-10-18
    Seen in the repository: .claude, CLAUDE.md
    Named in .gitignore: .claude
How this is detected·Detection ruleset v4 (updated 2026-09-27)

Dependencies

Declared dependencies
15 external dependencies (excludes base and recommended)

Installing aopdata adds 25 packages (20 with compiled code, 28 MB of source tarballs). Heaviest: sf 9.3 MB, data.table 5.7 MB, s2 2.8 MB.

Depends (1)
R >= 4.1.0
LinkingTo (0)
none
Enhances (0)
none
Reverse dependencies
0direct
0indirect

Nothing depends on this yet.

People & History

People (7)
Author, Maintainer since 0.1.0 (2021)
Author · added in 1.0.0
Author · added in 0.2.0
Contributor · added in 1.0.0
Contributor · added in 1.0.0
Copyright holder, Funder · added in 1.0.0
Listed in earlier versions (1)
Ipea - Institue for Applied Economic Research
no longer listed · 0.1.0 to 0.2.3
Releases (13)

Pick two releases to compare their code metrics.

  • 1.2.0Latest
    record
    2026-10-19 · current release · diff ↗ ·
    listed once in CRAN's queue
    Seen in one reading of CRAN's incoming queue, at 2026-10-19 05:32 UTC, so it stayed less than the time between readings.
  • R
    R 4.6.0 released · 2026-04-24
  • 1.1.2
    record
    2026-01-09 · diff ↗
  • R
    R 4.5.0 released · 2025-04-11
  • 1.1.1
    record
    2025-01-29 · diff ↗
  • 1.1.0
    record
    2024-08-28 · diff ↗
  • R
    R 4.4.0 released · 2024-04-24
  • 1.0.3
    record
    2023-08-31 · diff ↗
  • 1.0.2
    record
    2023-05-19 · diff ↗
  • R
    R 4.3.0 released · 2023-04-21
  • 1.0.1
    record
    2022-08-31 · diff ↗
  • unarchivedReturned to CRAN
    2022-08-12
  • 1.0.0
    record
    2022-08-12 · diff ↗ ·
    removed 10 exports
    aop_merge, aop_spatial_join, check_connection, download_data, download_metadata, load_data, select_city_input, select_metadata, select_mode_input, select_year_input
    added 1 export
    aopdata_dictionary
  • R
    R 4.2.0 released · 2022-04-22
  • archivedRemoved from CRAN
    2022-02-06
    repeated policy violation On Internet access
  • 0.2.3
    record
    2022-01-28 · diff ↗
Show 6 earlier eventsHide 6 earlier events
  • R
    R 4.1.0 released · 2021-05-18
  • 0.2.2
    record
    2021-04-30 · diff ↗
  • 0.2.1
    record
    2021-04-07 · diff ↗ ·
    removed 1 export
    rm_accent
  • 0.2.0
    record
    2021-03-31 · diff ↗ ·
    added 2 exports
    check_connection, read_population
  • 0.1.0
    record
    2021-03-08
  • R
    R 4.0.0 released · 2020-04-24
Across CRAN, the median accepted release of the past year spent 26 hours in the queue, 90% under 11 days.How queue time is measured

Package metadata

First published
2021-03-08
Total releases
13 / 5 yrs
License
MIT + file LICENSE OSI
Minimum R
≥ 4.1.0
Download size
374 KB

Cite

Cite this package

Run in R for the authors' entry:

citation("aopdata")

The package provides a citation file, so citation() returns the authors' own entry.

It points to 10.38116/td2800, 10.38116/td2772.

Cite the R Observatory

For a number measured here: a download total, a coverage figure, an archival date.

APA

Balamuta, J. J. (2026). R Observatory: Metrics for aopdata version 1.2.0 [Data set]. HJJB, LLC. Data release v2026-10-25. https://doi.org/10.5281/zenodo.21843040

From data release v2026-10-25, which the citation names so these numbers can be found later. More on citing and the projects behind them.

Report a problem with this page →

Privacy choices

These apply to this browser and are stored on this device only. Nothing about your choice is sent to us.

Read the privacy policy