THEORY2

User Tools

Site Tools

Trace: • data_format_iact
ml4gamma:wdocs:data_format_iact

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
ml4gamma:wdocs:data_format_iact [20/02/2025 11:35] – removed - external edit (Unknown date) 127.0.0.1ml4gamma:wdocs:data_format_iact [26/09/2025 06:56] (current) – [7. Файлы с событиями после клининга] volchugov
Line 1: Line 1:
 +====== Описание формата данных 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-координата направления прихода ШАЛ (в см), 
 +    * x-координата положения оси ШАЛ (в м), 
 +    * y-координата положения оси ШАЛ (в м), 
 +    * коэффициенты a и b главной оси эллипса (уравнение прямой: y = ax + b).
 +  * Далее идут строки с данными по каждому пикселю события. Формат строк аналогичен файлам *_c.txt и *_cb0.txt.
 +