Recalculate percentile benchmarks after adding artworks

Recalculates percentile-based benchmark scores for all of an artist's artworks. Benchmarks compare each artwork against the artist's portfolio, enabling "this is in your top 10% for time investment" insights.

Call this after adding artworks to update all percentiles. The operation deletes existing benchmarks and recalculates from scratch in a transaction.

Usage

update_artist_benchmarks(artist, cn = NULL)

Arguments

artist

Character. Artist UUID (format: "746bxxxx-xxxx-xxxx-xxxxxxxxxxxx"). Validated with artcore::validate_uuid() where applicable.

cn

Database connection. If NULL, creates a connection via artcore::dbc() and closes it on exit. Pass an existing connection to batch multiple queries efficiently.

Value

TRUE invisibly on success. Errors on failure (transaction rolled back).

Benchmark Categories

time_effort

Drawing hours, brush strokes, pace metrics

skill_artistry

Color usage, blending, spectrum coverage

complex_detail

Stroke density, color variance, technique phases

See also

Other data-modify: add_artist(), add_artwork(), add_collection(), delete_collection(), update_artist_stats()