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.

Safety Notice

This listing is from the official public ClawHub registry. Review SKILL.md and referenced scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "lomb-scargle-periodogram" with this command: npx skills add wu-uk/exoplanet-detection-period-lomb-scargle-periodogram

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.

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Related Skills

Related by shared tags or category signals.

General

Demora

Use the Demora OpenClaw plugin for dementia-friendly companionship, medication reminders, caregiver escalation, Weixin intervention, and voice-safe patient r...

Registry SourceRecently Updated
General

AIWolfPK - AI狼人杀

四个AI互相猜疑,你坐着看戏。每局30秒,到底谁是狼? Four AIs play Werewolf while you watch. 30s per round. Spot the wolf before they do.

Registry SourceRecently Updated
General

Miaoji Video Script Pro

亚马逊视频脚本Pro版,多时长规格+平台专属Hook+A/B测试脚本+缩略图文案。 从单次脚本建议升级为完整视频内容矩阵。基础功能可使用 miaoji-video-script 免费版。

Registry SourceRecently Updated
General

Juejin

掘金技术社区一站式操作技能,支持热门文章排行榜查询、Markdown 文章一键发布和文章下载保存为 Markdown。

Registry SourceRecently Updated
17K6wscats