Back to research

charisma: An R package to perform reproducible colour characterization of digital images for biological studies

Shawn T. Schwartz, Whitney L. E. Tsai, Elizabeth A. Karan, Mark S. Juhn, Allison J. Shultz, John E. McCormack, Thomas B. Smith, Michael E. Alfaro

Methods in Ecology and Evolution

April 27, 2026DOIPDFCode

Abstract

Advances in digital imaging and software tools have provided increasingly accessible datasets and methods for analysing colour evolution. Despite the variety of computational packages available, most rely on colour classification before running analyses. Previous methods to characterise colour limit the ability to analyse large-scale image databases and are not always representative of biologically relevant colour classes, which decrease the accuracy of downstream analyses. Here, we present charisma, an R package designed to characterize the distribution of distinct colour classes in images suitable for large-scale studies of biological organisms. We demonstrate the utility of our package through an analysis of colour evolution in a sample of diverse and charismatic birds, tanagers, in the subfamily Thraupinae. We show that charisma can quickly and accurately classify every pixel in an image and validate these results using pre-identified, canonical colour swatches. We find that charisma colour classifications are consistent with those made by colour pattern experts in the field. Applying charisma to tanager colour evolution, we find that charisma outputs seamlessly integrate with downstream evolutionary analyses. Our results demonstrate that using charisma to manually curate and characterize colours in images provides a standardized, reliable and reproducible framework for high-throughput colour classification.

Paper (PDF)

Cite this paper

@article{schwartz2026,
  title = {charisma: An R package to perform reproducible colour characterization of digital images for biological studies},
  author = {Shawn T. Schwartz and Whitney L. E. Tsai and Elizabeth A. Karan and Mark S. Juhn and Allison J. Shultz and John E. McCormack and Thomas B. Smith and Michael E. Alfaro},
  year = {2026},
  journal = {Methods in Ecology and Evolution},
  doi = {10.1111/2041-210x.70310}
}