Skip to main content

nuance

Efficient detection of planets transiting quiet or active stars

nuance uses linear models and Gaussian processes (using the JAX-based tinygp) to simultaneously search for planetary transits while modeling correlated noises (e.g. stellar variability) in a tractable way. See the paper for more details.

When to use nuance?

  • To detect single or periodic transits
  • When correlated noises are present in the data (e.g. stellar variability or instrumental systematics)
  • For space-based or sparse ground-based observations
  • To effectively find transits in light curves from multiple instruments
  • To use GPUs for fast transit searches

Documentation at nuance.readthedocs.io

Example

import numpy as np
from nuance import linear_search, periodic_search, core

# linear search
epochs = time.copy()
durations = np.linspace(0.01, 0.2, 15)
ls = linear_search(time, flux, gp=gp)(epochs, durations)

# periodic search
periods = np.linspace(0.3, 5, 2000)
snr_function = jax.jit(core.snr(time, flux, gp=gp))
ps_function = periodic_search(epochs, durations, ls, snr_function)
snr, params = ps_function(periods)

t0, D, P = params[np.argmax(snr)]

Installation

nuance is written for python 3 and can be installed using pip

pip install nuance

or from sources

git clone https://github.com/lgrcia/nuance
cd nuance
pip install -e .

Citation

If you find nuance useful for your research, cite Garcia et. al 2024. The BibTeX entry for the paper is:

@ARTICLE{2024AJ....167..284G,
       author = {{Garcia}, Lionel J. and {Foreman-Mackey}, Daniel and {Murray}, Catriona A. and {Aigrain}, Suzanne and {Feliz}, Dax L. and {Pozuelos}, Francisco J.},
        title = "{nuance: Efficient Detection of Planets Transiting Active Stars}",
      journal = {\aj},
     keywords = {Exoplanet detection methods, Stellar activity, Time series analysis, Gaussian Processes regression, Computational methods, GPU computing, 489, 1580, 1916, 1930, 1965, 1969, Astrophysics - Earth and Planetary Astrophysics, Astrophysics - Instrumentation and Methods for Astrophysics},
         year = 2024,
        month = jun,
       volume = {167},
       number = {6},
          eid = {284},
        pages = {284},
          doi = {10.3847/1538-3881/ad3cd6},
archivePrefix = {arXiv},
       eprint = {2402.06835},
 primaryClass = {astro-ph.EP},
       adsurl = {https://ui.adsabs.harvard.edu/abs/2024AJ....167..284G},
      adsnote = {Provided by the SAO/NASA Astrophysics Data System}
}

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nuance-0.8.1.tar.gz (2.4 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

nuance-0.8.1-py3-none-any.whl (13.8 kB view details)

Uploaded Python 3

File details

Details for the file nuance-0.8.1.tar.gz.

File metadata

  • Download URL: nuance-0.8.1.tar.gz
  • Upload date:
  • Size: 2.4 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.0.0 CPython/3.12.4

File hashes

Hashes for nuance-0.8.1.tar.gz
Algorithm Hash digest
SHA256 8f64075d28ada298b225dc26bf1061ae25ee0d295f18c821435ed8822736274d
MD5 7a2f6189cfc426b6376a16081c1d5a3a
BLAKE2b-256 52fe4b20fe32ebd8f78b6154dd45e521f4c0a79b2bc9e2fc994e28f9338f6399

See more details on using hashes here.

File details

Details for the file nuance-0.8.1-py3-none-any.whl.

File metadata

  • Download URL: nuance-0.8.1-py3-none-any.whl
  • Upload date:
  • Size: 13.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.0.0 CPython/3.12.4

File hashes

Hashes for nuance-0.8.1-py3-none-any.whl
Algorithm Hash digest
SHA256 5a655352168777df01d4a99421a8d707c52978a5c07f731b9b26d73b3aba625c
MD5 f73149905cf1171731d30e6f1b9fac7b
BLAKE2b-256 ebd73e3dc916b9c1e89932d0c08fb5f28a290c1c9066ea8f81bd8f2808d708c8

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.8.1 This release

2 files

0.8.0

2 files

0.7.1

2 files

0.7.0

2 files

0.6.1

2 files

0.6.0

2 files

0.5.3

2 files

0.5.2

2 files

0.4.0

2 files

0.3.1

2 files

0.1.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page