TreeLevel Tools 0.3.1 — Windows

TreeLevel Tools 0.3.1 — Windows

🌐 This page in your language — the TreeLevel site opens it in the language of your browser. Or unfold yours below: Français · Deutsch · Italiano · Español · Português (Brasil) · Русский · 简体中文 · 日本語 · 한국어 · हिन्दी.

The engine that runs the Monte Carlo generators for TreeLevel on Windows. It is installed by unfolding the archive into %LOCALAPPDATA%\Programs — no installer, nothing in the registry. To update a previous version: close TreeLevel, then unfold the archive in the same place, replacing the files.

Choose the archive for your machine: arm64 for a Copilot+ PC or an ARM tablet, x64 everywhere else. When in doubt, the x64 one also works on ARM, under emulation.

What the archive contains: the engine and the Pythia 8 module compiled for this architecture. Herwig, Sherpa, WHIZARD and CalcHEP go through the container image, which requires Docker Desktop:

docker pull ghcr.io/gpasa/treelevel-tools

Nothing else to do: TreeLevel itself creates an ephemeral container for each job. Docker Desktop must be running when TreeLevel starts; the image's generators then appear, marked “(Docker)”.

The engine has no window. TreeLevel launches it, whenever needed. If you double-click treelevel-tools.exe, Windows SmartScreen warns of an unrecognised app — the engine is not signed — and, once past the warning, a console shows its usage and closes again. This is normal, and harmless: you never have to launch it yourself.

Fixes in this version

• The image pulled without a number is recognised. 0.3.0 only recognised the :0.3.0 tag; yet the command that the package page suggests, and the one everyone types, pulls :latest. The image was on the machine, answered when launched by hand, and yet TreeLevel offered only Pythia. Both tags designate the same image, and both are now recognised.
• Sherpa on lepton beams, when it runs outside the image: its cross section is no longer inflated by QED initial-state radiation (some fifteen picobarns instead of 3.2 for e⁻e⁺ → b b̄ at 200 GeV). The route that depended on it — Sherpa installed yourself in WSL — will be removed in a coming version: Docker is the intended route.

Five generators, two families

Pythia 8 and Herwig 7 dress the partonic events that TreeLevel gives them: shower, hadronisation, decays.

Sherpa 3, WHIZARD 3 and CalcHEP 3 have no Les Houches reader — they compute the process described by the diagram themselves. The protocol therefore passes them a description of the process (beams, energies, final state, coupling orders) alongside the events.

Measured: e⁻e⁺ → W⁺W⁻ at 200 GeV

engine	σ
TreeLevel	19.22 pb
WHIZARD 3.1.6	19.441 ± 0.006 pb
CalcHEP 3.9.2	20.42 pb
Sherpa 3.0.5	18.2 ± 1.1 pb

The differences are choices of coupling scheme, not errors.

Reminder: what 0.3.0 brought

• Collider mode. The generator receives only the beams and the energy, never a final state: it produces the whole mixture, like a real machine, and TreeLevel then counts the events that carry the signature of the drawn process — which measures a cross section instead of computing it. Six families of channels, including hard QCD, photoproduction and the total cross section. Pythia 8 for now.
• Two machine configurations combined. A lepton beam enters as a lepton or as the photon flux it radiates, never both in the same draw: the engine draws both and keeps from each the share that its cross section earns it.
• The reported cross section is the one after the last event. Pythia normalises after its loop; the driver wrote the running estimate, off by 12% over a few hundred events.
• The program is called TreeLevel Tools, and the executable treelevel-tools.exe.
• Jobs numbered, timestamped and kept in a list, which TreeLevel reopens; cross section read where each generator puts it.

TreeLevel Tools is under GPL v3 or later (see LICENSE.txt in the archive); each generator keeps its own licence, below.

Français

Le moteur qui fait tourner les générateurs Monte-Carlo pour TreeLevel sur Windows. Il s'installe en dépliant l'archive dans %LOCALAPPDATA%\Programs — pas de programme d'installation, rien dans le registre. Pour mettre à jour une version précédente : fermez TreeLevel, et dépliez l'archive au même endroit en remplaçant les fichiers.

Choisissez l'archive de votre machine : arm64 pour un PC Copilot+ ou une tablette ARM, x64 partout ailleurs. En cas de doute, la x64 fonctionne aussi sur ARM, en émulation.

Ce que l'archive contient : le moteur et le module Pythia 8 compilé pour cette architecture. Herwig, Sherpa, WHIZARD et CalcHEP passent par l'image de conteneur, qui demande Docker Desktop :

docker pull ghcr.io/gpasa/treelevel-tools

Rien d'autre à faire : TreeLevel crée lui-même un conteneur éphémère pour chaque travail. Docker Desktop doit être lancé quand TreeLevel démarre ; les générateurs de l'image apparaissent alors, marqués « (Docker) ».

Le moteur n'a pas de fenêtre. C'est TreeLevel qui le lance, à chaque besoin. Si vous double-cliquez treelevel-tools.exe, Windows SmartScreen avertit d'une application non reconnue — le moteur n'est pas signé — et, passé l'avertissement, une console affiche son mode d'emploi et se referme. C'est normal, et sans effet : vous n'avez jamais à le lancer vous-même.

Corrections de cette version

• L'image tirée sans numéro est reconnue. La 0.3.0 ne reconnaissait que l'étiquette :0.3.0 ; or la commande que propose la page du paquet, et celle que tout le monde tape, tire :latest. L'image était sur la machine, répondait quand on la lançait à la main, et TreeLevel n'offrait pourtant que Pythia. Les deux étiquettes désignent la même image, et les deux sont désormais reconnues.
• Sherpa sur des faisceaux de leptons, quand il tourne hors de l'image : sa section efficace n'est plus gonflée par le rayonnement initial de QED (une quinzaine de picobarns au lieu de 3,2 pour e⁻e⁺ → b b̄ à 200 GeV). La voie qui en dépendait — Sherpa installé soi-même dans WSL — sera retirée dans une prochaine version : Docker est la voie prévue.

Cinq générateurs, deux familles

Pythia 8 et Herwig 7 habillent les événements partoniques que TreeLevel leur donne : gerbe, hadronisation, désintégrations.

Sherpa 3, WHIZARD 3 et CalcHEP 3 n'ont pas de lecteur Les Houches — ils calculent eux-mêmes le processus décrit par le diagramme. Le protocole leur transmet donc une description du processus (faisceaux, énergies, état final, ordres de couplage) à côté des événements.

Mesuré : e⁻e⁺ → W⁺W⁻ à 200 GeV

moteur	σ
TreeLevel	19,22 pb
WHIZARD 3.1.6	19,441 ± 0,006 pb
CalcHEP 3.9.2	20,42 pb
Sherpa 3.0.5	18,2 ± 1,1 pb

Les écarts sont des choix de schéma de couplages, pas des erreurs.

Rappel : ce qu'apportait la 0.3.0

• Le mode collisionneur. Le générateur ne reçoit que les faisceaux et l'énergie, jamais un état final : il produit le mélange entier, comme une vraie machine, et TreeLevel compte ensuite les événements qui portent la signature du processus dessiné — ce qui mesure une section efficace au lieu de la calculer. Six familles de voies, dont la QCD dure, la photoproduction et la section efficace totale. Pythia 8 pour l'instant.
• Deux configurations de machine assemblées. Un faisceau de leptons entre comme lepton ou comme le flux de photons qu'il rayonne, jamais les deux dans un même tirage : le moteur tire les deux et garde de chacun la part que sa section efficace lui vaut.
• La section efficace rapportée est celle d'après le dernier événement. Pythia normalise après sa boucle ; le pilote écrivait l'estimation courante, fausse de 12 % sur quelques centaines d'événements.
• Le programme s'appelle TreeLevel Tools, et l'exécutable treelevel-tools.exe.
• Travaux numérotés, horodatés et conservés dans une liste, que TreeLevel rouvre ; section efficace lue là où chaque générateur la met.

TreeLevel Tools est sous GPL v3 ou ultérieure (voir LICENSE.txt dans l'archive) ; chaque générateur garde sa propre licence, ci-dessous.

Deutsch

Der Kern, der die Monte-Carlo-Generatoren für TreeLevel unter Windows ausführt. Er wird installiert, indem man das Archiv nach %LOCALAPPDATA%\Programs entpackt — kein Installationsprogramm, nichts in der Registrierung. Zum Aktualisieren einer früheren Version: TreeLevel schließen und das Archiv an derselben Stelle entpacken, wobei die vorhandenen Dateien ersetzt werden.

Wählen Sie das Archiv für Ihren Rechner: arm64 für einen Copilot+ PC oder ein ARM-Tablet, x64 überall sonst. Im Zweifel läuft die x64-Fassung auch auf ARM, unter Emulation.

Was das Archiv enthält: der Kern und das Pythia-8-Modul, für diese Architektur übersetzt. Herwig, Sherpa, WHIZARD und CalcHEP laufen über das Container-Image, das Docker Desktop voraussetzt:

docker pull ghcr.io/gpasa/treelevel-tools

Sonst ist nichts zu tun: TreeLevel legt selbst für jeden Auftrag einen kurzlebigen Container an. Docker Desktop muss laufen, wenn TreeLevel startet; die Generatoren des Images erscheinen dann, mit „(Docker)“ gekennzeichnet.

Der Kern hat kein Fenster. TreeLevel startet ihn, wann immer er gebraucht wird. Wenn Sie treelevel-tools.exe doppelklicken, warnt Windows SmartScreen vor einer nicht erkannten App — der Kern ist nicht signiert —, und nach der Warnung zeigt eine Konsole seine Gebrauchsanweisung und schließt sich wieder. Das ist normal und ohne Wirkung: Sie müssen ihn nie selbst starten.

Korrekturen in dieser Version

• Das ohne Nummer gezogene Image wird erkannt. 0.3.0 erkannte nur das Tag :0.3.0; der Befehl, den die Paketseite vorschlägt, und der, den alle eintippen, zieht aber :latest. Das Image war auf dem Rechner, antwortete, wenn man es von Hand startete, und dennoch bot TreeLevel nur Pythia an. Beide Tags bezeichnen dasselbe Image, und beide werden nun erkannt.
• Sherpa auf Leptonenstrahlen, wenn es außerhalb des Images läuft: Sein Wirkungsquerschnitt wird nicht mehr durch die QED-Anfangszustandsstrahlung aufgebläht (rund fünfzehn Pikobarn statt 3,2 für e⁻e⁺ → b b̄ bei 200 GeV). Der Weg, der davon abhing — Sherpa selbst in WSL installiert —, wird in einer kommenden Version entfernt: Docker ist der vorgesehene Weg.

Fünf Generatoren, zwei Familien

Pythia 8 und Herwig 7 kleiden die partonischen Ereignisse ein, die TreeLevel ihnen gibt: Schauer, Hadronisierung, Zerfälle.

Sherpa 3, WHIZARD 3 und CalcHEP 3 haben keinen Leser für Les Houches — sie berechnen den vom Diagramm beschriebenen Prozess selbst. Das Protokoll übermittelt ihnen daher neben den Ereignissen eine Beschreibung des Prozesses (Strahlen, Energien, Endzustand, Kopplungsordnungen).

Gemessen: e⁻e⁺ → W⁺W⁻ bei 200 GeV

Programm	σ
TreeLevel	19,22 pb
WHIZARD 3.1.6	19,441 ± 0,006 pb
CalcHEP 3.9.2	20,42 pb
Sherpa 3.0.5	18,2 ± 1,1 pb

Die Abweichungen gehen auf die Wahl des Kopplungsschemas zurück, nicht auf Fehler.

Zur Erinnerung: was 0.3.0 brachte

• Der Collider-Modus. Der Generator erhält nur die Strahlen und die Energie, nie einen Endzustand: Er erzeugt die ganze Mischung, wie eine echte Maschine, und TreeLevel zählt danach die Ereignisse, die die Signatur des gezeichneten Prozesses tragen — was einen Wirkungsquerschnitt misst, statt ihn zu berechnen. Sechs Familien von Kanälen, darunter harte QCD, Photoproduktion und der totale Wirkungsquerschnitt. Vorerst Pythia 8.
• Zwei Maschinenkonfigurationen zusammengefügt. Ein Leptonenstrahl tritt als Lepton oder als der von ihm abgestrahlte Photonenfluss ein, nie beides in derselben Ziehung: Der Kern zieht beide und behält von jeder den Anteil, der ihr nach ihrem Wirkungsquerschnitt zusteht.
• Der gemeldete Wirkungsquerschnitt ist der nach dem letzten Ereignis. Pythia normiert nach seiner Schleife; der Treiber schrieb die laufende Schätzung, die bei einigen hundert Ereignissen um 12 % danebenlag.
• Das Programm heißt TreeLevel Tools, und die ausführbare Datei treelevel-tools.exe.
• Aufträge nummeriert, mit Zeitstempel versehen und in einer Liste aufbewahrt, die TreeLevel wieder öffnet; Wirkungsquerschnitt dort gelesen, wo jeder Generator ihn ablegt.

TreeLevel Tools steht unter GPL v3 oder neuer (siehe LICENSE.txt im Archiv); jeder Generator behält seine eigene Lizenz, siehe unten.

Italiano

Il motore che fa girare i generatori Monte Carlo per TreeLevel su Windows. Si installa scompattando l'archivio in %LOCALAPPDATA%\Programs — nessun programma d'installazione, nulla nel registro. Per aggiornare una versione precedente: chiudete TreeLevel, e scompattate l'archivio nello stesso posto sostituendo i file.

Scegliete l'archivio della vostra macchina: arm64 per un PC Copilot+ o un tablet ARM, x64 ovunque altrove. Nel dubbio, la x64 funziona anche su ARM, in emulazione.

Che cosa contiene l'archivio: il motore e il modulo Pythia 8 compilato per questa architettura. Herwig, Sherpa, WHIZARD e CalcHEP passano dall'immagine container, che richiede Docker Desktop:

docker pull ghcr.io/gpasa/treelevel-tools

Nient'altro da fare: TreeLevel crea da sé un container effimero per ogni lavoro. Docker Desktop deve essere avviato quando TreeLevel parte; i generatori dell'immagine compaiono allora, contrassegnati «(Docker)».

Il motore non ha finestra. È TreeLevel a lanciarlo, a ogni necessità. Se fate doppio clic su treelevel-tools.exe, Windows SmartScreen avverte di un'applicazione non riconosciuta — il motore non è firmato — e, superato l'avviso, una console mostra le sue istruzioni d'uso e si richiude. È normale, e senza effetto: non dovete mai lanciarlo voi stessi.

Correzioni di questa versione

• L'immagine scaricata senza numero è riconosciuta. La 0.3.0 riconosceva solo il tag :0.3.0; ma il comando che propone la pagina del pacchetto, e quello che tutti digitano, scarica :latest. L'immagine era sulla macchina, rispondeva quando la si lanciava a mano, eppure TreeLevel offriva solo Pythia. I due tag designano la stessa immagine, ed entrambi sono ora riconosciuti.
• Sherpa su fasci di leptoni, quando gira fuori dall'immagine: la sua sezione d'urto non è più gonfiata dalla radiazione iniziale di QED (una quindicina di picobarn invece di 3,2 per e⁻e⁺ → b b̄ a 200 GeV). La via che ne dipendeva — Sherpa installato da sé in WSL — sarà rimossa in una prossima versione: Docker è la via prevista.

Cinque generatori, due famiglie

Pythia 8 e Herwig 7 vestono gli eventi partonici che TreeLevel dà loro: sciame, adronizzazione, decadimenti.

Sherpa 3, WHIZARD 3 e CalcHEP 3 non hanno un lettore Les Houches — calcolano da sé il processo descritto dal diagramma. Il protocollo trasmette loro quindi una descrizione del processo (fasci, energie, stato finale, ordini di accoppiamento) accanto agli eventi.

Misurato: e⁻e⁺ → W⁺W⁻ a 200 GeV

motore	σ
TreeLevel	19,22 pb
WHIZARD 3.1.6	19,441 ± 0,006 pb
CalcHEP 3.9.2	20,42 pb
Sherpa 3.0.5	18,2 ± 1,1 pb

Gli scarti sono scelte di schema degli accoppiamenti, non errori.

Promemoria: che cosa portava la 0.3.0

• La modalità collisore. Il generatore riceve solo i fasci e l'energia, mai uno stato finale: produce l'intera miscela, come una vera macchina, e TreeLevel conta poi gli eventi che portano la firma del processo disegnato — il che misura una sezione d'urto invece di calcolarla. Sei famiglie di canali, tra cui la QCD dura, la fotoproduzione e la sezione d'urto totale. Per ora Pythia 8.
• Due configurazioni di macchina assemblate. Un fascio di leptoni entra come leptone o come il flusso di fotoni che irraggia, mai entrambi in una stessa estrazione: il motore estrae entrambi e tiene di ciascuno la parte che la sua sezione d'urto gli vale.
• La sezione d'urto riportata è quella dopo l'ultimo evento. Pythia normalizza dopo il suo ciclo; il driver scriveva la stima corrente, sbagliata del 12 % su qualche centinaio di eventi.
• Il programma si chiama TreeLevel Tools, e l'eseguibile treelevel-tools.exe.
• Lavori numerati, datati e conservati in un elenco, che TreeLevel riapre; sezione d'urto letta là dove ogni generatore la mette.

TreeLevel Tools è sotto GPL v3 o successiva (vedi LICENSE.txt nell'archivio); ogni generatore mantiene la propria licenza, qui sotto.

Español

El motor que hace funcionar los generadores Monte Carlo para TreeLevel en Windows. Se instala desplegando el archivo en %LOCALAPPDATA%\Programs — sin instalador, nada en el registro. Para actualizar una versión anterior: cierre TreeLevel y despliegue el archivo en el mismo lugar, sustituyendo los ficheros.

Elija el archivo de su máquina: arm64 para un PC Copilot+ o una tableta ARM, x64 en todos los demás casos. En caso de duda, el x64 funciona también en ARM, en emulación.

Lo que contiene el archivo: el motor y el módulo Pythia 8 compilado para esta arquitectura. Herwig, Sherpa, WHIZARD y CalcHEP pasan por la imagen de contenedor, que exige Docker Desktop:

docker pull ghcr.io/gpasa/treelevel-tools

No hay nada más que hacer: TreeLevel crea por sí mismo un contenedor efímero para cada trabajo. Docker Desktop debe estar en marcha cuando TreeLevel arranca; los generadores de la imagen aparecen entonces, marcados «(Docker)».

El motor no tiene ventana. Es TreeLevel quien lo lanza, cada vez que hace falta. Si hace doble clic en treelevel-tools.exe, Windows SmartScreen advierte de una aplicación no reconocida — el motor no está firmado — y, superada la advertencia, una consola muestra sus instrucciones de uso y se cierra. Es normal, y no tiene ningún efecto: nunca tiene que lanzarlo usted mismo.

Correcciones de esta versión

• Se reconoce la imagen descargada sin número. La 0.3.0 solo reconocía la etiqueta :0.3.0; ahora bien, el comando que propone la página del paquete, y el que escribe todo el mundo, descarga :latest. La imagen estaba en la máquina, respondía cuando se lanzaba a mano, y sin embargo TreeLevel solo ofrecía Pythia. Las dos etiquetas designan la misma imagen, y ahora se reconocen ambas.
• Sherpa sobre haces de leptones, cuando funciona fuera de la imagen: su sección eficaz ya no está inflada por la radiación inicial de QED (unos quince picobarns en lugar de 3,2 para e⁻e⁺ → b b̄ a 200 GeV). La vía que dependía de ello — Sherpa instalado por uno mismo en WSL — se retirará en una próxima versión: Docker es la vía prevista.

Cinco generadores, dos familias

Pythia 8 y Herwig 7 visten los sucesos partónicos que TreeLevel les da: cascada, hadronización, desintegraciones.

Sherpa 3, WHIZARD 3 y CalcHEP 3 no tienen lector Les Houches — calculan por sí mismos el proceso descrito por el diagrama. Por eso el protocolo les transmite una descripción del proceso (haces, energías, estado final, órdenes de acoplamiento) junto a los sucesos.

Medido: e⁻e⁺ → W⁺W⁻ a 200 GeV

motor	σ
TreeLevel	19,22 pb
WHIZARD 3.1.6	19,441 ± 0,006 pb
CalcHEP 3.9.2	20,42 pb
Sherpa 3.0.5	18,2 ± 1,1 pb

Las diferencias se deben a la elección del esquema de acoplamientos, no a errores.

Recordatorio: lo que trajo la 0.3.0

• El modo colisionador. El generador solo recibe los haces y la energía, nunca un estado final: produce la mezcla entera, como una máquina real, y TreeLevel cuenta después los sucesos que llevan la firma del proceso dibujado — lo que mide una sección eficaz en lugar de calcularla. Seis familias de canales, entre ellas la QCD dura, la fotoproducción y la sección eficaz total. Por ahora, Pythia 8.
• Dos configuraciones de máquina combinadas. Un haz de leptones entra como leptón o como el flujo de fotones que radia, nunca ambos en una misma generación: el motor genera los dos y conserva de cada uno la parte que le corresponde según su sección eficaz.
• La sección eficaz indicada es la posterior al último suceso. Pythia normaliza después de su bucle; el controlador escribía la estimación en curso, errónea en un 12 % sobre unos cientos de sucesos.
• El programa se llama TreeLevel Tools, y el ejecutable treelevel-tools.exe.
• Trabajos numerados, con fecha y hora y conservados en una lista, que TreeLevel vuelve a abrir; sección eficaz leída allí donde cada generador la pone.

TreeLevel Tools está bajo GPL v3 o posterior (véase LICENSE.txt en el archivo); cada generador conserva su propia licencia, más abajo.

Português (Brasil)

O motor que roda os geradores Monte Carlo para o TreeLevel no Windows. Ele é instalado descompactando o arquivo em %LOCALAPPDATA%\Programs — sem instalador, nada no registro. Para atualizar uma versão anterior: feche o TreeLevel e descompacte o arquivo no mesmo lugar, substituindo os arquivos existentes.

Escolha o arquivo da sua máquina: arm64 para um PC Copilot+ ou um tablet ARM, x64 em todos os outros casos. Na dúvida, o x64 também funciona no ARM, em emulação.

O que o arquivo contém: o motor e o módulo Pythia 8 compilado para esta arquitetura. Herwig, Sherpa, WHIZARD e CalcHEP passam pela imagem de contêiner, que exige o Docker Desktop:

docker pull ghcr.io/gpasa/treelevel-tools

Não há mais nada a fazer: o próprio TreeLevel cria um contêiner efêmero para cada trabalho. O Docker Desktop precisa estar em execução quando o TreeLevel é iniciado; os geradores da imagem aparecem então, marcados “(Docker)”.

O motor não tem janela. É o TreeLevel que o inicia, sempre que necessário. Se você clicar duas vezes em treelevel-tools.exe, o Windows SmartScreen avisa sobre um aplicativo não reconhecido — o motor não é assinado — e, passado o aviso, um console mostra suas instruções de uso e se fecha. É normal, e não tem efeito algum: você nunca precisa iniciá-lo por conta própria.

Correções desta versão

• A imagem baixada sem número é reconhecida. A 0.3.0 só reconhecia a etiqueta :0.3.0; ora, o comando que a página do pacote propõe, e o que todo mundo digita, baixa :latest. A imagem estava na máquina, respondia quando era iniciada à mão, e mesmo assim o TreeLevel só oferecia o Pythia. As duas etiquetas designam a mesma imagem, e agora ambas são reconhecidas.
• Sherpa com feixes de léptons, quando roda fora da imagem: sua seção de choque não é mais inflada pela radiação inicial de QED (uns quinze picobarns em vez de 3,2 para e⁻e⁺ → b b̄ a 200 GeV). A via que dependia disso — o Sherpa instalado por conta própria no WSL — será removida em uma próxima versão: o Docker é a via prevista.

Cinco geradores, duas famílias

Pythia 8 e Herwig 7 completam os eventos partônicos que o TreeLevel lhes entrega: chuveiro, hadronização, decaimentos.

Sherpa 3, WHIZARD 3 e CalcHEP 3 não têm leitor Les Houches — eles mesmos calculam o processo descrito pelo diagrama. Por isso o protocolo lhes transmite uma descrição do processo (feixes, energias, estado final, ordens de acoplamento) junto com os eventos.

Medido: e⁻e⁺ → W⁺W⁻ a 200 GeV

motor	σ
TreeLevel	19,22 pb
WHIZARD 3.1.6	19,441 ± 0,006 pb
CalcHEP 3.9.2	20,42 pb
Sherpa 3.0.5	18,2 ± 1,1 pb

As diferenças vêm da escolha do esquema de acoplamentos, não de erros.

Lembrete: o que a 0.3.0 trouxe

• O modo colisor. O gerador recebe apenas os feixes e a energia, nunca um estado final: produz a mistura inteira, como uma máquina real, e o TreeLevel conta em seguida os eventos que trazem a assinatura do processo desenhado — o que mede uma seção de choque em vez de calculá-la. Seis famílias de canais, entre elas a QCD dura, a fotoprodução e a seção de choque total. Por enquanto, Pythia 8.
• Duas configurações de máquina combinadas. Um feixe de léptons entra como lépton ou como o fluxo de fótons que ele irradia, nunca os dois em uma mesma geração: o motor gera os dois e guarda de cada um a parte que lhe cabe segundo sua seção de choque.
• A seção de choque informada é a de depois do último evento. O Pythia normaliza após o seu laço; o driver escrevia a estimativa corrente, errada em 12 % com algumas centenas de eventos.
• O programa se chama TreeLevel Tools, e o executável treelevel-tools.exe.
• Trabalhos numerados, com data e hora e guardados em uma lista, que o TreeLevel reabre; seção de choque lida onde cada gerador a coloca.

O TreeLevel Tools é GPL v3 ou posterior (veja LICENSE.txt no arquivo); cada gerador mantém sua própria licença, abaixo.

Русский

Ядро, которое запускает генераторы Монте-Карло для TreeLevel в Windows. Устанавливается распаковкой архива в %LOCALAPPDATA%\Programs — ни установщика, ни записей в реестре. Чтобы обновить предыдущую версию: закройте TreeLevel и распакуйте архив в то же место, заменив файлы.

Выберите архив для своей машины: arm64 для ПК Copilot+ или планшета на ARM, x64 во всех остальных случаях. В случае сомнений x64 работает и на ARM, под эмуляцией.

Что содержит архив: ядро и модуль Pythia 8, скомпилированный для этой архитектуры. Herwig, Sherpa, WHIZARD и CalcHEP идут через образ контейнера, которому нужен Docker Desktop:

docker pull ghcr.io/gpasa/treelevel-tools

Больше ничего делать не нужно: TreeLevel сам создаёт временный контейнер для каждого задания. Docker Desktop должен быть запущен, когда стартует TreeLevel; тогда появляются генераторы образа с пометкой «(Docker)».

У ядра нет окна. Его запускает TreeLevel, всякий раз, когда это нужно. Если дважды щёлкнуть treelevel-tools.exe, Windows SmartScreen предупредит о нераспознанном приложении — ядро не подписано, — а после предупреждения консоль покажет инструкцию по использованию и закроется. Это нормально и ни на что не влияет: вам никогда не нужно запускать его самостоятельно.

Исправления в этой версии

• Образ, скачанный без номера, распознаётся. 0.3.0 распознавала только тег :0.3.0; между тем команда, которую предлагает страница пакета, и та, которую набирают все, скачивает :latest. Образ был на машине, отвечал при запуске вручную, и всё же TreeLevel предлагал только Pythia. Оба тега обозначают один и тот же образ, и теперь распознаются оба.
• Sherpa на лептонных пучках, когда он работает вне образа: его сечение больше не завышено начальным излучением КЭД (около пятнадцати пикобарн вместо 3,2 для e⁻e⁺ → b b̄ при 200 GeV). Путь, который от этого зависел, — Sherpa, самостоятельно установленный в WSL, — будет удалён в одной из следующих версий: предусмотренный путь — Docker.

Пять генераторов, два семейства

Pythia 8 и Herwig 7 достраивают партонные события, которые им передаёт TreeLevel: ливень, адронизация, распады.

У Sherpa 3, WHIZARD 3 и CalcHEP 3 нет считывателя Les Houches — они сами вычисляют процесс, описанный диаграммой. Поэтому протокол передаёт им, наряду с событиями, описание процесса (пучки, энергии, конечное состояние, порядки по константам связи).

Измерено: e⁻e⁺ → W⁺W⁻ при 200 GeV

программа	σ
TreeLevel	19,22 pb
WHIZARD 3.1.6	19,441 ± 0,006 pb
CalcHEP 3.9.2	20,42 pb
Sherpa 3.0.5	18,2 ± 1,1 pb

Расхождения объясняются выбором схемы констант связи, а не ошибками.

Напоминание: что принесла 0.3.0

• Режим коллайдера. Генератор получает только пучки и энергию, никогда — конечное состояние: он производит всю смесь, как настоящий ускоритель, а TreeLevel затем подсчитывает события, несущие сигнатуру нарисованного процесса, — так сечение измеряется, а не вычисляется. Шесть семейств каналов, в том числе жёсткая КХД, фоторождение и полное сечение. Пока только Pythia 8.
• Две конфигурации ускорителя, собранные вместе. Лептонный пучок входит либо как лептон, либо как поток фотонов, который он излучает, но никогда не как то и другое в одном розыгрыше: ядро разыгрывает оба варианта и оставляет от каждого долю, которая соответствует его сечению.
• Сообщаемое сечение — это сечение после последнего события. Pythia нормирует после своего цикла; управляющая программа записывала текущую оценку, ошибочную на 12 % при нескольких сотнях событий.
• Программа называется TreeLevel Tools, а исполняемый файл — treelevel-tools.exe.
• Задания пронумерованы, снабжены отметкой времени и хранятся в списке, который TreeLevel открывает снова; сечение считывается там, куда его помещает каждый генератор.

TreeLevel Tools распространяется под GPL v3 или более поздней (см. LICENSE.txt в архиве); у каждого генератора своя лицензия, см. ниже.

简体中文

本引擎为 Windows 上的 TreeLevel 运行蒙特卡罗生成器。安装方法是把压缩包解压到 %LOCALAPPDATA%\Programs——没有安装程序，注册表里什么也不留。要更新旧版本：关闭 TreeLevel，把压缩包解压到同一位置，替换原有文件。

选择与您的机器相符的压缩包：Copilot+ PC 或 ARM 平板用 arm64，其他情况一律用 x64。拿不准时，x64 版本在 ARM 上也能以模拟方式运行。

压缩包内容：引擎以及为该架构编译的 Pythia 8 模块。Herwig、Sherpa、WHIZARD 与 CalcHEP 经由容器镜像运行，这需要 Docker Desktop：

docker pull ghcr.io/gpasa/treelevel-tools

无需其他操作：TreeLevel 会为每个作业自行创建一个临时容器。TreeLevel 启动时 Docker Desktop 必须已在运行；镜像中的生成器随即出现，并标有“(Docker)”。

引擎没有窗口。它由 TreeLevel 在需要时启动。如果您双击 treelevel-tools.exe，Windows SmartScreen 会警告这是一个无法识别的应用——引擎没有签名——越过警告后，会有一个控制台显示其使用说明，随即关闭。这是正常的，也不会产生任何影响：您永远不需要自己启动它。

本版本的修正

• 不带版本号拉取的镜像能被识别了。0.3.0 只识别标签 :0.3.0；而软件包页面给出的命令、也是大家都会输入的命令，拉取的是 :latest。镜像就在机器上，手动启动时也有响应，TreeLevel 却只提供 Pythia。两个标签指向同一个镜像，现在两者都能被识别。
• 轻子束流上的 Sherpa，在镜像之外运行时：其截面不再被 QED 初态辐射抬高（对 200 GeV 下的 e⁻e⁺ → b b̄，约十五皮靶，而非 3.2）。依赖于此的途径——在 WSL 中自行安装 Sherpa——将在后续版本中移除：Docker 是预定的途径。

五个生成器，两个家族

Pythia 8 与 Herwig 7 为 TreeLevel 交给它们的部分子事件补全物理：簇射、强子化、衰变。

Sherpa 3、WHIZARD 3 与 CalcHEP 3 没有 Les Houches 读取器——它们自行计算图所描述的过程。因此，协议在事件之外还向它们传递过程的描述（束流、能量、末态、耦合阶数）。

实测：200 GeV 下的 e⁻e⁺ → W⁺W⁻

引擎	σ
TreeLevel	19.22 pb
WHIZARD 3.1.6	19.441 ± 0.006 pb
CalcHEP 3.9.2	20.42 pb
Sherpa 3.0.5	18.2 ± 1.1 pb

差异来自耦合方案的选择，而非错误。

回顾：0.3.0 带来的内容

• 对撞机模式。生成器只接收束流和能量，从不接收末态：它像一台真正的加速器那样产生完整的混合，TreeLevel 随后统计带有所画过程特征的事件——这是在测量截面，而不是计算截面。共有六类道，其中包括硬 QCD、光致产生和总截面。目前仅限 Pythia 8。
• 两种加速器配置的组合。轻子束流要么作为轻子进入，要么作为它所辐射的光子流进入，从不在同一次抽样中兼为两者：引擎对两者都进行抽样，并从每一种中保留其截面所对应的份额。
• 报告的截面是最后一个事件之后的值。Pythia 在其循环结束后进行归一化；驱动程序原先写出的是当前的估计值，在几百个事件上偏差 12%。
• 程序名为 TreeLevel Tools，可执行文件为 treelevel-tools.exe。
• 作业带编号、带时间戳并保存在列表中，可由 TreeLevel 重新打开；截面从每个生成器存放它的位置读取。

TreeLevel Tools 以 GPL v3 或更高版本发布（见压缩包中的 LICENSE.txt）；每个生成器保留其自身的许可证，见下文。

日本語

Windows 上の TreeLevel のためにモンテカルロ生成器を動かすエンジンです。書庫を %LOCALAPPDATA%\Programs に展開するだけでインストールできます——インストーラもなく、レジストリにも何も残しません。以前のバージョンを更新するには、TreeLevel を閉じ、書庫を同じ場所に展開してファイルを置き換えます。

お使いのマシンに合う書庫を選んでください：Copilot+ PC や ARM タブレットなら arm64、それ以外はすべて x64。迷ったら、x64 版も ARM でエミュレーションで動きます。

書庫の内容：エンジンと、このアーキテクチャ向けにコンパイルされた Pythia 8 モジュール。Herwig、Sherpa、WHIZARD、CalcHEP はコンテナイメージを通ります。それには Docker Desktop が必要です：

docker pull ghcr.io/gpasa/treelevel-tools

ほかに必要なことはありません：TreeLevel がジョブごとに使い捨てのコンテナを自ら作ります。TreeLevel の起動時に Docker Desktop が動いている必要があります。そうすれば、イメージの生成器が「(Docker)」の印付きで現れます。

エンジンにはウィンドウがありません。必要になるたびに TreeLevel が起動します。treelevel-tools.exe をダブルクリックすると、Windows SmartScreen が認識されないアプリだと警告します——エンジンは署名されていません——。警告を越えると、コンソールが使い方を表示して閉じます。これは正常で、何の影響もありません：自分で起動する必要は一切ありません。

このバージョンの修正

• 番号なしで pull したイメージが認識されます。0.3.0 はタグ :0.3.0 しか認識しませんでした。ところが、パッケージのページが示すコマンド、そして誰もが打つコマンドは :latest を pull します。イメージはマシンにあり、手で起動すれば応答したのに、TreeLevel は Pythia しか提示しませんでした。二つのタグは同じイメージを指しており、今はどちらも認識されます。
• レプトンビームでの Sherpa（イメージの外で動かす場合）：その断面積が QED の始状態放射で膨らまなくなりました（200 GeV での e⁻e⁺ → b b̄ で、3.2 ではなく十五ピコバーンほど）。これに頼っていた経路——WSL に自分でインストールした Sherpa——は今後のバージョンで削除されます：Docker が想定された経路です。

五つの生成器、二つの系統

Pythia 8 と Herwig 7 は、TreeLevel が渡すパートンのイベントに肉付けします：シャワー、ハドロン化、崩壊。

Sherpa 3、WHIZARD 3、CalcHEP 3 には Les Houches リーダーがありません——ダイアグラムが表す過程を自ら計算します。そこでプロトコルは、イベントと並べて過程の記述（ビーム、エネルギー、終状態、結合の次数）を渡します。

測定：200 GeV での e⁻e⁺ → W⁺W⁻

エンジン	σ
TreeLevel	19.22 pb
WHIZARD 3.1.6	19.441 ± 0.006 pb
CalcHEP 3.9.2	20.42 pb
Sherpa 3.0.5	18.2 ± 1.1 pb

差は結合定数のスキームの選び方によるもので、誤りではありません。

おさらい：0.3.0 がもたらしたもの

• コライダーモード。生成器が受け取るのはビームとエネルギーだけで、終状態は決して受け取りません：本物の加速器のように混合全体を生み出し、TreeLevel はそのあと、描かれた過程の特徴を持つイベントを数えます——断面積を計算する代わりに測定するのです。六つのチャンネル群があり、ハード QCD、光生成、全断面積を含みます。今のところ Pythia 8 のみです。
• 二つの加速器構成の組み合わせ。レプトンビームはレプトンとして、あるいはそれが放射する光子のフラックスとして入り、同じ試行で両方になることはありません：エンジンは両方を生成し、それぞれの断面積に見合った割合を各々から残します。
• 報告される断面積は最後のイベントの後の値です。Pythia はループの後で規格化します。ドライバは途中の推定値を書いており、数百イベントでは 12% ずれていました。
• プログラムの名前は TreeLevel Tools、実行ファイルは treelevel-tools.exe です。
• ジョブには番号と日時が付き、一覧に保存され、TreeLevel が開き直せます。断面積は各生成器が置く場所から読み取ります。

TreeLevel Tools は GPL v3 以降のもとにあります（書庫の LICENSE.txt を参照）。各生成器はそれぞれのライセンスを保ちます。下記を参照してください。

한국어

Windows에서 TreeLevel을 위해 몬테카를로 생성기를 돌리는 엔진입니다. 압축 파일을 %LOCALAPPDATA%\Programs에 풀기만 하면 설치됩니다—설치 프로그램도 없고 레지스트리에 남는 것도 없습니다. 이전 버전을 업데이트하려면 TreeLevel을 닫고, 압축 파일을 같은 자리에 풀어 파일을 덮어쓰십시오.

여러분의 컴퓨터에 맞는 압축 파일을 고르십시오: Copilot+ PC나 ARM 태블릿이면 arm64, 그 밖에는 모두 x64. 헷갈릴 때는 x64판도 ARM에서 에뮬레이션으로 돌아갑니다.

압축 파일의 내용: 엔진과, 이 아키텍처용으로 컴파일된 Pythia 8 모듈. Herwig, Sherpa, WHIZARD, CalcHEP은 컨테이너 이미지를 거치며, 이 이미지에는 Docker Desktop이 필요합니다:

docker pull ghcr.io/gpasa/treelevel-tools

더 할 일은 없습니다: TreeLevel이 작업마다 일회용 컨테이너를 직접 만듭니다. TreeLevel이 시작할 때 Docker Desktop이 실행 중이어야 하며, 그러면 이미지의 생성기가 ‘(Docker)’ 표시를 달고 나타납니다.

엔진에는 창이 없습니다. TreeLevel이 필요할 때마다 실행합니다. treelevel-tools.exe를 더블클릭하면 Windows SmartScreen이 인식할 수 없는 앱이라고 경고합니다—엔진은 서명되어 있지 않습니다—. 경고를 넘기면 콘솔이 사용법을 보여 주고 닫힙니다. 정상이며, 아무 영향도 없습니다: 여러분이 직접 실행할 일은 전혀 없습니다.

이번 버전의 수정 사항

• 번호 없이 받은 이미지를 인식합니다. 0.3.0은 :0.3.0 태그만 인식했습니다. 그런데 패키지 페이지가 제시하는 명령, 그리고 누구나 입력하는 명령은 :latest를 받습니다. 이미지는 컴퓨터에 있었고 손으로 실행하면 응답했는데도, TreeLevel은 Pythia만 제공했습니다. 두 태그는 같은 이미지를 가리키며, 이제 둘 다 인식됩니다.
• 렙톤 빔에서의 Sherpa, 이미지 밖에서 실행될 때: 그 단면적이 더 이상 QED 초기 상태 복사로 부풀려지지 않습니다(200 GeV에서 e⁻e⁺ → b b̄에 대해 3.2 대신 열다섯 피코반가량). 이것에 의존하던 경로—WSL에 직접 설치한 Sherpa—는 다음 버전에서 제거됩니다: Docker가 예정된 경로입니다.

생성기 다섯, 두 계열

Pythia 8과 Herwig 7은 TreeLevel이 넘겨주는 파톤 사건을 완성합니다: 샤워, 강입자화, 붕괴.

Sherpa 3, WHIZARD 3, CalcHEP 3에는 Les Houches 판독기가 없습니다—다이어그램이 기술하는 과정을 직접 계산합니다. 그래서 프로토콜은 사건과 나란히 과정의 기술(빔, 에너지, 최종 상태, 결합 차수)을 이들에게 전달합니다.

측정: 200 GeV에서 e⁻e⁺ → W⁺W⁻

엔진	σ
TreeLevel	19.22 pb
WHIZARD 3.1.6	19.441 ± 0.006 pb
CalcHEP 3.9.2	20.42 pb
Sherpa 3.0.5	18.2 ± 1.1 pb

차이는 결합 스킴의 선택에서 오는 것이지, 오류가 아닙니다.

다시 보기: 0.3.0이 가져온 것

• 충돌기 모드. 생성기는 빔과 에너지만 받을 뿐 최종 상태는 결코 받지 않습니다: 진짜 가속기처럼 혼합 전체를 만들어 내고, TreeLevel은 그다음 그려진 과정의 특징을 지닌 사건을 셉니다—단면적을 계산하는 대신 측정하는 것입니다. 채널 계열은 여섯 가지이며, 그중에는 경성 QCD, 광생성, 전체 단면적이 있습니다. 지금은 Pythia 8만 해당합니다.
• 두 가지 가속기 구성의 조합. 렙톤 빔은 렙톤으로, 또는 그것이 복사하는 광자 선속으로 들어가며, 한 번의 추출에서 둘 다가 되는 일은 없습니다: 엔진은 둘 다 추출하고, 각각의 단면적에 해당하는 몫을 각각에서 남깁니다.
• 보고되는 단면적은 마지막 사건 이후의 값입니다. Pythia는 루프가 끝난 뒤에 정규화합니다. 드라이버는 진행 중인 추정값을 쓰고 있었고, 이는 수백 개 사건에서 12% 어긋났습니다.
• 프로그램 이름은 TreeLevel Tools, 실행 파일은 treelevel-tools.exe입니다.
• 작업에는 번호와 시각이 매겨지고 목록에 보관되며, TreeLevel이 다시 열 수 있습니다. 단면적은 각 생성기가 두는 곳에서 읽습니다.

TreeLevel Tools는 GPL v3 이상을 따릅니다(압축 파일 안의 LICENSE.txt 참조). 각 생성기는 저마다의 사용권을 유지합니다. 아래를 보십시오.

हिन्दी

वह इंजन जो Windows पर TreeLevel के लिए मोंटे कार्लो जनक चलाता है। इसे स्थापित करने के लिए आर्काइव को %LOCALAPPDATA%\Programs में निकालिए — कोई संस्थापक नहीं, रजिस्ट्री में कुछ नहीं। पिछले संस्करण को अद्यतन करने के लिए: TreeLevel बंद करें, और आर्काइव उसी जगह निकालें, फ़ाइलों को बदलते हुए।

अपनी मशीन का आर्काइव चुनिए: Copilot+ PC या ARM टैबलेट के लिए arm64, बाकी हर जगह x64। संदेह हो तो x64 भी ARM पर, अनुकरण के सहारे, चलता है।

आर्काइव में क्या है: इंजन और इस वास्तुकला के लिए संकलित Pythia 8 मॉड्यूल। Herwig, Sherpa, WHIZARD और CalcHEP कंटेनर इमेज के माध्यम से चलते हैं, जिसके लिए Docker Desktop चाहिए:

docker pull ghcr.io/gpasa/treelevel-tools

और कुछ करने की ज़रूरत नहीं: TreeLevel हर कार्य के लिए स्वयं एक अल्पकालिक कंटेनर बनाता है। TreeLevel शुरू होते समय Docker Desktop चालू होना चाहिए; तब इमेज के जनक दिखाई देते हैं, उनके बाद “(Docker)” लिखा होता है।

इंजन की कोई विंडो नहीं है। इसे TreeLevel ही, जब भी ज़रूरत हो, शुरू करता है। यदि आप treelevel-tools.exe पर डबल-क्लिक करें, तो Windows SmartScreen एक अपरिचित ऐप्लिकेशन की चेतावनी देता है — इंजन हस्ताक्षरित नहीं है — और चेतावनी के बाद एक कंसोल उसके उपयोग का तरीका दिखाकर बंद हो जाता है। यह सामान्य है, और इसका कोई प्रभाव नहीं: आपको इसे कभी स्वयं शुरू करने की ज़रूरत नहीं।

इस संस्करण के सुधार

• बिना संख्या के खींची गई इमेज पहचानी जाती है। 0.3.0 केवल :0.3.0 टैग पहचानता था; जबकि पैकेज का पृष्ठ जो आदेश सुझाता है, और जिसे सब टाइप करते हैं, वह :latest खींचता है। इमेज मशीन पर थी, हाथ से चलाने पर उत्तर देती थी, फिर भी TreeLevel केवल Pythia प्रस्तुत करता था। दोनों टैग एक ही इमेज को दर्शाते हैं, और अब दोनों पहचाने जाते हैं।
• लेप्टॉन किरणपुंजों पर Sherpa, जब वह इमेज के बाहर चलता है: उसका अनुप्रस्थ काट अब QED के प्रारंभिक विकिरण से बढ़ा हुआ नहीं होता (200 GeV पर e⁻e⁺ → b b̄ के लिए 3.2 के बजाय लगभग पंद्रह पिकोबार्न)। जो रास्ता इस पर निर्भर था — WSL में स्वयं स्थापित Sherpa — वह किसी आगामी संस्करण में हटा दिया जाएगा: Docker ही नियत रास्ता है।

पाँच जनक, दो परिवार

Pythia 8 और Herwig 7 उन पार्टनी घटनाओं को पूर्ण करते हैं जो TreeLevel उन्हें देता है: शावर, हैड्रॉनीकरण, क्षय।

Sherpa 3, WHIZARD 3 और CalcHEP 3 के पास Les Houches पाठक नहीं है — वे आरेख द्वारा वर्णित प्रक्रिया की गणना स्वयं करते हैं। इसलिए प्रोटोकॉल उन्हें घटनाओं के साथ प्रक्रिया का एक विवरण (किरणपुंज, ऊर्जाएँ, अंतिम अवस्था, युग्मन कोटियाँ) भेजता है।

मापा गया: 200 GeV पर e⁻e⁺ → W⁺W⁻

प्रोग्राम	σ
TreeLevel	19.22 pb
WHIZARD 3.1.6	19.441 ± 0.006 pb
CalcHEP 3.9.2	20.42 pb
Sherpa 3.0.5	18.2 ± 1.1 pb

अंतर युग्मन-योजना के चुनावों से हैं, त्रुटियों से नहीं।

स्मरण: 0.3.0 क्या लाया था

• कोलाइडर मोड। जनक को केवल किरणपुंज और ऊर्जा मिलती है, कभी अंतिम अवस्था नहीं: वह एक असली त्वरक की तरह पूरा मिश्रण उत्पन्न करता है, और फिर TreeLevel उन घटनाओं को गिनता है जिनमें आरेखित प्रक्रिया का चिह्न होता है — इससे अनुप्रस्थ काट की गणना के बजाय उसका मापन होता है। चैनलों के छह परिवार, जिनमें कठोर QCD, फ़ोटो-उत्पादन और कुल अनुप्रस्थ काट शामिल हैं। अभी केवल Pythia 8।
• त्वरक के दो विन्यास, एक साथ जोड़े गए। लेप्टॉन किरणपुंज या तो लेप्टॉन के रूप में प्रवेश करता है या अपने द्वारा विकिरित फ़ोटॉन प्रवाह के रूप में, एक ही प्रतिचयन में कभी दोनों नहीं: इंजन दोनों का प्रतिचयन करता है और हर एक का उतना अंश रखता है जितना उसका अनुप्रस्थ काट उसे देता है।
• बताया गया अनुप्रस्थ काट अंतिम घटना के बाद का है। Pythia अपने लूप के बाद सामान्यीकरण करता है; ड्राइवर चालू अनुमान लिखता था, जो कुछ सौ घटनाओं पर 12% गलत था।
• प्रोग्राम का नाम TreeLevel Tools है, और निष्पाद्य फ़ाइल का treelevel-tools.exe।
• कार्य क्रमांकित, समय-अंकित और एक सूची में सुरक्षित, जिसे TreeLevel फिर से खोलता है; अनुप्रस्थ काट वहीं से पढ़ा जाता है जहाँ हर जनक उसे रखता है।

TreeLevel Tools GPL v3 या उसके बाद के संस्करण के अंतर्गत है (आर्काइव में LICENSE.txt देखें); हर जनक का अपना लाइसेंस बना रहता है, नीचे देखें।

Links and credits — the generators, their authors and what to cite: CREDITS.md · in your language