Working with the Neotoma Paleoecology Database
Overview
Access and manipulation of data using the Neotoma Paleoecology Database. https://api.neotomadb.org/api-docs/. Examples in functions that require API access are not executed during CRAN checks. Vignettes do not execute as to avoid API calls during CRAN checks.
- Added
count()to tally sites, collection units, or datasets in a record object. samples()gains achronnameargument to report ages against a chosen chronology.filter()now handles multiple conditions together with spatial (loc) filters.- More robust parsing of malformed API records (empty slots no longer create phantom IDs).
- Faster
parseURL()and automatic retry when the API is temporarily unavailable. all_data = TRUEstops as soon as a page comes back short, rather than spending an extra request to confirm the end of the results. Queries whose results fit in one page now cost one request instead of two.- A request that times out is retried at most once. Retrying a slow query stacks work onto an API that is already struggling, which made spatial (
loc) queries worse rather than better; other transient failures still retry as before. - Raised the default request timeout to 180 seconds, above the observed latency of the spatial endpoints, so healthy-but-slow queries are no longer aborted mid-flight.
NEOTOMA_TIMEOUTandNEOTOMA_RETRIESstill override both.
Show all changes in 1.1.0Hide the rest of the changes in 1.1.0
- A spatial geometry is now converted once per query rather than once per page, and the API's parameter list is fetched once per session rather than on every
get_*()call. - Paginated queries report their progress in interactive sessions.
- Improved
chronologies()function to show a data frame instead of the raw format of chronologies data.
From NEWS.md in the release
Install
Health
- OK13 OK2026-09-19
- NOTE12 OK, 1 NOTE2026-07-11
- OK13 OK2026-04-30
- NOTE13 OK, 1 NOTE2026-04-12
- OK14 OK2026-03-10
Documentation
- Help pages
- 86 (2 internal)
- Examples that run
- 23%7 run in a plain check · 23 never run
- Exported functions with examples
- 45%
- Documented parameters
- 99%
- Return-value docs
- 98%
- Help pages citing references
- 0%
Downloads
Repository
- PRs merged (all time)
- 67%
- Median days to close, 50 most recently updated closed issues
- 97
- Median days to close, 50 most recently updated closed PRs
- 1
Stars over time
Forks over time
Releases over time
Issues over time
PRs over time
Commits over time
Commit identities over time
11 development-tooling and community-health practices detected across 6 families in the upstream repository
Checks run against github.com/neotomadb/neotoma2 on 2026-10-11.
The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel
GitHub Pages site last deployed 2026-09-15 · The repository has a site deploy workflow
Show all practicesHide 2 practices
Dependencies
Installing neotoma2 adds 80 packages (47 with compiled code, 67 MB of source tarballs). Heaviest: stringi 11 MB, sf 9.3 MB, bslib 5.6 MB.
Code & Tests
People & History
Maintainer since 1.0.3 (2024), previously Simon Goring (1.0.0 to 1.0.2)
Pick two releases to compare their code metrics.
- RR 4.6.0 released · 2026-04-24
- 1.1.0Latest
- 1.0.122026-04-23 · diff ↗
- 1.0.112025-12-14 · diff ↗
- 1.0.102025-12-06 · diff ↗
- 1.0.92025-11-26 · diff ↗
- 1.0.82025-11-18 · diff ↗ ·
removed 5 exports
add_chronology, build_specimen, selectMatch, set_publications, showMatchadded 8 exports
clean, get_documentation, get_speleothems, getids.sites, set_publication, set_speleothem, speleothemdetails, speleothems - 1.0.72025-07-15 · diff ↗ ·
removed 9 exports
build_chron, build_collunits, build_dataset, build_sample, build_sites, get_specimens, parseURL, specimens, toJSON - unarchivedReturned to CRAN2025-06-25
- 1.0.6
- archivedRemoved from CRAN2025-06-02policy violation On Internet access
- RR 4.5.0 released · 2025-04-11
- 1.0.52024-08-21 · diff ↗
- unarchivedReturned to CRAN2024-07-28
- 1.0.42024-07-28 · diff ↗
- archivedRemoved from CRAN2024-06-14policy violation On Internet access
Show 7 earlier eventsHide 7 earlier events
Package metadata
- First published
- 2023-04-20
- Total releases
- 14 / 3 yrs
- License
- MIT + file LICENSE OSI
- Download size
- 438 KB
Cite
Cite this package
Run in R for the authors' entry:
citation("neotoma2")The package provides a citation file, so citation() returns the authors' own entry.
It points to 10.5281/zenodo.8114874.
The repository also keeps a CITATION.cff.
Cite the R Observatory
For a number measured here: a download total, a coverage figure, an archival date.
From data release v2026-10-18, which the citation names so these numbers can be found later. More on citing and the projects behind them.