====== Описание формата данных TAIGA-IACT ======
(Версия от 24.02.2025))

{{ :ml4gamma:ml4gamma:wdocs:taiga_tools.pdf | презентация}}
===== Файлы моделирования событий =====

На примере моделирования /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.