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}
}

Metadata

Release files for nuance 0.8.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 nuance 0.8.1
File Size Uploaded
nuance-0.8.1.tar.gz 2.4 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for nuance 0.8.1
File Interpreter ABI Platform
nuance-0.8.1-py3-none-any.whl Python 3 none any Details

Total release size: 2.4 MB

Release files / nuance-0.8.1.tar.gz

Download URL nuance-0.8.1.tar.gz
Size 2.4 MB
Tags Source
SHA-256 checksum
How to use checksums
8f64075d28ada298b225dc26bf1061ae25ee0d295f18c821435ed8822736274d
BLAKE2b-256 checksum
How to use checksums
52fe4b20fe32ebd8f78b6154dd45e521f4c0a79b2bc9e2fc994e28f9338f6399
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/5.0.0 CPython/3.12.4

Release files / nuance-0.8.1-py3-none-any.whl

Download URL nuance-0.8.1-py3-none-any.whl
Size 13.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5a655352168777df01d4a99421a8d707c52978a5c07f731b9b26d73b3aba625c
BLAKE2b-256 checksum
How to use checksums
ebd73e3dc916b9c1e89932d0c08fb5f28a290c1c9066ea8f81bd8f2808d708c8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/5.0.0 CPython/3.12.4

Release history Release notifications | RSS feed

This release

0.8.1 This release

2 release files

0.8.0

2 release files

0.7.1

2 release files

0.7.0

2 release files

0.6.1

2 release files

0.6.0

2 release files

0.5.3

2 release files

0.5.2

2 release files

0.4.0

2 release files

0.3.1

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