injector.py — Synthetic source injector for recovery and completeness studies

injector.py v1.5 — Inject synthetic point sources or transient events into real FITS images.

Features
• Accepts any single-extension FITS image with valid WCS  
• Injects a properly centered Gaussian PSF at user-specified RA/Dec or pixel (x, y) position  
• Converts input magnitude to flux using actual header zero-point (MAGZPT, ZPMAG, etc.; fallback 25.0)  
• Supports point source, simple transit dip, supernova-like burst, or microlensing boost  
• Performs image bounds checking and safe WCS handling  
• Preserves original header and WCS in output  

Intended for pipeline validation and completeness testing.

Usage example:
python injector.py science.fits --ra 266.4168 --dec -29.0078 --mag 19.2 --type point --fwhm 2.8 --out injected.fits

Made by Britt (2025) — MIT License