bio-viz-film · Biologische 3D-Erklärfilme (v2)
Ziel: Professoren sehen keine Fehler, Studenten verstehen beim ersten Anschauen, visuelle Qualität auf kommerziellem Niveau. Genauigkeit geht vor Ästhetik; keine erfundenen Daten oder Abläufe.
Verzeichnis
template/site2/ ← Aktuelle Engine (v2)
index.html Erklär-Layout (eigens entwickelt: dunkel, akademisch, Serifen-Überschriften, rechte Navigationsleiste)
engine.js Renderer, Kamera, Zeitlinie, Post-Processing (Tiefenschärfe + Bloom), Erklär-Overlay
lib.js Seed-Zufall, instanziiertes Bauen, dynamischer Pool, Baking-AO
scene-*.js Programmatische Szene, exportiert build(scene, seed) → { anchors, update(t,T), palette }
story-*.js Story-Script: Schritte, Kamerafahrten, Untertitel, Zeitfenster, Legenden, Quellen
vendor/ Three.js r170 + Addons (Postprocessing / Environments usw.)
template/site/ ← Alte Engine v1 (Dashboard-Stil, Zellen/Viren; bekannte wissenschaftliche Probleme siehe references/pitfalls.md, nicht empfohlen)
template/tools/ record.mjs Frame-für-Frame-Rekorder · sheet2.py Musterseiten-Fotografie · probe.mjs Raytracing-Sonde · hidetest.mjs Einzelobjekt-Ausschluss
references/ accuracy-protocol.md (Pflichtlektüre) · techniques.md · new-scene.md · science-checklist.md · pitfalls.md
examples/ secretion: Vollständiges Beispiel aus dem chinesischen Lehrbuch (PEP, Biologie Pflichtmodul 1, 3.2) mit 5 Prüfrunden
Ausgabeformate (Layout wählbar)
?layout= | Effekt | Geeignet für |
|---|---|---|
clean | Reine 3D-Szene, ohne Web- oder Textelemente | Zweitschnitt, Voice-Over, Hintergrund |
lecture (Standard) | Dunkles akademisches Layout: Schrittnummern + Serifen-Überschrift + Original-Lehrbuchsätze, rechte Navigationsleiste, Legenden, untere Quellenleiste | Erklärvideos, Veröffentlichung |
notes | Helles Vorlesungs-Layout: Linke 3D-Ecke mit abgerundetem Bild, rechts alle Schritte auf Papier (aktueller Schritt mit Originaltext), Legenden, Experimentdaten, Quellen | Unterricht, Beamer-Präsentation |
dashboard | Tracking-Dashboard: Rechtes Panel zeigt Echtzeit-Zählung markierter Moleküle in verschiedenen Kompartimenten (aus dem Modell, nicht experimentell) | Wissenschaftliche Vorträge, ‚Prozess‘-Demonstrationen |
bench | Helles Labor-Seiten-Layout (im Stil erfolgreicher Dashboard-Seiten): Obere Leiste (Sichtfeld, Schritt, Modelluhr) + Laufband mit echten Fakten + 3D-Fenster mit Rahmen (Label mit Fadenkreuz an 3D-Strukturen, Echtzeit-Maßstab) + Modellzählbalken + Schrittanzeige + drei kleine Karten (typische Wertekurve / Modellzählkurve / Lehrbuchabbildung). Hochformat 1080×1350 optimal | Twitter, Xiaohongshu, soziale Medien |
| Benutzerdefiniert | In layouts/ neue <name>.js Datei, exportiert meta / css / html / mount / update. Aufruf mit ?layout=<name> | Themen- oder anforderungsspezifische Anpassung |
- In der Story kann
layout: 'notes'als Standard gesetzt werden; mit--size 1080x1920wird das Layout automatisch auf Hochformat umgestellt. - Neue Layout-Regeln:
- Jede Zahl auf dem Bild muss echt sein (aus Quelle oder Modellstatus);
- Keine Referenzvideos kopieren; Layout themenspezifisch neu entwerfen;
- 3D-Hauptobjekt durch
meta.camShiftPlatz für Text freigeben.
Showreel-Modus – für Reichweite und Wow-Effekt
Verwendet denselben wissenschaftlichen Inhalt, nur anders präsentiert. Kann direkt im Prompt oder mit Parametern gesteuert werden:
| Du sagst | Parameter | Optionen |
|---|---|---|
| „Mach ein Showreel / eine beeindruckende Version / ein vertikales Kurzvideo“ | ?story=<thema>-reel (Story wird auf 0,42x komprimiert, One-Take) | — |
| „Stil hell / Neon / akademisch / Papier“ | look= | vivid bunt, Bonbon · neon dunkel, Neon-Leuchten · academic dunkel, akademisch · paper Papieroptik |
| „Farbpalette Bonbon / Eisblau / Sonnenuntergang“ | palette= | textbook · candy · ice · sunset · neon |
| „Ich möchte diesen Scan-Farbwechsel-Übergang“ | fx=channels | Bei jedem Schritt Pixel-Scan-Übergang zum nächsten ‚Pseudofarb-Kanal‘ (wie Fluoreszenzmikroskop-Kanalwechsel) |
| „Große Überschriften / TikTok-Stil“ | layout=reel | Pro Schritt ein großer Hook-Text, plus Pseudofarb-Kanal-Label und kurzer Disclaimer |
| „Hochformat“ | --size 1080x1920 | Kamera zoomt automatisch 1,7x heraus (portraitZoom) |
Regeln:
- Pseudofarben ändern nur die Farbe, nicht Struktur oder Ablauf; permanenter Hinweis „Farben sind Pseudofarben“ auf dem Bild.
- Showreel-Version durchläuft ebenfalls die wissenschaftliche Prüfung.
Aufzeichnung:
node tools/record.mjs site2 out/x_clean.mp4 --size 1920x1080 --dpr 2 --scale 1920x1080 --query "story=secretion&layout=clean"
node tools/record.mjs site2 out/x_lecture.mp4 --size 1920x1080 --dpr 2 --scale 1920x1080 --query "story=secretion"
--draft (1x, 30 fps, ca. 1/8 der Zeit) erstellt eine Vorschau zur Freigabe, dann die endgültige Aufnahme. Der Rekorder sperrt Dateien, um parallele Schreibvorgänge zu verhindern; schreibt zuerst *.partial.mp4, benennt nach Fertigstellung um. Automatische Frame-für-Frame-Überprüfung; Fehler werden gemeldet.
--dpr 2 --scale 1920x1080 bedeutet: Rendern in 2-facher Auflösung, dann auf 1080p skalieren (Supersampling-Antialiasing). Für 4K-Endergebnis --scale weglassen.
Workflow (kein Schritt darf übersprungen werden)
1. Faktenliste (vor der Szene) – gemäß references/accuracy-protocol.md
- Lehrbuchthema: Zuerst den Original-Lehrbuchsatz finden, als Untertitelgerüst verwenden; Untertitel enthalten nur Schlussfolgerungen auf Lehrbuchniveau, Details auf Universitätsniveau in Notizen zur Faktenliste.
- Forschungsthema: Argumente aus Abstract und Bildunterschriften extrahieren, jede Einstellung entspricht einer Abbildung, Quellenangabe (z. B. Fig.2b).
- Ergebnis:
review/Faktenliste.md, Spalten: Schritt | Original-Untertitel | Quelle (Lehrbuchkapitel/DOI) | Status (geprüft/ungeprüft). Ungeprüfte Inhalte dürfen nicht auf den Bildschirm. - Gleichzeitig Liste verbotener Darstellungen erstellen, die häufige Fehler zu diesem Thema auflistet (z. B. „Ribosom gelangt in das endoplasmatische Retikulum-Lumen“, „Protein treibt nackt im Zytoplasma“).
2. Erste unabhängige Prüfung (Faktenliste + Szenendesign): Einen Unter-Agenten starten, der nur die Faktenliste, das Story-Script und die Szenenbeschreibung erhält; er muss Punkt für Punkt Fehler finden.
3. Szene und Story schreiben: Siehe references/new-scene.md.
- Jeden Prozess als reine Funktion von t schreiben (z. B.
update(t, T)), Zeitfenster in der Story inTdefinieren. - Verfolgte Moleküle mit leuchtendem Material, andere mit dunklem Material darstellen. Die Bedeutung von ‚Markierung‘ muss mit dem Experiment übereinstimmen.
- Größenverhältnisse nur relativ erhalten; auf dem Bild vermerken: „Nicht maßstabsgetreu“. Zeitkompression ebenfalls vermerken.
4. Selbstprüfung mit Musterseiten: Mit --stills eine Momentaufnahme jedes Schritts generieren, zu einem Raster zusammensetzen und prüfen: Ist das Schlüsselereignis im Bildzentrum? Ist es sichtbar? Gibt es Durchdringungen oder Löcher in der Struktur?
- Bei verdächtigen dunklen Bereichen oder Löchern mit
probe.mjs(Raytracing-Sonde) undhidetest.mjs(Einzelobjekt-Ausblendung) lokalisieren, nicht raten.
5. Zweite unabhängige Prüfung (Endfassungs-Musterseiten): Der Unter-Agent spielt die Rolle eines „Professors für Zellbiologie + Art Director für Wissenschaftskommunikation“ und prüft Musterseiten, Untertitel und Prozesscode. Er erstellt eine Liste zwingender Änderungen und eine Bewertung, ob das Material direkt unterrichtet werden kann.
- Nur wenn alle Fehler und irreführenden Darstellungen behoben sind, darf das Video ausgegeben werden.
6. Ausgabe und Lieferung:
- Liefergegenstände: Reine 3D-Version + Erklärversion (zwei MP4s) plus Faktenliste und Protokolle beider Prüfrunden.
- Bei Veröffentlichung chinesische und englische Texte beifügen; kein Hintergrundmusik-Mix.
Webseiten-Version (bench) – Wesentliche Punkte
- In der Story
layout: 'bench'setzen undbrand / title / sub / notes(Laufband, muss belegte Fakten enthalten) /clock(Filmsekunden → physiologische Millisekunden) /conv(welches Signal wird pro Schritt hervorgehoben) angeben. Pro Schrittchip / badge / call(Anmerkung: Anker, Titel, Untertitel, Hauptpunkte) definieren. - Zahlen auf der Seite dürfen nur drei Quellen haben, die im Karten-Etikett vermerkt sind:
MODEL(Szenen-Census-Zählung),TYPICAL(Lehrbuch-Typwerte),TEXTBOOK. Nicht „LIVE“ / „Echtzeit-Mikroskopie“ o. Ä. schreiben, was als echte Daten missverstanden werden könnte. - Modelluhr mit Untertiteln und Kurven synchronisieren; Zeitlupenfaktor als echten Bereich angeben (bei Nichtlinearität „nichtlinear“ schreiben).
Nahaufnahme-„Schnittmodus“ und Membrandicke
STORY.slab(t): Zweite globale Schnittebene (nur z ≥ Wert), bei Nahaufnahme die Szene in ca. 50–100 nm dicke Scheiben schneiden, sauber wie Elektronenmikroskop-Schnitte.- Membran mit
shell()als geschlossene Doppelschicht modellieren (Außenseite nach außen, Innenseite nach innen, 5 nm), Materialcapify, Schnittflächen als Vollfarbbänder darstellen; Schlüsselereignisse (Fusionspore, Endozytose-Grübchen) auf der Schnittebene platzieren, Kamera nahezu von oben, damit Ω-förmige Konturen sichtbar werden. - In der Totale Moleküle/Ionen je nach Kameradistanz vergrößert darstellen (
__camDist), in der Fußzeile „Vergrößerte Moleküle in der Totale“ vermerken.
Zwei Rendering-Pipelines (Details in references/two-routes.md)
- Schnelle Route: Three.js Echtzeit-Rendering (mit N8AO Ambient Occlusion), 49-Sekunden-Video in ca. 15 Minuten fertig, für Iterationen und tägliche Ausgaben.
- Professionelle Route:
export_blender.mjsexportiert die Szene →blender_build.pybaut sie in Blender nach, Rendering mit Cycles Path Tracing →record.mjs --overlay-dirgeneriert die Web-UI-Ebene und überlagert sie. Lokal ca. 17–20 s/Frame, für finale Veröffentlichungen. - Es kann immer nur eine Blender-Aufgabe gleichzeitig laufen; zwei führen zu Speichermangel und sofortigem Absturz.
Molekül-„Perlenstil“ (keine Vereinfachung: echte Strukturen)
tools/pdb2beads.py <PDB> site2/mol/<PDB>.json [--opm] [--group Kette]: Wandelt echte Atomstrukturen in Perlenmodelle um. Membranproteine mit--opmund der OPM-Datenbank-Orientierung.- Szenen-Top-Level
await fetch('./mol/*.json'), Geometrie mitbeadGeo()erzeugen. Perlen oberhalb der Schnittebene komplett entfernen, keine halben Hohlschalen hinterlassen. - Platzierung mit Kollisionserkennung auf Perlenebene, 0 Überlappung sicherstellen;
node tools/check.mjs site2 "story=..."überprüft. - Zählungen müssen stöchiometrisch konsistent sein (z. B. 1 O₂ entspricht PSII-Absorption von 4 Photonen, PSI-Absorption von 4 Photonen, 4 Elektronen, 12 H⁺ in das Thylakoid-Lumen, 2 NADPH, ca. 2,6 ATP). Schematische kontinuierliche Animationen separat als ILLUSTRATIV kennzeichnen.
Morphologische Prinzipien (keine Vereinfachung)
- Organellen nach realen EM-Formen und -Verhältnissen modellieren, nicht als regelmäßige geometrische Körper. Größen zuerst tabellarisch erfassen (wie in
references/morphology-acinar.md), dann codieren. - Bei drei Größenordnungen (Zelle 15 μm → Ribosom 25 nm) Strukturen nicht skalieren, sondern die Kamera kontinuierlich heranzoomen (logarithmische Distanzinterpolation); molekulare Ereignisse in der Nahaufnahme betrachten.
- Geschlossene Strukturen (Vesikel, Mitochondrien, konzentrierte Vakuolen, Zellkerne) bei einem Schnitt als Vollquerschnitt (
capify) darstellen, keine Hohlschalen.
Layout-Prinzipien
- Layout themenspezifisch originell gestalten, keine Referenzvideos kopieren.
- Standardstil: Dunkel, akademisch: Serifen-Überschrift, Textkörper mit Lehrbuch-Originalzitaten, eine Akzentfarbe (entspricht der Markerfarbe).
- Jede Zahl auf dem Bild muss eine Quelle haben. Keine unechten Dashboards, falschen Zählungen oder Kurven.
- Quellen- und Disclaimer-Zeile ständig in der Fußzeile: Schematische Animation · Nicht maßstabsgetreu · Zeit komprimiert · Quellen.
Fertige Beispiele
thylakoid: Chloroplast → Grana → Thylakoid-Membran-Lichtreaktion, 9 echte Proteinstrukturen (PSII-LHCII, b₆f, PSI, ATP-Synthase, LHCII, PC, Fd, FNR, Rubisco), englische Bench-Webseitestory=thylakoid-en, schnelle und professionelle Route beide realisiert.synapse: Hippocampale glutamaterge Synapse (Axon-Varicosität → pilzförmiger dendritischer Dorn), echter Maßstab 1 Einheit = 20 nm, Aktionspotential → Ca²⁺-Einstrom → Einzelvesikel-Vollfusion → ~4.000 Glutamat-Diffusion → AMPA-Öffnung, Na⁺-Einstrom → Astrozytenaufnahme → Clathrin-vermittelte Endozytose und Wiederauffüllung. Englische Bench-Webseitestory=synapse-en, ca. 50 s. Faktenliste und Prüfprotokolle inexamples/synapse/.secretion: Meerschweinchen-Pankreas-Azinuszelle, vollständiger Sekretprotein-Weg von freiem Ribosom bis Exozytose, ca. 75 s, 9 Schritte, mit ³H-Leucin-Experiment-Zeitlinie (3/17/117 min, Lehrbuchdaten).