Permalink
Browse files

rename package to CS Lewis's Narnia

  • Loading branch information...
njtierney committed Jun 1, 2017
1 parent 82095ec commit 154256718dcae9e5f661597a1b0f90167028c378
Showing with 2,185 additions and 1,181 deletions.
  1. +8 −8 DESCRIPTION
  2. +4 −0 NEWS.md
  3. +1 −1 R/defunct_missing_data_tidiers.R
  4. +1 −2 R/geom_missing_point.R
  5. +1 −1 R/legend-draw.R
  6. +1 −4 R/missing_data_tidiers.R
  7. +0 −6 R/naniar-ggproto.R
  8. +6 −0 R/narnia-ggproto.R
  9. +2 −2 R/{naniar-package.R → narnia-package.R}
  10. +1 −1 R/stat_missing_point.R
  11. +1 −1 R/utils.R
  12. BIN README-figs/README-facet-add-theme-1.png
  13. BIN README-figs/README-facet-by-month-1.png
  14. BIN README-figs/README-geom-missing-point-1.png
  15. BIN README-figs/README-geom-missing-point-alpha-1.png
  16. +12 −12 README.Rmd
  17. +11 −11 README.md
  18. +1 −1 _pkgdown.yml
  19. BIN docs/README-figs/README-facet-add-theme-1.png
  20. BIN docs/README-figs/README-facet-by-month-1.png
  21. BIN docs/README-figs/README-geom-missing-point-1.png
  22. BIN docs/README-figs/README-geom-missing-point-alpha-1.png
  23. BIN docs/README-figs/README-viss-miss-1.png
  24. +8 −6 docs/articles/index.html
  25. +44 −44 docs/articles/missingness-building-on-ggplot2.html
  26. BIN docs/articles/missingness-building-on-ggplot2_files/figure-html/ggeom_missing-1.png
  27. BIN docs/articles/missingness-building-on-ggplot2_files/figure-html/unnamed-chunk-2-1.png
  28. +87 −87 docs/articles/shadow-mechanics.html
  29. +6 −4 docs/authors.html
  30. +82 −84 docs/index.html
  31. +28 −18 docs/news/index.html
  32. +70 −25 docs/pkgdown.css
  33. +25 −20 docs/reference/add_n_miss.html
  34. BIN docs/reference/add_prop_miss-4.png
  35. +25 −20 docs/reference/add_prop_miss.html
  36. +24 −19 docs/reference/as_shadow.html
  37. +24 −19 docs/reference/bind_shadow.html
  38. +79 −78 docs/reference/brfss.html
  39. +24 −15 docs/reference/draw_key.html
  40. +25 −20 docs/reference/gather_shadow.html
  41. +57 −44 docs/reference/geom_missing_point.html
  42. +15 −10 docs/reference/gg_missing_case.html
  43. +14 −9 docs/reference/gg_missing_var.html
  44. +14 −9 docs/reference/gg_missing_which.html
  45. +175 −122 docs/reference/index.html
  46. +14 −9 docs/reference/is_na.html
  47. +45 −40 docs/reference/label_missing_1d.html
  48. +49 −42 docs/reference/label_missing_2d.html
  49. +47 −42 docs/reference/label_missings.html
  50. +14 −9 docs/reference/miss_case_pct.html
  51. +24 −19 docs/reference/miss_case_summary.html
  52. +15 −10 docs/reference/miss_case_table.html
  53. +23 −14 docs/reference/miss_cat.html
  54. +14 −10 docs/reference/miss_df_pct.html
  55. +16 −11 docs/reference/miss_summary.html
  56. +14 −11 docs/reference/miss_var_pct.html
  57. +15 −10 docs/reference/miss_var_summary.html
  58. +15 −10 docs/reference/miss_var_table.html
  59. +14 −9 docs/reference/n_complete.html
  60. +14 −9 docs/reference/n_miss.html
  61. +120 −0 docs/reference/narnia-ggproto.html
  62. +113 −0 docs/reference/narnia.html
  63. +14 −9 docs/reference/percent_missing_case.html
  64. +14 −9 docs/reference/percent_missing_df.html
  65. +14 −9 docs/reference/percent_missing_var.html
  66. +136 −0 docs/reference/prop_complete.html
  67. +136 −0 docs/reference/prop_miss.html
  68. +15 −10 docs/reference/prop_na.html
  69. +9 −9 docs/reference/reexports.html
  70. +24 −19 docs/reference/shadow_df.html
  71. +15 −10 docs/reference/shadow_shift.html
  72. +57 −43 docs/reference/stat_missing_point.html
  73. +15 −10 docs/reference/summarise_missingness.html
  74. +14 −9 docs/reference/summary_missing_case.html
  75. +14 −9 docs/reference/summary_missing_var.html
  76. +14 −9 docs/reference/table_missing_case.html
  77. +14 −9 docs/reference/table_missing_var.html
  78. +20 −19 docs/reference/tao.html
  79. +182 −0 docs/reference/which_na.html
  80. +7 −7 inst/development-notes.Rmd
  81. +1 −1 man/draw_key.Rd
  82. +0 −1 man/geom_missing_point.Rd
  83. +0 −1 man/miss_df_pct.Rd
  84. +1 −1 man/miss_summary.Rd
  85. +0 −2 man/miss_var_pct.Rd
  86. +0 −10 man/naniar.Rd
  87. +4 −4 man/{naniar-ggproto.Rd → narnia-ggproto.Rd}
  88. +10 −0 man/narnia.Rd
  89. +1 −1 man/summarise_missingness.Rd
  90. +1 −1 man/which_na.Rd
  91. +2 −2 tests/testthat.R
  92. +1 −1 tests/testthat/test-plots.R
  93. +5 −5 vignettes/missingness-building-on-ggplot2.Rmd
  94. +3 −3 vignettes/shadow-mechanics.Rmd
@@ -1,4 +1,4 @@
Package: naniar
Package: narnia
Type: Package
Title: Provide Summaries and Visualisations for Missing Data
Version: 0.0.6.9100
@@ -9,9 +9,9 @@ Authors@R: c(
person("Miles", "McBain", , "miles.mcbain@gmail.com", role = "aut")
)
Description: Missing values are ubiquitous in data and need to be explored and
handled in the initial stages of analysis. naniar provides helpers for
handled in the initial stages of analysis. narnia provides helpers for
exploring missing data dependencies with minimal deviation from the common
workflows of ggplot and tidy data. naniar builds data structures and
workflows of ggplot and tidy data. narnia builds data structures and
functions that ensure missings are plotted easily and enables imputations
to be examined.
License: MIT + file LICENSE
@@ -42,21 +42,21 @@ Imports:
Remotes:
njtierney/visdat
RoxygenNote: 6.0.1.9000
Collate:
Collate:
'add_cols.R'
'data.R'
'defunct_missing_data_tidiers.R'
'legend-draw.R'
'geom_missing_point.R'
'label_missings.R'
'missing_data_tidiers.R'
'naniar-ggproto.R'
'naniar-package.R'
'narnia-ggproto.R'
'narnia-package.R'
'old_shadow_shifters.R'
'plotting.R'
'shadow_shifters.R'
'shadows.R'
'stat_missing_point.R'
'utils.R'
URL: https://github.com/njtierney/naniar
BugReports: https://github.com/njtierney/naniar/issues
URL: https://github.com/njtierney/narnia
BugReports: https://github.com/njtierney/narnia/issues
@@ -1,3 +1,7 @@
# narnia 0.0.7.9000 (2017/06/02)

* renamed package from `naniar` to `narnia` - I had to explain the spelling a few times when I was introducing the package and I realised that I should change the name. Fortunately it isn't on CRAN yet.

# naniar 0.0.6.9100 (2017/03/21)

* Added `prop_miss` and the complement `prop_complete`. Where `n_miss` returns the number of missing values, `prop_miss` returns the proportion of missing values. Likewise, `prop_complete` returns the proportion of complete values.
@@ -102,7 +102,7 @@ summary_missing_case <- function(...){
use 'miss_case_summary' instead")
}

#' Collate summary measures from naniar into one tibble
#' Collate summary measures from narnia into one tibble
#'
#' Deprecated as of version 0.0.6.9000. Please use miss_summary instead.
#'
@@ -48,7 +48,6 @@
#' @examples
#'
#' library(ggplot2)
#' library(naniar)
#'
#' # using regular geom_point()
#' ggplot(airquality,
@@ -88,7 +87,7 @@ geom_missing_point <- function(mapping = NULL,

}

#' @rdname naniar-ggproto
#' @rdname narnia-ggproto
#' @format NULL
#' @usage NULL
#' @export
@@ -1,7 +1,7 @@
#' Key drawing functions
#'
#' Each Geom has an associated function that draws the key when the geom needs
#' to be displayed in a legend. These are the options built into naniar.
#' to be displayed in a legend. These are the options built into narnia.
#'
#' @return A grid grob.
#' @param data A single row data frame containing the scaled aesthetics to
@@ -11,7 +11,6 @@
#'
#' @examples
#'
#' library(naniar)
#' miss_df_pct(airquality)
#'
miss_df_pct <- function(data){
@@ -39,8 +38,6 @@ miss_df_pct <- function(data){
#'
#' @examples
#'
#' library(naniar)
#'
#' miss_var_pct(airquality)
#'
miss_var_pct <- function(data){
@@ -261,7 +258,7 @@ miss_case_summary <- function(data){
} else stop("Input must inherit from data.frame", call. = FALSE)
}

#' Collate summary measures from naniar into one tibble
#' Collate summary measures from narnia into one tibble
#'
#' \code{summarise_missingness} performs all of the missing data helper summaries and puts them into a list. Perhaps in the future this can all be some sort of nested dataframe?
#'

This file was deleted.

Oops, something went wrong.
@@ -0,0 +1,6 @@
#' @name narnia-ggproto
#' @title narnia-ggroto
#'
#' @description These are the stat and geom overrides using ggproto from ggplot2 that make narnia work.
#'
NULL
@@ -1,6 +1,6 @@
#' naniar
#' narnia
#'
#' @name naniar
#' @name narnia
#' @docType package
#' @importFrom magrittr %>%
#' @import ggplot2
@@ -64,7 +64,7 @@ stat_missing_point <- function(mapping = NULL,

}

#' @rdname naniar-ggproto
#' @rdname narnia-ggproto
#' @export
StatMissingPoint <- ggproto("StatMissingPoint", Stat,
required_aes = c("x", "y"),
@@ -10,7 +10,7 @@
#'
#' @examples
#'
#' which_na(airquality)
#' narnia:::which_na(airquality)
#'
which_na <- function(x){
which(is.na(x), arr.ind = TRUE)
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
@@ -12,11 +12,11 @@ knitr::opts_chunk$set(
)
```

# naniar
[![AppVeyor Build Status](https://ci.appveyor.com/api/projects/status/github/njtierney/naniar?branch=master&svg=true)](https://ci.appveyor.com/project/njtierney/naniar) [![Travis-CI Build Status](https://travis-ci.org/njtierney/naniar.svg?branch=master)](https://travis-ci.org/njtierney/naniar)
[![Coverage Status](https://img.shields.io/codecov/c/github/njtierney/naniar/master.svg)](https://codecov.io/github/njtierney/naniar?branch=master)
# narnia
[![AppVeyor Build Status](https://ci.appveyor.com/api/projects/status/github/njtierney/narnia?branch=master&svg=true)](https://ci.appveyor.com/project/njtierney/narnia) [![Travis-CI Build Status](https://travis-ci.org/njtierney/narnia.svg?branch=master)](https://travis-ci.org/njtierney/narnia)
[![Coverage Status](https://img.shields.io/codecov/c/github/njtierney/narnia/master.svg)](https://codecov.io/github/njtierney/narnia?branch=master)

`naniar` aims to make it easy to summarise, visualise, and manipulate missing data in a tidy fashion.
`narnia` aims to make it easy to summarise, visualise, and manipulate missing data in a tidy fashion.

Currently it provides:

@@ -39,15 +39,15 @@ Currently it provides:
+ `miss_var_table()`
+ `miss_df_pct()`

For a more formal description, you can read the vignette ["building on ggplot2 for exploration of missing values"](http://www.njtierney.com/naniar/articles/missingness-building-on-ggplot2.html).
For a more formal description, you can read the vignette ["building on ggplot2 for exploration of missing values"](http://www.njtierney.com/narnia/articles/missingness-building-on-ggplot2.html).

**Why `naniar`?**
**Why `narnia`?**

`naniar` was previously named `ggmissing` and initially provided a ggplot geom and some visual summaries. It was changed to `naniar` to reflect the fact that this package is going to be bigger in scope, and is not just related to ggplot2. Specifically, the package is designed to provide a suite of tools for generating visualisations of missing values and imputations, manipulate, and summarise missing data.
`narnia` was previously named `ggmissing` and initially provided a ggplot geom and some visual summaries. It was changed to `narnia` to reflect the fact that this package is going to be bigger in scope, and is not just related to ggplot2. Specifically, the package is designed to provide a suite of tools for generating visualisations of missing values and imputations, manipulate, and summarise missing data.

> ...But _why_ `naniar`?
> ...But _why_ `narnia`?
Well, I think it is useful to think of missing values in data being like this other dimension, perhaps like Narnia - a different world, hidden away. Close, but very different. So the name, "naniar", is a play on the "Narnia" books. e.g., naniar: The Last Battle (...with missing data). Also, `NA`niar, naniar = na in r, and if you so desire, naniar may sound like "noneoya" in an nz/aussie accent. Full credit to @MilesMcbain for the name.
Well, I think it is useful to think of missing values in data being like this other dimension, perhaps like Narnia - a different world, hidden away. Close, but very different. So the name, "narnia", is a play on the "Narnia" books. e.g., narnia: The Last Battle (...with missing data). Also, `NA`niar, narnia = na in r, and if you so desire, narnia may sound like "noneoya" in an nz/aussie accent. Full credit to @MilesMcbain for the name.

Please note that this project is released with a [Contributor Code of Conduct](CONDUCT.md). By participating in this project you agree to abide by its terms.

@@ -84,7 +84,7 @@ We can instead use the `geom_missing_point()` to display the missing data

```{r geom-missing-point}
library(naniar)
library(narnia)
ggplot(data = airquality,
aes(x = Ozone,
@@ -183,7 +183,7 @@ gridExtra::grid.arrange(p1, p2, ncol = 2)

# Numerical summaries for missing data

`naniar` provides numerical summaries of missing data. For variables, cases, and dataframes there are the function families `miss_var_*`, `miss_case_*`, and `miss_df_*`. To find the percent missng variables, cases, and dataframes:
`narnia` provides numerical summaries of missing data. For variables, cases, and dataframes there are the function families `miss_var_*`, `miss_case_*`, and `miss_df_*`. To find the percent missng variables, cases, and dataframes:

```{r numerical-percent-missing}
@@ -277,7 +277,7 @@ gg_missing_which(airquality)

# Future Work

`naniar` will be undergoing more changes over the next 6 months. The current plan is to submit it for rOpenSci onboarding by the end of January, and then to submit it to CRAN after that.
`narnia` will be undergoing more changes over the next 6 months. The current plan is to submit it for rOpenSci onboarding by the end of January, and then to submit it to CRAN after that.

Other plans to extend the `geom_missing_` family to include:

@@ -1,11 +1,11 @@

<!-- README.md is generated from README.Rmd. Please edit that file -->
naniar
narnia
======

[![AppVeyor Build Status](https://ci.appveyor.com/api/projects/status/github/njtierney/naniar?branch=master&svg=true)](https://ci.appveyor.com/project/njtierney/naniar) [![Travis-CI Build Status](https://travis-ci.org/njtierney/naniar.svg?branch=master)](https://travis-ci.org/njtierney/naniar) [![Coverage Status](https://img.shields.io/codecov/c/github/njtierney/naniar/master.svg)](https://codecov.io/github/njtierney/naniar?branch=master)
[![AppVeyor Build Status](https://ci.appveyor.com/api/projects/status/github/njtierney/narnia?branch=master&svg=true)](https://ci.appveyor.com/project/njtierney/narnia) [![Travis-CI Build Status](https://travis-ci.org/njtierney/narnia.svg?branch=master)](https://travis-ci.org/njtierney/narnia) [![Coverage Status](https://img.shields.io/codecov/c/github/njtierney/narnia/master.svg)](https://codecov.io/github/njtierney/narnia?branch=master)

`naniar` aims to make it easy to summarise, visualise, and manipulate missing data in a tidy fashion.
`narnia` aims to make it easy to summarise, visualise, and manipulate missing data in a tidy fashion.

Currently it provides:

@@ -28,15 +28,15 @@ Currently it provides:
- `miss_var_table()`
- `miss_df_pct()`

For a more formal description, you can read the vignette ["building on ggplot2 for exploration of missing values"](http://www.njtierney.com/naniar/articles/missingness-building-on-ggplot2.html).
For a more formal description, you can read the vignette ["building on ggplot2 for exploration of missing values"](http://www.njtierney.com/narnia/articles/missingness-building-on-ggplot2.html).

**Why `naniar`?**
**Why `narnia`?**

`naniar` was previously named `ggmissing` and initially provided a ggplot geom and some visual summaries. It was changed to `naniar` to reflect the fact that this package is going to be bigger in scope, and is not just related to ggplot2. Specifically, the package is designed to provide a suite of tools for generating visualisations of missing values and imputations, manipulate, and summarise missing data.
`narnia` was previously named `ggmissing` and initially provided a ggplot geom and some visual summaries. It was changed to `narnia` to reflect the fact that this package is going to be bigger in scope, and is not just related to ggplot2. Specifically, the package is designed to provide a suite of tools for generating visualisations of missing values and imputations, manipulate, and summarise missing data.

> ...But *why* `naniar`?
> ...But *why* `narnia`?
Well, I think it is useful to think of missing values in data being like this other dimension, perhaps like Narnia - a different world, hidden away. Close, but very different. So the name, "naniar", is a play on the "Narnia" books. e.g., naniar: The Last Battle (...with missing data). Also, `NA`niar, naniar = na in r, and if you so desire, naniar may sound like "noneoya" in an nz/aussie accent. Full credit to @MilesMcbain for the name.
Well, I think it is useful to think of missing values in data being like this other dimension, perhaps like Narnia - a different world, hidden away. Close, but very different. So the name, "narnia", is a play on the "Narnia" books. e.g., narnia: The Last Battle (...with missing data). Also, `NA`niar, narnia = na in r, and if you so desire, narnia may sound like "noneoya" in an nz/aussie accent. Full credit to @MilesMcbain for the name.

Please note that this project is released with a [Contributor Code of Conduct](CONDUCT.md). By participating in this project you agree to abide by its terms.

@@ -73,7 +73,7 @@ We can instead use the `geom_missing_point()` to display the missing data

``` r
library(naniar)
library(narnia)
ggplot(data = airquality,
aes(x = Ozone,
@@ -195,7 +195,7 @@ gridExtra::grid.arrange(p1, p2, ncol = 2)
Numerical summaries for missing data
====================================

`naniar` provides numerical summaries of missing data. For variables, cases, and dataframes there are the function families `miss_var_*`, `miss_case_*`, and `miss_df_*`. To find the percent missng variables, cases, and dataframes:
`narnia` provides numerical summaries of missing data. For variables, cases, and dataframes there are the function families `miss_var_*`, `miss_case_*`, and `miss_df_*`. To find the percent missng variables, cases, and dataframes:

``` r
@@ -349,7 +349,7 @@ gg_missing_which(airquality)
Future Work
===========

`naniar` will be undergoing more changes over the next 6 months. The current plan is to submit it for rOpenSci onboarding by the end of January, and then to submit it to CRAN after that.
`narnia` will be undergoing more changes over the next 6 months. The current plan is to submit it for rOpenSci onboarding by the end of January, and then to submit it to CRAN after that.

Other plans to extend the `geom_missing_` family to include:

@@ -1,7 +1,7 @@
home:
links:
- text: Learn more
href: https://github.com/njtierney/naniar
href: https://github.com/njtierney/narnia
reference:
- title: "Visualisation"
desc: >
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.

Some generated files are not rendered by default. Learn more.

Oops, something went wrong.
Oops, something went wrong.

0 comments on commit 1542567

Please sign in to comment.