ПлатформаВерсия

Установка

Сначала приложение, потом генераторы — и только если они вам нужны. TreeLevel считает и разыгрывает события сам; внешние генераторы служат, чтобы одеть их ливнем и адронизацией или чтобы сравнить.

Одно приложение, и больше ничего настраивать не нужно: TreeLevel считает и разыгрывает свои события сам.

Приложение

TreeLevel покупается в Mac App Store. Он требует macOS 14 Sonoma или новее и работает нативно как на Apple silicon, так и на Intel. Покупка универсальная: версия для iPad входит в неё.

TreeLevel покупается в App Store. Он требует iPadOS 17 или новее. Покупка универсальная: версия для Mac входит в неё.

На iPad есть единственный внешний генератор: Pythia 8, скомпилированный в WebAssembly и работающий внутри приложения, ничего никуда не отправляя. Он не входит в приложение: его загружают из настроек — см. ниже. Herwig, Sherpa, WHIZARD, CalcHEP и контейнер остаются на Mac и ПК: это отдельные программы, запускать которые iPad не позволяет. Собственная генерация TreeLevel на партонном уровне работает везде.

TreeLevel покупается в Microsoft Store. Он требует Windows 10 версии 2004 или новее либо Windows 11 и работает нативно как на x64, так и на ARM64 — PC Copilot+ получает версию ARM64, а не эмуляцию.

Почему генераторы отдельно

Pythia, Herwig, Sherpa, WHIZARD и CalcHEP выпущены под лицензией GPL. Связать их с приложением, продаваемым в магазине, значило бы создать проблему с лицензией, а распространять их вместе — создать другую. Поэтому они живут в отдельной программе, TreeLevel Tools, которую вы ставите сами и которую TreeLevel обнаруживает, если она есть.

Ничто не идёт по сети: TreeLevel пишет папку задания на ваш диск, программа её читает, считает и пишет события рядом. Если ни один генератор не установлен, TreeLevel остаётся на собственном партонном уровне, которого довольно для всего, что делает раздел «Расчёт».

TreeLevel ToolsМодуль Pythia 8

Одна загрузка, приносящая ядро и четыре генератора, собранных для вашей машины: Pythia 8 и Herwig 7, которые одевают события, рассчитанные TreeLevel — ливень, адронизация, распады —, а также Sherpa 3 и CalcHEP 3, которые сами считают процесс, описанный диаграммой. Больше ставить нечего.

Одна загрузка, приносящая ядро и модуль Pythia 8, собранный для вашей машины. Остальные генераторы идут через контейнер, ниже.

Возьмите .dmg со страницы выпусков и перетащите TreeLevel Tools в свои программы. Приложение подписано и нотаризовано Apple: macOS проверяет его молча и лишь в первый раз просит подтвердить открытие загруженной программы.

Возьмите архив, соответствующий вашей машине, на странице выпусков — TreeLevelTools-версия-x64.zip или -arm64.zip, около 45 МБ — и распакуйте его в:

%LOCALAPPDATA%\Programs

Это вся установка: ни установщика, ни записей в реестре. TreeLevel смотрит туда, а затем в PATH. Чтобы удалить, сотрите папку.

Если вы не знаете свою архитектуру: Параметры › Система › О системе, строка Тип системы. В сомнении версия x64 работает везде, на ARM — под эмуляцией.

На iPad нет TreeLevel Tools: Pythia 8 устанавливается как модуль из настроек (шестерёнка на панели инструментов), карточка Модуль Pythia 8. Pythia — свободная программа под лицензией GPL: приложение не содержит её, а загружает со страницы версий TreeLevel Tools и проверяет каждый файл по отпечатку SHA-256 перед установкой. Две части:

Pythia 8.318	около 14 МБ, кнопка Загрузить: партонный ливень, адронизация, распады и источник «Ускоритель»
Данные адронов	около 55 МБ, по желанию, кнопка Добавить: партонные плотности, которые говорят, как энергия протона делится между его кварками и глюонами; без них пучок протонов или пионов отклоняется

Обе части удаляются на той же карточке, кнопка Удалить.

Что содержит каждый пакет, его версии и авторы генераторов: TreeLevel Tools.

Контейнер

Готовый образ, несущий пять генераторов в согласованном окружении. На Mac он даёт WHIZARD 3 — единственный, который нельзя поставить вместе с TreeLevel Tools: он переписывает каждый процесс на Фортране и компилирует его при запуске.

Herwig, Sherpa, WHIZARD и CalcHEP требуют полной цепочки компиляции и часов сборки. Вместо того чтобы навязывать их вам, они поставляются в уже собранном образе контейнера, одном для всех систем.

Установите Docker Desktop, затем, один-единственный раз:

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

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

TreeLevel Tools пользуется им, как только он есть и Docker отвечает. Развёрнутый образ весит около двух гигабайт.

Контейнер не молчаливая подмена. Генератор, установленный нативно, и тот же генератор в образе несут ни те же версии, ни те же настройки и потому дают не совсем одно и то же сечение. TreeLevel Tools никогда не переходит от одного к другому, не сказав об этом: это флажок, изначально снятый.

Начиная с 1.3 на Mac флажок называется tout faire tourner dans l'image Docker («запускать всё в образе Docker»): если он отмечен, образ ведёт все задания, а генераторы из комплекта TreeLevel Tools молчат; если нет Docker или образа, ничего не предлагается — без тихого возврата к встроенным.

Docker Desktop требует виртуализации. На физической машине она почти всегда доступна; в виртуальной машине нужно, чтобы хозяин разрешил вложенную виртуализацию, а это делают не все. Без неё нативный модуль Pythia всё равно работает — именно поэтому он поставляется отдельно.

Проверить, что всё отвечает

Откройте раздел Генерация. Список генераторов показывает, кто отозвался, с номерами версий:

Генератор, попавший в список, откликнулся на зов: мало быть установленным, надо заговорить. Повреждённый модуль там не появится.

Справка › О 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`, в папке задания

Прошлые задания видны в разделе Генерация, с датой и с их весом: выборка из десяти тысяч событий с ливнем занимает несколько сотен мегабайт, и их набирается дюжина незаметно. Загрузить перечитывает одно, ничего не запуская заново, Удалить его стирает.

Ваши документы	там, где вы их сохраняете, в `.feyndiag`
Задания ядра	в песочнице TreeLevel, по пути `~/Library/Containers/org.pasahome.Feyn/Data/Library/Application Support/MCJobs`

Прошлые задания видны в разделе Генерация, с датой и с их весом.

Ваши документы лежат там, где вы их сохраняете, в .feyndiag: в приложении Файлы, на iPad или в iCloud Drive.

Задания Pythia остаются внутри приложения; Прошлые задания в пространстве «Генерация» показывают их дату и размер, загружают их снова или удаляют.

Вернуть настройки возвращает в документ настройки задания — генератор, число событий, зерно и его машину, если она была, — не читая его события: остаётся лишь снова запустить генерацию.

Когда что-то не так

В списке только «TreeLevel — партонный уровень»

TreeLevel Tools не найдена или не ответила. Проверьте расположение, указанное выше, затем Проверить снова в разделе «Генерация». Кнопка Указать расположение… позволяет задать его вручную.

На iPad модуль Pythia не установлен или был удалён: настройки (шестерёнка), карточка Модуль Pythia 8, Загрузить. Других генераторов на iPad нет.

Задание падает сразу

Сообщение несёт причину, а кнопка Посмотреть журнал… открывает то, что написал генератор, прокрученное к концу — причина там. Чаще всего отказ связан с пучками, которые не могут сделать требуемого: два лептона не несут партонов, электрон и протон не аннигилируют.

На iPad пучку протонов или пионов нужны Данные адронов: без них задание сразу отклоняется, и сообщение говорит об этом. Они добавляются на той же карточке настроек.

Формулы не отображаются

Отрисовка идёт через веб-представление. Закройте и снова откройте документ; если не помогает, сообщите об этом, указав версию системы.

В остальном страница Поддержка отвечает на самые частые вопросы и говорит, как сообщить о неполадке.