Skip to content
cccskills
FreePublished on GitHub

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.

The English summary is being prepared. Showing the original description.

Run score Not tested

See how to install

Files included (1)

  • SKILL.md3.4 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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

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

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
# 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:

# 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

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.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Perform various data analysis on SEC 13-F and obtain some insights of fund activities such as number of holdings, AUM, and change of holdings between two quarters.

The English summary is being prepared. Showing the original description.

benchflow-ai/skillsbench1.9KUpdated Oct 23, 2026

AC branch pi-model power flow equations (P/Q and |S|) with transformer tap ratio and phase shift, matching `acopf-math-model.md` and MATPOWER branch fields. Use when computing branch flows in either direction, aggregating bus injections for nodal balance, checking MVA (rateA) limits, computing branch loading %, or debugging sign/units issues in AC power flow.

The English summary is being prepared. Showing the original description.

benchflow-ai/skillsbench1.9KUpdated Oct 23, 2026

Redact text from PDF documents for blind review anonymization

The English summary is being prepared. Showing the original description.

benchflow-ai/skillsbench1.9KUpdated Oct 23, 2026

Use when checking simplified ADA-derived plan-view bathroom accessibility constraints such as turning space, door clear width, toilet centerline, grab bars, and lavatory knee/toe clearance.

The English summary is being prepared. Showing the original description.

benchflow-ai/skillsbench1.9KUpdated Oct 23, 2026

Analyze failed GitHub Action jobs for a pull request.

The English summary is being prepared. Showing the original description.

benchflow-ai/skillsbench1.9KUpdated Oct 23, 2026

Use when extracting plan-view architectural geometry from DXF files with semantic CAD layers, especially when outputs must normalize rooms, doors, fixtures, clearances, and grab bars into machine-checkable JSON.

The English summary is being prepared. Showing the original description.

benchflow-ai/skillsbench1.9KUpdated Oct 23, 2026

See all skills by benchflow-ai

Report a problem with this skill