Skip to content

tidync

0.5.0Package record

Tidy Approach to 'NetCDF' Data Exploration and Extraction

2packages dependsuggested by 1
11.4Kdownloads / year
–test coverage
13/13flavors OK

Overview

About

Tidy tools for 'NetCDF' data sources. Explore the contents of a 'NetCDF' source (file or URL) presented as variables organized by grid with a database-like interface. The hyper_filter() interactive function translates the filter value or index expressions to array-slicing form. No data is read until explicitly requested, as a data frame or list of arrays via hyper_tibble() or hyper_array().

Changes in 0.5.0

This release adds multi-source support, request of (#131): a tidync object can now present a consolidated

lazy view across a collection of NetCDF sources, extending the

filter-then-read model unchanged from one file to many.

Multi-source collections

  • tidync() now accepts a vector of file paths together with a concat_dim argument, building a consolidated view across sources along that dimension (typically time). Downstream operations (hyper_filter(), hyper_array(), hyper_tibble(), hyper_tbl_cube()) work transparently across the collection, and only the files needed for the current selection are opened at read time. A single file with concat_dim is a valid degenerate collection.
  • Fast mode for large collections: tidync(files, concat_dim = "time", fast = TRUE) skips full metadata scans of sources 2..N, reading only the concat dimension coordinate from each file. Validation is deferred to data-read time, where dimension mismatches are reported with the offending file named. In fast mode the time coordinate is presented numerically (no timestamp column), since per-source calendar metadata is not read; use the default full mode for CFtime timestamps.
Show all changes in 0.5.0Hide the rest of the changes in 0.5.0
  • Zero file I/O construction: supply coordinate values directly with concat_dim = list(name = "time", values = dates) and only the first source is opened (as the template). Values can be numeric, Date, or POSIXct, and hyper_filter() operates on them directly. This is aimed at file-database workflows (for example raadfiles) where per-file coordinates are already known. This construction assumes one step per source; files holding more steps on the concat dimension are detected at read time and reported as an error rather than silently subset.
  • Read-time validation is armed automatically for fast mode and for values-supplied construction: shared dimensions and the per-source concat dimension length are checked against the consolidated view as each file is opened, with clear errors naming the file.
  • Optional parallel reads via mirai: when mirai::daemons() are active, per-source reads in hyper_array() run in parallel with mirai::mirai_map(), falling back to sequential reads when mirai is not installed or no daemons are set. Parallelism is entirely under user control; tidync never starts daemons itself. Errors raised during parallel reads (including validation failures) propagate normally.
  • Sources are kept in the order supplied; the consolidated index on the concat dimension is file order. Value-based filters work regardless of ordering, but supply sources in coordinate order for a monotonic view.
  • tidync() on a tidync_data object (round-trip) preserves the source table and concat_dim.

Known limitations

  • Non-contiguous selections *within* a single source still read a bounding slab and are not supported at hyper_array() time, consistent with single-source behaviour. Non-contiguous selections that span whole sources (for example dropping intermediate files) are supported and read only the files required.

Fixes

  • Fixed hyper_tibble() producing constant dimension values when drop = TRUE (the default) collapses arrays to bare vectors; expansion is now based on length() rather than prod(dim()).
  • Fixed the print method showing NA for min/max of Date/POSIXct coordinate columns; non-numeric coordinates are now converted with as.numeric() (Date as days since epoch) rather than replaced with NA.
  • Repaired mangled pipe operators in the package overview help examples.
  • Removed commented-out browser() calls.
  • Update to CFTime as_timestamp(), thanks to @fabern.
  • Support for CF time metadata via package CFtime thanks to @pvanlaake, see https://github.com/ropensci/tidync/pull/124
  • Suppress ncdf4 warnings on open, issue #119.

Dependencies and internals

  • Minimum R version is now 4.1.0 (native pipe |>). Removed forcats, magrittr, and purrr dependencies; %>% replaced with |> throughout and purrr::safely() replaced with tryCatch().
  • ncmeta (>= 0.5.0) is now required, for extended (CFtime) metadata and for correct handling of sources with no variables (such as compound-type L3 bin files), which errored uninformatively with earlier ncmeta under current dplyr.
  • Minimum dplyr version is 1.1.0 (multiple argument in joins) and minimum tidyr version is 1.0.0 (cols argument in unnest()); all version-gating conditionals removed.
  • mirai added to Suggests.
  • print.tidync now returns its input invisibly, as always claimed.

From NEWS.md in the release

Install

Health

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

none known

Documentation

In release 0.5.0
READMEYes · 899 wordsVignettesYes · 1 · dynamicNEWSYes · 100% structured · mentions 0.5.0Citation fileNoWebsiteYes · pkgdown
Help pages
12 (1 internal)includes a package overview page
Examples that run
100%12 run in a plain check
Exported functions with examples
100%
Documented parameters
100%
Return-value docs
100%
Help pages citing references
0%

Downloads

11.4K
CRAN downloads in the past year
Rank #3,835 · ~31/day · ~950/mo
Daily download trend is not available in this view yet.
79930 days
2.5K90 days
11.4K1 year
Compare downloads with other packages →
Also on505 r2u4 autocran1.4K conda_forge

Repository

95Stars
12Forks
21Open issues
0Open PRs
2Releases
450Commits
8Commit identities
450 commits · Last activity 2026-07-31 · 0% stars, 30d
Responsiveness
How these are sampled
PRs merged (all time)
75%
Median days to close, 50 most recently updated closed issues
200
Median days to close, 50 most recently updated closed PRs
0

Stars over time

2025-07-18 · 922026-08-31 · 95
PracticesBeta

12 development-tooling and community-health practices detected across 6 families in the upstream repository

Checks run against github.com/ropensci/tidync on 2026-10-25.

Continuous integration (2)
GitHub ActionsR CMD check workflow

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

Governance and community (4)
Code of conductContributing guideIssue templatesPR template
Docs source (3)
README.Rmd

GitHub Pages site last deployed 2019-11-06 · The repository has a site deploy workflow

Reproducibility and dev environment (1)
data-raw/
Show all practicesHide 2 practices
CRAN release process (1)
cran-comments.md
Lint, format, editor (1)
RStudio project
How this is detected·Detection ruleset v4 (2026-10-20)

Dependencies

Declared dependencies
15 external dependencies (excludes base and recommended)

Installing tidync adds 24 packages (14 with compiled code, 19 MB of source tarballs). Heaviest: stringi 11 MB, vctrs 1.0 MB, dplyr 902 KB.

Depends (1)
R >= 4.1.0
LinkingTo (0)
none
Enhances (0)
none
Reverse dependencies
2direct
0indirect
Imports 2
Suggested by 1
Depends, Imports or LinkingTo, most downloaded first
Suggests, most downloaded first

People & History

People (10)
Author, Maintainer since 0.1.1 (2019), Copyright holder
Contributor · added in 0.4.0
Contributor · added in 0.2.0
Contributor · added in 0.2.0
Contributor · added in 0.3.0
Contributor
Contributor
Contributor · added in 0.4.0
Contributor · added in 0.2.4
Show 1 more contributorHide 1 contributor
Releases (9)

Pick two releases to compare their code metrics.

  • 0.5.0Latest
    record
    2026-07-31 · current release · diff ↗ ·
    removed 1 export
    %>%
  • R
    R 4.6.0 released · 2026-04-24
  • R
    R 4.5.0 released · 2025-04-11
  • 0.4.0
    record
    2024-08-17 · diff ↗ ·
    added 1 export
    nc_get
  • R
    R 4.4.0 released · 2024-04-24
  • R
    R 4.3.0 released · 2023-04-21
  • 0.3.0
    record
    2022-10-27 · diff ↗
  • R
    R 4.2.0 released · 2022-04-22
  • R
    R 4.1.0 released · 2021-05-18
  • 0.2.4
    record
    2020-05-12 · diff ↗
  • R
    R 4.0.0 released · 2020-04-24
  • unarchivedReturned to CRAN
    2019-11-07
  • 0.2.3
    record
    2019-11-07 · diff ↗
  • archivedRemoved from CRAN
    2019-11-06
    check problems were not corrected in time
  • 0.2.2
    record
    2019-10-22 · diff ↗
  • 0.2.1
    record
    2019-05-23 · diff ↗
Show 3 earlier eventsHide 3 earlier events

Package metadata

First published
2019-04-27
Total releases
9 / 7 yrs
License
GPL-3 OSI
Minimum R
≥ 4.1.0
Download size
384 KB

Cite

Cite this package

Run in R for the authors' preferred citation:

citation("tidync")
Sumner, M., Bernhard, F., Lucas, T., Nowosad, J., Odenweller, A., Raymond, B., Remenyi, T., Van Laake, P., Wickham, H., & Wotherspoon, S. (2026). tidync: Tidy Approach to 'NetCDF' Data Exploration and Extraction (Version 0.5.0) [Computer software]. https://doi.org/10.32614/CRAN.package.tidync

This package has no citation file, so citation() returns this entry built from DESCRIPTION.

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 tidync version 0.5.0 [Data set]. HJJB, LLC. Data release v2026-10-26. https://doi.org/10.5281/zenodo.21843040

From data release v2026-10-26, 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