Skip to main content

Deep-LC

PyPI Image

Deep-LC is open-source and intended for the classification of light curves (LCs) in a gernaral purpose. It utilizes a weakly supervised object detection algorithm to automatically zoom in on the LC and power spectrum (PS) to extract local features. This eliminates the need for manual feature extraction and allows it to be applied to both space- and ground-based observations, as well as multiband LCs with large gaps and nonuniform sampling.

The implenmentaion and performace detail can be found in our paper.

LC component processing animation of TIC 470109695, which is a rotating variable star. Our model can automatically zoom in on the LC and PS to extract local features.

LC component processing

PS component processing animation of KIC 12268220, which is an eclipsing bianry with a $\delta$ Scuti pulsating primary star.

PS component processing

Introduction

Deep-LC is easy to install with pip:

pip install deep-lightcurve

Or install the development version from source:

git clone https://github.com/ckm3/Deep-LC.git
cd Deep-LC
pip install -e .

Quickstart

from deep_lc import DeepLC

# Load model
dl_combined = DeepLC(combined_model="model_path")

# Load light curve
lc = np.load("your_light_curve_path")

# Predict as show intermediate results
prediction, figs = dl_combined.predict(lc, show_intermediate_results=True)

Please visit the quickstart page for details. All models are avilable on Zenodo.

Citing

If you are using Deep-LC in your research, please cite our paper and add a footnote of this Github project.

@ARTICLE{Cui:2024:ApJS,
       author = {{Cui}, Kaiming and {Armstrong}, D.~J. and {Feng}, Fabo},
        title = "{Identifying Light-curve Signals with a Deep-learning-based Object Detection Algorithm. II. A General Light-curve Classification Framework}",
      journal = {\apjs},
     keywords = {Light curve classification, Astronomy data analysis, Convolutional neural networks, Variable stars, Transient detection, 1954, 1858, 1938, 1761, 1957, Astrophysics - Instrumentation and Methods for Astrophysics, Astrophysics - High Energy Astrophysical Phenomena, Astrophysics - Solar and Stellar Astrophysics, Computer Science - Computer Vision and Pattern Recognition},
         year = 2024,
        month = oct,
       volume = {274},
       number = {2},
          eid = {29},
        pages = {29},
          doi = {10.3847/1538-4365/ad62fd},
archivePrefix = {arXiv},
       eprint = {2311.08080},
 primaryClass = {astro-ph.IM},
       adsurl = {https://ui.adsabs.harvard.edu/abs/2024ApJS..274...29C},
      adsnote = {Provided by the SAO/NASA Astrophysics Data System}
}

Metadata

Release files for Deep-Lightcurve 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for Deep-Lightcurve 0.1.1
File Size Uploaded
deep_lightcurve-0.1.1.tar.gz 507.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for Deep-Lightcurve 0.1.1
File Interpreter ABI Platform
deep_lightcurve-0.1.1-py3-none-any.whl Python 3 none any Details

Total release size: 539.4 kB

Release files / deep_lightcurve-0.1.1.tar.gz

Download URL deep_lightcurve-0.1.1.tar.gz
Size 507.7 kB
Tags Source
SHA-256 checksum
How to use checksums
551094333ebffcbaece998f5887bb0bbdb7059ebd29c136e6725f1ed8b443cb5
BLAKE2b-256 checksum
How to use checksums
5f7da872cb40372381ab34400dbddc82928854d473ca7a9fc2684388a417e802
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.10

Release files / deep_lightcurve-0.1.1-py3-none-any.whl

Download URL deep_lightcurve-0.1.1-py3-none-any.whl
Size 31.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8154b0d0af7efed107a28fb042adb05f212689cd65472c031991b177d3efa446
BLAKE2b-256 checksum
How to use checksums
49047a6ef0c5bc80bbae60544f151ac17b5da7b15bf8155d19239e18bc3dce70
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.10

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page