Este repositório contém o código-fonte do livro Introdução à acessibilidade urbana: um guia prático em R, escrito por Rafael H. M. Pereira e Daniel Herszenhut. Caso use o material deste livro, pedimos por gentileza que cite-o utilizando a seguinte referência:
Pereira, Rafael H. M. & Herszenhut, Daniel. (2023) Introdução à acessibilidade urbana: um guia prático em R. Instituto de Pesquisa Econômica Aplicada (Ipea).
Nota: Este livro está em constante processo de modificação, o que signfica que seu conteúdo pode ser alterado ao longo do tempo. No entanto, esse conteúdo tem estado estável desde o começo de 2023, com apenas algumas pequenas correções e revisões gramaticais.
A forma mais fácil de baixar o código-fonte do livro é utilizando o software git. Depois de instalá-lo, o código pode ser baixado com o seguinte comando:
git clone https://github.com/ipeaGIT/intro_access_book.gitAlternativamente, o código pode ser baixado manualmente no link a seguir: https://github.com/ipeaGIT/intro_access_book/archive/refs/heads/main.zip. Caso este método seja utilizado, é necessário também extrair o conteúdo do arquivo ZIP baixado para uma nova pasta.
Este livro foi escrito com o sistema de publicação Quarto. A renderização de arquivos .qmd em HTML/PDF/etc requer que o programa Quarto esteja instalado. Confira as instruções de instalação desse programa neste link.
Buscando facilitar a reprodução do livro localmente, este projeto utiliza o pacote de R {renv}. Esse pacote faz a gestão de dependências do livro, garantindo que os mesmos pacotes utilizados em seu desenvolvimento sejam utilizados na cópia a ser reproduzida em seu computador.
Para baixar as dependências, primeiro abra o projeto do livro. Usuários do RStudio devem abrir o arquivo intro_access_book.Rproj, localizado dentro da pasta criada ao baixar o código-fonte. Usuários de outros editores de texto (neovim, VS Code, etc) devem iniciar a sessão do R dentro dessa pasta. Você irá se deparar com mensagens similiares às seguintes:
# Bootstrapping renv 0.16.0 --------------------------------------------------
* Downloading renv 0.16.0 ... OK (downloaded binary)
* Installing renv 0.16.0 ... Done!
* Successfully installed and loaded renv 0.16.0.
* Project '~/repos/intro_access_book' loaded. [renv 0.16.0]
* The project library is out of sync with the lockfile.
* Use `renv::restore()` to install packages recorded in the lockfile.Após isso, rode o seguinte comando para instalar as dependências usadas no livro:
renv::restore()Nesse momento, uma série de pacotes serão listados e o {renv} pedirá para confirmar se você deseja instalá-los. Após essa confirmação, os pacotes serão instalados.
Nota: Esse processo pode tomar um longo tempo. A instalação de todos os pacotes, caso você nunca tenha usado o {renv} antes, pode levar de 5 a 30 minutos, dependendo das configurações da sua máquina.
Nota 2: Este livro depende do pacote {sf}. Caso você esteja tentando reproduzir o livro em uma distribuição do Linux, a instalação desse pacote requer algumas dependências a nível de sistema. Por favor veja as instruções de instalação do {sf} para mais detalhes sobre como proceder nesse caso. As dependências de sistema devem ser instaladas antes de rodar o comando renv::restore().
Depois de instaladas as dependências do livro, seu código-fonte poderá ser executado normalmente. Os capítulos do livro estão ordenados numericamente em arquivos no formato .qmd. Para rodar o livro todo de uma vez, utilize um dos seguintes comandos:
quarto::quarto_preview()
quarto::quarto_render()Nota: A renderização do livro pode tomar algum tempo. Em nossa experiência, o processo como um todo pode levar de 5 a 15 minutos, dependendo das especificações do seu computador.
Nota 2: A renderização do livro, em particular do Capítulo 6, requer cerca de 4 GB de memória RAM. Certifique-se de que o seu computador consiga cumprir com esse requisito, caso contrário os comandos provavelmente retornarão uma mensagem de erro e o seu computador ficará muito lento.
O primeiro comando (quarto::quarto_preview()) renderiza os capítulo e abre o livro gerado localmente em uma aba do seu navegador. O segundo apenas renderiza os capítulos. Ao final de sua execução, os arquivos renderizados ficam salvos na pasta _book, criada pelos comandos.
Um binder é uma ferramenta que permite rodar códigos na nuvem através de um navegador. O código do livro pode ser rodado usando um servidor publicado pelo mybinder. Para isso, clique no ícone abaixo: após alguns instantes, uma sessão do RStudio Cloud começará a rodar no seu navegador. Esta sessão inclui todos os arquivos e dados necessários para rodar o código do livro.
Por favor, note que sessões do mybinder estão limitadas a 2 GB de memória RAM. Esta restrição pode impedir que capítulos de processamento um pouco mais pesado, em particular o Capítulo 6, sejam executados adequadamente. Em caso de uso do binder, sugerimos que não tente renderizar o livro todo com o Quarto, como mostrado acima.
Este livro foi elaborado pelo Instituto de Pesquisa Econômica Aplicada (Ipea) no âmbito da parceria entre Ipea e a Secretaria de Mobilidade e Desenvolvimento Regional e Urbano (SMDRU) do Ministério do Desenvolvimento Regional (MDR). Os autores agradecem aos comentários e sugestões de Lucas Mation.