TreeLevelInstallazione
Prima l'applicazione, poi i generatori — e solo se li volete. TreeLevel calcola e genera eventi da solo; i generatori esterni servono a vestirli di uno sciame e di un'adronizzazione, o a confrontare.
Un'applicazione, e nient'altro da installare: TreeLevel calcola e genera i suoi eventi da sé.
L'applicazione
TreeLevel si acquista sul Mac App Store. Chiede macOS 14 Sonoma o più recente, e gira nativamente su Apple silicon come su Intel. L'acquisto è universale: la versione per iPad è compresa.
TreeLevel si acquista sull'App Store. Chiede iPadOS 17 o più recente. L'acquisto è universale: la versione per Mac è compresa.
Sull'iPad c'è un solo generatore esterno: Pythia 8, compilato in WebAssembly ed eseguito nell'app, senza inviare nulla. Non fa parte dell'app: si scarica dalle impostazioni — vedi più sotto. Herwig, Sherpa, WHIZARD, CalcHEP e il container restano sul Mac e sul PC: sono programmi separati, che l'iPad non permette di avviare. La generazione propria di TreeLevel, a livello partonico, funziona ovunque.
TreeLevel si acquista sul Microsoft Store. Chiede Windows 10 versione 2004 o più recente, oppure Windows 11, e gira nativamente in x64 come in ARM64 — un PC Copilot+ riceve la versione ARM64, non un'emulazione.
Perché i generatori stanno a parte
Pythia, Herwig, Sherpa, WHIZARD e CalcHEP sono pubblicati sotto licenza GPL. Collegarli a un'applicazione venduta in un negozio porrebbe un problema di licenza, e distribuirli insieme ne porrebbe un altro. Vivono dunque in un programma separato, TreeLevel Tools, che installate voi stessi e che TreeLevel rileva se è presente.
Nulla passa dalla rete: TreeLevel scrive una cartella di lavoro sul vostro disco, il programma la legge, calcola, e scrive gli eventi accanto. Se nessun generatore è installato, TreeLevel si attiene al proprio livello partonico, che basta a tutto ciò che fa lo spazio Calcolo.
TreeLevel ToolsModulo Pythia 8
Un solo scaricamento, che porta il motore e quattro generatori compilati per la vostra macchina: Pythia 8 e Herwig 7, che vestono gli eventi calcolati da TreeLevel — sciame, adronizzazione, decadimenti —, nonché Sherpa 3 e CalcHEP 3, che calcolano essi stessi il processo descritto dal diagramma. Nient'altro da installare.
Un solo scaricamento, che porta il motore e il modulo Pythia 8 compilato per la vostra macchina. Gli altri generatori passano dal contenitore, più sotto.
Prendete il .dmg dalla pagina delle versioni e trascinate TreeLevel Tools nelle vostre Applicazioni. L'applicazione è firmata e autenticata da Apple: macOS la verifica in silenzio e chiede soltanto, la prima volta, conferma di aprire un programma scaricato.
Prendete l'archivio che corrisponde alla vostra macchina sulla pagina delle versioni — TreeLevelTools-versione-x64.zip oppure -arm64.zip, circa 45 MB — e scompattatelo in:
%LOCALAPPDATA%\ProgramsQuesta è tutta l'installazione: nessun programma d'installazione, nulla nel registro. TreeLevel cerca lì, poi nel PATH. Per cancellarlo, eliminate la cartella.
Se non sapete quale architettura avete: Impostazioni › Sistema › Informazioni, riga Tipo di sistema. Nel dubbio, la versione x64 funziona ovunque, in emulazione su ARM.
Niente TreeLevel Tools sull'iPad: Pythia 8 vi si installa come modulo, dalle impostazioni (la rotella della barra degli strumenti), scheda Modulo Pythia 8. Pythia è software libero sotto licenza GPL: l'app non lo contiene, lo scarica dalla pagina delle versioni di TreeLevel Tools e verifica ogni file con la sua impronta SHA-256 prima di installarlo. Due parti:
| Pythia 8.318 | circa 14 MB, pulsante Scarica: sciame partonico, adronizzazione, decadimenti e la sorgente Macchina |
|---|---|
| Dati degli adroni | circa 55 MB, facoltativi, pulsante Aggiungi: le densità partoniche, che dicono come l'energia di un protone si ripartisce tra quark e gluoni; senza di esse, un fascio di protoni o di pioni viene rifiutato |
Entrambe si tolgono dalla stessa scheda, pulsante Rimuovi.
Che cosa contiene ogni pacchetto, le sue versioni e gli autori dei generatori: TreeLevel Tools.
Il contenitore
Un'immagine già costruita, che porta i cinque generatori in un ambiente coerente. Su un Mac apporta WHIZARD 3, il solo che non possa essere consegnato con TreeLevel Tools: riscrive ogni processo in Fortran e lo compila all'esecuzione.
Herwig, Sherpa, WHIZARD e CalcHEP chiedono una catena di compilazione completa e ore di costruzione. Piuttosto che imporvele, sono consegnati in un'immagine di contenitore già costruita, la stessa per tutti i sistemi.
Installate Docker Desktop, poi, una volta sola:
docker pull ghcr.io/gpasa/treelevel-tools:0.3.0docker pull ghcr.io/gpasa/treelevel-tools:latestTreeLevel Tools se ne serve non appena è presente e Docker risponde. L'immagine pesa circa due gigabyte una volta distesa.
Il contenitore non è un sostituto silenzioso. Un generatore installato nativamente e lo stesso generatore nell'immagine non portano né le stesse versioni né le stesse regolazioni, e non danno dunque esattamente la stessa sezione d'urto. TreeLevel Tools non passa mai dall'uno all'altro senza dirlo: è una casella, non spuntata all'origine.
Dalla 1.3, sul Mac, la casella dice tout faire tourner dans l'image Docker («eseguire tutto nell'immagine Docker»): spuntata, l'immagine conduce tutti i lavori e i generatori forniti con TreeLevel Tools tacciono; se mancano Docker o l'immagine, non viene proposto nulla anziché ripiegare in silenzio sui nativi.
Docker Desktop chiede la virtualizzazione. Su una macchina fisica è quasi sempre disponibile; in una macchina virtuale, occorre che l'ospite autorizzi la virtualizzazione annidata, cosa che non tutti fanno. Senza di essa, il modulo Pythia nativo funziona comunque — ed è proprio per questo che è consegnato a parte.
Verificare che tutto risponda
Aprite lo spazio Generazione. L'elenco dei generatori dà ciò che ha risposto, con i numeri di versione:
Un generatore che figura nell'elenco ha risposto all'appello: non basta che sia installato, bisogna che parli. Un modulo rovinato non vi appare.
Aiuto › Informazioni su TreeLevel dà gli stessi numeri, ed è ciò che va allegato a una segnalazione: un risultato di fisica vale le versioni che l'hanno prodotto.
TreeLevel › Informazioni dà gli stessi numeri, ed è ciò che va allegato a una segnalazione: un risultato di fisica vale le versioni che l'hanno prodotto.
Indica anche la versione di TreeLevel Tools, e il pulsante Copia le versioni mette tutto negli appunti, pronto da incollare in un messaggio.
Sull'iPad, la scheda Modulo Pythia 8 delle impostazioni dice che cosa è installato — Pythia, i dati degli adroni — e quanto pesa ogni parte.
Il modulo ha un numero proprio, distinto da quello di Pythia: la scheda lo mostra — Pythia 8.318 (WebAssembly, modulo 0.5.0) —, e il fondo delle impostazioni lo ripete accanto alla versione dell'app, con il pulsante Copia le versioni per un messaggio di assistenza. Quando esce una versione più recente, la scheda propone Aggiorna; l'app la prende anche da sé all'avvio, fuori dalla rete cellulare, e verifica ogni file prima di installarlo.
Dove vivono i file
| I vostri documenti | dove li salvate, in .feyndiag |
|---|---|
| Impostazioni | %LOCALAPPDATA%\TreeLevel |
| Lavori del motore | accanto a treelevel-tools.exe, in MCJobs\ |
| Registro di un lavoro | engine.log, nella cartella del lavoro |
I lavori passati si rivedono nello spazio Generazione, datati e con quanto pesano: un campione di diecimila eventi con sciame arriva a qualche centinaio di megabyte, e se ne accumulano dodici senza accorgersene. Carica ne rilegge uno senza rilanciare nulla, Elimina lo cancella.
| I vostri documenti | dove li salvate, in .feyndiag |
|---|---|
| Lavori del motore | nella sabbiera di TreeLevel, sotto ~/Libreria/Containers/org.pasahome.Feyn/Data/Library/Application Support/MCJobs |
I lavori passati si rivedono nello spazio Generazione, datati e con quanto pesano.
I vostri documenti stanno dove li salvate, in .feyndiag: nell'app File, sull'iPad o in iCloud Drive.
I lavori di Pythia restano nell'app; Lavori passati, nello spazio Generazione, li data, dice quanto pesano, li ricarica o li cancella.
Riprendi le impostazioni riporta nel documento le impostazioni di un lavoro — generatore, numero di eventi, seme e la sua macchina se ne aveva una — senza rileggerne gli eventi: resta solo da rilanciare la generazione.
Quando qualcosa non va
L'elenco propone soltanto «TreeLevel — livello partonico»
TreeLevel Tools non è stata trovata, o non ha risposto. Verificate la posizione qui sopra, poi Verifica di nuovo nello spazio Generazione. Il pulsante Indica la posizione… permette di designarla a mano.
Sull'iPad, il modulo Pythia non è installato, o è stato rimosso: impostazioni (la rotella), scheda Modulo Pythia 8, Scarica. Gli altri generatori non esistono sull'iPad.
Il lavoro fallisce subito
Il messaggio porta la ragione, e il pulsante Vedi il registro… apre ciò che il generatore ha scritto, scorso fino alla fine — è lì che sta la causa. I rifiuti più frequenti sono fasci che non possono fare ciò che si chiede loro: due leptoni non portano partoni, un elettrone e un protone non si annichilano.
Sull'iPad, un fascio di protoni o di pioni richiede i Dati degli adroni: senza, il lavoro è rifiutato subito, e il messaggio lo dice. Si aggiungono dalla stessa scheda delle impostazioni.
Le formule non compaiono
La resa passa da una vista web. Chiudete e riaprite il documento; se persiste, segnalatelo con la versione del sistema.
Per il resto, la pagina Assistenza risponde alle domande più frequenti e dice come segnalare un problema.