README.Rmd

---
output: github_document
---

<a href="https://github.com/datazoompuc/datazoom.amazonia"><img src="https://raw.githubusercontent.com/datazoompuc/datazoom.amazonia/master/logo.png?token=AU72KNQCGY4ZR6XLARTNSXLBXCPNG" align="left" width="100" hspace="10" vspace="6"></a>

<!-- 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/README-",
  out.width = "100%"
)
```

# datazoom.amazonia

<!-- badges: start -->
[![CRAN version](https://www.r-pkg.org/badges/version/datazoom.amazonia?color=orange)](https://cran.r-project.org/package=datazoom.amazonia?style=flat)
[![R build status](https://github.com/datazoompuc/datazoom.amazonia/workflows/R-CMD-check/badge.svg)](https://github.com/datazoompuc/datazoom.amazonia/actions?style=flat) 
[![CRAN downloads](https://cranlogs.r-pkg.org/badges/grand-total/datazoom.amazonia?color=blue)](https://cran.r-project.org/package=datazoom.amazonia?style=flat)
[![CRAN downloads](https://cranlogs.r-pkg.org/badges/datazoom.amazonia?color=lightgrey)](https://cran.r-project.org/package=datazoom.amazonia?style=flat)
![Languages](https://img.shields.io/github/languages/count/datazoompuc/datazoom.amazonia?style=flat)
![Commits](https://img.shields.io/github/commit-activity/y/datazoompuc/datazoom.amazonia?style=flat)
![Open Issues](https://img.shields.io/github/issues-raw/datazoompuc/datazoom.amazonia?style=flat)
![Closed Issues](https://img.shields.io/github/issues-closed-raw/datazoompuc/datazoom.amazonia?style=flat)
![Files](https://img.shields.io/github/directory-file-count/datazoompuc/datazoom.amazonia?style=flat)
![Followers](https://img.shields.io/github/followers/datazoompuc?style=flat)
<!-- badges: end -->

The datazoom.amazonia package facilitates access to official Brazilian Amazon data, including agriculture, deforestation, production. The package provides functions that download and pre-process selected datasets.

## Installation

You can install the released version of `datazoom.amazonia` from
[CRAN](https://CRAN.R-project.org/package=datazoom.amazonia) with:

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

And the development version from GitHub with:

``` {r, eval=FALSE}
# install.packages("devtools")
devtools::install_github("datazoompuc/datazoom.amazonia")
```

```{r, echo=FALSE, message=FALSE}
devtools::load_all()
```


**[1 - Environmental data](#environmental-data)** 

<table>

<tr><td>

|||
|---|---|
| **[PRODES](#prodes)** | _Yearly deforestation_ |
| **[DETER](#deter)** | _Alerts on forest cover changes_ |
| **[DEGRAD](#degrad)** | _Forest degradation_ |
| **[Imazon](#imazon)** | _Deforestation pressure in the Amazon_ |

</td><td>

|||
|---|---|
| **[IBAMA](#ibama)** | _Environmental fines_ |
| **[MapBiomas](#mapbiomas)** | _Land cover and land use_ |
| **[TerraClimate](#terraclimate)** | _Climate data_ |
| **[SEEG](#seeg)** | _Greenhouse gas emission estimates_ |
| **[CENSOAGRO](#censoagro)** | _Agriculture activities_ |

</td></tr> </table>

**[2 - Social data](#social-data)**

<table>

<tr><td>

|||
|---|---|
| **[IPS](#ips)** | _Amazon Social Progress Index_ |
| **[DATASUS](#datasus)** | _Causes of mortality and availability of hospital beds_ |
| **[IEMA](#iema)** | _Access to electricity in the Amazon region_ |
| **[Population](#population)** | _Population_ |

</td></tr> </table>

**[3 - Economic data](#economic-data)**

<table>

<tr><td>

|||
|---|---|
| **[COMEX](#comex)** | _Brazilian international trade_ |
| **[BACI](#baci)** | _Global international trade_ |
| **[PIB-Munic](#pib-munic)** | _Municipal GDP_ |
| **[CEMPRE](#cempre)** | _Central register of companies_ |
| **[PAM](#pam)** | _Agricultural production_ |

</td><td>

|||
|---|---|
| **[PEVS](#pevs)** | _Forestry and extraction_ |
| **[PPM](#ppm)** | _Livestock farming_ |
| **[SIGMINE](#sigmine)** | _Mining_ |
| **[ANEEL](#aneel)** | _Energy development_ |
| **[EPE](#epe)** | _Energy consumption_ |

</td></tr> </table>

**[4 - Other tools](#other-tools)**

<table>

<tr><td>

|||
|---|---|
| **[Legal Amazon Municipalities](#legal-amazon-municipalities)** | _Dataset with brazilian cities and whether they belong to the Legal Amazon_ |
| **[The 'googledrive' package](#googledrive)** | _Troubleshooting and information for downloads from Google Drive_ |

</table>

# Environmental Data

## PRODES

```{r child = "vignettes/PRODES.Rmd"}
```

## DETER

```{r child = "vignettes/DETER.Rmd"}
```

## DEGRAD

```{r child = "vignettes/DEGRAD.Rmd"}
```

## Imazon

```{r child = "vignettes/IMAZON.Rmd"}
```

&#x1F534; This function uses the `googledrive` package to download data. In case of authentication errors, see [googledrive](#googledrive).

## IBAMA

```{r child = "vignettes/IBAMA.Rmd"}
```

## MapBiomas

```{r child = "vignettes/MAPBIOMAS.Rmd"}
```

## TerraClimate

```{r child = "vignettes/TERRACLIMATE.Rmd"}
```

## SEEG

```{r child = "vignettes/SEEG.Rmd"}
```

&#x1F534; This function uses the `googledrive` package to download data at the municipality level. In case of authentication errors, see [googledrive](#googledrive).

## CENSOAGRO

```{r child = "vignettes/CENSOAGRO.Rmd"}
```

# Social Data

## IPS

```{r child = "vignettes/IPS.Rmd"}
```

## DATASUS

```{r child = "vignettes/DATASUS.Rmd"}
```

## IEMA

```{r child = "vignettes/IEMA.Rmd"}
```

&#x1F534; This function uses the `googledrive` package to download data. In case of authentication errors, see [googledrive](#googledrive).

## Population

```{r child = "vignettes/POPULATION.Rmd"}
```


# Economic Data

## COMEX

```{r child = "vignettes/COMEX.Rmd"}
```

## BACI

```{r child = "vignettes/BACI.Rmd"}
```

## PIB-Munic

```{r child = "vignettes/PIBMUNIC.Rmd"}
```

## CEMPRE

```{r child = "vignettes/CEMPRE.Rmd"}
```

## PAM

```{r child = "vignettes/PAM.Rmd"}
```

## PEVS

```{r child = "vignettes/PEVS.Rmd"}
```

## PPM

```{r child = "vignettes/PPM.Rmd"}
```

## SIGMINE

```{r child = "vignettes/SIGMINE.Rmd"}
```

## ANEEL

```{r child = "vignettes/ANEEL.Rmd"}
```

## EPE

```{r child = "vignettes/EPE.Rmd"}
```

# Other tools

## Legal Amazon Municipalities

```{r child = "vignettes/municipalities.Rmd"}
```

## <a name="googledrive"></a> The 'googledrive' package

```{r child = "vignettes/GOOGLEDRIVE.Rmd"}
```

## Credits

DataZoom is developed by a team at Pontifícia Universidade Católica do Rio de Janeiro (PUC-Rio), Department of Economics. Our official website is at: <https://www.econ.puc-rio.br/datazoom/>.

To cite package `datazoom.amazonia` in publications use:

> Data Zoom (2023). Data Zoom: Simplifying Access To Brazilian Microdata.  
> https://www.econ.puc-rio.br/datazoom/english/index.html

A BibTeX entry for LaTeX users is:

``` 
@Unpublished{DataZoom2023,
	author = {Data Zoom},
	title = {Data Zoom: Simplifying Access To Brazilian Microdata},
	url = {https://www.econ.puc-rio.br/datazoom/english/index.html},
	year = {2023},
}

```