Introdução
Documentos interativos com tecnologia Quarto Live podem baixar e usar pacotes R e Python adicionais em tempo de execução. Existem duas abordagens principais:
- Instalando pacotes enquanto o documento é carregado: Os pacotes são instalados automaticamente quando o documento é iniciado.
- Instalando pacotes interativamente: Os pacotes são instalados a partir de blocos de código interativos.
Instalando pacotes à medida que o documento é carregado
Para instalar pacotes durante a inicialização do mecanismo WebAssembly, adicione uma chave packages sob o cabeçalho YAML específico do seu mecanismo.
Adicione os pacotes R desejados sob a chave webr. Por exemplo:
example-r.qmd
---
format: live-html
webr:
packages:
- dplyr
- palmerpenguins
- ggplot2
---Especifique seus pacotes Python sob a chave pyodide. Por exemplo:
example-py.qmd
---
format: live-html
pyodide:
packages:
- matplotlib
- numpy
- seaborn
---Repositórios personalizados
Se seus pacotes não estiverem disponíveis nos repositórios padrão, você pode usar repositórios personalizados.
Pacotes R personalizados podem ser compilados para WebAssembly (por exemplo, usando rwasm). Depois de hospedado em um repositório semelhante ao CRAN (como R-universe), inclua a URL do repositório no cabeçalho YAML:
example-r.qmd
---
format: live-html
webr:
packages:
- cli
repos:
- https://r-lib.r-universe.dev
---Para pacotes Python, se um pacote não for encontrado no repositório Pyodide, ele poderá ser carregado do PyPI usando micropip se o pacote for um wheel Python puro ou uma compilação wasm32/emscripten. Você também pode instalar wheels diretamente de uma URL:
example-py.qmd
---
format: live-html
pyodide:
packages:
- https://username.github.io/mypackage/mypackage-0.0-1-py3-none-any.whl
---Instalando pacotes interativamente
Você também pode instalar pacotes interativamente dentro dos seus blocos de código.
Use a função R padrão install.packages() para instalar pacotes interativamente a partir do repositório de pacotes públicos webR. Por exemplo:
O Pyodide vem com o pacote micropip, que pode ser usado para instalar pacotes Python compatíveis com WebAssembly fornecidos pela equipe Pyodide usando a função micropip.install().
Em Python, a função micropip.install() é assíncrona, portanto, certifique-se de aguardar sua execução antes de usar o pacote.
Conclusão
Este guia explica os dois métodos para carregar e usar pacotes em documentos Quarto interativos. Se você deseja que os pacotes sejam instalados automaticamente na inicialização ou sob demanda durante sessões interativas, essas técnicas permitem estender os recursos dos seus blocos de código R e Python interativos.
Para obter mais informações, consulte os tutoriais relacionados sobre blocos de código interativos e execução híbrida.
Leitura adicional
Blocos de código interativo explicados
Saiba como os blocos de código interativos são criados e personalizados no Quarto Live.Plotting and Graphics
Explore como criar visualizações dinâmicas usando pacotes como ggplot2 em R e matplotlib em Python.Gerenciando ambientes de execução
Entenda como controlar o compartilhamento de variáveis e isolar exercícios interativos em seus documentos.Referência de opções de célula
Para obter uma lista completa de todas as opções de células disponíveis e configurações avançadas no Quarto Live.
Explore mais artigos
Aqui estão mais artigos da mesma categoria para ajudá-lo a se aprofundar no tópico.
Reuso
Citação
@online{kassambara2025,
author = {Kassambara, Alboukadel},
title = {Carregando e usando pacotes},
date = {2025-03-07},
url = {https://www.datanovia.com/pt/learn/interactive/getting-started/packages.html},
langid = {pt}
}