Skip to contents

Changelog

Source: NEWS.md

charisma 1.0.0

CRAN release: 2025-12-08

Initial CRAN Release

First public release of charisma - an R package for reproducible color characterization of digital images for biological studies (and other things).

Features

  • Automatic Color Classification: Classify image colors into one of 10 discrete, biologically-inspired categories (black, blue, brown, green, grey, orange, purple, red, white, yellow)

  • CLUT System: Color Look-Up Table (CLUT) with scientifically-defined HSV boundaries for each color category, validated across 3.6+ million color coordinates

  • Main Functions:

    • charisma(): Main color classification pipeline with automatic thresholding
    • charisma2(): Rewind and edit saved charisma objects without re-running full pipeline
    • color2label(): Convert individual RGB/HSV colors to discrete labels
    • validate(): Validate CLUT completeness across color space

  • Integration:

    • Leverages recolorize for image preprocessing and color segmentation
    • Optional pavo integration for color pattern geometry analysis
    • Supports both interactive and automated workflows

  • Reproducibility:

    • Complete state tracking with merge/replacement history
    • Save and reload analyses with full provenance
    • Deterministic color classification for cross-study comparisons

  • Visualization:

    • Plot methods for charisma objects
    • Mosaic plots showing color proportions
    • Color masks and classification overlays

Documentation

  • Comprehensive vignette with step-by-step tutorial
  • Example data from bird (Tangara fastuosa)
  • Tips for museum specimens and automated workflows
  • pkgdown website with full documentation

Testing

  • Unit tests covering main functions
  • Example workflows validated against published results
  • CLUT validation across full HSV color space