TreeLevelInstalação
Primeiro a aplicação, depois os geradores — e só se os quiser. O TreeLevel calcula e gera eventos sozinho; os geradores externos servem para vesti-los com um chuveiro e uma hadronização, ou para comparar.
Uma aplicação, e nada mais a instalar: o TreeLevel calcula e gera os seus eventos ele mesmo.
A aplicação
O TreeLevel compra-se na Mac App Store. Pede macOS 14 Sonoma ou mais recente, e roda nativamente em Apple silicon como em Intel. A compra é universal: a versão para iPad está incluída.
O TreeLevel compra-se na App Store. Pede iPadOS 17 ou mais recente. A compra é universal: a versão para Mac está incluída.
No iPad há um único gerador externo: Pythia 8, compilado em WebAssembly e executado dentro do app, sem enviar nada. Ele não faz parte do app: é baixado pelos ajustes — veja abaixo. Herwig, Sherpa, WHIZARD, CalcHEP e o contêiner ficam no Mac e no PC: são programas separados, que o iPad não permite executar. A geração própria do TreeLevel, em nível partônico, funciona em toda parte.
O TreeLevel compra-se na Microsoft Store. Pede Windows 10 versão 2004 ou mais recente, ou Windows 11, e roda nativamente em x64 como em ARM64 — um PC Copilot+ recebe a versão ARM64, não emulação.
Por que os geradores ficam à parte
Pythia, Herwig, Sherpa, WHIZARD e CalcHEP são publicados sob licença GPL. Ligá-los a uma aplicação vendida numa loja levantaria um problema de licença, e distribuí-los juntos levantaria outro. Vivem portanto num programa separado, o TreeLevel Tools, que você instala e que o TreeLevel detecta se estiver presente.
Nada passa pela rede: o TreeLevel escreve uma pasta de trabalho no seu disco, o programa a lê, calcula, e escreve os eventos ao lado. Se nenhum gerador estiver instalado, o TreeLevel atém-se ao seu próprio nível partônico, que basta para tudo o que o espaço Cálculo faz.
TreeLevel ToolsMódulo Pythia 8
Um único download, que traz o motor e quatro geradores compilados para a sua máquina: Pythia 8 e Herwig 7, que vestem os eventos calculados pelo TreeLevel — chuveiro, hadronização, decaimentos —, além de Sherpa 3 e CalcHEP 3, que calculam eles próprios o processo descrito pelo diagrama. Nada mais a instalar.
Um único download, que traz o motor e o módulo Pythia 8 compilado para a sua máquina. Os outros geradores passam pelo contêiner, mais abaixo.
Pegue o .dmg na página das versões e arraste o TreeLevel Tools para os seus Aplicativos. A aplicação é assinada e autenticada pela Apple: o macOS a verifica em silêncio e só pede, na primeira vez, confirmação para abrir um programa baixado.
Pegue o arquivo que corresponde à sua máquina na página das versões — TreeLevelTools-versão-x64.zip ou -arm64.zip, cerca de 45 MB — e descompacte-o em:
%LOCALAPPDATA%\ProgramsÉ toda a instalação: sem instalador, nada no registro. O TreeLevel procura ali, depois no PATH. Para apagá-lo, exclua a pasta.
Se não souber qual arquitetura tem: Configurações › Sistema › Sobre, linha Tipo de sistema. Na dúvida, a versão x64 funciona em toda parte, em emulação no ARM.
Sem TreeLevel Tools no iPad: o Pythia 8 é instalado ali como módulo, pelos ajustes (a engrenagem da barra de ferramentas), cartão Módulo Pythia 8. Pythia é software livre sob licença GPL: o app não o contém, ele o baixa da página de versões do TreeLevel Tools e verifica cada arquivo pela impressão SHA-256 antes de instalá-lo. Duas partes:
| Pythia 8.318 | cerca de 14 MB, botão Baixar: chuveiro partônico, hadronização, decaimentos e a fonte Máquina |
|---|---|
| Dados dos hádrons | cerca de 55 MB, opcionais, botão Adicionar: as densidades de pártons, que dizem como a energia de um próton se reparte entre seus quarks e glúons; sem elas, um feixe de prótons ou de píons é recusado |
Ambas se removem no mesmo cartão, botão Remover.
O que cada pacote contém, suas versões e os autores dos geradores: TreeLevel Tools.
O contêiner
Uma imagem já construída, que leva os cinco geradores num ambiente coerente. Num Mac ela traz o WHIZARD 3, o único que não pode ser entregue com o TreeLevel Tools: reescreve cada processo em Fortran e o compila na execução.
Herwig, Sherpa, WHIZARD e CalcHEP exigem uma cadeia de compilação completa e horas de construção. Em vez de impô-los a você, são entregues numa imagem de contêiner já construída, a mesma para todos os sistemas.
Instale o Docker Desktop, e depois, uma única vez:
docker pull ghcr.io/gpasa/treelevel-tools:0.3.0docker pull ghcr.io/gpasa/treelevel-tools:latestO TreeLevel Tools serve-se dele assim que está presente e o Docker responde. A imagem pesa cerca de dois gigabytes depois de aberta.
O contêiner não é um substituto silencioso. Um gerador instalado nativamente e o mesmo gerador na imagem não trazem nem as mesmas versões nem os mesmos ajustes, e portanto não dão exatamente a mesma seção de choque. O TreeLevel Tools nunca passa de um para o outro sem dizê-lo: é uma caixa, desmarcada de origem.
Desde a 1.3, no Mac, a caixa diz tout faire tourner dans l'image Docker (“rodar tudo na imagem Docker”): marcada, a imagem conduz todos os trabalhos e os geradores incluídos no TreeLevel Tools se calam; se faltarem o Docker ou a imagem, nada é oferecido, em vez de um retorno silencioso aos nativos.
O Docker Desktop exige a virtualização. Numa máquina física quase sempre está disponível; numa máquina virtual, é preciso que o hospedeiro autorize a virtualização aninhada, o que nem todos fazem. Sem ela, o módulo Pythia nativo funciona assim mesmo — é precisamente por isso que ele é entregue à parte.
Verificar que tudo responde
Abra o espaço Geração. A lista dos geradores dá o que respondeu, com os números de versão:
Um gerador que figura na lista respondeu à chamada: não basta que esteja instalado, é preciso que fale. Um módulo danificado não aparece ali.
Ajuda › Sobre o TreeLevel dá os mesmos números, e é isso que se deve anexar a um relato: um resultado de física vale as versões que o produziram.
TreeLevel › Sobre dá os mesmos números, e é isso que se deve anexar a um relato: um resultado de física vale as versões que o produziram.
Também mostra a versão do TreeLevel Tools, e o botão Copiar as versões põe tudo na área de transferência, pronto para colar numa mensagem.
No iPad, o cartão Módulo Pythia 8 dos ajustes diz o que está instalado — Pythia, os dados dos hádrons — e quanto pesa cada parte.
O módulo tem seu próprio número, distinto do do Pythia: o cartão o mostra — Pythia 8.318 (WebAssembly, módulo 0.5.0) —, e o fim dos ajustes o repete ao lado da versão do app, com o botão Copiar as versões para uma mensagem de suporte. Quando sai uma versão mais recente, o cartão oferece Atualizar; o app também a baixa sozinho ao abrir, fora da rede celular, e verifica cada arquivo antes de instalá-lo.
Onde vivem os arquivos
| Seus documentos | onde você os salvar, em .feyndiag |
|---|---|
| Ajustes | %LOCALAPPDATA%\TreeLevel |
| Trabalhos do motor | ao lado de treelevel-tools.exe, em MCJobs\ |
| Registro de um trabalho | engine.log, na pasta do trabalho |
Os trabalhos passados revêem-se no espaço Geração, datados e com o que pesam: uma amostra de dez mil eventos com chuveiro chega a algumas centenas de megabytes, e acumulam-se doze sem que se perceba. Carregar relê um deles sem relançar nada, Apagar o exclui.
| Seus documentos | onde você os salvar, em .feyndiag |
|---|---|
| Trabalhos do motor | na caixa de areia do TreeLevel, sob ~/Library/Containers/org.pasahome.Feyn/Data/Library/Application Support/MCJobs |
Os trabalhos passados revêem-se no espaço Geração, datados e com o que pesam.
Seus documentos ficam onde você os salvar, em .feyndiag: no app Arquivos, no iPad ou no iCloud Drive.
Os trabalhos do Pythia ficam no app; Trabalhos anteriores, no espaço Geração, os data, diz quanto pesam, os recarrega ou os apaga.
Retomar os ajustes recoloca no documento os ajustes de um trabalho — gerador, número de eventos, semente e sua máquina, se tinha uma — sem reler seus eventos: só resta relançar a geração.
Quando algo não vai bem
A lista só propõe «TreeLevel — nível partônico»
O TreeLevel Tools não foi encontrado, ou não respondeu. Verifique o local acima, depois Verificar de novo no espaço Geração. O botão Indicar o local… permite apontá-lo à mão.
No iPad, o módulo Pythia não está instalado, ou foi removido: ajustes (a engrenagem), cartão Módulo Pythia 8, Baixar. Os outros geradores não existem no iPad.
O trabalho falha logo
A mensagem traz a razão, e o botão Ver o registro… abre o que o gerador escreveu, rolado até o fim — é ali que está a causa. As recusas mais frequentes são feixes que não podem fazer o que se lhes pede: dois léptons não carregam pártons, um elétron e um próton não se aniquilam.
No iPad, um feixe de prótons ou de píons precisa dos Dados dos hádrons: sem eles, o trabalho é recusado logo de início, e a mensagem o diz. Eles são adicionados no mesmo cartão dos ajustes.
As fórmulas não aparecem
A renderização passa por uma vista web. Feche e reabra o documento; se persistir, relate com a versão do sistema.
Para o resto, a página Suporte responde às perguntas mais frequentes e diz como relatar um problema.