Ajoute le graphique des personnages représentés

lib/plots/minifig_characters.py

@@ -0,0 +1,42 @@
+"""Graphique du nombre de minifigs par personnage."""
+
+from pathlib import Path
+from typing import List
+
+import matplotlib.pyplot as plt
+
+from lib.filesystem import ensure_parent_dir
+from lib.rebrickable.stats import read_rows
+
+
+def load_counts(path: Path) -> List[dict]:
+    """Charge le CSV des comptes par personnage."""
+    return read_rows(path)
+
+
+def plot_minifigs_per_character(counts_path: Path, destination_path: Path) -> None:
+    """Trace un diagramme en barres horizontales du nombre de minifigs par personnage."""
+    rows = load_counts(counts_path)
+    characters = [row["known_character"] for row in rows]
+    counts = [int(row["minifig_count"]) for row in rows]
+    positions = list(range(len(rows)))
+    height = max(6, len(rows) * 0.22)
+
+    fig, ax = plt.subplots(figsize=(12, height))
+    bars = ax.barh(positions, counts, color="#1f77b4", edgecolor="#0d0d0d", linewidth=0.6)
+    ax.set_yticks(positions)
+    ax.set_yticklabels(characters)
+    ax.invert_yaxis()
+    ax.set_xlabel("Nombre de minifigs distinctes")
+    ax.set_title("Minifigs par personnage (thèmes filtrés)")
+    ax.grid(True, axis="x", linestyle="--", alpha=0.25)
+    max_value = max(counts) if counts else 0
+    ax.set_xlim(0, max_value + 1)
+    for index, bar in enumerate(bars):
+        value = counts[index]
+        ax.text(value + 0.1, bar.get_y() + bar.get_height() / 2, str(value), va="center", fontsize=8)
+
+    ensure_parent_dir(destination_path)
+    fig.tight_layout()
+    fig.savefig(destination_path, dpi=160)
+    plt.close(fig)

lib/rebrickable/minifig_characters.py

@@ -0,0 +1,41 @@
+"""Agrégation des minifigs par personnage représenté."""
+
+from collections import defaultdict
+from pathlib import Path
+from typing import Dict, Iterable, List, Sequence
+
+from lib.rebrickable.stats import read_rows
+from lib.filesystem import ensure_parent_dir
+import csv
+
+
+def load_minifigs_by_set(path: Path) -> List[dict]:
+    """Charge le CSV minifigs_by_set."""
+    return read_rows(path)
+
+
+def aggregate_by_character(rows: Iterable[dict]) -> List[dict]:
+    """Compte les minifigs distinctes par personnage (fig_num unique)."""
+    fig_nums_by_character: Dict[str, set] = defaultdict(set)
+    for row in rows:
+        character = row["known_character"].strip()
+        fig_num = row["fig_num"].strip()
+        if character == "" or fig_num == "":
+            continue
+        fig_nums_by_character[character].add(fig_num)
+    aggregates: List[dict] = []
+    for character, fig_nums in fig_nums_by_character.items():
+        aggregates.append({"known_character": character, "minifig_count": len(fig_nums)})
+    aggregates.sort(key=lambda r: (-r["minifig_count"], r["known_character"]))
+    return aggregates
+
+
+def write_character_counts(path: Path, rows: Sequence[dict]) -> None:
+    """Écrit le CSV des comptes par personnage."""
+    ensure_parent_dir(path)
+    fieldnames = ["known_character", "minifig_count"]
+    with path.open("w", newline="") as csv_file:
+        writer = csv.DictWriter(csv_file, fieldnames=fieldnames)
+        writer.writeheader()
+        for row in rows:
+            writer.writerow(row)