← Back to Skills Marketplace
wu-uk

lomb-scargle-periodogram

by wu-uk · GitHub ↗ · v0.1.0 · MIT-0
cross-platform ✓ Security Clean
70
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install exoplanet-detection-period-lomb-scargle-periodogram
Description
Lomb-Scargle periodogram for finding periodic signals in unevenly sampled time series data. Use when analyzing light curves, radial velocity data, or any ast...
README (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

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.

Usage Guidance
This skill is a straightforward, instruction-only guide for using lightkurve to compute Lomb–Scargle periodograms. If you install dependencies, prefer installing from the official PyPI packages or your environment's package manager and verify package provenance. Note the examples expect you to provide time, flux, and error arrays (they do not load data for you). If you plan to run code in a shared or production environment, review and test the code snippets and consider using virtual environments to isolate installed packages.
Capability Assessment
Purpose & Capability
Name and description match the SKILL.md content: examples and dependency list (lightkurve, numpy, matplotlib) are exactly what a Lomb–Scargle periodogram helper would need.
Instruction Scope
SKILL.md contains only example Python code and guidance for period selection, plotting, and interpretation. It does not instruct reading unrelated files, accessing credentials, calling external endpoints, or collecting data outside the stated astronomy context. Example snippets assume caller provides time/flux arrays, which is normal.
Install Mechanism
No install spec; dependency installation is limited to standard pip packages (lightkurve, numpy, matplotlib) mentioned in docs. No downloads from untrusted URLs or archive extraction are specified.
Credentials
Skill declares no required environment variables, credentials, or config paths. The requested packages and examples are proportionate to the stated functionality.
Persistence & Privilege
Skill is instruction-only, not always-enabled, and does not request persistent or cross-skill configuration. Autonomous invocation is allowed by platform default but is not combined with any broad privileges.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install exoplanet-detection-period-lomb-scargle-periodogram
  3. After installation, invoke the skill by name or use /exoplanet-detection-period-lomb-scargle-periodogram
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
Bulk publish from all-task-skills-dedup
Metadata
Slug exoplanet-detection-period-lomb-scargle-periodogram
Version 0.1.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is 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 ast... It is an AI Agent Skill for Claude Code / OpenClaw, with 70 downloads so far.

How do I install lomb-scargle-periodogram?

Run "/install exoplanet-detection-period-lomb-scargle-periodogram" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is lomb-scargle-periodogram free?

Yes, lomb-scargle-periodogram is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does lomb-scargle-periodogram support?

lomb-scargle-periodogram is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created lomb-scargle-periodogram?

It is built and maintained by wu-uk (@wu-uk); the current version is v0.1.0.

💬 Comments