box-least-squares

Detect periodic box-shaped transit signals in photometric time series using the Box Least Squares method.

Updated Jan 15, 2026
One-click install
npx skills add https://github.com/KaiserWhoLearns/skillsbench --skill box-least-squares
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: box-least-squares
Source: https://github.com/KaiserWhoLearns/skillsbench/tree/main/tasks/exoplanet-detection-period/environment/skills/box-least-squares
Command: npx skills add https://github.com/KaiserWhoLearns/skillsbench --skill box-least-squares

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Box Least Squares (BLS) periodogram detects periodic box-shaped transit signals in photometric time series, enabling efficient search for exoplanets and eclipsing binaries by fitting for period, duration, depth, and reference time.

Core Features & Use Cases

  • Automatic period search and peak detection in light curves to identify transit candidates.
  • Parameter estimation and validation with compute_stats(), including depth, duration, and transit timing.
  • Built-in support for cross-checking with TLS and Lomb-Scargle in exoplanet surveys.

Quick Start

Run the BLS search on your light curve data to identify candidate box-shaped transits.

Frequently Asked Questions about box-least-squares

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

FAQPage Schema
How do I detect exoplanet transits in a photometric light curve?

Apply a Box Least Squares periodogram search to your photometric time series to detect periodic box-shaped transit signals. It automatically estimates period, duration, depth, and reference time for exoplanet and eclipsing-binary candidates.

How does the Box Least Squares method estimate transit parameters?

The Box Least Squares method fits periodic box-shaped signals to photometric time series data to estimate transit period, duration, depth, and reference time. It provides validation statistics to help assess the detected exoplanet transit candidates.

Can I use astropy BoxLeastSquares for eclipsing binary searches?

Yes, you can use astropy BoxLeastSquares for eclipsing binary searches because it detects periodic box-shaped signals in photometric time series. The method applies to both exoplanet transit detection and eclipsing-binary light curve analysis.

What is the best way to validate transit candidates in a light curve?

Validate transit candidates by applying compute_stats() to the detected Box Least Squares peaks. This provides validation statistics for transit timing, depth, and duration to confirm periodic box-shaped signals in photometric time series data.

How does BLS compare to Lomb-Scargle for exoplanet transit detection?

BLS detects periodic box-shaped transit signals in light curves, while Lomb-Scargle fits sinusoidal variations in time series. The BLS periodogram is designed for exoplanet transit detection and can be cross-checked with Lomb-Scargle during surveys.

Do I need numpy and astropy to run a BLS periodogram search?

Yes, you need numpy and astropy to run a BLS periodogram search. The Skill requires astropy BoxLeastSquares for core transit fitting and numpy for array handling, with optional plotting libraries for visualizing light curve results.