mkaremm80/paper-explainer-video

Paper-Erklärvideo (Dashboard-Stil)

Verwende dies, wenn der Nutzer nach einem Erklärvideo, einer Animation oder einem "Video wie das FAS-Video" für eine Arbeit, einen Abschnitt (Systemmodell, Theorem, Ergebnisdiagramm) oder ein Lehrkonzept fragt.

Wie die Ausgabe aussieht

Ein 16:9-Frame (1920×1080, 30 fps, weißer Hintergrund, farbenfroh):

• Oben: eine kleine graue Quellenangabe, ein fetter Titel und eine einzeilige violette Zusammenfassung des Aufbaus.
• Links (ca. 40% Breite): eine animierte physikalische Szene (Wellen, Antennen, Knoten, Benutzer, Schaltkreise). Sie bewegt sich jedes Bild, mit Markierungen, die die Entscheidungen oder Ergebnisse zeigen.
• Rechts: ein 2×2-Raster mit Live-Panels. Statische Kurven werden einmal gezeichnet; eine gepunktete vertikale Linie und Punkte bewegen sich entlang dieser Kurven. Ein Panel kann pro Bild vollständig neu gezeichnet werden (z. B. ein Balkendiagramm einer Realisierung).
• Unten: ein gelber abgerundeter Textkasten. Er ändert sich 4–6 Mal, wenn der gesweepete Parameter Schwellenwerte überschreitet, und zeigt dann eine Zusammenfassung mit den wichtigsten Zahlen während eines finalen Halts.
• Ein optionaler Inset in der Szene (z. B. ein Pfeil in der komplexen Ebene) für die Schlüsselgröße.

Vorgehen

1. Lies den Paper-Abschnitt. Wähle EINEN gesweepeten Parameter, der die Geschichte erzählt (Horizont, SNR, Geschwindigkeit, Neigung, Anzahl Blöcke usw.). Schreibe die ein Satz lange Botschaft, die das Video zeigen muss.
2. Implementiere das Modell in numpy/scipy mit den Gleichungen und Parameterwerten der Arbeit. Überprüfe die Schlüsselzahlen (geschlossene Formen vs. numerische Integration, Tabellenwerte, Grenzwerte), bevor du etwas zeichnest. Informiere den Nutzer, wenn etwas nicht übereinstimmt.
3. Berechne die teuren Teile vor: Monte-Carlo-Kurven auf einem feinen Gitter (ca. 21 Punkte, etwa 20k Ziehungen) und cache sie.
4. Verwende für Realisierungs-Panels EINEN festen zufälligen Zug, der sich gleichmäßig mit dem Parameter ändert (z. B. eine endliche ebene Wellensumme mit festen Pfaden und einmal gezogenem Rauschen). Scanne Seeds und wähle einen, der die Geschichte klar erzählt; notiere dies in den Erzählungsnotizen.
5. Zeitstrahl: Einleitender Halt (ca. 2 s), ein sanfter Sweep (0.5 − 0.5·cos(π·x)) und ein finaler Halt (ca. 3 s). Standardmäßig 17 s; für Voice-Over ca. 60 s (z. B. 8 / 42 / 10 s).
6. Schreibe das Skript mit argparse: --out, --preview (erzeugt 3 PNG-Frames), --dpi. Setze die Parameter oben (CREDIT, Modellwerte, SEED, Timings). Rendere mit matplotlib FFMpegWriter (libx264, yuv420p, bitrate 6000) in einer grab_frame-Schleife.
7. Rendere IMMER zuerst die Vorschauen und betrachte sie. Behebe Überlappungen, dann rendere das vollständige Video. Extrahiere anschließend 4 Frames mit ffmpeg und überprüfe sie.
8. Liefere die .mp4-Datei, die .py-Datei und eine Erzählungs-.md-Datei (Zeit | Beschriftung | was in einfachem Englisch gesagt werden soll | Panel-Anleitung | Einstellungen | einfache Anpassungen). Nummeriere Versionen v1, v2, …

Layout-Lektionen (vermeide diese Fehler)

• Verwende für die Szenenachsen set_aspect('equal', adjustable='datalim') und zentriere die xlim auf den Inhalt, sonst schrumpft die Szene und wird abgeschnitten.
• Platziere lange Szenenbeschriftungen dort, wo sich nichts bewegt; überprüfe, dass Inset-Achsen keine Beschriftungen überdecken.
• Legenden: platziere sie in leeren Bereichen (oft lower right bei Ausfallskurven). Verwende ncol=2 für Balkenpanels und lasse in ylim Platz für Markierungen.
• Halte den gridspec-Oberrand bei etwa 0.86, damit der Untertitel nicht mit den Panel-Titeln kollidiert, und den Unterrand bei etwa 0.155, damit ein zweizeiliger Textkasten nicht die x-Beschriftungen berührt.
• Formeltexte gehören in leere Bereiche der Achsen, nicht über eine Kurve.
• Vollständige Neuzuzeichnungen (cla) nur für die Szene und ein Realisierungs-Panel; die anderen verwenden set_data. Etwa 4 Minuten für 510 Frames bei 1080p ist normal.

Stilkonstanten

Blau #1c7ed6, Orange #e8590c, Grün #2f9e44, Rot #e03131, Blaugrün #0c8599, Violett #7048e8, Grau #868e96, Tinte #212529, Gold #f59f00. Fette Titel bei 11.5 pt, Grundschrift 10 pt, obere/rechte Spines aus.

Sprache

Beschriftungen und Erzählungen verwenden einfaches Englisch (B2 oder niedriger), mit kurzen Sätzen und nummerierten Schritten ("1 ·", "2 ·", …).