Instalação
O pacote febr para R foi criado para facilitar o acesso aos conjuntos de dados publicados no Repositório Brasileiro Livre para Dados Abertos do Solo, também conhecido como FEBR (/ˈfɛ.bɾe/). Ele pode ser descarregado do CRAN da seguinte maneira:
install.packages(pkgs = "febr")Já a versão de desenvolvimento, disponível no GitHub, pode ser instalada—usando o pacote remotes—da seguinte maneira:
if (!require(remotes)) {
install.packages(pkgs = "remotes")
}
remotes::install_github("samuel-rosa/febr-package")Utilização básica
A principal função de descarregamento de dados do pacote febr chama-se readFEBR. Ela aceita dois argumentos: data.set, o código de identificação do conjunto de dados no FEBR, e data.table, o nome de uma ou mais tabelas de dados contidas no conjunto de dados escolhido—as opções são "identificacao", "versionamento", "metadado", "observacao", and "camada". Veja alguns exemplos a seguir:
# Descarregar todas as tabelas de dados do conjunto de dados ctb0003
dados <- readFEBR(data.set = "ctb0003")
# Descarregar todas as tabelas de dados dos conjuntos de dados ctb0001, ctb0002 e ctb0003
dados <- readFEBR(data.set = c("ctb0001", "ctb0002", "ctb0003"))
# Descarregar apenas a tabela de dados de identificação dos conjuntos de dados ctb0001, ctb0002 e ctb0003
dados <- readFEBR(data.set = c("ctb0001", "ctb0002", "ctb0003"), data.table = "identificacao")O objeto retornado é uma lista de conjuntos de dados, os quais são listas com suas próprias tabelas de dados. Para processar esses dados, você pode usar funções como lapply.
Quero colaborar
Nós usamos o modelo de desenvolvimento colaborativo fork & pull. Isso significa que você tem liberdade para fazer um cópia paralela – fork – do código fonte e fazer as alterações que julgar necessárias. Isso tudo sem que seja necessário pedir qualquer autorização para a gente. Caso as alterações que você realizou na sua cópia pessoal do código fonte sejam interessantes e você tenha interesse em compartilhar as mesmas conosco, então basta solicitar que sejam puxadas – pull request – para o código fonte original. Depois de uma revisão das alterações, nós decidiremos se elas podem ser fundidas – merge – com o código fonte original.
