bundle.perf_report.storage.tracy
================================

.. py:module:: bundle.perf_report.storage.tracy

.. autoapi-nested-parse::

   HDF5 storage for Tracy zone profiling data.



Classes
-------

.. autoapisummary::

   bundle.perf_report.storage.tracy.ProfileStorage


Module Contents
---------------

.. py:class:: ProfileStorage(h5_path: pathlib.Path | str)

   Store and retrieve Tracy zone data in HDF5, keyed by version and platform.

   HDF5 layout::

       /<version>/<platform_id>/meta       (attrs: machine_id, platform_id, bundle_version, timestamp)
       /<version>/<platform_id>/profiles/<name>  (structured dataset)


   .. py:attribute:: h5_path


   .. py:method:: save(profiles: list[bundle.perf_report.extractor.ProfileData], machine_id: str, bundle_version: str, platform_id: str, platform_meta: dict | None = None)

      Write profiles under /<version>/<platform_id>/, appending to existing file.



   .. py:method:: list_versions() -> list[str]


   .. py:method:: list_platforms(version: str) -> list[str]


   .. py:method:: load_meta(version: str, platform_id: str) -> dict


   .. py:method:: load_profiles(version: str, platform_id: str) -> list[bundle.perf_report.extractor.ProfileData]

      Load all profiles for a specific version+platform.



   .. py:method:: from_directory(prof_dir: pathlib.Path, h5_path: pathlib.Path, machine_id: str, bundle_version: str, platform_id: str, platform_meta: dict | None = None) -> ProfileStorage
      :classmethod:


      Extract all Tracy CSV files from a path and save to HDF5.