README.Rmd

---
output: github_document
---

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

```{r, include = FALSE}
knitr::opts_chunk$set(
  collapse = TRUE,
  comment = "#>",
  fig.path = "man/figures/",
  out.width = "100%"
)

library(dados)
library(ggplot2)
library(dplyr)
library(purrr)
library(stringr)
knitr::opts_chunk$set(echo = TRUE)
```

# dados <img src="man/figures/dados-hex.png" align="right" width = "120px"/>

<!-- badges: start -->
[![CRAN status](https://www.r-pkg.org/badges/version/dados)](https://cran.r-project.org/package=dados)
[![R-CMD-check](https://github.com/cienciadedatos/dados/workflows/R-CMD-check/badge.svg)](https://github.com/cienciadedatos/dados/actions)
<!-- badges: end -->

Este pacote disponibiliza a tradução de conjuntos de dados em inglês originalmente disponíveis em outros pacotes de R. Os dados traduzidos são utilizados nos exemplos do livro [R for Data Science](https://r4ds.had.co.nz/) de Hadley Wickham & Garrett Grolemund, cuja [versão em português](https://altabooks.com.br/produto/r-para-data-science/) foi publicada por AltaBooks & O'Reilly.

## Instalação

Este pacote pode ser instalado a partir do CRAN:

```{r, eval = FALSE}
install.packages("dados")
```

A versão de desenvolvimento pode ser instalada a partir do GitHub:

```{r, eval = FALSE}
# install.packages("remotes")
remotes::install_github("cienciadedatos/dados")
```


## Traduções

As traduções disponíveis dentro de `dados` são as seguintes:

```{r, echo = FALSE}

specs <- list.files("inst/specs")
all <- map(file.path("inst", "specs", specs), yaml::read_yaml)
sources <- map_chr(all, ~.x$df$source)
pkgs <- tibble(
  Nome = map_chr(all, ~.x$df$name),
  `Título` = map_chr(all, ~.x$help$title),
  Pacote = map_chr(strsplit(sources, "::"), ~.x[[1]]),
  Dataset = map_chr(strsplit(sources, "::"), ~.x[[2]])
)


pkgs %>%
  arrange(Pacote, Dataset) %>%
  knitr::kable()
```


## Uso

O pacote `dados` pode ser carregado como qualquer outro pacote de R: 

```{r, message = FALSE}
library(dados)
library(ggplot2)
library(dplyr)
```

Ao carregar o pacote, as variáveis que contêm os dados estarão disponíveis imediatamente para uso. Porém, os dados não serão traduzidos até que a variável seja "chamada" explicitamente por um comando. Neste exemplo, o conjunto de dados `diamante`, que provém de `ggplot2::diamonds`, é carregado no _workspace_ do R no momento em que o chamamos pela primeira vez em português:

```{r}
glimpse(diamante)
```

Os dados traduzidos permanecerão carregados em sua sessão de R:

```{r eval = FALSE}
diamante %>%
  filter(corte == "Bom") %>%
  ggplot() +
  geom_boxplot(aes(transparencia, preco, fill = transparencia)) +
  theme(legend.position = "none") +
  labs(title = "Diamantes", subtitle = "Preço e transparência", y = "Preço", x = "Transparência")


```

<img src="man/figures/diamantes.png">


## Funções internas de `dados`

As funções internas de `dados` foram desenvolvidas originalmente por seu pacote irmão: [`datos`](https://cienciadedatos.github.io/datos/).