Trie le graphique de réutilisation des têtes par usage décroissant

README.md

@@ -298,3 +298,70 @@ Le calcul lit `data/intermediate/colors_by_set.csv` et `data/intermediate/sets_e
 - `data/intermediate/color_richness_by_year.csv` : agrégat annuel (moyenne, médiane, bornes de diversité et concentration).
 
 Les graphiques `figures/step28/color_richness_boxplot.png`, `figures/step28/color_richness_top_sets.png` et `figures/step28/color_concentration_scatter.png` montrent respectivement la répartition annuelle, le top des sets les plus colorés et la concentration des palettes (part des 3 couleurs dominantes vs nombre de couleurs).
+
+### Étape 29 : répartition par catégories de pièces (structure vs esthétique)
+
+1. `source .venv/bin/activate`
+2. `python -m scripts.compute_part_categories`
+3. `python -m scripts.plot_part_categories`
+
+Le calcul lit `data/intermediate/parts_filtered.csv`, `data/raw/parts.csv`, `data/raw/part_categories.csv` et `data/intermediate/sets_enriched.csv` pour mesurer la part de chaque catégorie de pièce (rechanges exclues), marquer celles considérées comme structurelles/technic (liste `IGNORED_PART_CATEGORY_IDS` de `lib/rebrickable/color_ignores.py`), et produire :
+
+- `data/intermediate/part_categories_by_set.csv` : parts par set et par catégorie, avec possession et indicateur structurel.
+- `data/intermediate/part_categories_by_year.csv` : parts annuelles par catégorie.
+- `data/intermediate/part_categories_global.csv` : parts globales par catégorie.
+
+Les visuels `figures/step29/top_part_categories_area.png`, `figures/step29/part_categories_heatmap.png` et `figures/step29/structural_share_timeline.png` montrent respectivement l’évolution des principales catégories (aire empilée), une heatmap exhaustive catégorie × année, et la trajectoire de la part des pièces structurelles.
+
+### Étape 30 : visages multiples sur les têtes de minifigs
+
+1. `source .venv/bin/activate`
+2. `python -m scripts.compute_minifig_head_faces`
+3. `python -m scripts.plot_minifig_head_faces`
+
+Le calcul lit `data/intermediate/minifigs_by_set.csv`, `data/raw/parts.csv` et `data/intermediate/sets_enriched.csv` pour annoter les têtes de minifigs contenant plusieurs visages (détection par mots-clés dans le nom de pièce). Il produit :
+
+- `data/intermediate/minifig_head_faces.csv` : têtes annotées (set, personnage, genre, indicateur dual-face).
+- `data/intermediate/minifig_head_faces_by_year.csv` : volume et part des dual-face par année.
+- `data/intermediate/minifig_head_faces_by_set.csv` : volume et part par set (possession incluse).
+- `data/intermediate/minifig_head_faces_by_character.csv` : volume et part par personnage.
+
+Les visuels `figures/step30/minifig_head_faces_timeline.png`, `figures/step30/minifig_head_faces_top_sets.png` et `figures/step30/minifig_head_faces_characters.png` montrent respectivement la trajectoire annuelle, le top des sets concernés et les personnages dotés de têtes dual-face.
+
+### Étape 31 : téléchargement des ressources visuelles (sets, minifigs, têtes)
+
+1. Renseigner `REBRICKABLE_TOKEN` dans `.env` (clé API Rebrickable).
+2. `source .venv/bin/activate`
+3. `python -m scripts.download_resources`
+
+Le script lit `data/intermediate/sets_enriched.csv`, `data/intermediate/minifigs_by_set.csv` et `data/raw/minifigs.csv`. Il récupère les URLs d'images de têtes via l’API Rebrickable `/api/v3/lego/parts/{part_num}/`, ajoute la colonne `part_img_url` à `data/intermediate/minifigs_by_set.csv`, puis télécharge :
+
+- `figures/rebrickable/{set_id}/set.jpg` : visuel du set (img_url).
+- `figures/rebrickable/{set_id}/{known_character}/minifig.jpg` : visuel de la minifig complète.
+- `figures/rebrickable/{set_id}/{known_character}/head.jpg` : visuel de la tête correspondante.
+
+Les requêtes API sont dédoublonnées, espacées (fair-use) et mises en cache dans `data/intermediate/part_img_cache.csv` pour reprise en cas d’interruption. Les images déjà téléchargées sont réutilisées localement pour éviter les requêtes répétées.
+
+### Étape 32 : frises chronologiques des minifigs par personnage
+
+1. `source .venv/bin/activate`
+2. `python -m scripts.plot_minifig_character_collages`
+3. `python -m scripts.plot_minifig_head_collages`
+
+Le script lit `data/intermediate/minifigs_by_set.csv`, `data/intermediate/sets_enriched.csv` et les ressources téléchargées dans `figures/rebrickable`. Il regroupe chaque personnage connu (hors figurants) avec les sets associés et leur année de commercialisation, pour produire :
+
+- `data/intermediate/minifig_character_sets.csv` : apparitions des personnages avec set, identifiant de set, année, possession et fig_num.
+- `figures/step32/minifig_characters/{personnage}.png` : frise horizontale par personnage, composée des visuels de minifigs dans l’ordre chronologique, annotés avec l’année, le numéro de set (avec `*` si possédé) et l’identifiant de minifig. Les minifigs dont l’image n’est pas disponible sont remplacées par un rectangle neutre pour matérialiser le manque.
+- `figures/step32/minifig_heads/{personnage}.png` : même principe mais en utilisant les visuels de têtes (`head.jpg`) pour chaque apparition, annotés avec l’année, le set (avec `*` si possédé) et le `part_num` de la tête.
+
+### Étape 33 : réutilisation des têtes de minifigs dans le catalogue
+
+1. `source .venv/bin/activate`
+2. `python -m scripts.compute_head_reuse`
+3. `python -m scripts.plot_head_reuse`
+
+Le calcul lit `data/intermediate/minifigs_by_set.csv`, `data/raw/parts.csv`, `data/raw/inventories.csv` et `data/raw/inventory_parts.csv` pour recenser les têtes présentes dans les sets filtrés, puis compter combien de sets du catalogue les contiennent (rechanges exclues). Il produit :
+
+- `data/intermediate/head_reuse.csv` : pour chaque tête observée dans les sets filtrés, le nombre de sets filtrés qui la contiennent, le nombre de sets du reste du catalogue et le total.
+- `figures/step33/head_reuse.png` : bar chart horizontal montrant, par tête, la part filtrée vs le reste du catalogue (têtes exclusives en haut).
+- Les étiquettes affichent aussi l’identifiant de la minifig (`fig-*`) et un astérisque à côté du set (`set_num*`) lorsqu’il est présent dans la collection.

config/known_character_aliases.csv

@@ -29,4 +29,5 @@ Guard with Scarf,Figurant
 Park Worker,Figurant
 Park Guest in Dark Pink Vest Jacket,Figurant
 Wildlife Guard,Figurant
-Kid,Figurant
+Kid,Figurant
+Franklin Web,Franklin Webb