index.Rmd

<img src="https://raw.githubusercontent.com/walmes/EACS/master/vignettes/img/logo.png" width="120px" align="right" display="block" style="padding-top: 2em; -webkit-filter: drop-shadow(0px 0px 3px #111);">

Estatística Aplicada à Ciência do Solo
======================================

[![Build Status](https://travis-ci.org/walmes/EACS.svg?branch=master)](https://travis-ci.org/walmes/EACS)

## Organização

O `EACS` é um pacote não oficial para o
[software R](https://cran.r-project.org/).  O pacote contém conjuntos de
dados documentados e relatórios que exibem a análise dos dados.  Veja na
seção [Uso do Pacote](#uso-do-pacote) como acessar o conteúdo do pacote
e na seção [Instalação](#instalacao) como instalar.

A documentação online do pacote está disponível no endereço:
<http://leg.ufpr.br/~walmes/pacotes/EACS>. O código fonte está público
no GitHub: <https://github.com/walmes/EACS>.

## Instalação

O pacote pode ser instalado diretamente do repositório em que está
hospedado no GitHub (<https://github.com/walmes/EACS>). Para isso é
necessário ter o pacote `devtools`. Com ele, execute o código abaixo em
uma sessão R.

```r
# Carrega o devtools.
library(devtools)

# Instala do GitHub (estável)
install_github(repo =  "walmes/EACS", ref = "master")
```

Caso não consiga instalar o pacote, tente fazer a partir dos aquivos
comprimidos listados abaixo. Se você usa Windows, use o `zip`, se Linux
use o `tar.gz`. O código abaixo mostra como fazer a
instalação. Substitua `x.y-z` pela versão do pacote conforme está no
nome dos arquivos.

```{r, eval = TRUE, echo = FALSE, results = "asis"}
# setwd("./docs")
invisible(file.copy(from = list.files(pattern = "EACS_"),
                    to = "./docs",
                    overwrite = TRUE))
fls <- dir(path = ".",
           pattern = "*.(zip|tar\\.gz)$",
           full.names = TRUE)
if (length(fls) > 0) {
    bn <- basename(path = fls)
    cat(sprintf("  * [`%s`](./%s)", bn, bn), sep = "\n")
}
```

```r
# Instalando a partir do tarball (Linux).
install.packages(pkgs = "EACS_x.y-z.tar.gz",
                 repos = NULL,
                 type = "source")

# Instalando a partir do zip (Windows).
install.packages(pkgs = "EACS_x.y.z.zip",
                 repos = NULL,
                 type = "source")
```

Lembre-se de apontar o diretório de trabalho para o local onde está o
arquivo baixado (use `setwd()`) ou forneça o caminho completo para o
arquivo. Instalar o pacote pelos arquivos comprimidos não instala as
dependências do pacote. Portanto, na hora de usá-lo pode faltar
algo. Para evitar isso, antes de instalar, procure instalar todos os
pacotes que são dependências para o EACS. Eles são listados no arquivo
[DESCRIPTION].

```{r, echo = FALSE, results = "asis"}
# setwd("./docs")
fls <- list.files(path = "./EACS.Rcheck",
                  "EACS-manual.pdf",
                  full.names = TRUE)
if (length(fls)) {
    invisible(file.copy(fls, to = "./docs", overwrite = TRUE))
    txt <- sprintf(paste(
        "## Manual em PDF\n\n",
        "O manual em PDF do pacote está disponível para",
        "baixar: [`%s`](./%s)."),
        basename(fls),
        basename(fls))
    cat(txt, "\n")
}
```

## Tour pelo pacote

O código abaixo permite que fazer um *tour* pelo pacote EACS.

```r
# Carrega o pacote.
library(EACS)

# Lista os objetos do pacote.
ls("package:EACS")

# Abre a documentação do pacote.
help(package = "EACS", help_type = "html")

# Mostra as vinhetas disponíveis.
browseVignettes(package = "EACS")

# Abre alguma vinheta.
vignette(topic = "vignette_name_here", package = "EACS")

# Cita o pacote.
citation("EACS")
```

## Uso dos dados

As análises e dados no pacote `EACS` foram feitos para serem de livre
acesso.  No entanto, todo e qualquer uso dos dados, científico ou não,
que gere publicações tais como, mas não se limitando a, artigos,
trabalhos em congressos, materias de blog e material didático devem ter
o consentimento dos seus proprietários. Entendemos que os dados gerados
pelas pesquisas com financiamentos governamentais devem ser públicos,
mas o pesquisador responsável pela pesquisa tem precedência sobre o uso
dos dados em respeito à sua dedicação.

Deseja-se ao fornecer acesso aos dados 1) gerar exemplos de análise que
possam servir de base para outras pesquisas e 2) estimular pesquisas
inovadoras de metodologia estatística a partir dos dados.

Os dados no pacote `EACS` se tornam públicos antes das publicações que
irão utilizá-los, já que as análises feitas neste pacote são justamente
para gerar os resultados que serão apresentados nas publicações.

<!------------------------------------------- -->
[DESCRIPTION]: https://github.com/walmes/EACS/blob/master/DESCRIPTION
[Walmes Zeviani]: http://leg.ufpr.br/~walmes