Organize
Estruture tratamentos ou áreas nas linhas e biomarcadores nas colunas.
Calcule os índices IBR e IBRv2, padronize seus biomarcadores e transforme resultados multivariados em gráficos-radar claros e reprodutíveis.
Visão geral
O IBRtools recebe dados multibiomarcadores previamente estruturados, padroniza as respostas, calcula os índices integrados e comunica os resultados visualmente.
Estruture tratamentos ou áreas nas linhas e biomarcadores nas colunas.
Padronize as respostas e calcule IBR ou IBRv2 de forma reprodutível.
Compare os perfis integrados em gráficos-radar prontos para explorar.
Instalação
Instale a versão estável pelo CRAN ou acesse a versão de desenvolvimento diretamente pelo GitHub.
# Instalar a versão estável do CRAN
install.packages("IBRtools")
# Carregar o pacote
library(IBRtools)
# Instalar a versão de desenvolvimento
install.packages("remotes")
remotes::install_github("ecologicaltools/IBRtools")
# Carregar o pacote
library(IBRtools)
Documentação básica
Escolha o índice apropriado para seu desenho e siga da padronização ao gráfico-radar.
IBR revisitado
ibr_std(df, z)
Padroniza as respostas. z define os coeficientes; se omitido, o valor padrão é 1.
ibr_index(df)
Calcula o índice total e resume média e desvio-padrão por grupo.
listibr_chart(df, ...)
Gera o gráfico-radar a partir dos valores padronizados.
plotAtenção: esta implementação segue a revisão de Devin et al. (2014). Use de 3 a 9 biomarcadores e pelo menos três valores não ausentes por biomarcador.
Desvio da referência
ibrv2_bdi(df)
Calcula valores padronizados em relação ao tratamento de referência.
data.frameibrv2_index(df)
Obtém o IBRv2 de cada área ou tratamento comparado à referência.
data.frameibrv2_chart(df, ...)
Visualiza cada comparação com a referência em um gráfico-radar.
plotAtenção: use de 3 a 15 biomarcadores. A referência deve ser a primeira linha de cada subconjunto; com mais de uma variável independente, divida os dados antes da análise. Os segmentos e eixos do gráfico podem exigir ajuste manual.
Dados incluídos
enzactIBR · 28 observações
enzact_coefCoeficientes Z
enzact2IBRv2 · 38 observações
Exemplos em R
# Carregar o pacote e os dados de exemplo
library(IBRtools)
data("enzact")
data("enzact_coef")
# Padronizar as respostas dos biomarcadores
enzact_std <- ibr_std(enzact, enzact_coef)
# Calcular o índice IBR
ibr_result <- ibr_index(enzact_std)
ibr_result$IBR_total
# Criar o gráfico-radar
ibr_chart(enzact_std)
# Carregar o pacote e o dataset do IBRv2
library(IBRtools)
data("enzact2")
# Padronizar em relação à referência
ibrv2_std <- ibrv2_bdi(enzact2)
# Calcular os valores do índice
ibrv2_result <- ibrv2_index(enzact2)
# Comparar um tratamento com a referência
comparison <- ibrv2_std[c(1, 2), ]
ibrv2_chart(
comparison,
seg = 8,
caxislabels = seq(-1, 1.9, 0.34),
axistype = 1
)
Ilustração do tipo de gráfico gerado por ibrv2_chart().
Publicação e citação
A publicação descreve os algoritmos de IBR e IBRv2, o funcionamento do pacote e um fluxo completo com dados de exemplo.
Anna Carolina Resende & Diego Mauro Carneiro Pereira
Acessar artigo ↗@article{resende2024ibrtools,
title = {IBRtools: An R package for
calculating integrated biomarker indexes},
author = {Resende, Anna Carolina and
Pereira, Diego Mauro Carneiro},
journal = {Ecology and Evolution},
year = {2024},
volume = {14},
pages = {e10864},
doi = {10.1002/ece3.10864}
}
Comece sua análise