← Back to Skills Marketplace
wu-uk

light-curve-preprocessing

by wu-uk · GitHub ↗ · v0.1.0 · MIT-0
cross-platform ✓ Security Clean
78
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install exoplanet-detection-period-light-curve-preprocessing
Description
Preprocessing and cleaning techniques for astronomical light curves. Use when preparing light curve data for period analysis, including outlier removal, tren...
README (SKILL.md)

Light Curve Preprocessing

Preprocessing is essential before period analysis. Raw light curves often contain outliers, long-term trends, and instrumental effects that can mask or create false periodic signals.

Overview

Common preprocessing steps:

  1. Remove outliers
  2. Remove long-term trends
  3. Handle data quality flags
  4. Remove stellar variability (optional)

Outlier Removal

Using Lightkurve

import lightkurve as lk

# Remove outliers using sigma clipping
lc_clean, mask = lc.remove_outliers(sigma=3, return_mask=True)
outliers = lc[mask]  # Points that were removed

# Common sigma values:
# sigma=3: Standard (removes ~0.3% of data)
# sigma=5: Conservative (removes fewer points)
# sigma=2: Aggressive (removes more points)

Manual Outlier Removal

import numpy as np

# Calculate median and standard deviation
median = np.median(flux)
std = np.std(flux)

# Remove points beyond 3 sigma
good = np.abs(flux - median) \x3C 3 * std
time_clean = time[good]
flux_clean = flux[good]
error_clean = error[good]

Removing Long-Term Trends

Flattening with Lightkurve

# Flatten to remove low-frequency variability
# window_length: number of cadences to use for smoothing
lc_flat = lc_clean.flatten(window_length=500)

# Common window lengths:
# 100-200: Remove short-term trends
# 300-500: Remove medium-term trends (typical for TESS)
# 500-1000: Remove long-term trends

The flatten() method uses a Savitzky-Golay filter to remove trends while preserving transit signals.

Iterative Sine Fitting

For removing high-frequency stellar variability (rotation, pulsation):

def sine_fitting(lc):
    """Remove dominant periodic signal by fitting sine wave."""
    pg = lc.to_periodogram()
    model = pg.model(time=lc.time, frequency=pg.frequency_at_max_power)
    lc_new = lc.copy()
    lc_new.flux = lc_new.flux / model.flux
    return lc_new, model

# Iterate multiple times to remove multiple periodic components
lc_processed = lc_clean.copy()
for i in range(50):  # Number of iterations
    lc_processed, model = sine_fitting(lc_processed)

Warning: This removes periodic signals, so use carefully if you're searching for periodic transits.

Handling Data Quality Flags

IMPORTANT: Quality flag conventions vary by data source!

Standard TESS format

# For standard TESS files (flag=0 is GOOD):
good = flag == 0
time_clean = time[good]
flux_clean = flux[good]
error_clean = error[good]

Alternative formats

# For some exported files (flag=0 is BAD):
good = flag != 0
time_clean = time[good]
flux_clean = flux[good]
error_clean = error[good]

Always verify your data format! Check which approach gives cleaner results.

Preprocessing Pipeline Considerations

When building a preprocessing pipeline for exoplanet detection:

Key Steps (Order Matters!)

  1. Quality filtering: Apply data quality flags first
  2. Outlier removal: Remove bad data points (flares, cosmic rays)
  3. Trend removal: Remove long-term variations (stellar rotation, instrumental drift)
  4. Optional second pass: Additional outlier removal after detrending

Important Principles

  • Always include flux_err: Critical for proper weighting in period search algorithms
  • Preserve transit shapes: Use methods like flatten() that preserve short-duration dips
  • Don't over-process: Too aggressive preprocessing can remove real signals
  • Verify visually: Plot each step to ensure quality

Parameter Selection

  • Outlier removal sigma: Lower sigma (2-3) is aggressive, higher (5-7) is conservative
  • Flattening window: Should be longer than transit duration but shorter than stellar rotation period
  • When to do two passes: Remove obvious outliers before detrending, then remove residual outliers after

Preprocessing for Exoplanet Detection

For transit detection, be careful not to remove the transit signal:

  1. Remove outliers first: Use sigma=3 or sigma=5
  2. Flatten trends: Use window_length appropriate for your data
  3. Don't over-process: Too much smoothing can remove shallow transits

Visualizing Results

Always plot your light curve to verify preprocessing quality:

import matplotlib.pyplot as plt

# Use .plot() method on LightCurve objects
lc.plot()
plt.show()

Best practice: Plot before and after each major step to ensure you're improving data quality, not removing real signals.

Dependencies

pip install lightkurve numpy matplotlib

References

Best Practices

  1. Always check quality flags first: Remove bad data before processing
  2. Remove outliers before flattening: Outliers can affect trend removal
  3. Choose appropriate window length: Too short = doesn't remove trends, too long = removes transits
  4. Visualize each step: Make sure preprocessing improves the data
  5. Don't over-process: More preprocessing isn't always better
Usage Guidance
This skill is an instruction-only guide for preprocessing astronomical light curves and appears coherent with its stated purpose. If you plan to use the code: run it in a controlled Python environment (virtualenv/conda), inspect and test the snippets on non-sensitive example data, and only install the listed pip packages from official sources. Be aware that aggressive detrending or iterative sine removal can erase real signals—follow the advice in the doc and visualize each step before applying to production datasets.
Capability Analysis
Type: OpenClaw Skill Name: exoplanet-detection-period-light-curve-preprocessing Version: 0.1.0 The skill bundle provides standard astronomical data preprocessing techniques using the 'lightkurve' and 'numpy' libraries. The code and instructions in SKILL.md are strictly focused on outlier removal, detrending, and handling data quality flags for light curve analysis, with no evidence of malicious intent, data exfiltration, or prompt injection.
Capability Assessment
Purpose & Capability
Skill name and description (light-curve preprocessing for period analysis) match the content of SKILL.md. Required actions (outlier removal, flattening, quality-flag handling) and the declared dependency list (lightkurve, numpy, matplotlib) are appropriate and proportional to the stated purpose.
Instruction Scope
All runtime instructions are local data-processing code snippets (Python using lightkurve and numpy) referencing time, flux, error, and quality flag arrays. There are no instructions to read unrelated system files, access external endpoints, or exfiltrate data. The guidance is specific to preprocessing and includes sensible warnings about preserving signals.
Install Mechanism
No install spec is provided and the SKILL.md only suggests a standard pip install of well-known Python packages. This represents low installation risk for an instruction-only skill.
Credentials
No environment variables, credentials, or config paths are requested. The dependencies and operations described are consistent with processing local light-curve data and do not require elevated or unrelated secrets.
Persistence & Privilege
The skill is not always-enabled and does not claim any persistent system presence or modification of other skills. It is user-invocable and its scope is limited to providing code/instructions.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install exoplanet-detection-period-light-curve-preprocessing
  3. After installation, invoke the skill by name or use /exoplanet-detection-period-light-curve-preprocessing
  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-light-curve-preprocessing
Version 0.1.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is light-curve-preprocessing?

Preprocessing and cleaning techniques for astronomical light curves. Use when preparing light curve data for period analysis, including outlier removal, tren... It is an AI Agent Skill for Claude Code / OpenClaw, with 78 downloads so far.

How do I install light-curve-preprocessing?

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

Is light-curve-preprocessing free?

Yes, light-curve-preprocessing is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does light-curve-preprocessing support?

light-curve-preprocessing is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created light-curve-preprocessing?

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

💬 Comments