R Observatory: Metrics for naniar version 1.1.0

Balamuta, James Joseph

doi:10.5281/zenodo.21843040

naniar

1.1.0Package record

Data Structures, Summaries, and Visualisations for Missing Data

7packages dependsuggested by 9

276.6Kdownloads / year

91.1%test coverage

1/13flavors OK

Overview

About

Maintained by Nicholas TierneyCRAN page ↗GitHub ↗Website ↗Issues ↗

Missing values are ubiquitous in data and need to be explored and handled in the initial stages of analysis. 'naniar' provides data structures and functions that facilitate the plotting of missing values and examination of imputations. This allows missing data dependencies to be explored with minimal deviation from the common work patterns of 'ggplot2' and tidy data. The work is fully discussed at Tierney & Cook (2023) doi:10.18637/jss.v105.i07.

Changes in 1.1.0

New

Implement impute_fixed, impute_zero, and impute_factor. notably these do not implement "scoped variants" which were previously implemented - for example, impute_fixed_if etc. This is in favour of using the new across workflow within dplyr, and it is easier to maintain. #261
Add digit argument to miss_var_summary to help display %missing data correctly when there is a very small fraction of missingness. #284
Implemented impute_mode - resolves #213.
geom_miss_point() works with shape argument #290
Fix bug with all_complete, which was implemented as !anyNA(x) but should be all(complete.cases(x)).
Correctly implement any_na() (and any_miss()) and any_complete(). Rework examples to demonstrate workflow for finding complete variables.

Bug fixes

Fix bug with shadow_long not working when gathering variables of mixed type. Fix involves specifying a value transform, which defaults to character. #314
Implement Date, POSIXct and POSIXlt methods for impute_below() - #158
Provide replace_na_with, a complement to replace_with_na - #129
Fix bug with gg_miss_fct where it used a deprecated function from forcats - #342

Show all changes in 1.1.0Hide the rest of the changes in 1.1.0

Misc

Use cli::cli_abort and cli::cli_warn instead of stop and warn (#326)
Use expect_snapshot instead of expect_error (#326)

Changes

Soft deprecated shadow_shift - #193
Soft deprecate miss_case_cumsum() and miss_var_cumsum() - #257

From NEWS.md in the release

Install

R (CRAN)pak (dev)Ubuntu (r2u)Fedora (COPR)openSUSE (OBS)

install.packages("naniar", repos = "https://cloud.r-project.org/")

Installs the current CRAN release. Prebuilt binaries on Windows and macOS.

if (!requireNamespace("pak", quietly = TRUE))
  install.packages("pak", repos = "https://cloud.r-project.org/")
pak::pak("njtierney/naniar")

Development version from njtierney/naniar. Installs pak first if it is not already available.

Release

# enable cranapt (r2u) if it is not already set up, then install
grep -rqs r2u.stat.illinois.edu /etc/apt/sources.list /etc/apt/sources.list.d/ \
  || curl -fsSL https://raw.githubusercontent.com/eddelbuettel/r2u/master/inst/scripts/add_cranapt_noble.sh | sudo bash
sudo apt install -y r-cran-naniar

Fast Ubuntu binaries via r2u (no compilation). The cranapt setup runs once and is skipped when it is already enabled. We list this channel from recorded r2u download activity rather than from a live index of the repository, so treat it as last known rather than guaranteed.

bspm (used by r2u) also needs make: sudo apt install make

# enable the iucar/cran COPR if it is not already present, then install
ls /etc/yum.repos.d/*iucar*cran*.repo >/dev/null 2>&1 \
  || sudo dnf copr enable -y iucar/cran
sudo dnf install -y R-CRAN-naniar

RPMs from the iucar/cran COPR, rebuilt from CRAN.

For install.packages() integration in R, also: sudo dnf install R-CoprManager

# add the autoCRAN OBS repo (Tumbleweed) if it is missing, then install
zypper -q lr | grep -qi autoCRAN \
  || sudo zypper addrepo https://download.opensuse.org/repositories/devel:/languages:/R:/autoCRAN/openSUSE_Tumbleweed/devel:languages:R:autoCRAN.repo
sudo zypper install -y R-naniar

RPMs auto-built from CRAN on openSUSE OBS (Tumbleweed). We list this channel from recorded autoCRAN download activity rather than from a live index of the repository, so treat it as last known rather than guaranteed.

Health

CRAN checks

12NOTE1OK

Check messages

NOTEDESCRIPTION meta-informationr-devel-linux-x86_64-debian-clang, r-devel-linux-x86_64-debian-gcc, r-devel-linux-x86_64-fedora-clang, r-devel-linux-x86_64-fedora-gcc, r-devel-windows-x86_64, r-oldrel-macos-arm64, r-oldrel-windows-x86_64, r-patched-linux-x86_64, r-release-linux-x86_64, r-release-macos-arm64, r-release-macos-x86_64, r-release-windows-x86_64

r-devel-linux-x86_64-debian-clang, r-devel-linux-x86_64-debian-gcc, r-devel-linux-x86_64-fedora-clang, r-devel-linux-x86_64-fedora-gcc, r-oldrel-macos-arm64, r-patched-linux-x86_64, r-release-linux-x86_64, r-release-macos-arm64, r-release-macos-x86_64

Missing dependency on R >= 4.1.0 because package code uses the pipe
  |> or function shorthand \(...) syntax added in R 4.1.0.
  File(s) using such syntax:
    ‘impute_below.Rd’ ‘impute_factor.Rd’ ‘impute_fixed.Rd’
    ‘impute_mean.Rd’ ‘impute_median.Rd’ ‘impute_mode.Rd’ ‘impute_zero.Rd’
    ‘replace_na_with.Rd’

r-devel-windows-x86_64, r-oldrel-windows-x86_64, r-release-windows-x86_64

Missing dependency on R >= 4.1.0 because package code uses the pipe
  |> or function shorthand \(...) syntax added in R 4.1.0.
  File(s) using such syntax:
    'impute_below.Rd' 'impute_factor.Rd' 'impute_fixed.Rd'
    'impute_mean.Rd' 'impute_median.Rd' 'impute_mode.Rd' 'impute_zero.Rd'
    'replace_na_with.Rd'

CRAN check page ↗

Slowest check: 4.8 min · r-oldrel-windows-x86_64

Status changes

NOTE1 OK, 12 NOTENow
NOTE2 OK, 11 NOTE2026-06-08
ERROR1 OK, 11 NOTE, 1 ERROR2026-06-07
NOTE4 OK, 10 NOTE2026-03-10

Advisories

none known

How this is measured·How advisories are found

Documentation

In release 1.1.0

READMEYes · 1,104 wordsVignettesYes · 5 · dynamicNEWSYes · 100% structured · mentions 1.1.0Citation fileYes · cites a publicationWebsiteYes · pkgdown

Cites a JSS article

Help pages: 102 (3 internal)includes a package overview page
Examples that run: 95%87 run in a plain check · 4 never run · 1 hold no code
Exported functions with examples: 93%
Documented parameters: 100%
Return-value docs: 88%
Help pages citing references: 1%

Vignettes (5)

Exploring Imputed Values HTML
Gallery of Missing Data Visualisations HTML
Getting Started with naniar HTML
Replacing values with NA HTML
Special Missing Values HTML

How these are measured

Downloads

276.6K

CRAN downloads in the past year

Rank #843 · ~758/day · ~23.1K/mo

Releases R versions

Daily download trend is not available in this view yet.

18.1K30 days

53K90 days

276.6K1 year

Compare downloads with other packages →

Also on4.5K r2u5 autocran3.3K conda_forge250 c2d4u

How downloads are counted

Repository

njtierney/naniar ↗Account: njtierney

675Stars

57Forks

67Open issues

2Open PRs

13Releases

967Commits

24Commit identities

missing-datadata-visualisationggplot2missingnesstidy-datar-package

967 commits · Last activity 2025-04-30 · 0% stars, 30d · Default branch at 1.1.0.9000, ahead of CRAN 1.1.0 (checked 2026-10-22)

Responsiveness

How these are sampled

PRs merged (all time): 99%
Median days to close, 50 most recently updated closed issues: 1,156
Median days to close, 50 most recently updated closed PRs: 0

Stars over time

2025-10-19 · 6592026-08-27 · 675

How these are measured

PracticesBeta

16 development-tooling and community-health practices detected across 7 families in the upstream repository

Checks run against github.com/njtierney/naniar on 2026-10-22.

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 (5)

Code of conductContributing guideIssue templatesPR template

The repository owner accepts GitHub Sponsors

Docs source (4)

README.Rmdpkgdown

GitHub Pages site last deployed 2025-04-30 · The repository has a site deploy workflow

pkgdown site last built 2025-04-30

Coverage (1)

Coverage reporting (Codecov)

Show all practicesHide 3 practices

Reproducibility and dev environment (1)

data-raw/

CRAN release process (2)

cran-comments.mdrevdep/

Lint, format, editor (1)

RStudio project

How this is detected·Detection ruleset v4 (2026-10-20)

Dependencies

Declared dependencies

29 external dependencies (excludes base and recommended)

Installing naniar adds 47 packages (23 with compiled code, 41 MB of source tarballs). Heaviest: stringi 11 MB, ggplot2 6.0 MB, UpSetR 3.9 MB.

Depends (1)

R >= 3.1.2

Imports (17)

dplyr ggplot2 purrr tidyr tibble norm magrittrstatsvisdat rlang forcats viridis glue UpSetR cli vctrs lifecycle

LinkingTo (0)

none

Suggests (14)

knitr rmarkdown testthatrpartrpart.plot covr gridExtra wakefield vdiffr here simputation imputeTS Hmisc spelling

Enhances (0)

none

Dependency license breakdown →

Reverse dependencies

7direct

1indirect

Imports 7

Suggested by 9

Show all 16 packagesHide all 16 packages

Depends, Imports or LinkingTo, most downloaded first

dbGaPCheckup FAfA surveyPrev cataScience smdi triageR vegetablesSriLanka

Suggests, most downloaded first

surveyframe ModStatR fastml NBDCtools cleanepi fairmetrics wdiexplorer misc causalCmprsk

How these are counted

Code & Tests

Datasets

People & History

People (8)

Nicholas Tierney

Author, Maintainer since 0.1.0 (2017)

Author

Author

Author

Contributor · added in 0.6.1

Jim Hester

Contributor · added in 0.2.0

Mitchell O'Hara-Wild

Contributor · added in 0.4.0.0

Luke Smith

Contributor · added in 0.3.0

Releases (14)

Pick two releases to compare their code metrics.

R
R 4.6.0 released · 2026-04-24
R
R 4.5.0 released · 2025-04-11
R
R 4.4.0 released · 2024-04-24
1.1.0Latest
record
2024-03-05 · current release · diff ↗ ·
added 5 exports
impute_factor, impute_fixed, impute_mode, impute_zero, replace_na_with
R
R 4.3.0 released · 2023-04-21
1.0.0
record
2023-02-02 · diff ↗ ·
removed 1 export
to_basic.GeomMissPoint

added 2 exports
set_n_miss, set_prop_miss
R
R 4.2.0 released · 2022-04-22
R
R 4.1.0 released · 2021-05-18
0.6.1
record
2021-05-14 · diff ↗ ·
added 1 export
mcar_test
0.6.0
record
2020-09-02 · diff ↗ ·
removed 4 exports
is_nabular, is_shadow, new_nabular, new_shadow
0.5.2
record
2020-06-29 · diff ↗
0.5.1
record
2020-05-01 · diff ↗
R
R 4.0.0 released · 2020-04-24
0.5.0
record
2020-02-28 · diff ↗ ·
added 2 exports
miss_case_cumsum, miss_var_cumsum
R
R 3.6.0 released · 2019-04-26
0.4.2
record
2019-02-15 · diff ↗ ·
added 1 export
to_basic.GeomMissPoint

Show 8 earlier eventsHide 8 earlier events

0.4.1
record
2018-11-20 · diff ↗
0.4.0.0
record
2018-09-10 · diff ↗ ·
removed 1 export
are_shadow

added 26 exports
.where, any_shade, are_shade, gg_miss_upset, impute_below_all, impute_median, impute_median_all, impute_median_at, impute_median_if, is_nabular, is_shade, nabular, new_nabular, new_shadow, pct_complete_case, pct_complete_var, pct_miss_case, pct_miss_var, prop_complete_case, prop_complete_var, prop_miss_case, prop_miss_var, recode_shadow, shade, shadow_long, which_are_shade
0.3.1
record
2018-06-08 · diff ↗
0.3.0
record
2018-06-07 · diff ↗ ·
added 29 exports
all_complete, all_miss, all_na, any_complete, any_miss, any_na, are_na, are_shadow, as_shadow_upset, complete_case_pct, complete_case_prop, complete_var_pct, complete_var_prop, impute_below, impute_below_at, impute_below_if, impute_mean, impute_mean_all, impute_mean_at, impute_mean_if, is_na, is_shadow, miss_var_which, n_case_complete, n_case_miss, n_var_complete, n_var_miss, unbind_data, unbind_shadow
R
R 3.5.0 released · 2018-04-23
0.2.0
record
2018-02-09 · diff ↗ ·
removed 2 exports
miss_case_cumsum, miss_var_cumsum

added 12 exports
add_miss_cluster, miss_scan_count, n_complete_row, n_miss_row, prop_complete_row, prop_miss_row, replace_with_na, replace_with_na_all, replace_with_na_at, replace_with_na_if, where_na, which_na
0.1.0
record
2017-08-09
R
R 3.4.0 released · 2017-04-21

Package metadata

First published: 2017-08-09
Total releases: 14 / 9 yrs
License: MIT + file LICENSE OSI
Minimum R: ≥ 3.1.2
Bundled data: 70 KB / 5 files
Download size: 2.7 MB

Appears in task views

Missing Data

Cite

Cite this package

Run in R for the authors' entry:

citation("naniar")

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

It points to 10.18637/jss.v105.i07.

Cite the R Observatory

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

Format

APA

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

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