Workflow quick reference

0. Зарегистрироваться на BINP/GCF кластере

зайти на stark или proxima Если ещё нет создать ssh ключ.

зайти в gitlab https://git.inp.nsk.su/ зарегистрировать этот ключ в своём аккаунте

этот шаг у вас должен быть уже пройден.

1. Открыть центральный репозиторий https://git.inp.nsk.su/sctau/aurora

и сделать форк к себе.

2. Настройка рабочей среды.

1. создадим рабочую директорию

mkdir workarea cd workarea

1. Директории для сборки и запуска

mkdir build run

1. Настройка самой базовой среды,
2. данную команду необходимо выполнять каждый раз при входе

setupSCTAU

1. Выберем релиз и его версию, в которой будем работать
2. Для работы требующей стабильности окружения, например физический анализ,

нужно использовать этот вариант asetup SСTauSim,0.1.0

1. Для работ по разработке программных компонент этот

asetup SCTauSim,0.1,latest

1. Для простого запуска готовых примеров этих шагов достаточно

cd run

1. запуск первичных генераторов моделирования

ctaurun GenExamples/evtgen.py

1. Запуск полного моделирования
3. Перед запуском полного моделирования в текущей директории надо положить файл
4. taumugamma.root, с входными данными - частицы из первичного генератора
6. Этот файл можно взять, например, у Виталия
7. /home/vvorob/public/tuples/fccedm/taumugamma.root

ctaurun G4SimExamples/fullsim_example.py

3. Для разработки нового или модификации существующего кода нужны следующие действия возвращаемся в workarea

1. Подготовка рабочей директории (делается один раз)

git sctau init-workdir ssh://git@git.inp.nsk.su/sctau/aurora.git cd aurora

1. Получение обновлений с головного репозитория
2. нужно делать периодически при длительном существовании рабочей директории и
3. существенных изменениях в головном

git fetch upstream

1. Подготовка рабочей тематической ветки, эта ветка будет видна другим людям,
2. поэтому название стоит выбирать говорящим и осмысленным

git checkout -b MyDevelopmentBranch upstream/0.1 --no-track

1. Если хотим модифицировать существующий пакет, то
2. Добавим пакеты из репозитория

git sctau addpkg GenExamples и/или git sctau addpkg G4SimExamples

1. Если надо создать новый пакет, то надо создать всю структуру директорий где

он должен лежать, написать CMakeLists.txt и всё остальное что нужно для нового пакета.

1. Сборка

cd ../build/ cmake ../aurora/Projects/WorkDir make

1. Настройка локального окружения
2. эта строчка принципиально важна, чтобы использовались локально собранные
3. пакеты вместо тех, что в релизе

source x86_64-slc7-gcc7-opt/setup.sh

1. Запуск

cd ../run ctaurun GenExamples/evtgen.py ctaurun G4SimExamples/fullsim_example.py