Workflow quick reference

Revision as of 15:28, 15 October 2018

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

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

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

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

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

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

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

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

mkdir workarea
cd workarea

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

mkdir build  run

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

setupSCTAU

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

asetup SСTauSim,0.1.0

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

asetup SCTauSim,master,latest

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

cd run

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

ctaurun GenExamples/evtgen.py 

Запуск полного моделирования:

Перед запуском полного моделирования в текущей директории надо положить файл taumugamma.root, с входными данными - частицы из первичного генератора

Этот файл можно взять, например, у Виталия: /home/vvorob/public/tuples/fccedm/taumugamma.root

ctaurun G4SimExamples/fullsim_example.py

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

Возвращаемся в workarea.

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

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

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

git fetch upstream

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

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

Если хотим модифицировать существующий пакет, то

Добавим пакеты из репозитория

git sctau addpkg GenExamples

и/или

git sctau addpkg G4SimExamples

Если создаётся новый пакет, то надо создать всю структуру директорий, где он должен лежать, написать CMakeLists.txt и всё остальное, что нужно для нового пакета.

Сборка

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

Настройка локального окружения

эта строчка принципиально важна, чтобы использовались локально собранные пакеты вместо тех, что в релизе:

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

Запуск

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