> ggrelated.md
Quem é parente de quem? Estime o parentesco (relatedness) sem precisar ler o manual do related dez vezes e com gráficos que não parecem de 1995.
Por que o ggrelated existe?
Em estudos de genética de populações e ecologia reprodutiva, entender o parentesco (kinship) entre indivíduos é fundamental para desvendar sistemas de acasalamento e padrões de dispersão. Softwares como o Colony ou pacotes em R como o related são poderosos e concentrados no hardwork, mas suas saídas gráficas nem sempre estão prontas para publicação.
Esse foi o nosso caso no estudo com a biologia reprodutiva do mandí (Pimelodus maculatus), um belo bagre de água doce, bastante comum nos rios do sul do Brasil. Você pode conferir todos os gráficos da publicação original neste link do ResearchGate.
O ggrelated preenche essa lacuna, permitindo que você transforme dados brutos em gráficos ggplot2 totalmente customizáveis. O padrão das matrizes de saída está alinhado com as melhores práticas de visualização de dados, incluindo paletas colorblind friendly.
Destaques do Projeto
- Integração Direta: Funciona perfeitamente com os outputs do pacote R
related. - Narrativa Científica: Este script foi o motor visual dos resultados apresentados em Frantine-Silva et al. (2022).
- Customização Estética: Controle cores, temas e anotações para combinar com o layout da sua revista científica.
Exemplo de Uso Prático
Imagine que você coletou larvas de peixes em um rio e precisa saber se elas são filhas do mesmo casal ou se possuem apenas um progenitor em comum. Ao utilizar o ggrelated, você transforma as matrizes de relatedness em heatmaps ou histogramas de frequências de parentesco em segundos:
# Instalação simplificada via devtools
devtools::install_github("wilsonfrantine/ggrelated")
# Carregando a biblioteca e gerando o gráfico principal
library(ggrelated)
plot_kinship(data)Fique à vontade para sugerir melhorias ou relatar bugs diretamente no repositório oficial!