transit-least-squares

Detect exoplanet transits in light curves using the transitleastsquares package.

4|Updated Feb 22, 2026
One-click install
npx skills add https://github.com/GeneralReasoning/env-skillsbench --skill transit-least-squares-generalreasoning
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: transit-least-squares
Source: https://github.com/GeneralReasoning/env-skillsbench/tree/main/exoplanet-detection-period/environment/skills/transit-least-squares
Command: npx skills add https://github.com/GeneralReasoning/env-skillsbench --skill transit-least-squares-generalreasoning

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

TLS provides a transit-focused method for detecting exoplanet signals in stellar light curves, outperforming generic periodograms for transit-shaped dips.

Core Features & Use Cases

  • Detect periodic transit events by fitting physical transit models across a range of periods, durations, and epochs.
  • Enable multi-planet searches with mask-and-reanalyze workflows and phase-folded visualization.
  • Applicable to photometric survey data from missions like Kepler/TESS and ground-based campaigns, for exoplanet discovery and validation.

Quick Start

Provide a light curve time series with time, flux, and flux_err to TLS to search for transits and retrieve the best-fit period, transit epoch, and depth.

Frequently Asked Questions about transit-least-squares

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I detect exoplanet transits in light curve time series data?

You can detect exoplanet transits in light curve data by fitting physical transit models across a period grid. This approach searches for transit-shaped dips in photometric time series, returning the best-fit period, depth, and signal metrics for validation.

What inputs do I need to run a transit period search on photometric data?

To run a transit period search, you need to provide time-series photometry containing time, flux, and flux_err arrays. These inputs allow the algorithm to fit transit models and retrieve period, T0, depth, SNR, and SDE metrics.

Does transit least squares work with light curves that have data gaps and varying noise?

Transit least squares is designed for time-series photometry with gaps and varying noise. It fits transit models across these imperfections, making it suitable for real-world light curves from missions like Kepler and TESS.

Why use transit least squares instead of a generic periodogram for exoplanet discovery?

Transit least squares outperforms generic periodograms for exoplanet discovery because it fits transit-shaped dips specifically. Unlike generic methods, it applies physical transit models across period and duration grids to validate candidate signals accurately.

Can I search for multiple planets in the same light curve using transit least squares?

You can search for multiple planets using a mask-and-reanalyze workflow. After identifying the primary transit signal, you mask it and reanalyze the light curve to detect additional periodic transit events.

What metrics does transit least squares output for candidate validation?

Transit least squares outputs period, T0, depth, SNR, and SDE metrics for candidate validation. These results characterize the fitted transit model and help confirm the presence of exoplanet signals in light curves.