PlateformeVersion

Installation

L'application d'abord, les générateurs ensuite — et seulement si vous en voulez. TreeLevel calcule et génère des événements tout seul ; les générateurs externes servent à les habiller d'une gerbe et d'une hadronisation, ou à comparer.

Une application, et rien d'autre à installer : TreeLevel calcule et génère ses événements lui-même.

L'application

TreeLevel s'achète sur le Mac App Store. Il demande macOS 14 Sonoma ou plus récent, et tourne nativement sur Apple silicon comme sur Intel. L'achat est universel : la version iPad est comprise.

TreeLevel s'achète sur l'App Store. Il demande iPadOS 17 ou plus récent. L'achat est universel : la version Mac est comprise.

Sur l'iPad, un seul générateur externe : Pythia 8, compilé en WebAssembly et exécuté dans l'app, sans rien envoyer. Il ne fait pas partie de l'app : on le télécharge depuis les réglages — voir plus bas. Herwig, Sherpa, WHIZARD, CalcHEP et le conteneur restent au Mac et au PC : ce sont des programmes séparés, que l'iPad n'autorise pas à lancer. La génération propre à TreeLevel, au niveau partonique, fonctionne partout.

TreeLevel s'achète sur le Microsoft Store. Il demande Windows 10 version 2004 ou plus récent, ou Windows 11, et tourne nativement en x64 comme en ARM64 — un PC Copilot+ reçoit la version ARM64, pas de l'émulation.

Pourquoi les générateurs sont à part

Pythia, Herwig, Sherpa, WHIZARD et CalcHEP sont publiés sous licence GPL. Les lier à une application vendue sur une boutique poserait un problème de licence, et les distribuer ensemble en poserait un autre. Ils vivent donc dans un programme séparé, TreeLevel Tools, que vous installez vous-même et que TreeLevel détecte s'il est là.

Rien ne transite par le réseau : TreeLevel écrit un dossier de travail sur votre disque, le programme le lit, calcule, et écrit les événements à côté. Si aucun générateur n'est installé, TreeLevel s'en tient à son propre niveau partonique, qui suffit à tout ce que fait l'espace Calcul.

TreeLevel ToolsModule Pythia 8

Un seul téléchargement, qui apporte le moteur et quatre générateurs compilés pour votre machine : Pythia 8 et Herwig 7, qui habillent les événements calculés par TreeLevel — gerbe, hadronisation, désintégrations —, ainsi que Sherpa 3 et CalcHEP 3, qui calculent eux-mêmes le processus décrit par le diagramme. Rien d'autre à installer.

Un seul téléchargement, qui apporte le moteur et le module Pythia 8 compilé pour votre machine. Les autres générateurs passent par le conteneur, plus bas.

Prenez l'archive .dmg de la page des versions et glissez TreeLevel Tools dans vos Applications. L'application est signée et notarisée par Apple : macOS la vérifie en silence et demande seulement, la première fois, confirmation d'ouvrir un programme téléchargé.

Prenez l'archive qui correspond à votre machine sur la page des versions — TreeLevelTools-version-x64.zip ou -arm64.zip, environ 45 Mo — et dépliez-la dans :

%LOCALAPPDATA%\Programs

C'est toute l'installation : pas de programme d'installation, rien dans le registre. TreeLevel cherche à cet endroit, puis auprès du PATH. Pour l'effacer, supprimez le dossier.

Si vous ne savez pas quelle architecture vous avez : Paramètres › Système › Informations système, ligne Type du système. En cas de doute, la version x64 fonctionne partout, en émulation sur ARM.

Pas de TreeLevel Tools sur l'iPad : Pythia 8 s'y installe comme un module, depuis les réglages (la roue dentée de la barre d'outils), carte Module Pythia 8. Pythia est un logiciel libre, sous licence GPL : l'app ne le contient pas, elle le télécharge depuis la page des versions de TreeLevel Tools et vérifie chaque fichier par son empreinte SHA-256 avant de l'installer. Deux parties :

Pythia 8.318	environ 14 Mo, bouton Télécharger : gerbe partonique, hadronisation, désintégrations, et la source Machine
Données des hadrons	environ 55 Mo, facultatives, bouton Ajouter : les densités de partons, qui disent comment l'énergie d'un proton se partage entre ses quarks et ses gluons ; sans elles, un faisceau de protons ou de pions est refusé

L'une et l'autre se retirent depuis la même carte, bouton Retirer.

Ce que chaque paquet contient, ses versions et les auteurs des générateurs : TreeLevel Tools.

Le conteneur

Une image déjà bâtie, qui porte les cinq générateurs dans un environnement cohérent. Sur un Mac elle apporte WHIZARD 3, le seul qui ne puisse pas être livré avec TreeLevel Tools : il réécrit chaque processus en Fortran et le compile à l'exécution.

Herwig, Sherpa, WHIZARD et CalcHEP demandent une chaîne de compilation complète et des heures de construction. Plutôt que de vous les imposer, ils sont livrés dans une image de conteneur déjà bâtie, la même pour tous les systèmes.

Installez Docker Desktop, puis, une fois seulement :

docker pull ghcr.io/gpasa/treelevel-tools:0.3.0

docker pull ghcr.io/gpasa/treelevel-tools:latest

TreeLevel Tools s'en sert dès qu'elle est présente et que Docker répond. L'image pèse environ deux gigaoctets déployée.

Le conteneur n'est pas un remplaçant silencieux. Un générateur installé nativement et le même générateur dans l'image ne portent ni les mêmes versions ni les mêmes réglages, et ne donnent donc pas exactement la même section efficace. TreeLevel Tools ne bascule jamais de l'un à l'autre sans le dire : c'est une case à cocher, décochée d'origine.

Depuis la 1.3, sur le Mac, la case dit tout faire tourner dans l'image Docker : cochée, l'image mène tous les travaux et les générateurs livrés avec TreeLevel Tools se taisent ; si Docker ou l'image manquent, rien n'est proposé plutôt qu'un retour discret au natif.

Docker Desktop demande la virtualisation. Sur une machine physique elle est presque toujours disponible ; dans une machine virtuelle, il faut que l'hôte autorise la virtualisation imbriquée, ce que tous ne font pas. Sans elle, le module Pythia natif fonctionne quand même — c'est précisément pourquoi il est livré à part.

Vérifier que tout répond

Ouvrez l'espace Génération. La liste des générateurs donne ce qui a répondu, avec les numéros de version :

Un générateur qui figure dans la liste a répondu à l'appel : il ne suffit pas qu'il soit installé, il faut qu'il parle. Un module abîmé n'y apparaît pas.

Aide › À propos de TreeLevel donne les mêmes numéros, et c'est ce qu'il faut joindre à un rapport : un résultat de physique vaut les versions qui l'ont produit.

TreeLevel › À propos donne les mêmes numéros, et c'est ce qu'il faut joindre à un rapport : un résultat de physique vaut les versions qui l'ont produit.

Il donne aussi la version de TreeLevel Tools, et son bouton Copier les versions met le tout dans le presse-papiers, prêt à coller dans un message.

Sur l'iPad, la carte Module Pythia 8 des réglages dit ce qui est installé — Pythia, les données des hadrons — et ce que chaque partie pèse.

Le module porte son propre numéro, distinct de celui de Pythia : la carte l'affiche — Pythia 8.318 (WebAssembly, module 0.5.0) —, et le bas des réglages le redonne à côté de la version de l'application, avec le bouton Copier les versions pour un message d'assistance. Quand une version plus récente est publiée, la carte propose Mettre à jour ; l'app la prend aussi d'elle-même au lancement, hors réseau cellulaire, et vérifie chaque fichier avant de l'installer.

Où vivent les fichiers

Vos documents	où vous les enregistrez, en `.feyndiag`
Réglages	`%LOCALAPPDATA%\TreeLevel`
Travaux du moteur	à côté de `treelevel-tools.exe`, dans `MCJobs\`
Journal d'un travail	`engine.log`, dans le dossier du travail

Les travaux passés se revoient dans l'espace Génération, datés et avec ce qu'ils pèsent : un échantillon de dix mille événements gerbés fait quelques centaines de mégaoctets, et on en accumule douze sans s'en apercevoir. Charger relit l'un d'eux sans rien relancer, Effacer le supprime.

Vos documents	où vous les enregistrez, en `.feyndiag`
Travaux du moteur	dans le bac à sable de TreeLevel, sous `~/Bibliothèque/Containers/org.pasahome.Feyn/Data/Library/Application Support/MCJobs`

Les travaux passés se revoient dans l'espace Génération, datés et avec ce qu'ils pèsent.

Vos documents sont là où vous les enregistrez, en .feyndiag : dans l'app Fichiers, sur l'iPad ou dans iCloud Drive.

Les travaux de Pythia restent dans l'app ; Travaux passés, dans l'espace Génération, les date, dit ce qu'ils pèsent, les recharge ou les efface.

Reprendre les réglages remet dans le document les réglages d'un travail — générateur, nombre d'événements, graine, et sa machine s'il en avait une — sans relire ses événements : il ne reste qu'à relancer la génération.

Quand quelque chose ne va pas

La liste ne propose que « TreeLevel — niveau partonique »

TreeLevel Tools n'a pas été trouvée, ou n'a pas répondu. Vérifiez l'emplacement ci-dessus, puis Vérifier à nouveau dans l'espace Génération. Le bouton Indiquer l'emplacement… permet de la désigner à la main.

Sur l'iPad, le module Pythia n'est pas installé, ou a été retiré : réglages (la roue dentée), carte Module Pythia 8, Télécharger. Les autres générateurs n'existent pas sur l'iPad.

Le travail échoue tout de suite

Le message porte la raison, et le bouton Voir le journal… ouvre ce que le générateur a écrit, défilé sur sa fin — c'est là qu'est la cause. Les refus les plus fréquents sont des faisceaux qui ne peuvent pas faire ce qu'on leur demande : deux leptons ne portent pas de partons, un électron et un proton ne s'annihilent pas.

Sur l'iPad, un faisceau de protons ou de pions demande les Données des hadrons : sans elles, le travail est refusé dès le départ, et le message le dit. Elles s'ajoutent depuis la même carte des réglages.

Les formules ne s'affichent pas

Le rendu passe par une vue web. Fermez et rouvrez le document ; si cela persiste, signalez-le avec la version du système.

Pour le reste, la page Assistance répond aux questions les plus fréquentes et dit comment signaler un problème.