Ajoute les visualisations des couleurs de têtes de minifigs et jalons

README.md

@@ -123,6 +123,7 @@ En parallèle, le script `python -m scripts.plot_parts_per_set` génère `figure
 2. `python -m scripts.download_parts_data`
 
 Le script télécharge les fichiers compressés `inventories.csv.gz`, `inventory_parts.csv.gz`, `inventory_minifigs.csv.gz`, `minifigs.csv.gz`, `parts.csv.gz` et `colors.csv.gz` vers `data/raw/`, les décompresse immédiatement en supprimant chaque archive `.gz`, et ne retélécharge pas les fichiers âgés de moins de 7 jours (cache fondé sur les CSV décompressés). Ces données complètent les sets en décrivant leurs inventaires, les pièces individuelles, les minifigs associées et les couleurs disponibles.
+Le fichier des catégories de pièces (`part_categories.csv.gz`) est également téléchargé afin d'affiner au besoin la sélection de catégories liées aux têtes de minifigs.
 
 ### Étape 9 : assembler l'inventaire des pièces par set
 
@@ -185,3 +186,17 @@ Le script lit `data/intermediate/colors_by_set.csv` et produit deux agrégats :
 
 Le script lit les agrégats de l'étape 14 et produit `figures/step15/colors_translucent_share.png` (part des pièces translucides par année et nombre de couleurs distinctes), `figures/step15/colors_heatmap_linear.png` (heatmap année × couleur en quantités brutes) et `figures/step15/colors_heatmap_log.png` (heatmap avec échelle log1p).
 Une troisième variante normalise les quantités par année : `figures/step15/colors_heatmap_share.png`. Dans cette vue, chaque colonne (année) est ramenée à une part relative (0–1) du total de pièces de l'année. Cela met en évidence la structure de palette indépendamment du volume : deux années restent comparables même si leur nombre total de pièces diffère fortement, mais l'information de volume absolu n'apparaît plus (à privilégier pour les comparaisons de proportions, pas pour mesurer la rareté volumique).
+
+### Étape 16 : couleurs de peau des minifigs
+
+1. `source .venv/bin/activate`
+2. `python -m scripts.compute_minifig_heads`
+
+Le script identifie les têtes de minifigs via la catégorie Rebrickable dédiée (part_cat_id 59 dans `data/raw/parts.csv`), filtre les pièces de rechange, puis agrège leurs couleurs depuis `data/intermediate/parts_filtered.csv`. Les sorties sont `data/intermediate/minifig_heads_by_set.csv` (quantités de têtes par set, couleur et année) et `data/intermediate/minifig_heads_by_year.csv` (agrégées par année). Ces fichiers serviront de base pour analyser l'évolution des teintes de peau (ou assimilées) des minifigs.
+
+### Étape 17 : visualiser les couleurs de peau des minifigs
+
+1. `source .venv/bin/activate`
+2. `python -m scripts.plot_minifig_heads`
+
+Le script lit `data/intermediate/minifig_heads_by_year.csv` et produit `figures/step16/minifig_heads_shares.png` (répartition annuelle des couleurs de têtes, en parts empilées) et `figures/step16/minifig_heads_global.png` (donut global des parts cumulées). Les couleurs sont limitées aux plus fréquentes (avec regroupement des autres).