Table of Contents
Описание формата данных TAIGA-IACT
(Версия от 24.02.2025))
Файлы моделирования событий
На примере моделирования /k38/taiga_pool/Hybrid_events/for_Krukov/IACT/20-22/bpe599_32m_da0.0_md5_wb1.22_old_cone.
Файлы моделирования событий, регистрируемых телескопами TAIGA-IACT с учётом триггера, организованы по следующей схеме.
1. Именование директорий моделирования
Каждая папка моделирования имеет имя вида:
bpe599_32m_da0.0_md5_wb1.22_old_cone
Расшифровка частей имени:
- bpe599: 599 — номер файла моделирования CORSIKA. Примечание: Полный список характеристик наборов моделирования CORSIKA можно найти в файле /k38/taiga_pool/CORSIKA_TAIGA/mc/stats_2.txt.
- 32m: 32 — номер версии программы моделирования оптики телескопов (Андрея Гринюка).
m — пометка, что стандартная конфигурация оптики модернизирована: используются более точные спектральные чувствительности ФЭУ, производится слежение за черенковскими фотонами в граничных пикселях камер. - da0.0: da указывает на тип распределения направлений прихода гамма-квантов.
0.0 — радиус круга, в котором равномерно распределены направления. При значении 0.0 моделируется точечный источник.
Примечание: Если вместо a стоит, например, g (dg…), то направления для ШАЛ моделируются как двумерный Гаусс, где число после dg интерпретируется как сигма распределения. - wb1.22: wb — моделируется wobbling направления прихода.
1.22 — смещение на 1.22 градуса от центра камеры. Обычно параметры подбираются так, чтобы направления были сосредоточены вблизи одной точки и не перемещались по камере. - old_cone: Указывает, что для моделирования используются конусы светосбора старого типа. Примечание: Новые конусы примерно в 2.17 раз эффективнее старых.
2. Версии моделирования внутри папок
В каждой папке (например, с именем, начинающимся на bpe) хранится конкретная версия моделирования. Возможны следующие варианты:
- Конкретные конфигурации телескопов: Папка может содержать моделирования, рассчитанные для камер с конфигурацией IACT01, IACT02 и т.д. Это означает, что все телескопы в данной папке имеют одинаковую конфигурацию камеры.
- Сложные комбинации камер: Версии могут именоваться как sim1, sim2 и т.п., если в моделировании участвует несколько типов регистрирующих камер.
Как определить конфигурацию моделирования?
- Откройте файл main.py, который находится внутри папки моделирования.
- Обратите внимание на массивы:
IACTs — содержит номера моделируемых телескопов.
coord_files — указывает на файлы с координатными сетками для телескопов.
3. Координатные сетки камер
В папке моделирования находятся файлы с координатными сетками, например:
- Первый телескоп:
xy_turn_2019s_EP.txt — координатная сетка до сезона наблюдений 2022-02-23.
xy_turn.iact01.2022-08-01_without_cl22.txt — координатная сетка для сезонов, начиная с 2022–2023. - Второй телескоп: XY_turn_2020jan2tel_18fix.txt — координаты пикселей до сезона наблюдений 2023–2024.
- Третий телескоп: xy_iact03_2022ian.txt — координатная сетка.
4. Файлы с данными черенковского сигнала
(без фона и клининга)
В основной папке моделирования находятся файлы вида:
taiga599_iact01_c.txt
Формат файла:
- Заголовок (первая строка):
- Номер события,
- номер оси разброса,
- число пикселей в изображении,
- энергия события.
- x-координата положения оси ШАЛ на земле [m].
- y-координата положения оси ШАЛ на земле [m].
- угол theta направления телескопа [radian].
- угол phi направления телескопа [radian].
- угол theta направления прихода ШАЛ [radian].
- угол phi направления прихода ШАЛ [radian].
- Xmax [$g/cm^2$]
- Далее идут строки с информацией по каждому сработавшему в событии пикселю:
- Номер кластера
- Номер пикселя
- x-координата пикселя
- y-координата пикселя
- Амплитуда пикселя
Примечание: Амплитуды могут быть равны нулю, поскольку черенковские фотоны попадают не во все пиксели камеры. Запись ведётся либо для всей камеры, либо только для сработавших кластеров (зависит от параметра trigger_type в main.py).
5. Конфигурационные файлы камер
Также в той же папке присутствуют файлы вида:
IACT01_cam_corsica_config.csv
В них содержится сгруппированная информация по моделируемым камерам:
- Координаты пикселей.
- Амплитудная калибровка.
- Соседи для каждого пикселя (используются при проведении клининга).
6. Файлы с наложением фона
(Background)
В папке моделирования имеется подпапка b0:
- b0 — означает background.
- 0 — фон берётся из гауссовского распределения, одинакового для всех пикселей камеры. Параметры фона задаются в переменной background_params в файле main.py.
Примечание: Возможна также подпапка с именем b1 (фоновый шум на основе экспериментальных данных), но на практике она пока не используется.
Файлы с фоном: Имена файлов имеют вид:
taiga599_iact01_cb0.txt
Формат таких файлов аналогичен формату файлов *_c.txt, за исключением того, что амплитуды пикселей здесь искажены наложенным фоном.
7. Файлы с событиями после клининга
Внутри папки b0 хранится дополнительная подпапка, соответствующая смоделированному клинингу. Обычно она имеет имя вроде:
14-7fix
где 14 и 7 — пороги клининга (в фотоэлектронах).
Файлы в этой папке: Имена файлов выглядят следующим образом:
taiga599_clean_iact01_14_7fix_cb0.txt
Формат файла после клининга:
- Заголовок (первая строка):
- Номер события в данном файле,
- номер события в CORSIKA,
- номер оси разброса,
- число пикселей в событии,
- энергия,
- x-координата направления прихода ШАЛ (в см),
- y-координата направления прихода ШАЛ (в см),
- коэффициенты a и b главной оси эллипса (уравнение прямой: y = ax + b).
- Далее идут строки с данными по каждому пикселю события. Формат строк аналогичен файлам *_c.txt и *_cb0.txt.