Search & research
evo-tess-transit
Detect exoplanet transit periods from TESS space telescope lightcurves. Identifies and removes stellar variability, runs BLS transit search with harmonic filtering, refines with batman model fitting, and validates across multiple detrending configurations.
Zhang-Henry · AI review on file
Installation
Read the source and dependencies before running a command. Copying does not install or execute anything.
npx skills add Zhang-Henry/CoEvoSkills --skill evo-tess-transitAbout this skill
name: evo-tess-transit description: "Detect exoplanet transit periods from TESS space telescope lightcurves. Identifies and removes stellar variability, runs BLS transit search with harmonic filtering, refines with batman model fitting, and validates across multiple detrending configurations."
TESS Transit Period Detection
Quick Start
import sys
sys.path.insert(0, '/app/environment/skills/evo-tess-transit/scripts')
from utils import find_exoplanet_period, validate_output
period = find_exoplanet_period(
input_path='/root/data/tess_lc.txt',
output_path='/root/period.txt',
round_digits=5
)
validate_output('/root/period.txt')
Pipeline Steps
- Load & filter — read 4-column file (time, flux, flag, error), keep flag==0
- Outlier removal — symmetric sigma clipping (configurable bounds)
- Stellar rotation — Lomb-Scargle finds dominant periodic variability
- Multi-window BLS — detrending windows derived as fractions of the stellar period; BLS peaks at stellar harmonics are excluded
- Iterative transit-masked detrending — mask transit phases, interpolate, re-smooth, repeat to avoid absorbing transits into the trend
- Batman model fit — differential evolution + Nelder-Mead for precise period, Rp/Rs, a/Rs, inclination
- Robustness — repeat batman fit across the detrending window grid; report median period
- Output — write rounded period to file
Function Reference
| Function | Purpose |
|---|---|
load_and_filter(path) | Quality-filtered LC |
remove_outliers(t,f,e,...) | Sigma clipping |
identify_stellar_rotation(t,f,e) | LS dominant period |
median_detrend(t,f,e,window) | Simple median filter |
detrend_with_transit_mask(t,f,e,P,t0,window,...) | Iterative masked detrend |
bls_search(t,f,e,...) | BLS periodogram |
refine_bls(t,f,e,p0,...) | Fine-grid BLS |
top_bls_peaks(results,...) | Ranked peak list |
is_harmonic(pa,pb,...) | Harmonic check |
multi_window_bls(t,f,e,stellar_p,...) | Multi-window search |
fit_batman(t,f,e,per0,t0,...) | Transit model fit |
find_exoplanet_period(in,out,...) | End-to-end entry point |
validate_output(path,...) | Output format check |
All numeric thresholds are function parameters with physically motivated defaults. No instance-specific constants are embedded.