Figure de Recherche : Générateur de Pipeline TikZ et de Rendu 3D Blender
Générez des figures de qualité publication grâce à une conversation structurée : comprenez le besoin de visualisation, confirmez la structure, générez le code (TikZ ou Blender Python), effectuez le rendu et itérez.
Prérequis
- Chemin TikZ : pdflatex avec les paquets TikZ (installez via
brew install --cask mactex-no-guisur macOS) - Chemin Blender : Blender 3.x+ (définissez la variable d'environnement
BLENDER_PATH, ou installez dans/Applications/sur macOS, ou ajoutez au PATH)
Phase 0 : Orientation
Décidez s'il s'agit d'une figure TikZ ou Blender en fonction de la demande de l'utilisateur.
Choisissez TikZ lorsque l'utilisateur souhaite :
- Pipeline méthodologique / organigramme / diagramme d'architecture
- Figures 2D avec boîtes et flèches
- Toute figure composée principalement de texte, boîtes et flèches
Choisissez Blender lorsque l'utilisateur souhaite :
- Maillage 3D rendu (SMPL, FBX, OBJ)
- Figure d'accroche avec plusieurs personnages 3D
- Comparaison de méthodes côte à côte avec maillages 3D
- Visualisation de squelette (points clés 3D + membres)
- Visualisation de boîte englobante autour d'objets 3D
- Toute figure nécessitant un rendu 3D
Choisissez Hybride (TikZ + Blender) lorsque :
- Un diagramme de pipeline contient des modules qui nécessitent des illustrations rendues en 3D
- Par exemple, un module « Estimation de pose 3D » doit contenir une image de maillage rendu
En cas d'ambiguïté, demandez à l'utilisateur.
Chemin TikZ
Principes de conception
Ces principes sont issus des meilleures pratiques en matière de conception de figures académiques :
- Disposition par cartes : Chaque module est enfermé dans un rectangle arrondi (carte). Les cartes sont reliées par des flèches. Cela rend la structure du pipeline immédiatement claire.
- Couleurs faiblement saturées : Utilisez des couleurs pastel et douces. N'utilisez jamais de couleurs vives/saturées. La figure doit être professionnelle, pas comme un PowerPoint.
- Disposition compacte : Minimisez les espaces blancs. Alignez les éléments horizontalement et verticalement. La figure doit être serrée et dense, pas dispersée.
- Polices sans empattement : Utilisez
\sffamilypartout pour un aspect moderne et épuré. - Mettez en évidence les contributions : Les modules de contribution novatrice de l'utilisateur doivent être visuellement distincts (bordure plus épaisse, couleur de fond différente) des modules standard.
- Éléments de visualisation 2D : Remplacez le texte brut par des éléments visuels stylisés lorsque c'est possible (cartes de caractéristiques sous forme de rectangles empilés, blocs de réseau sous forme de boîtes étiquetées, etc.). Gardez ces éléments simples et en 2D — aucun rendu 3D n'est nécessaire.
Phase TikZ 1 : Comprendre la méthode
Lorsque l'utilisateur fournit une description (résumé, résumé de la méthode, ou même une idée vague) :
- Lisez attentivement la description et extrayez la structure du pipeline sous forme de chaîne :
Entrée → Module1 → Intermédiaire1 → Module2 → ... → Sortie - Pour chaque module, identifiez :
- Nom : un nom court et descriptif
- Type : traitement de données, réseau neuronal, optimisation, inférence, perte, etc.
- Est-ce nouveau ? : si cela fait partie de la contribution de l'utilisateur
- Éléments internes : ce qui se passe à l'intérieur (convolution, attention, MLP, etc.)
- Identifiez le modèle de flux global :
- Linéaire (le plus courant)
- Boucle/itératif
- Multi-branches (traitement parallèle)
- Deux étapes (entraînement + inférence, ou deux sous-problèmes)
Phase TikZ 2 : Confirmer avec l'utilisateur (1-2 tours)
Présentez la structure extraite à l'utilisateur dans un format clair et structuré en utilisant AskUserQuestion ou une conversation directe. Restez bref — l'objectif est de confirmer, pas de concevoir à partir de zéro.
Tour 1 (obligatoire) : Affichez la structure du pipeline et demandez :
- La décomposition en modules est-elle correcte ?
- Quels sont les modules clés des contributions ?
- Préférence de disposition : horizontale (par défaut), verticale, boucle, deux étapes ou multi-branches ?
- Préférence de jeu de couleurs ? (Si non spécifié, par défaut Bleu-Gris)
Formatez le pipeline clairement, par exemple :
Pipeline extrait :
Entrée image → Encodeur de caractéristiques → [VOTRE MÉTHODE : Module de fusion adaptatif] → Décodeur → Maillage de sortie
Disposition : Linéaire horizontale (de gauche à droite)
Mise en évidence : « Module de fusion adaptatif » (contribution novatrice)
Jeu de couleurs : Bleu-Gris (par défaut)
Tour 2 (uniquement si nécessaire) : Si le pipeline est complexe ou si l'utilisateur a des demandes spéciales concernant les détails internes du module, demandez :
- Éléments de visualisation spécifiques à l'intérieur des modules
- Annotations ou étiquettes spéciales
- Fonctions de perte ou signaux d'entraînement à afficher
Si la méthode est simple, sautez le tour 2 et passez directement à la génération.
Phase TikZ 3 : Générer le code TikZ
Lisez les fichiers de référence pour assembler la figure :
-
Lisez
references/layout_templates.md— choisissez le modèle correspondant au type de disposition (horizontale linéaire, verticale, boucle, deux modules, multi-branches). Utilisez le modèle comme squelette structurel. -
Lisez
references/color_schemes.md— choisissez le jeu de couleurs choisi par l'utilisateur (ou Bleu-Gris par défaut). Copiez le bloc\definecolordans le préambule. -
Lisez
references/tikz_elements.md— sélectionnez les styles d'éléments nécessaires :- Styles de boîte de module (standard, nouveau, optionnel, io, groupe, perte)
- Styles de flèche (standard, étiquetée, orthogonale, pointillée, bidirectionnelle)
- Éléments 2D (cartes de caractéristiques, blocs de réseau, grilles, espaces réservés d'image)
- Annotations (accolades, légendes, étiquettes de dimension)
-
Composez le fichier
.texfinal en suivant ces règles :- Utilisez
\documentclass[border=5pt]{standalone}pour une sortie recadrée - Incluez tous les paquets et bibliothèques TikZ nécessaires
- Définissez toutes les couleurs dans le préambule
- Définissez tous les styles avec
\tikzsetdans le préambule - Placez les nœuds à l'aide de la bibliothèque
positioning(par exemple,right=1.0cm of nodeA) - Maintenez un espacement cohérent : généralement 0,8 à 1,2 cm entre les nœuds
- Assurez-vous que tout le texte tient dans sa boîte (utilisez
\\pour les sauts de ligne si nécessaire) - Utilisez
\textbfpour les titres de module,\footnotesize\color{textLight}pour les sous-titres - Ajoutez des étiquettes de flèche pour les flux de données importants (caractéristiques, codes latents, etc.)
- Utilisez le mode mathématique pour les symboles :
$\mathbf{z}$,$\mathcal{L}$, etc.
- Utilisez
-
Écrivez le fichier
.texdans le répertoire de travail (par exemple,figure.texou un nom spécifié par l'utilisateur).
Phase TikZ 4 : Compiler et auto-vérification
-
Compilez à l'aide du script fourni :
bash .claude/skills/research-figure/scripts/compile_tikz.sh <chemin-vers-fichier-tex> -
Si la compilation échoue : lisez la sortie d'erreur, corrigez le code LaTeX et réessayez. Problèmes courants :
- Paquets manquants → ajoutez
\usepackage{...} - Couleur non définie → vérifiez les définitions
\definecolor - Erreurs de positionnement de nœud → vérifiez les noms de nœud et les références
of - Erreurs de mode mathématique → vérifiez la correspondance
$...$
- Paquets manquants → ajoutez
-
Visualisez le résultat : Utilisez l'outil Read pour voir l'image PNG générée.
-
Auto-vérifiez la figure à l'aide de cette liste de contrôle :
- Tout le texte est lisible (pas de chevauchement)
- Les flèches pointent dans la bonne direction
- L'alignement horizontal et vertical est propre
- La disposition est compacte (pas de grandes zones vides)
- Le jeu de couleurs est cohérent et harmonieux
- Les modules de contribution novatrice sont visuellement mis en évidence
- Les noms de module correspondent à ce qui a été convenu avec l'utilisateur
- La police est sans empattement partout
-
Si des problèmes sont trouvés : corrigez le code TikZ et recompilez. Ne montrez PAS une figure cassée à l'utilisateur.
Phase TikZ 5 : Présenter et itérer
- Montrez la figure compilée à l'utilisateur (l'image PNG).
- Expliquez brièvement la structure.
- Demandez si des modifications sont nécessaires.
- En fonction des commentaires, modifiez le code TikZ, recompilez et montrez à nouveau.
- Répétez jusqu'à ce que l'utilisateur soit satisfait.
- Fournissez le chemin du fichier
.texfinal afin que l'utilisateur puisse :- L'inclure directement dans son article avec
\input{} - Ou le compiler indépendamment et l'inclure via
\includegraphics{}
- L'inclure directement dans son article avec
Chemin Blender
Phase Blender 1 : Comprendre la visualisation
Identifiez le cas d'utilisation :
| Cas d'utilisation | Description | Modèle |
|---|---|---|
| Accroche | N personnages le long de l'axe X, matériaux dégradés, sol + brouillard + trajectoire | templates/blender/template_teaser.py |
| Module de pipeline | Maillage unique avec fond transparent, pour inclusion dans TikZ | templates/blender/template_single_render.py |
| Comparaison | 2+ personnages, couleurs différentes (bleu = nôtre, rouge = référence) | templates/blender/template_comparison.py |
| Squelette | Sphères de points clés 3D + cylindres de membres | Recette D dans references/blender_recipes.md |
| Boîte englobante + Maillage | Boîte englobante en fil de fer autour d'un maillage | Recette E dans references/blender_recipes.md |
Extrayez de la demande de l'utilisateur :
- Chemins des fichiers de données (FBX, OBJ, NPZ)
- Indices d'image (images d'animation à afficher)
- Nombre de personnages / instances
- Préférences de style (couleurs, angle de caméra, avec/sans sol)
Phase Blender 2 : Confirmer avec l'utilisateur
Présentez un résumé structuré :
Type de figure : Accroche multi-personnages
Données : motion.fbx, images [1, 30, 60, 90, 120, 150]
Disposition : 6 personnages le long de l'axe X, espacement 1,5 m
Caméra : Plan large, focale 85 mm
Éclairage : Studio trois points
Matériau : Argile dégradée bleue
Sol : Damier avec reflets
Brouillard : Oui (bleu-gris)
Trajectoire : Oui (courbe dégradée avec flèche)
Sortie : 2048x1024 JPEG
Un tour est généralement suffisant. Passez à la génération.
Phase Blender 3 : Générer le script Blender
- Lisez
references/blender_api.mdpour les signatures de fonctions. - Lisez
references/blender_recipes.mdpour le modèle de recette correspondant. - Générez un script Python complet qui importe depuis
blender_utils.*(PAS depuismyblender.*). - Le script DOIT prendre en charge un indicateur
--previewqui bascule entre le mode de prévisualisation rapide et le mode de rendu final (voir ci-dessous). - Écrivez le script dans le répertoire de travail (par exemple,
render_teaser.py).
Le script doit être autonome et exécutable via :
bash .claude/skills/research-figure/scripts/render_blender.sh <script.py> -- [args]
Conception de rendu en deux passes
Chaque script Blender généré DOIT prendre en charge deux modes de rendu contrôlés par un indicateur CLI --preview :
import argparse
def parse_args():
parser = argparse.ArgumentParser()
parser.add_argument("--preview", action="store_true",
help="Prévisualisation rapide Eevee basse résolution")
# ... autres arguments ...
if '--' in sys.argv:
args = parser.parse_args(sys.argv[sys.argv.index('--') + 1:])
else:
args = parser.parse_args([])
return args
Dans la section de rendu, créez une branche sur args.preview :
scene = bpy.context.scene
if args.preview:
# Prévisualisation rapide : Eevee, basse résolution, PNG
set_eevee_renderer(scene, camera)
preview_path = output_path.rsplit('.', 1)[0] + '_preview.png'
set_output_properties(scene, output_file_path=preview_path,
res_x=800, res_y=400, format='PNG')
else:
# Rendu final : Cycles, pleine résolution
set_cycles_renderer(scene, camera, num_samples=256,
use_transparent_bg=False)
set_output_properties(scene, output_file_path=output_path,
res_x=2048, res_y=1024, format='JPEG')
render_with_progress()
Paramètres du mode prévisualisation :
- Moteur : Eevee (
set_eevee_renderer) — des ordres de grandeur plus rapide que Cycles - Résolution : 1/2 à 1/4 de la finale (par exemple, 800x400 pour une accroche 2048x1024)
- Format : PNG (pour un visionnage rapide)
- Chemin de sortie : ajoutez le suffixe
_previewavant l'extension
Paramètres du mode final :
- Moteur : Cycles (
set_cycles_renderer) — lancer de rayons, qualité publication - Résolution : résolution cible complète
- Échantillons : 256+ pour une qualité finale
Phase Blender 4 : Rendu de prévisualisation et auto-vérification
Effectuez toujours d'abord un rendu de prévisualisation rapide. N'allez PAS directement à un rendu Cycles.
-
Exécutez le rendu de prévisualisation :
bash .claude/skills/research-figure/scripts/render_blender.sh <script.py> -- --preview -
Si le rendu échoue : lisez la sortie d'erreur, corrigez le script Python et réessayez. Problèmes courants :
ModuleNotFoundError→ problème PYTHONPATH (render_blender.sh le gère automatiquement)KeyErrorsur les entrées de nœud → compatibilité de version Blender (utilisez try/except)- Rendu noir/vide → caméra non définie, ou objets non visibles
- Erreurs GPU → définissez
prefer_gpu=Falsedans set_cycles_renderer
-
Visualisez l'image de prévisualisation : Utilisez l'outil Read pour voir le fichier
*_preview.pnggénéré. -
Auto-vérifiez la prévisualisation :
- Les objets sont visibles et correctement positionnés
- L'angle de la caméra montre le sujet clairement
- L'éclairage est raisonnable (l'éclairage Eevee diffère légèrement de Cycles mais la composition doit être correcte)
- Les matériaux sont appliqués (pas de gris par défaut)
- L'arrière-plan est propre
- L'espacement et la disposition des personnages semblent corrects
-
Si des problèmes sont trouvés : corrigez le script et réexécutez la prévisualisation. Ne montrez PAS une figure cassée à l'utilisateur.
Phase Blender 5 : Présenter la prévisualisation et obtenir l'approbation
- Montrez l'image de prévisualisation à l'utilisateur.
- Expliquez qu'il s'agit d'une prévisualisation rapide Eevee pour vérifier la disposition/composition — le rendu final Cycles aura un meilleur éclairage, de meilleurs matériaux et un meilleur anti-aliasing.
- Demandez à l'utilisateur de confirmer que la prévisualisation semble correcte avant de procéder au rendu complet. Utilisez AskUserQuestion avec des options telles que :
- « Semble bon, faites le rendu final » — passez à la phase 6
- « Ajustez la caméra / l'éclairage / l'espacement » — itérez sur le script et refaites le rendu de prévisualisation
- « Changez les images / personnages » — modifiez et refaites le rendu de prévisualisation
- Si l'utilisateur demande des modifications, modifiez le script, refaites le rendu de prévisualisation (pas le rendu complet), et montrez à nouveau.
- Répétez jusqu'à ce que l'utilisateur approuve la prévisualisation.
Phase Blender 6 : Rendu final
Ne procédez ici qu'après que l'utilisateur a approuvé la prévisualisation.
-
Exécutez le rendu final Cycles (sans
--preview) :bash .claude/skills/research-figure/scripts/render_blender.sh <script.py>Remarque : cela prendra beaucoup plus de temps que la prévisualisation. C'est normal.
-
Visualisez le résultat : Utilisez l'outil Read pour voir l'image rendue finale.
-
Montrez l'image finale à l'utilisateur.
-
Si l'utilisateur souhaite d'autres ajustements, revenez à la phase 5 (itération de prévisualisation) plutôt que de relancer le rendu Cycles lent pour chaque ajustement.
Hybride : Appel récursif TikZ + Blender
Lorsqu'un diagramme de pipeline TikZ nécessite des illustrations de module rendues en 3D...