Back

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

Schwartz, S. T.; Tsai, W. L. E.; Karan, E. A.; Juhn, M. S.; Shultz, A. J.; McCormack, J. E.; Smith, T. B.; Alfaro, M. E.

2025-11-27 evolutionary biology
10.1101/2025.11.25.690362 bioRxiv
Show abstract

O_LIAdvances in digital imaging and software tools have provided increasingly accessible datasets and methods for analyzing color evolution. Despite the variety of computational packages available, most rely on color classification before running analyses. Previous methods to characterize color limit the ability to analyze large-scale image databases and are not always representative of biologically relevant color classes, which decrease the accuracy of downstream analyses. C_LIO_LIHere, we present charisma, an R package designed to characterize the distribution of distinct color classes in images suitable for large-scale studies of biological organisms. Here, we demonstrate the utility of our package through an analysis of color evolution in a sample of diverse and charismatic birds, tanagers, in the subfamily Thraupinae. C_LIO_LIWe show that charisma can quickly and accurately classify every pixel in an image and validate these results using pre-identified, canonical color swatches. We find that charisma color classifications are consistent with those made by color-pattern experts in the field. Applying charisma to tanager color evolution, we find that charisma outputs seamlessly integrate with downstream evolutionary analyses. C_LIO_LIOur results demonstrate that using charisma to manually curate and characterize colors in images provides a standardized, reliable, and reproducible framework for high-throughput color classification. C_LI Anonymized Data/Code for Peer ReviewO_LIAnalytic data/code for this manuscript can be found on the following Open Science Frame-work repo: https://osf.io/cqg59/overview?view_only=29c9786a338e48618fabbab2883937cc C_LIO_LIcharisma package GitHub repo: https://anonymous.4open.science/r/charisma-C87E/ C_LI

Published in Methods in Ecology and Evolution (predicted rank #1) · training set

Matching journals

The top 7 journals account for 50% of the predicted probability mass.

50% of probability mass above

"Similar papers" are the closest papers from that journal in the model's embedding space. They show what the match is built on, but the ranking comes mostly from a classifier over the whole training set, not from these examples alone.