Stingray: A Modern Python Library For Spectral Timing

Abstract

This paper describes the design and implementation of Stingray, a library in Python built to perform time series analysis and related tasks on astronomical light curves. Its core functionality comprises a range of Fourier analysis techniques commonly used in spectral-timing analysis, as well as extensions for analyzing pulsar data, simulating data sets, and statistical modeling. Its modular build allows for easy extensions and incorporation of its methods into data analysis workflows and pipelines. We aim for the library to be a platform for the implementation of future spectral-timing techniques. Here, we describe the overall vision and framework, core functionality, extensions, and connections to high-level command-line and graphical interfaces. The code is well-tested, with a test coverage of currently 95%, and is accompanied by extensive API documentation and a set of step-by-step tutorials.

16 pages, 6 figures; published in ApJ Vol 881, No 1

References in corpus (58)

• emcee: The MCMC Hammer
• The NumPy array: a structure for efficient numerical computation
• The Astropy Project: Building an inclusive, open-science project and status of the v2.0 core package
• The Transiting Exoplanet Survey Satellite
• LSST: from Science Drivers to Reference Design and Anticipated Data Products
• The Nuclear Spectroscopic Telescope Array (NuSTAR) Mission
• The Zwicky Transient Facility: System Overview, Performance, and First Results
• Detection of Planetary Transits Across a Sun-like Star
• On characterising the variability properties of X-ray light curves from active galaxies
• Fast and scalable Gaussian process modeling with applications to astronomical time series
• Kepler Input Catalog: Photometric Calibration and Stellar Classification
• The Zwicky Transient Facility: Science Objectives
• The Second Fermi Large Area Telescope Catalog of Gamma-ray Pulsars
• Statistics: Handle with Care, Detecting Multiple Model Components with the Likelihood Ratio Test
• Binary and Millisecond Pulsars
• The evolution of the timing properties of the black-hole transient GX 339-4 during its 2002/2003 outburst
• X-ray reverberation around accreting black holes
• Discovery of Rapid X-ray Oscillations in the Tail of the SGR 1806-20 Hyperflare
• The flux-dependent amplitude of broadband noise variability in X-ray binaries and active galaxies
• Discovery of Fast X-ray Oscillations During the 1998 Giant Flare from SGR 1900+14
• Flexible and Scalable Methods for Quantifying Stochastic Variability in the Era of Massive Time-Domain Astronomical Data Sets
• X-Ray Variability Coherence: How to Compute it, What it Means, and How it Constrains Models of Cyg X-1 and GX 339-4
• Dynamical Evidence for a Black Hole in GX 339-4
• Planetary Candidates Observed by Kepler. VII. The First Fully Uniform Catalog Based on The Entire 48 Month Dataset (Q1-Q17 DR24)
• Broad-band X-ray/gamma-ray spectra and binary parameters of GX 339-4 and their astrophysical implications
• A Bayesian test for periodic signals in red noise
• Detection with RHESSI of high frequency X-ray oscillations in the tail of the 2004 hyperflare from SGR 1806-20
• eXTP -- enhanced X-ray Timing and Polarimetry Mission
• Accretion disc variability in the hard state of black hole X-ray binaries
• On the masses and evolutionary status of the black hole binary GX 339-4. A twin system of XTE J1550-564?
• The Kepler Light Curves of AGN: A Detailed Analysis
• No Time for Dead Time: Timing analysis of bright black hole binaries with NuSTAR
• The mass function of GX 339-4 from spectroscopic observations of its donor star
• Accretion-induced variability links young stellar objects, white dwarfs, and black holes
• A large-scale search for evidence of quasi-periodic pulsations in solar flares
• Autoregressive Times Series Methods for Time Domain Astronomy
• Phase-resolved spectroscopy of low frequency quasi-periodic oscillations in GRS 1915+105
• A Potential Cyclotron Resonant Scattering Feature in the ULX Pulsar NGC 300 ULX1 seen by NuSTAR and XMM-Newton
• The evolution of GX 339-4 in the low-hard state as seen by NuSTAR and Swift
• Phase-Resolved Spectroscopy of Type B Quasi-Periodic Oscillations in GX 339-4
• Quasi-Periodic Oscillations and broadband variability in short magnetar bursts
• Radio Frequency Timing Analysis of the Compact Jet in the Black Hole X-ray Binary Cygnus X-1
• HZ Her: Stellar Radius from X-ray Eclipse Observations, Evolutionary State and a New Distance
• Magnetically gated accretion in an accreting 'non-magnetic' white dwarf
• Individual power density spectra of Swift gamma-ray bursts
• Higher Order Variability Properties of Accreting Black Holes
• Kepler K2 observations of the transitional millisecond pulsar PSR J1023+0038
• No Time for Dead Time: Use the Fourier Amplitude Differences to Normalize Dead-time-affected Periodograms
• The biphase explained: understanding the asymmetries in coupled Fourier components of astronomical timeseries
• Extreme radio flares and associated X-ray variability from young stellar objects in the Orion Nebula Cluster
• Inversion of the decay of the cyclotron line energy in Her X-1
• The Bicoherence as a Diagnostic for Models of High Frequency QPOs
• Observing the transient pulsations of SMC X-1 with NuSTAR
• The black hole X-ray transient Swift J1357.2-0933 as seen with Swift and NuSTAR during its 2017 outburst
• On the Statistical Properties of Cospectra
• Discovery of pulsation dropout and turn-on during the high state of the accreting X-ray pulsar LMC X-4
• The Physical Interpretation of X-ray Phase Lags and Coherence: RXTE Observations of Cygnus X--1 as a Case Study
• A curious case of the accretion-powered X-ray pulsar GX 1+4

Cited by in corpus (133)

• The Astropy Project: Sustaining and Growing a Community-oriented Open-source Project and the Latest Major Release (v5.0) of the Core Package
• PINT: A Modern Software Package for Pulsar Timing
• Gammapy: A Python package for gamma-ray astronomy
• Polarized x-rays from a magnetar
• Measuring fundamental jet properties with multi-wavelength fast timing of the black hole X-ray binary MAXI J1820+070
• Long-term X-ray spectral evolution of Ultraluminous X-ray sources: implications on the accretion flow geometry and the nature of the accretor
• Synthetic gamma-ray lightcurves of Kerr black-hole magnetospheric activity from particle-in-cell simulations
• The Unusual Broadband X-ray Spectral Variability of NGC 1313 X-1 seen with XMM$-$Newton, Chandra and NuSTAR
• Measuring the masses of magnetic white dwarfs: A NuSTAR Legacy Survey
• Quasi-periodic oscillations of the X-ray burst from the magnetar SGR J1935+2154 and associated with the fast radio burst FRB 200428
• All at once: transient pulsations, spin down and a glitch from the Pulsating Ultraluminous X-ray Source M82 X-2
• Highly Significant Detection of X-Ray Polarization from the Brightest Accreting Neutron Star Sco X-1
• Measuring the Density Structure of an Accretion Hot Spot
• Polarization properties of the weakly magnetized neutron star X-ray binary GS 1826-238 in the high soft state
• Disk Tearing Leads to Low and High Frequency Quasi Periodic Oscillations in a GRMHD Simulation of a Thin Accretion Disk
• A study of natural frequencies in a dynamic corona-disk system
• The evolution of the broadband temporal features observed in the black-hole transient MAXI J1820+070 with Insight-HXMT
• Wide-band view of High Frequency QPOs of GRS 1915+105 in 'softer' variability classes observed with AstroSat
• Orbital decay in M82 X-2
• A fast radio burst with sub-millisecond quasi-periodic structure
• A new candidate pulsating ULX in NGC 7793
• Timing Calibration of the NuSTAR X-ray Telescope
• Long-term pulse period evolution of the ultra-luminous X-ray pulsar NGC 7793 P13
• Relativistic X-Ray Reflection and Photoionised Absorption in the Neutron-Star Low-Mass X-ray Binary GX 13+1
• NuSTAR observations of the Transient Galactic Black Hole Binary Candidate Swift J1858.6-0814: A New Sibling of V404 Cyg and V4641 Sgr?
• Testing evolution of LFQPOs with mass accretion rate in GRS 1915+105 with Insight-HXMT
• Novel data analysis techniques in coronal seismology
• A detailed view of low-frequency quasi-periodic oscillation in the broadband 0.2-200 keV with Insight-HXMT and NICER
• Modelling Continuum Reverberation in AGN: A Spectral-Timing Analysis of the UV Variability Through X-ray Reverberation in Fairall 9
• Modeling the precession of the warped inner accretion disk in the pulsars LMC X-4 and SMC X-1 with NuSTAR and XMM-Newton
• The Evolution of Rapid Optical/X-ray Timing Correlations in the Initial Hard State of MAXI J1820+070
• Timing properties of the X-ray accreting pulsar 1A 0535+262 studied with Insight-HXMT
• Extending the $Z_n^2$ and $H$ statistics to generic pulsed profiles
• NICER observations of the evidence of Poynting-Robertson drag and disk reflection during type I X-ray bursts from 4U 1636$-$536
• Simultaneous NICER and NuSTAR Observations of the Ultra-compact X-ray Binary 4U 1543-624
• The accretion flow geometry of MAXI J1820+070 through broadband noise research with Insight-HXMT
• Correlating spectral and timing properties in the evolving jet of the micro blazar MAXI J1836-194
• A discovery of Two Slow Pulsars with FAST: "Ronin" from the Globular Cluster M15
• A Comprehensive X-ray Report on AT2019wey
• Accurate X-ray Timing in the Presence of Systematic Biases With Simulation-Based Inference
• StrayCats: A catalog of NuSTAR Stray Light Observations
• Variability In A Low-Mass AGN: Oscillation Or Eruption?
• Discovery of the first anti-glitch event in the rotation-powered pulsar PSR B0540-69
• Fast transitions of X-ray variability in the black hole transient GX 339--4: comparison with MAXI J1820+070 and MAXI J1348-630
• Optical Quasi-periodic Oscillations in the TESS light curves of three blazars
• Observing the onset of the accretion wake in Vela X-1
• UV and X-ray pulse amplitude variability in the transitional millisecond pulsar PSR J1023+0038
• RX J0529.8-6556: a BeXRB pulsar with an evolving optical period and out of phase X-ray outbursts
• X-ray spectro-polarimetric characterization of GX 340+0 in the horizontal branch: a highly inclined source?
• Search for Quasi-Periodical Oscillations in Precursors of Short and Long Gamma Ray Bursts
• Phase-resolved X-ray spectroscopy of PSR B0656+14 with SRG/eROSITA and XMM-Newton
• On the cyclotron absorption line and evidence of the spectral transition in SMC X-2 during 2022 giant outburst
• A broad-band X-ray view of the precessing accretion disk and pre-eclipse dip in the pulsar Her X-1 with NuSTAR and XMM-Newton
• Evolution of the spin, spectrum and super-orbital period of the ultraluminous X-ray pulsar M51 ULX7
• Discovery of a 584.65 Hz Burst Oscillation in the Low Mass X-Ray Binary 4U 1730--22
• Discovery of transition from marginally stable burning to unstable burning after a superburst in Aql X-1
• Detection of Millihertz Quasi-Periodic Oscillations in the X-Ray Binary 1RXS J180408.9$-$342058
• Diversity of gamma-ray and Radio Variabilities of Bright Blazars and Implications for gamma-ray Emission Location
• On the nature of the anomalous event in 2021 in the dwarf nova SS Cygni and its multi-wavelength transition
• An 8.56 keV absorption line in the hyperluminous X-ray source in NGC 4045: ultra-fast outflow or cyclotron line?
• MAXI and NuSTAR observations of the faint X-ray transient MAXI J1848-015 in the GLIMPSE-C01 Cluster
• Quasi periodic whispers from a transient ULX in M\,101: signatures of a fast-spinning neutron star?
• Reflection and timing study of the transient black hole X-ray binary MAXI J1803-298 with NuSTAR
• The Transient Ultra-luminous X-ray Source, ULX-4, in M51
• New technique for determining a pulsar period: Waterfall principal component analysis
• Determination of QPO properties in the presence of strong broad-band noise: a case study on the data of MAXI J1820+070
• Common patterns in pulse profiles of High Mass X-ray Binaries
• Investigating the nature of the ultraluminous X-ray sources in the galaxy NGC 925
• X-ray Dips and Polarization Angle Swings in GX 13+1
• Extending the baseline for SMC X-1's spin and orbital behavior with NuSTAR stray light
• An Insight-HXMT view of the mHz quasi-regular modulation phenomenon in the black hole X-ray binary 4U 1630-47
• Reflare in MAXI J1348-630]{Evolution of disc and corona in MAXI J1348-630 during the 2019 reflare: NICER and Insight-HXMT view
• X-ray reverberation lags from the 1.5 Seyfert galaxy NGC 5273
• Detection of a low frequency quasi-periodic oscillation in the soft state of Cygnus X-1 with Insight-HXMT
• Chandra, NuSTAR, and Optical Observations of the Cataclysmic Variables IGR J17528-2022 and IGR J20063+3641
• Broadband X-ray Spectral Study of Ultra-luminous X-ray Source M81 X--6
• NuSTAR and XMM-Newton observations of the binary 4FGL J1405.1-6119. A $\gamma$-ray emitting microquasar?
• The spectral-timing analysis of Cygnus X-1 with Insight-HXMT
• 1RXH J082623.6-505741: a new long-period cataclysmic variable with an evolved donor and a low mass transfer rate
• Simultaneous NICER and NuSTAR observations of the Ultraluminous source NGC 4190 ULX-1
• Modelling variability power spectra of active galaxies from irregular time series
• The inner flow geometry in MAXI J1820+070 during hard and hard-intermediate states
• The ultraluminous X-ray source M81 X-6: a weakly magnetised neutron star with a precessing accretion disc?
• Detection of QPO Soft Lag during Outburst of Swift J1727.8-1613: Estimation of Instrinsic Parameters from Spectral Study
• Revealing the intrinsic X-ray reverberation lags in IRAS 13224-3809 through the Granger causality test
• A rapid optical and X-ray timing study of the neutron star X-ray binary Swift J1858.6-0814
• An 85-s X-ray quasi-periodicity after a stellar tidal disruption by a candidate intermediate-mass black hole
• Hard X-ray flares and spectral variability in NGC 4395 ULX1
• An extreme Ultraluminous X-ray source X-1 in NGC 5055
• Constraint on the accretion of NGC 6946 X-1 using broadband X-ray data
• The High Energy X-ray Probe (HEX-P): Studying Extreme Accretion with Ultraluminous X-ray Sources
• Discovery of a ~30-Year-Duration Post-Nova Pulsating Supersoft Source in the Large Magellanic Cloud
• X-ray flashes from the low-mass X-ray binary IGR J17407-2808
• Constraining the evolution of the unstable accretion disk in SMC X-1 with NICER
• Evolution of QPOs in GX 339-4 and EXO 1846-031 with Insight-HXMT and NICER
• An X-ray view of the 2021 outburst of SXP 15.6: constraints on the binary orbit and magnetic field of the Neutron Star
• Identification of an X-ray Pulsar in the BeXRB system IGR J18219$-$1347
• The Black Hole Candidate Swift J1728.9$-$3613 and the Supernova Remnant G351.9$-$0.9
• The influence of the Insight-HXMT/LE time response on timing analysis
• Digging a little deeper: characterising three new extreme ULX candidates
• Time domain methods for X-ray and gamma-ray astronomy
• X-ray spectropolarimetric characterization of the Z-source GX 340+0 in the normal branch
• Dimming GRS 1915+105 observed with NICER and Insight--HXMT
• The hunt for new pulsating ultraluminous X-ray sources: a clustering approach
• A NuSTAR study of quasi-periodic oscillations from the ultraluminous X-ray sources in M82
• Development of the Timing System for the X-Ray Imaging and Spectroscopy Mission
• Modeling fast X-ray variability around an accreting black hole
• Extracting the X-ray reverberation response functions from the AGN light curves using an autoencoder
• Likely detection of magnetic field related LFQPO in the soft X-ray re-brightening of GRS~1915+105
• A simple, flexible method for timing cross-calibration of space missions
• Fourier Domain
• The variability behavior of NGC 925 ULX-3
• The restless population of bright X-ray sources of NCG 3621
• NGC 2403 XMM4: evidence for a super-Eddington neutron star with a possible transient pulsation
• Properties of 2017-18 'failed' Outburst of GX 339-4
• Discovery and Identification of MAXI J1621-501 as a Type I X-ray Burster with a Super-Orbital Period
• The population of hyperluminous X-ray sources as seen by XMM-Newton
• Swift J1753.5-0127 : Understanding the accretion geometry through frequency resolved spectroscopy
• Discovery of a new supergiant fast X-ray transient MAXI J0709-159 associated with the Be star LY CMa
• Searching for quasi-periodicities in short transients: the curious case of GRB 230307A
• IXPE view of the Sco-like source GX 349+2 in the normal branch
• Spectral variability in NGC 1042 ULX1
• Spectral and Timing Analysis of NuSTAR and Swift/XRT Observations of the X-Ray Transient MAXI J0637-430
• The NuSTAR view of Ultra-Compact X-ray Binaries
• 4XMM J175136.8-275858: A New Magnetar Candidate?
• Detection of Quasi-periodic Oscillations in SGR 150228213
• Probing heartbeat oscillations from the black hole X-ray binary GRS 1915+105 using spectral-timing analysis
• Pulse profile variations in the accreting X-ray pulsar Vela X-1
• A supermassive black hole under the radar: Repeating X-ray variability in a Seyfert galaxy
• Spectral and Temporal Properties of Ultra-luminous X-ray Source NGC 55 ULX1
• XMM-Newton follow-up of two eROSITA X-ray binary candidates
• Resolving SLX 1744-299 and SLX 1744-300 in the hard X-ray band: implications for their ultracompact nature
• Long thermonuclear burst driven thermal-viscous instability of accretion disk: triggering an outburst-like X-ray flare