Metadata-Version: 2.4
Name: legend-data-monitor
Version: 2.1.3
Summary: Python package for LEGEND data monitoring
Author-email: Sofia Calgaro <sofia.calgaro@physik.uzh.ch>, Michele Morella <michele.morella@gssi.it>
Maintainer: The LEGEND Collaboration
License: MIT
Keywords: LEGEND,monitoring,physics,data-analysis
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX
Classifier: Operating System :: Unix
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Classifier: Topic :: Scientific/Engineering :: Mathematics
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: Topic :: Software Development
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pygama
Requires-Dist: pylegendmeta>=0.9
Requires-Dist: seaborn
Provides-Extra: all
Requires-Dist: legend-data-monitor[docs,test]; extra == "all"
Provides-Extra: docs
Requires-Dist: furo; extra == "docs"
Requires-Dist: myst-parser; extra == "docs"
Requires-Dist: sphinx; extra == "docs"
Requires-Dist: sphinx-copybutton; extra == "docs"
Provides-Extra: test
Requires-Dist: pre-commit; extra == "test"
Requires-Dist: pytest>=6.0; extra == "test"
Requires-Dist: pytest-cov; extra == "test"
Requires-Dist: freezegun==1.5.5; extra == "test"
Dynamic: license-file

# legend-data-monitor

![GitHub tag (latest by date)](https://img.shields.io/github/v/tag/legend-exp/legend-data-monitor?logo=git)
[![GitHub Workflow Status](https://img.shields.io/github/checks-status/legend-exp/legend-data-monitor/main?label=main%20branch&logo=github)](https://github.com/legend-exp/legend-data-monitor/actions)
[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white)](https://github.com/pre-commit/pre-commit)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
[![Codecov](https://img.shields.io/codecov/c/github/legend-exp/legend-data-monitor?logo=codecov)](https://app.codecov.io/gh/legend-exp/legend-data-monitor)
![GitHub issues](https://img.shields.io/github/issues/legend-exp/legend-data-monitor?logo=github)
![GitHub pull requests](https://img.shields.io/github/issues-pr/legend-exp/legend-data-monitor?logo=github)
![License](https://img.shields.io/github/license/legend-exp/legend-data-monitor)
[![Read the Docs](https://img.shields.io/readthedocs/legend-data-monitor?logo=readthedocs)](https://legend-data-monitor.readthedocs.io)

`legend-data-monitor` is a Python toolkit for monitoring the LEGEND experiment, enabling **inspection, visualization, and quality control** of experimental data. The main features are:

- **dataframe setup**: build dataframes containing channel maps and status for subsystems like auxiliary, HPGe and SiPM channels.
- **parameter access**: retrieve parameters of interest from raw, DSP, hit tiers, or user-defined sources for a given dataset.
- **flexible inspection**: filter and inspect parameters by time intervals, specific runs, or keys.
- **status mapping**: plot channel status maps (ON/OFF/...), highlighting channels exceeding or falling below configurable thresholds.
- **automated monitoring workflows**: semi-offline and continuous performance checks.
- **visualization utilities**: generate time series plots, histograms, and other performance indicators for monitoring.
