Installation
Zuerst die Anwendung, dann die Generatoren — und nur, wenn Sie sie wollen. TreeLevel rechnet und erzeugt Ereignisse allein; die externen Generatoren kleiden sie in Schauer und Hadronisierung, oder dienen zum Vergleich.
Eine Anwendung, und nichts weiter einzurichten: TreeLevel rechnet und erzeugt seine Ereignisse selbst.
Die Anwendung
TreeLevel wird im Mac App Store gekauft. Es verlangt macOS 14 Sonoma oder neuer und läuft nativ auf Apple silicon wie auf Intel. Der Kauf ist universal: die iPad-Fassung ist enthalten.
TreeLevel wird im App Store gekauft. Es verlangt iPadOS 17 oder neuer. Der Kauf ist universal: die Mac-Fassung ist enthalten.
Auf dem iPad gibt es einen einzigen externen Generator: Pythia 8, nach WebAssembly kompiliert und in der App ausgeführt, ohne dass etwas gesendet wird. Er gehört nicht zur App: Man lädt ihn in den Einstellungen — siehe unten. Herwig, Sherpa, WHIZARD, CalcHEP und der Container bleiben dem Mac und dem PC vorbehalten: Es sind eigenständige Programme, die das iPad nicht starten lässt. Die eigene Generierung von TreeLevel auf Partonniveau funktioniert überall.
TreeLevel wird im Microsoft Store gekauft. Es verlangt Windows 10 Version 2004 oder neuer, oder Windows 11, und läuft nativ auf x64 wie auf ARM64 — ein Copilot+-PC erhält die ARM64-Fassung, keine Emulation.
Warum die Generatoren getrennt sind
Pythia, Herwig, Sherpa, WHIZARD und CalcHEP stehen unter der GPL. Sie in eine im Store verkaufte Anwendung zu binden wirft ein Lizenzproblem auf, sie gemeinsam auszuliefern ein weiteres. Sie wohnen daher in einem eigenen Programm, TreeLevel Tools, das Sie selbst installieren und das TreeLevel erkennt, wenn es da ist.
Nichts geht über das Netz: TreeLevel schreibt einen Auftragsordner auf Ihre Platte, das Programm liest ihn, rechnet und schreibt die Ereignisse daneben. Ist kein Generator installiert, bleibt TreeLevel bei seinem eigenen Partonniveau, das für alles reicht, was der Bereich Rechnung tut.
TreeLevel ToolsPythia-8-Modul
Ein einziger Download, der den Kern und vier Generatoren für Ihre Maschine übersetzt mitbringt: Pythia 8 und Herwig 7, die von TreeLevel gerechnete Ereignisse einkleiden — Schauer, Hadronisierung, Zerfälle —, sowie Sherpa 3 und CalcHEP 3, die den vom Diagramm beschriebenen Prozess selbst rechnen. Sonst nichts zu installieren.
Ein einziger Download, der den Kern und das für Ihre Maschine übersetzte Modul Pythia 8 mitbringt. Die übrigen Generatoren laufen über den Container, weiter unten.
Holen Sie das .dmg von der Versionsseite und ziehen Sie TreeLevel Tools in Ihre Programme. Die Anwendung ist von Apple signiert und notarisiert: macOS prüft sie still und fragt nur beim ersten Mal nach, ob ein geladenes Programm geöffnet werden soll.
Holen Sie das zu Ihrer Maschine passende Archiv von der Versionsseite — TreeLevelTools-version-x64.zip oder -arm64.zip, etwa 45 MB — und entpacken Sie es nach:
%LOCALAPPDATA%\Programs
Das ist die ganze Installation: kein Installationsprogramm, nichts in der Registrierung. TreeLevel sucht dort, danach im PATH. Zum Entfernen löschen Sie den Ordner.
Wenn Sie Ihre Architektur nicht kennen: Einstellungen › System › Info, Zeile Systemtyp. Im Zweifel läuft die x64-Fassung überall, auf ARM unter Emulation.
Kein TreeLevel Tools auf dem iPad: Pythia 8 wird dort als Modul installiert, in den Einstellungen (das Zahnrad der Symbolleiste), Karte Pythia-8-Modul. Pythia ist freie Software unter der GPL: Die App enthält es nicht, sie lädt es von der Versionsseite von TreeLevel Tools und prüft jede Datei anhand ihres SHA-256-Fingerabdrucks, bevor sie sie installiert. Zwei Teile:
| Pythia 8.318 | etwa 14 MB, Taste Laden: Partonschauer, Hadronisierung, Zerfälle und die Quelle Maschine |
|---|---|
| Hadronendaten | etwa 55 MB, optional, Taste Hinzufügen: die Partondichten, die sagen, wie sich die Energie eines Protons auf seine Quarks und Gluonen verteilt; ohne sie wird ein Protonen- oder Pionenstrahl abgelehnt |
Beides lässt sich auf derselben Karte entfernen, Taste Entfernen.
Was jedes Paket enthält, seine Versionen und die Autoren der Generatoren: TreeLevel Tools.
Der Container
Ein fertig gebautes Abbild, das die fünf Generatoren in einer stimmigen Umgebung trägt. Auf einem Mac bringt es WHIZARD 3, den einzigen, der nicht mit TreeLevel Tools ausgeliefert werden kann: er schreibt jeden Prozess in Fortran um und übersetzt ihn zur Laufzeit.
Herwig, Sherpa, WHIZARD und CalcHEP verlangen eine vollständige Übersetzungskette und Stunden des Bauens. Statt sie Ihnen aufzubürden, kommen sie in einem fertig gebauten Container-Abbild, für jedes System dasselbe.
Installieren Sie Docker Desktop, dann, ein einziges Mal:
docker pull ghcr.io/gpasa/treelevel-tools:0.3.0
docker pull ghcr.io/gpasa/treelevel-tools:latest
TreeLevel Tools nutzt ihn, sobald er da ist und Docker antwortet. Das Abbild wiegt entfaltet etwa zwei Gigabyte.
Der Container ist kein stiller Ersatz. Ein nativ installierter Generator und derselbe Generator im Abbild tragen weder dieselben Versionen noch dieselben Einstellungen und liefern daher nicht genau denselben Wirkungsquerschnitt. TreeLevel Tools wechselt nie vom einen zum anderen, ohne es zu sagen: es ist ein Kästchen, ab Werk nicht angekreuzt.
Seit 1.3 heißt das Kästchen auf dem Mac tout faire tourner dans l'image Docker („alles im Docker-Image ausführen“): Angekreuzt führt das Image alle Aufträge aus, und die mit TreeLevel Tools gelieferten Generatoren schweigen; fehlen Docker oder das Image, wird nichts angeboten, statt stillschweigend auf die nativen zurückzufallen.
Docker Desktop verlangt Virtualisierung. Auf einer physischen Maschine ist sie fast immer da; in einer virtuellen Maschine muss der Wirt geschachtelte Virtualisierung erlauben, was nicht alle tun. Ohne sie läuft das native Pythia-Modul trotzdem — genau darum wird es gesondert ausgeliefert.
Prüfen, dass alles antwortet
Öffnen Sie den Bereich Erzeugung. Die Liste der Generatoren gibt an, was geantwortet hat, mit den Versionsnummern:
Ein Generator, der in der Liste steht, hat den Ruf beantwortet: er muss nicht nur installiert sein, er muss sprechen. Ein beschädigtes Modul erscheint dort nicht.
Hilfe › Über TreeLevel nennt dieselben Nummern, und die gehören in einen Bericht: ein physikalisches Ergebnis ist so viel wert wie die Versionen, die es hervorgebracht haben.
TreeLevel › Über TreeLevel nennt dieselben Nummern, und die gehören in einen Bericht: ein physikalisches Ergebnis ist so viel wert wie die Versionen, die es hervorgebracht haben.
Es nennt auch die Version von TreeLevel Tools, und die Schaltfläche Versionen kopieren legt alles in die Zwischenablage, bereit zum Einfügen in eine Nachricht.
Auf dem iPad zeigt die Karte Pythia-8-Modul in den Einstellungen, was installiert ist — Pythia, die Hadronendaten — und wie viel jeder Teil wiegt.
Das Modul hat eine eigene Nummer, getrennt von der von Pythia: Die Karte zeigt sie — Pythia 8.318 (WebAssembly, Modul 0.5.0) —, und das Ende der Einstellungen nennt sie neben der Version der App, mit der Schaltfläche Versionen kopieren für eine Nachricht an den Support. Erscheint eine neuere Version, bietet die Karte Aktualisieren an; die App holt sie beim Start auch von selbst, außerhalb des Mobilfunknetzes, und prüft jede Datei vor der Installation.
Wo die Dateien liegen
| Ihre Dokumente | wo Sie sie sichern, als .feyndiag |
|---|---|
| Einstellungen | %LOCALAPPDATA%\TreeLevel |
| Aufträge des Kerns | neben treelevel-tools.exe, in MCJobs\ |
| Protokoll eines Auftrags | engine.log, im Auftragsordner |
Vergangene Aufträge sieht man im Bereich Erzeugung wieder, datiert und mit ihrem Gewicht: eine Stichprobe von zehntausend geschauerten Ereignissen kommt auf einige hundert Megabyte, und man sammelt ein Dutzend davon, ohne es zu merken. Laden liest einen wieder ein, ohne etwas neu zu starten, Löschen entfernt ihn.
| Ihre Dokumente | wo Sie sie sichern, als .feyndiag |
|---|---|
| Aufträge des Kerns | im Sandkasten von TreeLevel, unter ~/Library/Containers/org.pasahome.Feyn/Data/Library/Application Support/MCJobs |
Vergangene Aufträge sieht man im Bereich Erzeugung wieder, datiert und mit ihrem Gewicht.
Ihre Dokumente liegen dort, wo Sie sie sichern, als .feyndiag: in der App Dateien, auf dem iPad oder in iCloud Drive.
Die Arbeiten von Pythia bleiben in der App; Frühere Arbeiten im Bereich Generierung datiert sie, zeigt ihre Größe, lädt sie neu oder löscht sie.
Einstellungen übernehmen holt die Einstellungen eines Auftrags ins Dokument zurück — Generator, Zahl der Ereignisse, Startwert und seine Maschine, falls er eine hatte —, ohne seine Ereignisse zu lesen: Es bleibt nur, die Erzeugung neu zu starten.
Wenn etwas nicht stimmt
Die Liste bietet nur „TreeLevel — Partonniveau“
TreeLevel Tools wurde nicht gefunden oder hat nicht geantwortet. Prüfen Sie den Ort oben, dann Erneut prüfen im Bereich Erzeugung. Die Taste Ort angeben… erlaubt, es von Hand zu bezeichnen.
Auf dem iPad ist das Pythia-Modul nicht installiert oder wurde entfernt: Einstellungen (das Zahnrad), Karte Pythia-8-Modul, Laden. Die anderen Generatoren gibt es auf dem iPad nicht.
Der Auftrag scheitert sofort
Die Meldung trägt den Grund, und die Taste Protokoll ansehen… öffnet, was der Generator geschrieben hat, ans Ende gescrollt — dort steht die Ursache. Die häufigsten Ablehnungen sind Strahlen, die nicht können, was von ihnen verlangt wird: zwei Leptonen tragen keine Partonen, ein Elektron und ein Proton vernichten sich nicht.
Auf dem iPad braucht ein Protonen- oder Pionenstrahl die Hadronendaten: Ohne sie wird die Arbeit sofort abgelehnt, und die Meldung sagt es. Sie werden auf derselben Karte der Einstellungen hinzugefügt.
Die Formeln erscheinen nicht
Die Darstellung geht über eine Web-Ansicht. Schließen und öffnen Sie das Dokument erneut; hält es an, melden Sie es mit der Version des Systems.
Im Übrigen beantwortet die Seite Hilfe die häufigsten Fragen und sagt, wie man ein Problem meldet.