From 58ac405a48f42654a6031deda00501629c5068a2 Mon Sep 17 00:00:00 2001
From: hadley <h.wickham@gmail.com>
Date: Tue, 19 Jul 2016 08:57:22 -0500
Subject: [PATCH] Move tibble to own chapter.

---
 _bookdown.yml |   1 +
 tibble.Rmd    | 108 ++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 109 insertions(+)
 create mode 100644 tibble.Rmd

diff --git a/_bookdown.yml b/_bookdown.yml
index 7c55c56..564cfbe 100644
--- a/_bookdown.yml
+++ b/_bookdown.yml
@@ -10,6 +10,7 @@ rmd_files: [
   "EDA.Rmd",
 
   "wrangle.Rmd",
+  "tibble.Rmd",
   "import.Rmd",
   "tidy.Rmd",
   "relational-data.Rmd",
diff --git a/tibble.Rmd b/tibble.Rmd
new file mode 100644
index 0000000..d92d921
--- /dev/null
+++ b/tibble.Rmd
@@ -0,0 +1,108 @@
+# Tibbles
+
+## Introduction
+
+Throughout this book we work with "tibbles" instead of the traditional data frame. Tibbles _are_ data frames, but tweak some older behaviours to make life a littler easier. R is an old language, and some things that were true 10 or 20 years ago no longer apply. It's difficult to change base R without breaking existing code, so most innovation occurs in packages. Here we will describe the tibble package, which provides opinionated data frames that make working in the tidyverse a little easier. You can learn more about tibbles in the accompanying vignette: `vignette("tibble")`.
+
+### Prerequisites
+
+In this chapter we'll specifically explore the tibble package. Most of the chapters won't load this explicitly, as the packages (like readr, tidyr, and dplyr) will load it for you. You'll only need if you are creating tibbles "by hand".
+
+```{r setup}
+library(tibble)
+```
+
+## Creating tibbles {#tibbles}
+
+The majority of the functions that you'll use in this book already produce tibbles. If you're working with functions from other packages, you might need to coerce a regular data frame a tibble. You can do that with `as_tibble()`:
+
+```{r}
+as_tibble(iris)
+```
+
+`as_tibble()` knows how to convert data frames, lists (provided the elements are equal length vectors), matrices, and tables. 
+
+You can create a new tibble from individual vectors with `tibble()`:
+
+```{r}
+tibble(x = 1:5, y = 1, z = x ^ 2 + y)
+```
+
+`tibble()` automatically recycles inputs of length 1, and you can refer to variables that you just created. Compared to `data.frame()`, `tibble()` does much less: it never changes the type of the inputs (e.g. it never converts strings to factors!), it never changes the names of variables, and it never creates `row.names()`.
+
+Another way to create a tibble is with `frame_data()`, which is customised for data entry in R code. Column headings are defined by formulas (`~`), and entries are separated by commas:
+
+```{r}
+frame_data(
+  ~x, ~y,  ~z,
+  "a", 2,  3.6,
+  "b", 1,  8.5
+)
+```
+
+## Tibbles vs. data frames
+
+There are two main differences in the usage of a data frame vs a tibble: printing, and subsetting.
+
+### Printing
+
+Tibbles have a refined print method that shows only the first 10 rows, and all the columns that fit on screen. This makes it much easier to work with large data. In addition to its name, each column reports its type, a nice feature borrowed from `str()`:
+
+```{r}
+tibble(
+  a = lubridate::now() + runif(1e3) * 60,
+  b = lubridate::today() + runif(1e3),
+  c = 1:1e3,
+  d = runif(1e3),
+  e = sample(letters, 1e3, replace = TRUE)
+)
+```
+
+You can control the default appearance with options:
+
+* `options(tibble.print_max = n, tibble.print_min = m)`: if more than `m`
+  rows, print `n` rows. Use `options(dplyr.print_max = Inf)` to always
+  show all rows.
+
+* `options(tibble.width = Inf)` will always print all columns, regardless
+   of the width of the screen.
+
+You can see a complete list of options by looking at the package help: `package?tibble`.
+
+### Subsetting
+
+Tibbles are stricter about subsetting. If you try to access a variable that does not exist, you'll get a warning. Unlike data frames, tibbles do not use partial matching on column names:
+
+```{r}
+df <- data.frame(
+  abc = 1:10, 
+  def = runif(10), 
+  xyz = sample(letters, 10)
+)
+tb <- as_tibble(df)
+
+df$a
+tb$a
+```
+
+Tibbles clearly delineate `[` and `[[`: `[` always returns another tibble, `[[` always returns a vector.
+
+```{r}
+# With data frames, [ sometimes returns a data frame, and sometimes returns 
+# a vector
+df[, 1]
+
+# With tibbles, [ always returns another tibble
+tb[, 1]
+
+# To extract a single element, you should always use [[
+tb[[1]]
+```
+
+## Interacting with legacy code
+
+Some older functions don't work with tibbles because they expect `df[, 1]` to return a vector, not a data frame. If you encounter one of these functions, use `as.data.frame()` to turn a tibble back to a data frame:
+
+```{r}
+class(as.data.frame(tb))
+```