mkaremm80/paper-explainer-video

Vidéo explicative d'article (style tableau de bord)

Utilisez ceci lorsque l'utilisateur demande une vidéo explicative, une animation ou une « vidéo comme celle FAS » pour un article, une section (modèle système, théorème, figure de résultat) ou un concept pédagogique.

À quoi ressemble le résultat

Un cadre 16:9 (1920×1080, 30 ips, fond blanc, coloré) :

• Haut : une petite ligne de crédit grise, un titre en gras, et un résumé d'une ligne en violet du contexte.
• Gauche (environ 40% de largeur) : une scène physique animée (ondes, antennes, nœuds, utilisateurs, circuits). Elle se déplace à chaque image, avec des marqueurs indiquant les décisions ou résultats.
• Droite : une grille 2×2 de panneaux en direct. Les courbes statiques sont tracées une fois ; une ligne pointillée verticale et des points se déplacent le long d'elles. Un panneau peut être entièrement redessiné à chaque image (par exemple un diagramme à barres d'une réalisation).
• Bas : une légende arrondie jaune. Elle change 4 à 6 fois lorsque le paramètre balayé franchit des seuils, puis affiche un résumé avec les chiffres clés pendant une pause finale.
• Un encart optionnel dans la scène (par exemple une flèche dans le plan complexe) pour la quantité clé.

Procédure

1. Lisez la section de l'article. Choisissez UN paramètre balayé qui raconte l'histoire (horizon, SNR, vitesse, inclinaison, nombre de blocs, etc.). Rédigez le message d'une phrase que la vidéo doit montrer.
2. Réimplémentez le modèle en numpy/scipy, en utilisant les équations et valeurs de paramètres de l'article. Vérifiez les nombres clés (formes fermées vs. intégration numérique, valeurs de tableau, limites) avant de dessiner quoi que ce soit. Informez l'utilisateur si quelque chose ne correspond pas.
3. Précalculez les parties coûteuses : courbes Monte Carlo sur une grille fine (environ 21 points, environ 20 000 tirages), et mettez-les en cache.
4. Pour les panneaux de réalisation, utilisez UN tirage aléatoire fixe qui varie de manière fluide avec le paramètre (par exemple une somme d'ondes planes finie avec des chemins fixes, et un bruit tiré une fois). Parcourez les graines et choisissez celle qui raconte clairement l'histoire ; mentionnez-le dans les notes de narration.
5. Chronologie : pause introductive (environ 2 s), un balayage progressif (0.5 - 0.5 cos(π x)), et une pause finale (environ 3 s). Par défaut 17 s ; pour une voix off, faites environ 60 s (par exemple 8 / 42 / 10 s).
6. Écrivez le script avec argparse : --out, --preview (écrit 3 trames PNG), --dpi. Placez les paramètres en haut (CREDIT, valeurs du modèle, SEED, temporisations). Rendez avec matplotlib FFMpegWriter (libx264, yuv420p, débit binaire 6000), en utilisant une boucle grab_frame.
7. Rendez toujours les aperçus d'abord et regardez-les. Corrigez les chevauchements, puis rendez la vidéo complète. Ensuite, extrayez 4 trames avec ffmpeg et vérifiez-les.
8. Livrez le fichier .mp4, le fichier .py et un fichier de narration .md (temps | légende | quoi dire en anglais simple | guide des panneaux | paramètres | modifications faciles). Numérotez les versions v1, v2, ...

Leçons de mise en page (évitez ces bugs)

• Pour les axes de la scène, utilisez set_aspect('equal', adjustable='datalim') et centrez le xlim sur le contenu, sinon la scène rétrécit et est rognée.
• Placez les longues étiquettes de scène là où rien ne bouge ; vérifiez que les axes d'encart ne couvrent pas les étiquettes.
• Légendes : placez-les dans les zones vides (souvent lower right pour les courbes de type panne). Utilisez ncol=2 pour les panneaux à barres et laissez de la marge dans ylim pour les marqueurs.
• Gardez le gridspec en haut à environ 0.86, pour que le sous-titre ne heurte pas les titres des panneaux, et en bas à environ 0.155, pour qu'une légende de deux lignes ne touche pas les étiquettes x.
• Le texte des formules se trouve dans les axes dans une zone vide, pas au-dessus d'une courbe.
• Les redessins complets (cla) ne sont que pour la scène et un panneau de réalisation ; les autres utilisent set_data. Environ 4 minutes pour 510 images en 1080p est normal.

Constantes de style

Bleu #1c7ed6, orange #e8590c, vert #2f9e44, rouge #e03131, sarcelle #0c8599, violet #7048e8, gris #868e96, encre #212529, or #f59f00. Titres en gras à 11.5 pt, police de base 10 pt, bordures supérieure/droite désactivées.

Langue

Les légendes et la narration utilisent un anglais simple (niveau B2 ou moins), avec des phrases courtes et des étapes de légende numérotées ("1 ·", "2 ·", ...).