isgri 0.2.0

Python package for INTEGRAL IBIS/ISGRI lightcurve analysis

isgri

Python package for ISGRI (INTEGRAL Soft Gamma-Ray Imager) lightcurve analysis.

Installation

pip install isgri

Or from source:

git clone https://github.com/dominp/isgri.git
cd isgri
pip install -e .

Quick Start

from isgri.utils import LightCurve, QualityMetrics

# Load data
lc = LightCurve.load_data(
    events_path='/path/to/isgri_events.fits',
    pif_path='/path/to/source_model.fits'
)

# Create lightcurve
time, counts = lc.rebin(binsize=1.0, emin=30, emax=300)

# Create lightcurve per each module
times, module_counts = lc.rebin_by_modules(binsize=1.0, emin=30, emax=300)

# Compute quality metrics
qm = QualityMetrics(lc, binsize=1.0, emin=30, emax=300)
chi = qm.raw_chi_squared()

About PIF files: PIF (Pixel Illumination Fraction) files contain per-pixel sensitivity maps generated by OSA task ii_pif. They weight events based on source position to improve signal-to-noise ratio. Using PIF files is recommended but optional.

Features

• Load ISGRI events and PIF files
• Rebin lightcurves with custom binning
• Module-by-module analysis (8 detector modules)
• Quality metrics (chi-squared variability tests)
• Time conversions (IJD ↔ UTC)
• Custom event filtering

Documentation

• Tutorial: - Tutorial: See demo notebook on GitHub
• API docs: All functions have docstrings - use help(LightCurve)