TreeLevelインストール
まずアプリケーション、生成器はそのあと——しかも、欲しいときだけ。TreeLevel は自分で計算し、自分でイベントを生成します。外部生成器は、それにシャワーとハドロン化の衣を着せるため、あるいは突き合わせるためのものです。
アプリケーションがひとつ、ほかに用意するものはありません。TreeLevel は自分で計算し、自分でイベントを生成します。
アプリケーション
TreeLevel は Mac App Store で購入します。macOS 14 Sonoma 以降が必要で、Apple silicon でも Intel でもネイティブに動きます。購入はユニバーサルで、iPad 版も含まれます。
TreeLevel は App Store で購入します。iPadOS 17 以降が必要です。購入はユニバーサルで、Mac 版も含まれます。
iPad で使える外部ジェネレータは Pythia 8 ひとつだけです。WebAssembly にコンパイルされ、App の中で動き、何も外部に送りません。App には含まれておらず、設定からダウンロードします（下記参照）。Herwig、Sherpa、WHIZARD、CalcHEP とコンテナは Mac と PC だけのものです。これらは別個のプログラムで、iPad では実行が許されません。TreeLevel 自身のパートンレベルの生成はどこでも動きます。
TreeLevel は Microsoft Store で購入します。Windows 10 バージョン 2004 以降、または Windows 11 が必要で、x64 でも ARM64 でもネイティブに動きます——Copilot+ PC には ARM64 版が届き、エミュレーションではありません。
なぜ生成器が別なのか
Pythia、Herwig、Sherpa、WHIZARD、CalcHEP は GPL で公開されています。ストアで売るアプリケーションにリンクすればライセンスの問題が起き、一緒に配ればまた別の問題が起きます。そこで生成器は別のプログラム、TreeLevel Tools に住みます。導入はご自分で行い、TreeLevel はそれがあれば見つけます。
ネットワークを通るものはありません。TreeLevel はディスクにジョブのフォルダを書き、プログラムがそれを読み、計算し、イベントを隣に書きます。生成器がひとつも入っていなければ、TreeLevel は自前のパートン段階にとどまります。計算スペースの仕事にはそれで足ります。
TreeLevel ToolsPythia 8 モジュール
ダウンロードはひとつ。エンジンと、お使いのマシン向けにコンパイルされた四つの生成器が入っています。Pythia 8 と Herwig 7 は TreeLevel が計算したイベントに衣を着せ——シャワー、ハドロン化、崩壊——、Sherpa 3 と CalcHEP 3 はダイアグラムの表す過程を自分で計算します。ほかに入れるものはありません。
ダウンロードはひとつ。エンジンと、お使いのマシン向けにコンパイルされた Pythia 8 モジュールが入っています。ほかの生成器は、下のコンテナを通ります。
リリースのページから .dmg を取り、TreeLevel Tools をアプリケーションフォルダにドラッグします。アプリケーションは Apple の署名と公証を受けています。macOS は黙って検証し、初回だけ、ダウンロードしたプログラムを開いてよいかを尋ねます。
リリースのページからお使いのマシンに合う書庫——TreeLevelTools-バージョン-x64.zip か -arm64.zip、およそ 45 MB——を取り、次の場所に展開します：
%LOCALAPPDATA%\Programsインストールはこれで終わりです。インストーラもなく、レジストリにも何も残しません。TreeLevel はまずここを、次に PATH を見ます。消すにはフォルダを削除してください。
ご自分のアーキテクチャが分からないときは、設定 › システム › バージョン情報のシステムの種類の行を。迷ったら x64 版はどこでも動きます。ARM ではエミュレーションになります。
iPad には TreeLevel Tools はありません。Pythia 8 はモジュールとして、設定（ツールバーの歯車）のPythia 8 モジュールカードからインストールします。Pythia は GPL の自由ソフトウェアです。App はこれを含まず、TreeLevel Tools のリリースページからダウンロードし、インストール前に各ファイルを SHA-256 の指紋で検証します。2 つの部分があります。
| Pythia 8.318 | 約 14 MB、ダウンロードボタン：パートンシャワー、ハドロン化、崩壊、そして「加速器」ソース |
|---|---|
| ハドロンのデータ | 約 55 MB、任意、追加ボタン：陽子のエネルギーがクォークとグルーオンにどう分配されるかを示すパートン分布関数。これがないと陽子や π 中間子のビームは拒否されます |
どちらも同じカードの削除ボタンで取り除けます。
各パッケージの内容、そのバージョン、生成器の作者：TreeLevel Tools。
コンテナ
すでに組み上がったイメージで、五つの生成器を筋の通った環境ごと収めています。Mac では WHIZARD 3 をもたらします。TreeLevel Tools と一緒には配れない唯一の生成器で、過程ごとに Fortran へ書き直し、実行時にコンパイルするからです。
Herwig、Sherpa、WHIZARD、CalcHEP は完全なコンパイル環境と何時間もの構築を要します。それを押しつける代わりに、すでに組み上がったコンテナイメージに収めてあります。どのシステムでも同じものです。
Docker Desktop を入れ、そのうえで一度だけ：
docker pull ghcr.io/gpasa/treelevel-tools:0.3.0docker pull ghcr.io/gpasa/treelevel-tools:latestそれがあって Docker が応答すれば、TreeLevel Tools はすぐ使います。イメージは展開して約 2 GB です。
コンテナは黙って入れ替わる身代わりではありません。ネイティブに入れた生成器と、イメージのなかの同じ生成器とは、バージョンも設定も同じではなく、したがって断面積もぴたりとは一致しません。TreeLevel Tools が黙って一方から他方へ乗り換えることはありません。これはチェックボックスで、最初は外れています。
1.3 からは Mac でのチェックボックスはtout faire tourner dans l'image Docker（「すべて Docker イメージで実行」）です。チェックすると、すべてのジョブをイメージが実行し、TreeLevel Tools に同梱の生成器は使われません。Docker かイメージがなければ、ネイティブに黙って戻ることはせず、何も提示しません。
Docker Desktop は仮想化を要します。物理マシンではほぼ必ず使えますが、仮想マシンではホストが入れ子の仮想化を許す必要があり、すべてのホストが許すわけではありません。それがなくてもネイティブの Pythia モジュールは動きます——別に配っているのは、まさにそのためです。
すべて応答するか確かめる
生成スペースを開きます。生成器の一覧に、応答したものがバージョン番号つきで並びます：
一覧に出ている生成器は、呼びかけに答えたものです。入っているだけでは足りず、口をきかねばなりません。壊れたモジュールはそこに現れません。
ヘルプ › TreeLevel についてにも同じ番号が出ます。不具合を知らせるときは、これを添えてください。物理の結果は、それを生んだバージョンの分だけの値打ちがあります。
TreeLevel › TreeLevel についてにも同じ番号が出ます。不具合を知らせるときは、これを添えてください。物理の結果は、それを生んだバージョンの分だけの値打ちがあります。
TreeLevel Tools のバージョンも表示され、バージョンをコピーボタンですべてをクリップボードに入れて、メッセージに貼り付けられます。
iPad では、設定のPythia 8 モジュールカードに、インストール済みのもの（Pythia、ハドロンのデータ）と各部分の大きさが表示されます。
モジュールには Pythia とは別の独自の番号があります。カードに表示され（Pythia 8.318（WebAssembly、モジュール 0.5.0））、設定の下部にもアプリのバージョンと並んで示されます。サポートへの連絡用にバージョンをコピーボタンもあります。新しいバージョンが公開されるとカードにアップデートが出ます。アプリは起動時にも、モバイル通信でなければ自動で更新し、インストール前にすべてのファイルを検証します。
ファイルの居場所
| あなたの書類 | 保存した場所に、.feyndiag で |
|---|---|
| 設定 | %LOCALAPPDATA%\TreeLevel |
| エンジンのジョブ | treelevel-tools.exe の隣、MCJobs\ のなか |
| ジョブのログ | engine.log、そのジョブのフォルダに |
過去のジョブは生成スペースで日付と容量つきに見返せます。シャワーをかけた一万イベントの標本は数百 MB になり、気づかぬうちに十いくつ溜まります。読み込むは何も走らせずに一つを読み直し、消去はそれを削除します。
| あなたの書類 | 保存した場所に、.feyndiag で |
|---|---|
| エンジンのジョブ | TreeLevel のサンドボックス内、~/ライブラリ/Containers/org.pasahome.Feyn/Data/Library/Application Support/MCJobs |
過去のジョブは生成スペースで日付と容量つきに見返せます。
あなたの書類は保存した場所に、.feyndiag で置かれます。ファイルApp のなか、iPad 上か iCloud Drive に。
Pythia の作業は App の中に残ります。「生成」空間の過去の作業で日付と大きさを確認し、再読み込みや削除ができます。
設定を復元 は、ジョブの設定（生成器、事象数、シード、マシンがあればそのマシン）を、事象を読み込まずに文書へ戻します。あとは生成をやり直すだけです。
うまくいかないとき
一覧に「TreeLevel — パートン段階」しか出ない
TreeLevel Tools が見つからないか、応答しませんでした。上で述べた場所を確かめ、生成スペースでもう一度確認を押してください。場所を指定…のボタンで手ずから示すこともできます。
iPad では、Pythia モジュールがインストールされていないか、削除されています。設定（歯車）→ Pythia 8 モジュールカード → ダウンロード。ほかのジェネレータは iPad にはありません。
ジョブがすぐ失敗する
メッセージが理由を伝え、ログを見る…のボタンが生成器の書いたものを末尾までスクロールして開きます——原因はそこにあります。最も多い拒否は、求められたことができないビームです。二つのレプトンはパートンを持たず、電子と陽子は対消滅しません。
iPad では、陽子や π 中間子のビームにはハドロンのデータが必要です。ないと作業はすぐに拒否され、メッセージにその旨が出ます。設定の同じカードから追加できます。
数式が表示されない
描画は web ビューを通しています。書類を閉じて開き直してください。それでも続くようなら、システムのバージョンを添えてお知らせください。
そのほかは、サポートのページがよくある質問に答え、不具合の知らせ方を示します。