gammasimtools 0.15.0__py3-none-any.whl → 0.17.0__py3-none-any.whl

simtools/simtel/simtel_io_event_writer.py

@@ -1,10 +1,11 @@
-"""Generate a reduced dataset from given simulation event list and save the output to file."""
+"""Generate a reduced dataset from sim_telarray output files using astropy tables."""
 
 import logging
-from dataclasses import dataclass, field
+from dataclasses import dataclass
 
+import astropy.units as u
 import numpy as np
-import tables
+from astropy.table import Table
 from eventio import EventIOFile
 from eventio.simtel import (
     ArrayEvent,
@@ -15,107 +16,132 @@ from eventio.simtel import (
     TriggerInformation,
 )
 
+from simtools.corsika.primary_particle import PrimaryParticle
+from simtools.simtel.simtel_io_file_info import get_corsika_run_header
 from simtools.utils.geometry import calculate_circular_mean
 
-DEFAULT_FILTERS = tables.Filters(complevel=5, complib="zlib", shuffle=True, bitshuffle=False)
-
 
 @dataclass
-class ShowerEventData:
-    """Shower event data."""
-
-    simulated_energy: list = field(default_factory=list)
-    x_core: list = field(default_factory=list)
-    y_core: list = field(default_factory=list)
-    shower_azimuth: list = field(default_factory=list)
-    shower_altitude: list = field(default_factory=list)
-    shower_id: list = field(default_factory=list)
-    area_weight: list = field(default_factory=list)
-
-    x_core_shower: list = field(default_factory=list)
-    y_core_shower: list = field(default_factory=list)
-    core_distance_shower: list = field(default_factory=list)
-
-
-@dataclass
-class TriggeredEventData:
-    """Triggered event data."""
-
-    triggered_id: list = field(default_factory=list)
-    array_altitudes: list = field(default_factory=list)
-    array_azimuths: list = field(default_factory=list)
-    trigger_telescope_list_list: list = field(default_factory=list)
-    angular_distance: list = field(default_factory=list)
+class TableSchemas:
+    """Define schemas for output tables with units."""
+
+    shower_schema = {
+        "shower_id": (np.uint32, None),
+        "event_id": (np.uint32, None),
+        "file_id": (np.uint32, None),
+        "simulated_energy": (np.float64, u.TeV),
+        "x_core": (np.float64, u.m),
+        "y_core": (np.float64, u.m),
+        "shower_azimuth": (np.float64, u.rad),
+        "shower_altitude": (np.float64, u.rad),
+        "area_weight": (np.float64, None),
+    }
+
+    trigger_schema = {
+        "shower_id": (np.uint32, None),
+        "event_id": (np.uint32, None),
+        "file_id": (np.uint32, None),
+        "array_altitude": (np.float64, u.rad),
+        "array_azimuth": (np.float64, u.rad),
+        "telescope_list": (str, None),  # Store as comma-separated string
+    }
+
+    file_info_schema = {
+        "file_name": (str, None),
+        "file_id": (np.uint32, None),
+        "particle_id": (np.uint32, None),
+        "energy_min": (np.float64, u.TeV),
+        "energy_max": (np.float64, u.TeV),
+        "viewcone_min": (np.float64, u.deg),
+        "viewcone_max": (np.float64, u.deg),
+        "core_scatter_min": (np.float64, u.m),
+        "core_scatter_max": (np.float64, u.m),
+        "zenith": (np.float64, u.deg),
+        "azimuth": (np.float64, u.deg),
+        "nsb_level": (np.float64, None),
+    }
 
 
 class SimtelIOEventDataWriter:
     """
-    Generate a reduced dataset from given simulation event list and save the output to file.
+    Process sim_telarray events and write tables to file.
+
+    Extracts essential information from sim_telarray output files:
+
+    - Shower parameters (energy, core location, direction)
+    - Trigger patterns
+    - Telescope pointing
 
     Attributes
     ----------
     input_files : list
         List of input file paths to process.
-    output_file : str
-        Path to the output file.
     max_files : int, optional
         Maximum number of files to process.
     """
 
-    def __init__(self, input_files, output_file, max_files=100):
+    def __init__(self, input_files, max_files=100):
         """Initialize class."""
         self._logger = logging.getLogger(__name__)
         self.input_files = input_files
-        self.output_file = output_file
         try:
             self.max_files = max_files if max_files < len(input_files) else len(input_files)
         except TypeError as exc:
             raise TypeError("No input files provided.") from exc
-        self.shower = None
+
         self.n_use = None
-        self.shower_id_offset = 0
-        self.event_data = ShowerEventData()
-        self.triggered_data = TriggeredEventData()
-        self.file_names = []
+        self.shower_data = []
+        self.trigger_data = []
+        self.file_info = []
 
     def process_files(self):
-        """Process the input files and store them in an file."""
-        self.shower_id_offset = 0
-
-        for i, file in enumerate(self.input_files[: self.max_files], start=1):
-            self._logger.info(f"Processing file {i}/{self.max_files}: {file}")
-            self._process_file(file)
-            if i == 1 or len(self.event_data.simulated_energy) >= 1e7:
-                self._write_data(mode="w" if i == 1 else "a")
-                self.shower_id_offset += len(self.event_data.simulated_energy)
-                self._reset_data()
-
-        self._write_data(mode="a")
-
-    def get_event_data(self):
         """
-        Return shower and triggered event data.
+        Process input files and return tables.
 
         Returns
         -------
-        ShowerEventData, TriggeredEventData
-            Shower and triggered event data.
+        list
+            List of astropy tables containing processed data.
         """
-        return self.event_data, self.triggered_data
-
-    def _process_file(self, file):
+        for i, file in enumerate(self.input_files[: self.max_files]):
+            self._logger.info(f"Processing file {i + 1}/{self.max_files}: {file}")
+            self._process_file(i, file)
+
+        return self.create_tables()
+
+    def create_tables(self):
+        """Create astropy tables from collected data."""
+        tables = []
+        for data, schema, name in [
+            (self.shower_data, TableSchemas.shower_schema, "SHOWERS"),
+            (self.trigger_data, TableSchemas.trigger_schema, "TRIGGERS"),
+            (self.file_info, TableSchemas.file_info_schema, "FILE_INFO"),
+        ]:
+            table = Table(rows=data, names=schema.keys())
+            table.meta["EXTNAME"] = name
+            self._add_units_to_table(table, schema)
+            tables.append(table)
+        return tables
+
+    def _add_units_to_table(self, table, schema):
+        """Add units to a single table's columns."""
+        for col, (_, unit) in schema.items():
+            if unit is not None:
+                table[col].unit = unit
+
+    def _process_file(self, file_id, file):
         """Process a single file and update data lists."""
+        self._process_file_info(file_id, file)
         with EventIOFile(file) as f:
             for eventio_object in f:
                 if isinstance(eventio_object, MCRunHeader):
                     self._process_mc_run_header(eventio_object)
                 elif isinstance(eventio_object, MCShower):
-                    self._process_mc_shower(eventio_object)
+                    self._process_mc_shower(eventio_object, file_id)
                 elif isinstance(eventio_object, MCEvent):
                     self._process_mc_event(eventio_object)
                 elif isinstance(eventio_object, ArrayEvent):
-                    self._process_array_event(eventio_object)
-            self.file_names.append(str(file))
+                    self._process_array_event(eventio_object, file_id)
 
     def _process_mc_run_header(self, eventio_object):
         """Process MC run header and update data lists."""
@@ -123,36 +149,93 @@ class SimtelIOEventDataWriter:
         self.n_use = mc_head["n_use"]  # reuse factor n_use needed to extend the values below
         self._logger.info(f"Shower reuse factor: {self.n_use} (viewcone: {mc_head['viewcone']})")
 
-    def _process_mc_shower(self, eventio_object):
+    def _process_file_info(self, file_id, file):
+        """Process file information and append to file info list."""
+        run_info = get_corsika_run_header(file)
+        particle = PrimaryParticle(
+            particle_id_type="eventio_id", particle_id=run_info.get("primary_id", 1)
+        )
+        self.file_info.append(
+            {
+                "file_name": str(file),
+                "file_id": file_id,
+                "particle_id": particle.corsika7_id,
+                "energy_min": run_info["E_range"][0],
+                "energy_max": run_info["E_range"][1],
+                "viewcone_min": run_info["viewcone"][0],
+                "viewcone_max": run_info["viewcone"][1],
+                "core_scatter_min": run_info["core_range"][0],
+                "core_scatter_max": run_info["core_range"][1],
+                "zenith": 90.0 - np.degrees(run_info["direction"][1]),
+                "azimuth": np.degrees(run_info["direction"][0]),
+                "nsb_level": self._get_preliminary_nsb_level(str(file)),
+            }
+        )
+
+    def _process_mc_shower(self, eventio_object, file_id):
         """
         Process MC shower and update shower event list.
 
         Duplicated entries 'self.n_use' times to match the number simulated events with
         different core positions.
         """
-        self.shower = eventio_object.parse()
-
-        self.event_data.simulated_energy.extend([self.shower["energy"]] * self.n_use)
-        self.event_data.shower_azimuth.extend([self.shower["azimuth"]] * self.n_use)
-        self.event_data.shower_altitude.extend([self.shower["altitude"]] * self.n_use)
+        shower = eventio_object.parse()
+
+        self.shower_data.extend(
+            {
+                "shower_id": shower["shower"],
+                "event_id": None,  # filled in _process_mc_event
+                "file_id": file_id,
+                "simulated_energy": shower["energy"],
+                "x_core": None,  # filled in _process_mc_event
+                "y_core": None,  # filled in _process_mc_event
+                "shower_azimuth": shower["azimuth"],
+                "shower_altitude": shower["altitude"],
+                "area_weight": None,  # filled in _process_mc_event
+            }
+            for _ in range(self.n_use)
+        )
 
     def _process_mc_event(self, eventio_object):
-        """Process MC event and update shower event list."""
+        """
+        Process MC event and update shower event list.
+
+        Expected to be called n_use times after _process_shower.
+        """
         event = eventio_object.parse()
 
-        self.event_data.shower_id.append(event["shower_num"])
-        self.event_data.x_core.append(event["xcore"])
-        self.event_data.y_core.append(event["ycore"])
-        self.event_data.area_weight.append(event["aweight"])
+        shower_data_index = len(self.shower_data) - self.n_use + event["event_id"] % 100
 
-    def _process_array_event(self, eventio_object):
+        try:
+            if self.shower_data[shower_data_index]["shower_id"] != event["shower_num"]:
+                raise IndexError
+        except IndexError as exc:
+            raise IndexError(
+                f"Inconsistent shower and MC event data for shower id {event['shower_num']}"
+            ) from exc
+
+        self.shower_data[shower_data_index].update(
+            {
+                "event_id": event["event_id"],
+                "x_core": event["xcore"],
+                "y_core": event["ycore"],
+                "area_weight": event["aweight"],
+            }
+        )
+
+    def _process_array_event(self, eventio_object, file_id):
         """Process array event and update triggered event list."""
         tracking_positions = []
+        telescopes = []
 
-        for _, obj in enumerate(eventio_object):
+        for obj in eventio_object:
             if isinstance(obj, TriggerInformation):
-                self._process_trigger_information(obj)
-
+                trigger_info = obj.parse()
+                telescopes = (
+                    trigger_info["triggered_telescopes"]
+                    if len(trigger_info["triggered_telescopes"]) > 0
+                    else []
+                )
             if isinstance(obj, TrackingPosition):
                 tracking_position = obj.parse()
                 tracking_positions.append(
@@ -162,156 +245,53 @@ class SimtelIOEventDataWriter:
                     }
                 )
 
-        if tracking_positions:
-            self._process_tracking_positions(tracking_positions)
+        if len(telescopes) > 0 and tracking_positions:
+            self._fill_array_event(telescopes, tracking_positions, eventio_object.event_id, file_id)
 
-    def _process_tracking_positions(self, tracking_positions):
-        """
-        Process collected tracking positions and update triggered event list.
-
-        Use mean telescope tracking positions, averaged over all triggered telescopes.
-        """
+    def _fill_array_event(self, telescopes, tracking_positions, event_id, file_id):
+        """Add array event triggered events with tracking positions."""
         altitudes = [pos["altitude"] for pos in tracking_positions]
         azimuths = [pos["azimuth"] for pos in tracking_positions]
 
-        self.triggered_data.array_altitudes.append(np.mean(altitudes))
-        self.triggered_data.array_azimuths.append(calculate_circular_mean(azimuths))
-
-    def _process_trigger_information(self, trigger_info):
-        """Process trigger information and update triggered event list."""
-        trigger_info = trigger_info.parse()
-        telescopes = trigger_info["triggered_telescopes"]
-        if len(telescopes) > 0:
-            # add offset to obtain unique shower IDs among all files
-            self.triggered_data.triggered_id.append(self.shower["shower"] + self.shower_id_offset)
-            self.triggered_data.trigger_telescope_list_list.append(
-                np.array(telescopes, dtype=np.int16)
-            )
-
-    def _table_descriptions(self):
-        """HDF5 table descriptions for shower data, triggered data, and file names."""
-        shower_data_desc = {
-            "shower_id": tables.Int32Col(),
-            "simulated_energy": tables.Float32Col(),
-            "x_core": tables.Float32Col(),
-            "y_core": tables.Float32Col(),
-            "area_weight": tables.Float32Col(),
-            "shower_azimuth": tables.Float32Col(),
-            "shower_altitude": tables.Float32Col(),
-        }
-        triggered_data_desc = {
-            "triggered_id": tables.Int32Col(),
-            "array_altitudes": tables.Float32Col(),
-            "array_azimuths": tables.Float32Col(),
-            "telescope_list_index": tables.Int32Col(),  # Index into VLArray
-        }
-        file_names_desc = {
-            "file_names": tables.StringCol(256),
-        }
-        return shower_data_desc, triggered_data_desc, file_names_desc
-
-    def _tables(self, output_file, data_group, mode="a"):
-        """Create or get HDF5 tables."""
-        descriptions = self._table_descriptions()
-        table_names = ["reduced_data", "triggered_data", "file_names"]
-
-        table_dict = {}
-        for name, desc in zip(table_names, descriptions):
-            path = f"/data/{name}"
-            table_dict[name] = (
-                output_file.create_table(
-                    data_group, name, desc, name.replace("_", " ").title(), filters=DEFAULT_FILTERS
-                )
-                if mode == "w" or path not in output_file
-                else output_file.get_node(path)
-            )
-
-        return table_dict["reduced_data"], table_dict["triggered_data"], table_dict["file_names"]
-
-    def _write_event_data(self, reduced_table):
-        """Fill event data tables."""
-        if len(self.event_data.simulated_energy) == 0:
-            return
-        row = reduced_table.row
-        for i, energy in enumerate(self.event_data.simulated_energy):
-            row["shower_id"] = (
-                self.event_data.shower_id[i] if i < len(self.event_data.shower_id) else 0
-            )
-            row["simulated_energy"] = energy
-            row["x_core"] = self.event_data.x_core[i] if i < len(self.event_data.x_core) else 0
-            row["y_core"] = self.event_data.y_core[i] if i < len(self.event_data.y_core) else 0
-            row["area_weight"] = (
-                self.event_data.area_weight[i] if i < len(self.event_data.area_weight) else 0
-            )
-            row["shower_azimuth"] = (
-                self.event_data.shower_azimuth[i] if i < len(self.event_data.shower_azimuth) else 0
-            )
-            row["shower_altitude"] = (
-                self.event_data.shower_altitude[i]
-                if i < len(self.event_data.shower_altitude)
-                else 0
-            )
-            row.append()
-        reduced_table.flush()
-
-    def _writer_triggered_data(self, triggered_table, vlarray):
-        """Fill triggered event data tables."""
-        # Get or create VLArray for telescope lists
-        if len(self.triggered_data.triggered_id) == 0:
-            return
-        row = triggered_table.row
-        start_idx = vlarray.nrows
-        for i, triggered_id in enumerate(self.triggered_data.triggered_id):
-            row["triggered_id"] = triggered_id
-            row["array_altitudes"] = (
-                self.triggered_data.array_altitudes[i]
-                if i < len(self.triggered_data.array_altitudes)
-                else 0
-            )
-            row["array_azimuths"] = (
-                self.triggered_data.array_azimuths[i]
-                if i < len(self.triggered_data.array_azimuths)
-                else 0
-            )
-            row["telescope_list_index"] = start_idx + i  # Index into the VLArray
-            row.append()
-            vlarray.append(
-                self.triggered_data.trigger_telescope_list_list[i]
-                if i < len(self.triggered_data.trigger_telescope_list_list)
-                else []
-            )
-        triggered_table.flush()
-
-    def _write_data(self, mode="a"):
-        """Write data to HDF5 file."""
-        with tables.open_file(self.output_file, mode=mode) as f:
-            data_group = (
-                f.create_group("/", "data", "Data group")
-                if mode == "w" or "/data" not in f
-                else f.get_node("/data")
-            )
-
-            reduced_table, triggered_table, file_names_table = self._tables(f, data_group, mode)
-            self._write_event_data(reduced_table)
-
-            vlarray = (
-                f.create_vlarray(
-                    data_group,
-                    "trigger_telescope_list_list",
-                    tables.Int16Atom(),
-                    "List of triggered telescope IDs",
-                )
-                if mode == "w" or "/data/trigger_telescope_list_list" not in f
-                else f.get_node("/data/trigger_telescope_list_list")
-            )
-            self._writer_triggered_data(triggered_table, vlarray)
-
-            if self.file_names:
-                file_names_table.append([[name] for name in self.file_names])
-                file_names_table.flush()
-
-    def _reset_data(self):
-        """Reset data structures for batch processing."""
-        self.event_data = ShowerEventData()
-        self.triggered_data = TriggeredEventData()
-        self.file_names = []
+        self.trigger_data.append(
+            {
+                "shower_id": self.shower_data[-1]["shower_id"],
+                "event_id": event_id,
+                "file_id": file_id,
+                "array_altitude": float(np.mean(altitudes)),
+                "array_azimuth": float(calculate_circular_mean(azimuths)),
+                "telescope_list": ",".join(map(str, telescopes)),
+            }
+        )
+
+    def _get_preliminary_nsb_level(self, file):
+        """
+        Return preliminary NSB level from file name.
+
+        Hardwired values are used for "dark", "half", and "full" NSB levels
+        (actual values are made up for this example). Will be replaced with
+        reading of sim_telarray metadata entry for NSB level (to be implemented,
+        see issue #1572).
+
+        Parameters
+        ----------
+        file : str
+            File name to extract NSB level from.
+
+        Returns
+        -------
+        float
+            NSB level extracted from file name.
+        """
+        nsb_levels = {"dark": 1.0, "half": 2.0, "full": 5.0}
+
+        for key, value in nsb_levels.items():
+            try:
+                if key in file.lower():
+                    self._logger.warning(f"NSB level set to hardwired value of {value}")
+                    return value
+            except AttributeError as exc:
+                raise AttributeError("Invalid file name.") from exc
+
+        self._logger.warning("No NSB level found in file name, defaulting to 1.0")
+        return 1.0

simtools/simtel/simtel_io_file_info.py

@@ -0,0 +1,62 @@
+#!/usr/bin/python3
+"""Read file info and run headers from sim_telarray files."""
+
+from eventio import EventIOFile
+from eventio.simtel import MCRunHeader, MCShower, RunHeader
+
+
+def get_corsika_run_number(file):
+    """
+    Return the CORSIKA run number from a sim_telarray file.
+
+    Parameters
+    ----------
+    file: str
+        Path to the sim_telarray file.
+
+    Returns
+    -------
+    int, None
+        CORSIKA run number. Returns None if not found.
+    """
+    run_header = get_corsika_run_header(file)
+    return run_header.get("run") if run_header else None
+
+
+def get_corsika_run_header(file):
+    """
+    Return the CORSIKA run header information from a sim_telarray file.
+
+    Reads both RunHeader and MCRunHeader object from file and
+    returns a merged dictionary. Adds primary id from the first event.
+
+    Parameters
+    ----------
+    file: str
+        Path to the sim_telarray file.
+
+    Returns
+    -------
+    dict, None
+        CORSIKA run header. Returns None if not found.
+    """
+    run_header = None
+    mc_run_header = None
+    primary_id = None
+
+    with EventIOFile(file) as f:
+        for o in f:
+            if isinstance(o, RunHeader) and run_header is None:
+                run_header = o.parse()
+            elif isinstance(o, MCRunHeader) and mc_run_header is None:
+                mc_run_header = o.parse()
+            elif isinstance(o, MCShower):  # get primary_id from first MCShower
+                primary_id = o.parse().get("primary_id")
+            if run_header and mc_run_header and primary_id is not None:
+                break
+
+    run_header = run_header or {}
+    mc_run_header = mc_run_header or {}
+    if primary_id is not None:
+        mc_run_header["primary_id"] = primary_id
+    return run_header | mc_run_header or None

simtools/simtel/simtel_io_histogram.py

@@ -1,4 +1,4 @@
-"""Reads the content of either a single histogram or simtel_array output file."""
+"""Reads the content of either a single histogram or sim_telarray output file."""
 
 import copy
 import logging
@@ -11,7 +11,8 @@ from ctao_cr_spectra.definitions import IRFDOC_PROTON_SPECTRUM
 from ctao_cr_spectra.spectral import cone_solid_angle
 from eventio import EventIOFile, Histograms
 from eventio.search_utils import yield_toplevel_of_type
-from eventio.simtel import MCRunHeader
+
+from simtools.simtel.simtel_io_file_info import get_corsika_run_header
 
 __all__ = [
     "HistogramIdNotFoundError",
@@ -32,13 +33,13 @@ class SimtelIOHistogram:
     """
     Reads and generates histograms from sim_telarray output.
 
-    Read the content of either a single histogram (.hdata, or .hdata.zst) or a single simtel_array
+    Read the content of either a single histogram (.hdata, or .hdata.zst) or a single sim_telarray
     output file (.simtel or .simtel.zst).
 
     Parameters
     ----------
     histogram_file: str
-        The histogram (.hdata.zst) or simtel_array (.simtel.zst) file.
+        The histogram (.hdata.zst) or sim_telarray (.simtel.zst) file.
     area_from_distribution: bool
         If true, the area thrown (the area in which the simulated events are distributed)
         in the trigger rate calculation is estimated based on the event distribution.
@@ -135,14 +136,9 @@ class SimtelIOHistogram:
         Returns
         -------
         dict:
-            dictionary with information about the simulation (pyeventio MCRunHeader object).
+            dictionary with information about the simulation
         """
-        if self._config is None:
-            with EventIOFile(self.histogram_file) as f:
-                self._config = next(
-                    (obj.parse() for obj in f if isinstance(obj, MCRunHeader)), None
-                )
-        return self._config
+        return self._config if self._config else get_corsika_run_header(self.histogram_file)
 
     @property
     def total_number_of_events(self):
@@ -348,7 +344,7 @@ class SimtelIOHistogram:
             for the triggered events.
         """
         if self.trigger_rate is None:
-            # Get the simulated and triggered 2D histograms from the simtel_array output file
+            # Get the simulated and triggered 2D histograms from the sim_telarray output file
             if events_histogram is None and triggered_events_histogram is None:
                 events_histogram, triggered_events_histogram = self.fill_event_histogram_dicts()
             # Calculate triggered/simulated event 1D histogram (energy dependent)
@@ -408,7 +404,7 @@ class SimtelIOHistogram:
         """
         Produce the meta data to include in the tabulated form of the trigger rate per energy bin.
 
-        It shows some information from the input file (simtel_array file) and the final estimate
+        It shows some information from the input file (sim_telarray file) and the final estimate
         system trigger rate.
 
         Returns
@@ -417,7 +413,7 @@ class SimtelIOHistogram:
             dictionary with the metadata.
         """
         return {
-            "simtel_array_file": self.histogram_file,
+            "sim_telarray_file": self.histogram_file,
             "simulation_input": self.print_info(mode="silent"),
             "system_trigger_rate (Hz)": self.trigger_rate.value,
         }