Agent skill

lomb-scargle-periodogram

Lomb-Scargle periodogram for finding periodic signals in unevenly sampled time series data. Use when analyzing light curves, radial velocity data, or any astronomical time series to detect periodic variations. Works for stellar rotation, pulsation, eclipsing binaries, and general periodic phenomena. Based on lightkurve library.

Stars 897
Forks 232

Install this agent skill to your Project

npx add-skill https://github.com/benchflow-ai/skillsbench/tree/main/tasks/exoplanet-detection-period/environment/skills/lomb-scargle-periodogram

SKILL.md

Lomb-Scargle Periodogram

The Lomb-Scargle periodogram is the standard tool for finding periods in unevenly sampled astronomical time series data. It's particularly useful for detecting periodic signals in light curves from space missions like Kepler, K2, and TESS.

Overview

The Lomb-Scargle periodogram extends the classical periodogram to handle unevenly sampled data, which is common in astronomy due to observing constraints, data gaps, and variable cadences.

Basic Usage with Lightkurve

python
import lightkurve as lk
import numpy as np

# Create a light curve object
lc = lk.LightCurve(time=time, flux=flux, flux_err=error)

# Create periodogram (specify maximum period to search)
pg = lc.to_periodogram(maximum_period=15)  # Search up to 15 days

# Find strongest period
strongest_period = pg.period_at_max_power
max_power = pg.max_power

print(f"Strongest period: {strongest_period:.5f} days")
print(f"Power: {max_power:.5f}")

Plotting Periodograms

python
import matplotlib.pyplot as plt

pg.plot(view='period')  # View vs period (not frequency)
plt.xlabel('Period [days]')
plt.ylabel('Power')
plt.show()

Important: Use view='period' to see periods directly, not frequencies. The default view='frequency' shows frequency (1/period).

Period Range Selection

Choose appropriate period ranges based on your science case:

  • Stellar rotation: 0.1 - 100 days
  • Exoplanet transits: 0.5 - 50 days (most common)
  • Eclipsing binaries: 0.1 - 100 days
  • Stellar pulsations: 0.001 - 1 day
python
# Search specific period range
pg = lc.to_periodogram(minimum_period=2.0, maximum_period=7.0)

Interpreting Results

Power Significance

Higher power indicates stronger periodic signal, but be cautious:

  • High power: Likely real periodic signal
  • Multiple peaks: Could indicate harmonics (period/2, period*2)
  • Aliasing: Very short periods may be aliases of longer periods

Common Patterns

  1. Single strong peak: Likely the true period
  2. Harmonics: Peaks at period/2, period*2 suggest the fundamental period
  3. Aliases: Check if period*2 or period/2 also show signals

Model Fitting

Once you find a period, you can fit a model:

python
# Get the frequency at maximum power
frequency = pg.frequency_at_max_power

# Create a model light curve
model = pg.model(time=lc.time, frequency=frequency)

# Plot data and model
import matplotlib.pyplot as plt
lc.plot(label='Data')
model.plot(label='Model')
plt.legend()
plt.show()

Dependencies

bash
pip install lightkurve numpy matplotlib

References

When to Use This vs. Other Methods

  • Lomb-Scargle: General periodic signals (rotation, pulsation, eclipsing binaries)
  • Transit Least Squares (TLS): Specifically for exoplanet transits (more sensitive)
  • Box Least Squares (BLS): Alternative transit detection method

For exoplanet detection, consider using TLS after Lomb-Scargle for initial period search.

Expand your agent's capabilities with these related and highly-rated skills.

benchflow-ai/skillsbench

csv-processing

Use this skill when reading sensor data from CSV files, writing simulation results to CSV, processing time-series data with pandas, or handling missing values in datasets.

897 232
Explore
benchflow-ai/skillsbench

pid-controller

Use this skill when implementing PID control loops for adaptive cruise control, vehicle speed regulation, throttle/brake management, or any feedback control system requiring proportional-integral-derivative control.

897 232
Explore
benchflow-ai/skillsbench

yaml-config

Use this skill when reading or writing YAML configuration files, loading vehicle parameters, or handling config file parsing with proper error handling.

897 232
Explore
benchflow-ai/skillsbench

simulation-metrics

Use this skill when calculating control system performance metrics such as rise time, overshoot percentage, steady-state error, or settling time for evaluating simulation results.

897 232
Explore
benchflow-ai/skillsbench

vehicle-dynamics

Use this skill when simulating vehicle motion, calculating safe following distances, time-to-collision, speed/position updates, or implementing vehicle state machines for cruise control modes.

897 232
Explore
benchflow-ai/skillsbench

web-interface-guidelines

Vercel's comprehensive UI guidelines for building accessible, performant web interfaces. Use this skill when reviewing or building UI components for compliance with best practices around accessibility, performance, animations, and visual stability.

897 232
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results