kepler-downloader-dr25

Name	kepler-downloader-dr25 JSON
Version	1.5.0 JSON
	download
home_page	https://github.com/akira921x/Kepler-Downloader-DR25
Summary	A comprehensive toolkit for downloading and filtering Kepler DR25 FITS files from NASA's MAST archive
upload_time	2025-09-08 05:15:59
maintainer	None
docs_url	None
author	akira921x
requires_python	>=3.10
license	Apache-2.0
keywords	kepler nasa astronomy exoplanet fits mast telescope space data download
VCS
bugtrack_url
requirements	pandas astroquery redis requests numpy tqdm
Travis-CI	No Travis.
coveralls test coverage	No coveralls.

            # Kepler-Downloader-DR25

[![CI Status](https://github.com/akira921x/Kepler-Downloader-DR25/actions/workflows/ci.yml/badge.svg)](https://github.com/akira921x/Kepler-Downloader-DR25/actions/workflows/ci.yml)
[![Python Version](https://img.shields.io/badge/python-3.8%2B-blue)](https://www.python.org/downloads/)
[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
[![Platform](https://img.shields.io/badge/platform-Ubuntu%20%7C%20macOS-lightgrey)](https://github.com/akira921x/Kepler-Downloader-DR25)

## Research-Oriented Toolkit for Kepler Data Analysis

**This toolkit is designed for researchers studying NASA Kepler Space Telescope data.** It follows the data structure requirements of machine learning frameworks like **[ExoMiner](https://github.com/nasa/ExoMiner)** and **[AstroNet](https://github.com/google-research/exoplanet-ml/tree/master/exoplanet-ml/astronet)** while remaining flexible for diverse research applications beyond these specific frameworks.

### Key Design Philosophy
- **Research-First Approach**: Built to support various astronomical research workflows
- **ML-Ready**: Compatible with ExoMiner, AstroNet, and other machine learning pipelines
- **Flexible Architecture**: Not limited to specific frameworks - adaptable to custom research needs
- **Scientific Rigor**: Maintains data integrity and validation standards required for publication-quality research

## Overview

A comprehensive toolkit for downloading and filtering Kepler DR25 FITS files from NASA's MAST archive with intelligent mode detection, DVT validation, and universal filtering capabilities.

This project provides two main scripts and utility tools:

**Main Scripts:**
1. **`get-kepler-dr25.py`** - Main downloader with DVT filtering for ExoMiner mode and retry capabilities.
2. **`filter-get-kepler-dr25.py`** - Universal filter with mode detection, conversion, and download of missing files.

**Utility Tools (in util/ folder):**
- **`util/rebuild_database.py`** - Rebuild SQLite database from existing filesystem (useful for recovery)
- **`util/check_missing_kics.py`** - Compare CSV with downloaded KICs to find missing ones
- **`util/generate_stats.py`** - Generate comprehensive statistics for completed jobs
- **`util/test_health_report.py`** - Diagnostic tool to verify database and health report contents

### Why This Toolkit?

**The Challenge with Kepler Data:**
- **Full TCE dataset**: ~400+ GB disk space required
- **KOI dataset**: ~200+ GB disk space required  
- **Common problems without proper tooling**:
  - Missing KICs due to network timeouts
  - Corrupted FITS files from incomplete downloads
  - Database inconsistencies from concurrent writes
  - No recovery mechanism for partial failures
  - Manual tracking of thousands of files

**What This Toolkit Solves:**

Researchers studying exoplanets, stellar variability, or other phenomena in Kepler data need efficient, reliable tools that:
- **Prevent data loss**: Redis buffering ensures zero database corruption even with network failures
- **Handle scale**: Successfully manages datasets with 17,000+ KICs (tested with full TCE catalog)
- **Ensure completeness**: Automatic retry mechanism and missing KIC detection
- **Support modern ML workflows**: Compatible with [ExoMiner](https://github.com/nasa/ExoMiner), [AstroNet](https://github.com/google-research/exoplanet-ml/tree/master/exoplanet-ml/astronet), custom models
- **Provide verification**: Health reports confirm data integrity and completeness

### Key Features & Performance Metrics

**Proven Performance:**
- **5.5x faster** than traditional bulk query approaches
- **99.9% success rate** on 17,000+ KIC downloads (full TCE dataset)
- **Zero database corruption** with Redis write-ahead buffering
- **Automatic recovery** from network failures and timeouts

**Core Capabilities:**
- **Research-Ready Formats** - Supports both ExoMiner/AstroNet structure and MAST standard
- **Universal filtering** - Extract KOI subset from 400GB TCE data without re-downloading
- **Mode detection** - Automatically detects and converts between formats
- **DVT validation** - Ensures ML model compatibility with DVT file checking
- **Job-based organization** - Each run creates a timestamped job directory for reproducibility
- **Parallel processing** - 4-8 workers handle concurrent downloads efficiently
- **Health reporting** - Comprehensive analysis confirms data completeness
- **Smart recovery** - Automatically retries failed downloads and detects missing KICs

The standard Kepler light curve products available on the MAST archive are from the final Data Release 25 (DR25) processing.

## Data Source and Attribution

### NASA Kepler Mission Data

This toolkit downloads data from **NASA's Kepler Space Telescope mission**, which operated from 2009-2018 and revolutionized exoplanet science by discovering thousands of exoplanets. The data is hosted and distributed by:

- **MAST (Mikulski Archive for Space Telescopes)** - NASA's data archive hosted at the Space Telescope Science Institute (STScI)
- **Data Release**: DR25 (Data Release 25) - The final and most complete processing of Kepler data
- **Archive URL**: https://archive.stsci.edu/kepler/

### Data Usage and Citation

When using Kepler data downloaded with this toolkit, please:

1. **Acknowledge NASA and the Kepler mission** in your publications
2. **Cite the appropriate Kepler papers**:
   - Kepler Mission: Borucki et al. (2010) Science, 327, 977
   - Kepler Data Characteristics: Thompson et al. (2016) Kepler Data Release Notes (KSCI-19044-005)
   - DR25 Release: Available at MAST Kepler archive

3. **Include the standard acknowledgment**:
   > "This research has made use of the NASA Exoplanet Archive, which is operated by the California Institute of Technology, under contract with the National Aeronautics and Space Administration under the Exoplanet Exploration Program."

### Data Products

The toolkit downloads the following NASA Kepler data products:
- **Light Curve Files** (*_llc.fits) - Time series photometry data
- **Data Validation Files** (*_dvt.fits) - Transit model fits and diagnostics
- **Target Pixel Files** (*_tpf.fits) - Pixel-level photometry (when requested)

### Terms of Use

All Kepler data is in the public domain. There are no restrictions on the use of Kepler data. However, proper attribution and citations are expected as a matter of professional courtesy and scientific integrity.

For more information about Kepler data:
- MAST Kepler Archive: https://archive.stsci.edu/kepler/
- NASA Exoplanet Archive: https://exoplanetarchive.ipac.caltech.edu/
- Kepler Mission Page: https://www.nasa.gov/mission_pages/kepler/main/index.html

## Directory Structure

```
Kepler-Downloader-DR25/
├── input/
│   └── your_targets.csv
├── input_samples/
│   ├── cumulative_koi_2025.09.06_13.27.56.csv  # Kepler Objects of Interest
│   └── q1_q17_dr25_tce_2025.09.06_13.29.19.csv # Threshold Crossing Events
├── kepler_downloads/                # Default output directory
│   └── job-YYYYMMDD_HHMMSS/        # Timestamped job directory
│       ├── download_records.db      # SQLite database with all records
│       ├── health_check_report.txt  # Post-download health analysis
│       ├── reports/                  # DVT filtering and other reports
│       └── [Data directories based on mode]
├── util/                            # Utility scripts
│   ├── rebuild_database.py          # Rebuild database from filesystem
│   ├── check_missing_kics.py        # Find missing KICs
│   ├── generate_stats.py            # Generate job statistics
│   └── test_health_report.py        # Diagnostic tool
├── get-kepler-dr25.py              # Main downloader with DVT filtering
├── filter-get-kepler-dr25.py       # Universal filter with mode detection
├── setup.py                         # Package installation script
├── requirements.txt                 # Python dependencies
├── README.md                        # This file
├── QUICKSTART.md                   # Quick start guide
├── CHANGELOG.md                     # Version history
└── LICENSE                          # Apache 2.0 license
```

### Output Formats

#### ExoMiner Format (Default)
```
kepler_downloads/job-*/
└── Kepler/
    └── XXXX/                  # First 4 digits of 9-digit KIC
        └── XXXXXXXXX/         # Full 9-digit KIC
            ├── *_llc.fits     # Light curve files
            ├── *_dvt.fits     # Data validation files (required)
```

#### Standard MAST Format (`--no-exominer` flag)
```
kepler_downloads/job-*/
└── mastDownload/
    └── Kepler/
        └── kplrXXXXXXXXX_lc/  # Light curve files
        └── kplrXXXXXXXXX_dv/  # Data validation and report files
```

## Real-World Use Cases

### Example: Filtering KOI from TCE Dataset
**Problem**: You downloaded the full TCE dataset (400+ GB, 17,230 KICs) but only need KOI data (8,214 KICs)

**Traditional Approach**: Re-download 200+ GB of KOI data, taking hours and risking incomplete downloads

**With This Toolkit**:
```bash
# Filter existing TCE data to extract KOI subset
python filter-get-kepler-dr25.py \
  --input-csv input_samples/cumulative_koi_2025.09.06_13.27.56.csv \
  --source-job kepler_downloads/job-with-tce-data

# Result: 7,141 KICs copied, 1,073 missing KICs automatically downloaded
# Time saved: Hours of redundant downloads
# Storage saved: 200+ GB of duplicate data
```

## Security & Trust

[![PyPI Verified](https://img.shields.io/badge/PyPI-Verified-green)](https://pypi.org/project/kepler-downloader-dr25/)
[![Security Scan](https://github.com/akira921x/Kepler-Downloader-DR25/actions/workflows/ci.yml/badge.svg)](https://github.com/akira921x/Kepler-Downloader-DR25/actions/workflows/ci.yml)

This package implements comprehensive security measures:
- **Trusted Publishing**: Cryptographically verified releases via GitHub OIDC
- **Attestations**: PEP 740 compliant package attestations
- **Signed Packages**: Sigstore keyless signing for supply chain security
- **SBOM**: Software Bill of Materials for dependency transparency
- **Security Scanning**: Automated vulnerability scanning in CI/CD

For detailed security information, see [SECURITY.md](docs/SECURITY.md).

## Installation

### Prerequisites

1. **Python 3.8+** with pip installed
2. **Redis Server** (optional but recommended for reliability)
3. **Operating System**: Windows, macOS, or Linux
   
   Install Redis:
   ```bash
   # macOS
   brew install redis && brew services start redis
   
   # Ubuntu/Debian
   sudo apt install redis-server && sudo systemctl start redis
   
   # Windows (Option 1: WSL2)
   wsl --install
   # Then follow Ubuntu instructions above
   
   # Windows (Option 2: Docker)
   docker run -d -p 6379:6379 --name redis-kepler redis:latest
   
   # Windows (Option 3: Memurai - Redis for Windows)
   # Download from: https://www.memurai.com/get-memurai
   ```

### Installation Options

#### Option 1: Install from PyPI (Recommended)
```bash
# Install the package
pip install kepler-downloader-dr25

# Use command-line tools
kepler-download input/your_targets.csv
kepler-filter --input-csv input/kics.csv --source-job kepler_downloads/job-XXX
kepler-stats kepler_downloads/job-XXX
```

#### Option 2: Install from GitHub
```bash
# Clone and install
git clone https://github.com/akira921x/Kepler-Downloader-DR25.git
cd Kepler-Downloader-DR25
pip install -r requirements.txt

# Use scripts directly
python get-kepler-dr25.py input/your_targets.csv
```

### Python Dependencies

Required packages (automatically installed with pip):
- `pandas` - Data processing
- `astroquery` - MAST archive interface
- `redis` - Redis client for buffering
- `requests` - HTTP requests
- `numpy` - Numerical operations
- `tqdm` - Progress bars

## Quick Start

```bash
# Install from PyPI
pip install kepler-downloader-dr25

# Quick test with 3 targets
echo "006922244,007799349,011446443" > test.csv
kepler-download test.csv

# Download real datasets
kepler-download cumulative_koi.csv    # ~8,200 KOIs, ~200GB
kepler-download q1_q17_dr25_tce.csv   # ~17,000 TCEs, ~400GB

# Filter existing data (save time & storage)
kepler-filter --input-csv koi.csv --source-job kepler_downloads/job-XXX
```

See [Quick Start Guide](docs/QUICKSTART.md) for detailed instructions.

## Usage

### 1. Downloading Data

#### Basic Download (ExoMiner Format - Default)
```bash
# Download from CSV files in input/ folder (ExoMiner format by default)
python get-kepler-dr25.py input/your_targets.csv

# Verbose mode (detailed output)
python get-kepler-dr25.py input/your_targets.csv --verbose
```

#### Standard MAST Format
```bash
# Download with Standard MAST structure (no DVT requirement)
python get-kepler-dr25.py input/your_targets.csv --no-exominer

# Strict DVT mode - skip KICs without DVT immediately (ExoMiner is default)
python get-kepler-dr25.py input/your_targets.csv --strict-dvt

# Backup KICs without DVT instead of deleting (ExoMiner is default)
python get-kepler-dr25.py input/your_targets.csv --backup-no-dvt
```

#### Advanced Options
```bash
# Custom configuration
python get-kepler-dr25.py input/your_targets.csv \
  --workers 8 \
  --batch-size 50 \
  --output-dir custom_output

# Retry failed downloads from a previous run
python get-kepler-dr25.py input/your_targets.csv --retry-failed
```


### 2. Filtering Existing Data

The universal filter script can process any CSV with KIC IDs and intelligently handle mode conversions.

#### Basic Filtering
```bash
# Filter existing job with KOI data
python filter-get-kepler-dr25.py \
  --input-csv input_samples/cumulative_koi_2025.09.06_13.27.56.csv \
  --source-job kepler_downloads/job-20250906_020543

# Use Standard format instead of default ExoMiner
python filter-get-kepler-dr25.py \
  --input-csv input/custom_kics.csv \
  --source-job kepler_downloads/job-20250906_020543 \
  --no-exominer
```

#### Mode Conversion
```bash
# Convert from Standard to ExoMiner format (ExoMiner is default target)
python filter-get-kepler-dr25.py \
  --input-csv input/kics.csv \
  --source-job kepler_downloads/standard_job \
  --force-mode  # Required when modes don't match

# Disable DVT validation for ExoMiner
python filter-get-kepler-dr25.py \
  --input-csv input/kics.csv \
  --source-job kepler_downloads/job-20250906 \
  --no-validate-dvt
```

#### Download Missing KICs
```bash
# Filter and download missing KICs from MAST
python filter-get-kepler-dr25.py \
  --input-csv input/kics.csv \
  --source-job kepler_downloads/job-20250906

# Skip downloading missing KICs
python filter-get-kepler-dr25.py \
  --input-csv input/kics.csv \
  --source-job kepler_downloads/job-20250906 \
  --no-download-missing
```

## Command-Line Options

### get-kepler-dr25.py

| Option | Description | Required | Default |
|--------|-------------|----------|----------|
| `csv_file` | Input CSV file with KIC IDs | Yes | - |
| `--output-dir` | Output directory | No | `kepler_downloads` |
| `--workers` | Number of parallel workers | No | `4` |
| `--batch-size` | KICs per batch | No | `50` |
| `--no-exominer` | Use Standard MAST format instead of ExoMiner | No | `False` (ExoMiner enabled) |
| `--strict-dvt` | Skip KICs without DVT immediately (ExoMiner mode) | No | `False` |
| `--backup-no-dvt` | Backup instead of delete no-DVT KICs (ExoMiner mode) | No | `False` |
| `--retry-failed` | Retry failed downloads from a previous run. | No | `False` |
| `--verbose` | Enable verbose logging | No | `False` |

### filter-get-kepler-dr25.py

| Option | Description | Required | Default |
|--------|-------------|----------|----------|
| `--input-csv` | Input CSV with KIC IDs | Yes | - |
| `--source-job` | Source job folder | Yes | - |
| `--no-exominer` | Use Standard MAST format instead of ExoMiner | No | `False` (ExoMiner enabled) |
| `--output-dir` | Output directory | No | Auto-generated timestamp |
| `--force-mode` | Force mode conversion even if incompatible | No | `False` |
| `--no-validate-dvt` | Disable DVT validation for ExoMiner mode | No | `False` |
| `--no-download-missing` | Skip downloading missing KICs from MAST | No | `False` (download enabled) |
| `--workers` | Number of parallel workers for downloads | No | `4` |
| `--batch-size` | Batch size for downloads | No | `50` |
| `--verbose` | Enable verbose logging | No | `False` |

## Mode Detection and Compatibility

The filter script automatically detects job modes:

### ExoMiner/AstroNet Mode (Default)
- Structure: `Kepler/XXXX/XXXXXXXXX/`
- Requires DVT files for each KIC
- Optimized for machine learning workflows
- Compatible with [ExoMiner](https://github.com/nasa/ExoMiner), [AstroNet](https://github.com/google-research/exoplanet-ml/tree/master/exoplanet-ml/astronet), and similar ML frameworks
- Supports custom research pipelines requiring structured data organization

### Standard Mode
- Structure: `mastDownload/Kepler/kplr*_lc/`
- MAST's default organization
- No DVT requirement
- Compatible with traditional analysis tools

### Mode Compatibility Rules
1. **Same mode**: Direct copy, no conversion needed
2. **Different modes**: Requires `--force-mode` flag
3. **ExoMiner target**: DVT validation enabled by default
4. **Mode mismatch**: Detailed report explains incompatibility

## Health Reports

Both scripts generate comprehensive health reports:

### Download Health Report
- Download statistics (success/failure rates)
- DVT coverage for ExoMiner mode
- File inventory by type
- Performance metrics
- Failed KIC list with errors

### Filter Health Report
- Source job analysis (mode, structure, statistics)
- Mode compatibility assessment
- Processing statistics
- DVT validation results (ExoMiner)
- Recommendations for issues

## DVT Filtering (ExoMiner Mode)

When using ExoMiner mode, the system handles DVT (Data Validation) files:

1. **During Download** (`get-kepler-dr25.py --exominer`):
   - Downloads both LLC and DVT files
   - Tracks DVT availability
   - Post-download filtering removes KICs without DVT
   - Optional backup with `--backup-no-dvt`

2. **During Filtering** (`filter-get-kepler-dr25.py`):
   - Validates DVT presence for ExoMiner target
   - Moves no-DVT KICs to backup
   - Reports DVT coverage statistics

## Performance

### Expected Performance

**Download Performance** (with 4 workers, default settings):
- **Processing rate**: ~50-60 KICs/minute
- **Small datasets** (< 100 KICs): 2-5 minutes
- **Medium datasets** (1,000 KICs): 20-30 minutes  
- **KOI dataset** (~8,200 KICs): 2.5-3 hours (~200 GB)
- **Full TCE dataset** (~17,000 KICs): 5-6 hours (~400+ GB)

**Why Traditional Methods Fail at Scale**:
- No automatic retry for network timeouts
- Database corruption from concurrent writes
- No progress tracking or recovery mechanism
- Missing KIC detection requires manual verification
- Network interruptions cause incomplete FITS files

### Optimization Tips
1. Increase workers for faster downloads: `--workers 8`
2. Use larger batches: `--batch-size 100`
3. Ensure Redis is running for optimal performance
4. Use `--strict-dvt` to skip no-DVT KICs early
5. Run during off-peak hours for better MAST response

## Database Features

### Tables Created

#### download_records
- KIC ID and success status
- File counts (LLC and DVT)
- DVT presence flag
- Error messages
- Removal reasons (ExoMiner mode)

#### file_inventory
- Complete file catalog
- File types and sizes
- Download timestamps

#### removed_kics (ExoMiner mode)
- KICs removed for lacking DVT
- File statistics before removal
- Removal timestamps

#### filter_operations (filter script)
- Source and target modes
- Operation type (copy/download)
- Success status
- DVT validation results

## Utility Tools

### Check Missing KICs
```bash
# Compare CSV with downloaded KICs
python util/check_missing_kics.py input/target.csv kepler_downloads/job-20250907_015817

# Output: Creates missing_kics_job-20250907_015817.csv
```

### Generate Statistics
```bash
# Generate comprehensive statistics for a job
python util/generate_stats.py kepler_downloads/job-20250907_015817

# Export statistics to CSV
python util/generate_stats.py kepler_downloads/job-20250907_015817 --export stats.csv
```

### Rebuild Database
```bash
# Rebuild database from filesystem (useful for recovery)
python util/rebuild_database.py kepler_downloads/job-20250907_015817
```

### Test Health Report
```bash
# Verify database and health report contents
python util/test_health_report.py
```

## Troubleshooting

### Redis Connection Issues
```bash
# Check Redis status
redis-cli ping  # Should return PONG

# Start Redis
brew services start redis  # macOS
sudo systemctl start redis  # Linux
```

### Database Shows All Zeros (Old Downloads)
This was a known bug (missing conn.commit()) that has been fixed. For existing downloads:
```bash
# Rebuild the database from filesystem
python util/rebuild_database.py kepler_downloads/job-YYYYMMDD_HHMMSS

# This will scan all FITS files and recreate the database
```

### Mode Incompatibility
- Check health report for details
- Use `--force-mode` to override (use cautiously)
- Consider target mode requirements

### DVT Missing (ExoMiner)
- Some KICs don't have DVT files in MAST
- Use `--backup-no-dvt` to preserve data
- Consider Standard mode for analysis

### Download Failures
- Check network connectivity
- Verify KIC exists in MAST
- Review error messages in health report
- Retry with `--retry-failed`

## Related Projects

### Machine Learning Frameworks for Exoplanet Detection
- **[ExoMiner](https://github.com/nasa/ExoMiner)** - NASA's deep learning model for exoplanet detection
- **[AstroNet](https://github.com/google-research/exoplanet-ml/tree/master/exoplanet-ml/astronet)** - Google's neural network for identifying exoplanets

This toolkit provides data in formats compatible with these frameworks while maintaining flexibility for custom research applications.

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

### Development Setup
```bash
# Clone the repository
git clone https://github.com/akira921x/Kepler-Downloader-DR25.git
cd Kepler-Downloader-DR25

# Create virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install in development mode
pip install -e .

# Run tests (if available)
python -m pytest tests/
```

## Version History

See [CHANGELOG.md](CHANGELOG.md) for a detailed version history.

## License

This project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details.

Copyright 2025 Kepler-Downloader-DR25 Project

## Acknowledgments

- NASA Kepler Mission Team
- MAST Archive at STScI
- ExoMiner and AstroNet teams for ML framework specifications
- Open source community for invaluable tools and libraries

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/akira921x/Kepler-Downloader-DR25",
    "name": "kepler-downloader-dr25",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.10",
    "maintainer_email": "akira921x <noreply@use-github-issues.com>",
    "keywords": "kepler, nasa, astronomy, exoplanet, fits, mast, telescope, space, data, download",
    "author": "akira921x",
    "author_email": "akira921x <noreply@use-github-issues.com>",
    "download_url": "https://files.pythonhosted.org/packages/8a/3b/455f6d896a4a1c924fb248f419a650d60bb5a25340e883fe5b3780f0c844/kepler_downloader_dr25-1.5.0.tar.gz",
    "platform": null,
    "description": "# Kepler-Downloader-DR25\n\n[![CI Status](https://github.com/akira921x/Kepler-Downloader-DR25/actions/workflows/ci.yml/badge.svg)](https://github.com/akira921x/Kepler-Downloader-DR25/actions/workflows/ci.yml)\n[![Python Version](https://img.shields.io/badge/python-3.8%2B-blue)](https://www.python.org/downloads/)\n[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n[![Platform](https://img.shields.io/badge/platform-Ubuntu%20%7C%20macOS-lightgrey)](https://github.com/akira921x/Kepler-Downloader-DR25)\n\n## Research-Oriented Toolkit for Kepler Data Analysis\n\n**This toolkit is designed for researchers studying NASA Kepler Space Telescope data.** It follows the data structure requirements of machine learning frameworks like **[ExoMiner](https://github.com/nasa/ExoMiner)** and **[AstroNet](https://github.com/google-research/exoplanet-ml/tree/master/exoplanet-ml/astronet)** while remaining flexible for diverse research applications beyond these specific frameworks.\n\n### Key Design Philosophy\n- **Research-First Approach**: Built to support various astronomical research workflows\n- **ML-Ready**: Compatible with ExoMiner, AstroNet, and other machine learning pipelines\n- **Flexible Architecture**: Not limited to specific frameworks - adaptable to custom research needs\n- **Scientific Rigor**: Maintains data integrity and validation standards required for publication-quality research\n\n## Overview\n\nA comprehensive toolkit for downloading and filtering Kepler DR25 FITS files from NASA's MAST archive with intelligent mode detection, DVT validation, and universal filtering capabilities.\n\nThis project provides two main scripts and utility tools:\n\n**Main Scripts:**\n1. **`get-kepler-dr25.py`** - Main downloader with DVT filtering for ExoMiner mode and retry capabilities.\n2. **`filter-get-kepler-dr25.py`** - Universal filter with mode detection, conversion, and download of missing files.\n\n**Utility Tools (in util/ folder):**\n- **`util/rebuild_database.py`** - Rebuild SQLite database from existing filesystem (useful for recovery)\n- **`util/check_missing_kics.py`** - Compare CSV with downloaded KICs to find missing ones\n- **`util/generate_stats.py`** - Generate comprehensive statistics for completed jobs\n- **`util/test_health_report.py`** - Diagnostic tool to verify database and health report contents\n\n### Why This Toolkit?\n\n**The Challenge with Kepler Data:**\n- **Full TCE dataset**: ~400+ GB disk space required\n- **KOI dataset**: ~200+ GB disk space required  \n- **Common problems without proper tooling**:\n  - Missing KICs due to network timeouts\n  - Corrupted FITS files from incomplete downloads\n  - Database inconsistencies from concurrent writes\n  - No recovery mechanism for partial failures\n  - Manual tracking of thousands of files\n\n**What This Toolkit Solves:**\n\nResearchers studying exoplanets, stellar variability, or other phenomena in Kepler data need efficient, reliable tools that:\n- **Prevent data loss**: Redis buffering ensures zero database corruption even with network failures\n- **Handle scale**: Successfully manages datasets with 17,000+ KICs (tested with full TCE catalog)\n- **Ensure completeness**: Automatic retry mechanism and missing KIC detection\n- **Support modern ML workflows**: Compatible with [ExoMiner](https://github.com/nasa/ExoMiner), [AstroNet](https://github.com/google-research/exoplanet-ml/tree/master/exoplanet-ml/astronet), custom models\n- **Provide verification**: Health reports confirm data integrity and completeness\n\n### Key Features & Performance Metrics\n\n**Proven Performance:**\n- **5.5x faster** than traditional bulk query approaches\n- **99.9% success rate** on 17,000+ KIC downloads (full TCE dataset)\n- **Zero database corruption** with Redis write-ahead buffering\n- **Automatic recovery** from network failures and timeouts\n\n**Core Capabilities:**\n- **Research-Ready Formats** - Supports both ExoMiner/AstroNet structure and MAST standard\n- **Universal filtering** - Extract KOI subset from 400GB TCE data without re-downloading\n- **Mode detection** - Automatically detects and converts between formats\n- **DVT validation** - Ensures ML model compatibility with DVT file checking\n- **Job-based organization** - Each run creates a timestamped job directory for reproducibility\n- **Parallel processing** - 4-8 workers handle concurrent downloads efficiently\n- **Health reporting** - Comprehensive analysis confirms data completeness\n- **Smart recovery** - Automatically retries failed downloads and detects missing KICs\n\nThe standard Kepler light curve products available on the MAST archive are from the final Data Release 25 (DR25) processing.\n\n## Data Source and Attribution\n\n### NASA Kepler Mission Data\n\nThis toolkit downloads data from **NASA's Kepler Space Telescope mission**, which operated from 2009-2018 and revolutionized exoplanet science by discovering thousands of exoplanets. The data is hosted and distributed by:\n\n- **MAST (Mikulski Archive for Space Telescopes)** - NASA's data archive hosted at the Space Telescope Science Institute (STScI)\n- **Data Release**: DR25 (Data Release 25) - The final and most complete processing of Kepler data\n- **Archive URL**: https://archive.stsci.edu/kepler/\n\n### Data Usage and Citation\n\nWhen using Kepler data downloaded with this toolkit, please:\n\n1. **Acknowledge NASA and the Kepler mission** in your publications\n2. **Cite the appropriate Kepler papers**:\n   - Kepler Mission: Borucki et al. (2010) Science, 327, 977\n   - Kepler Data Characteristics: Thompson et al. (2016) Kepler Data Release Notes (KSCI-19044-005)\n   - DR25 Release: Available at MAST Kepler archive\n\n3. **Include the standard acknowledgment**:\n   > \"This research has made use of the NASA Exoplanet Archive, which is operated by the California Institute of Technology, under contract with the National Aeronautics and Space Administration under the Exoplanet Exploration Program.\"\n\n### Data Products\n\nThe toolkit downloads the following NASA Kepler data products:\n- **Light Curve Files** (*_llc.fits) - Time series photometry data\n- **Data Validation Files** (*_dvt.fits) - Transit model fits and diagnostics\n- **Target Pixel Files** (*_tpf.fits) - Pixel-level photometry (when requested)\n\n### Terms of Use\n\nAll Kepler data is in the public domain. There are no restrictions on the use of Kepler data. However, proper attribution and citations are expected as a matter of professional courtesy and scientific integrity.\n\nFor more information about Kepler data:\n- MAST Kepler Archive: https://archive.stsci.edu/kepler/\n- NASA Exoplanet Archive: https://exoplanetarchive.ipac.caltech.edu/\n- Kepler Mission Page: https://www.nasa.gov/mission_pages/kepler/main/index.html\n\n## Directory Structure\n\n```\nKepler-Downloader-DR25/\n\u251c\u2500\u2500 input/\n\u2502   \u2514\u2500\u2500 your_targets.csv\n\u251c\u2500\u2500 input_samples/\n\u2502   \u251c\u2500\u2500 cumulative_koi_2025.09.06_13.27.56.csv  # Kepler Objects of Interest\n\u2502   \u2514\u2500\u2500 q1_q17_dr25_tce_2025.09.06_13.29.19.csv # Threshold Crossing Events\n\u251c\u2500\u2500 kepler_downloads/                # Default output directory\n\u2502   \u2514\u2500\u2500 job-YYYYMMDD_HHMMSS/        # Timestamped job directory\n\u2502       \u251c\u2500\u2500 download_records.db      # SQLite database with all records\n\u2502       \u251c\u2500\u2500 health_check_report.txt  # Post-download health analysis\n\u2502       \u251c\u2500\u2500 reports/                  # DVT filtering and other reports\n\u2502       \u2514\u2500\u2500 [Data directories based on mode]\n\u251c\u2500\u2500 util/                            # Utility scripts\n\u2502   \u251c\u2500\u2500 rebuild_database.py          # Rebuild database from filesystem\n\u2502   \u251c\u2500\u2500 check_missing_kics.py        # Find missing KICs\n\u2502   \u251c\u2500\u2500 generate_stats.py            # Generate job statistics\n\u2502   \u2514\u2500\u2500 test_health_report.py        # Diagnostic tool\n\u251c\u2500\u2500 get-kepler-dr25.py              # Main downloader with DVT filtering\n\u251c\u2500\u2500 filter-get-kepler-dr25.py       # Universal filter with mode detection\n\u251c\u2500\u2500 setup.py                         # Package installation script\n\u251c\u2500\u2500 requirements.txt                 # Python dependencies\n\u251c\u2500\u2500 README.md                        # This file\n\u251c\u2500\u2500 QUICKSTART.md                   # Quick start guide\n\u251c\u2500\u2500 CHANGELOG.md                     # Version history\n\u2514\u2500\u2500 LICENSE                          # Apache 2.0 license\n```\n\n### Output Formats\n\n#### ExoMiner Format (Default)\n```\nkepler_downloads/job-*/\n\u2514\u2500\u2500 Kepler/\n    \u2514\u2500\u2500 XXXX/                  # First 4 digits of 9-digit KIC\n        \u2514\u2500\u2500 XXXXXXXXX/         # Full 9-digit KIC\n            \u251c\u2500\u2500 *_llc.fits     # Light curve files\n            \u251c\u2500\u2500 *_dvt.fits     # Data validation files (required)\n```\n\n#### Standard MAST Format (`--no-exominer` flag)\n```\nkepler_downloads/job-*/\n\u2514\u2500\u2500 mastDownload/\n    \u2514\u2500\u2500 Kepler/\n        \u2514\u2500\u2500 kplrXXXXXXXXX_lc/  # Light curve files\n        \u2514\u2500\u2500 kplrXXXXXXXXX_dv/  # Data validation and report files\n```\n\n## Real-World Use Cases\n\n### Example: Filtering KOI from TCE Dataset\n**Problem**: You downloaded the full TCE dataset (400+ GB, 17,230 KICs) but only need KOI data (8,214 KICs)\n\n**Traditional Approach**: Re-download 200+ GB of KOI data, taking hours and risking incomplete downloads\n\n**With This Toolkit**:\n```bash\n# Filter existing TCE data to extract KOI subset\npython filter-get-kepler-dr25.py \\\n  --input-csv input_samples/cumulative_koi_2025.09.06_13.27.56.csv \\\n  --source-job kepler_downloads/job-with-tce-data\n\n# Result: 7,141 KICs copied, 1,073 missing KICs automatically downloaded\n# Time saved: Hours of redundant downloads\n# Storage saved: 200+ GB of duplicate data\n```\n\n## Security & Trust\n\n[![PyPI Verified](https://img.shields.io/badge/PyPI-Verified-green)](https://pypi.org/project/kepler-downloader-dr25/)\n[![Security Scan](https://github.com/akira921x/Kepler-Downloader-DR25/actions/workflows/ci.yml/badge.svg)](https://github.com/akira921x/Kepler-Downloader-DR25/actions/workflows/ci.yml)\n\nThis package implements comprehensive security measures:\n- **Trusted Publishing**: Cryptographically verified releases via GitHub OIDC\n- **Attestations**: PEP 740 compliant package attestations\n- **Signed Packages**: Sigstore keyless signing for supply chain security\n- **SBOM**: Software Bill of Materials for dependency transparency\n- **Security Scanning**: Automated vulnerability scanning in CI/CD\n\nFor detailed security information, see [SECURITY.md](docs/SECURITY.md).\n\n## Installation\n\n### Prerequisites\n\n1. **Python 3.8+** with pip installed\n2. **Redis Server** (optional but recommended for reliability)\n3. **Operating System**: Windows, macOS, or Linux\n   \n   Install Redis:\n   ```bash\n   # macOS\n   brew install redis && brew services start redis\n   \n   # Ubuntu/Debian\n   sudo apt install redis-server && sudo systemctl start redis\n   \n   # Windows (Option 1: WSL2)\n   wsl --install\n   # Then follow Ubuntu instructions above\n   \n   # Windows (Option 2: Docker)\n   docker run -d -p 6379:6379 --name redis-kepler redis:latest\n   \n   # Windows (Option 3: Memurai - Redis for Windows)\n   # Download from: https://www.memurai.com/get-memurai\n   ```\n\n### Installation Options\n\n#### Option 1: Install from PyPI (Recommended)\n```bash\n# Install the package\npip install kepler-downloader-dr25\n\n# Use command-line tools\nkepler-download input/your_targets.csv\nkepler-filter --input-csv input/kics.csv --source-job kepler_downloads/job-XXX\nkepler-stats kepler_downloads/job-XXX\n```\n\n#### Option 2: Install from GitHub\n```bash\n# Clone and install\ngit clone https://github.com/akira921x/Kepler-Downloader-DR25.git\ncd Kepler-Downloader-DR25\npip install -r requirements.txt\n\n# Use scripts directly\npython get-kepler-dr25.py input/your_targets.csv\n```\n\n### Python Dependencies\n\nRequired packages (automatically installed with pip):\n- `pandas` - Data processing\n- `astroquery` - MAST archive interface\n- `redis` - Redis client for buffering\n- `requests` - HTTP requests\n- `numpy` - Numerical operations\n- `tqdm` - Progress bars\n\n## Quick Start\n\n```bash\n# Install from PyPI\npip install kepler-downloader-dr25\n\n# Quick test with 3 targets\necho \"006922244,007799349,011446443\" > test.csv\nkepler-download test.csv\n\n# Download real datasets\nkepler-download cumulative_koi.csv    # ~8,200 KOIs, ~200GB\nkepler-download q1_q17_dr25_tce.csv   # ~17,000 TCEs, ~400GB\n\n# Filter existing data (save time & storage)\nkepler-filter --input-csv koi.csv --source-job kepler_downloads/job-XXX\n```\n\nSee [Quick Start Guide](docs/QUICKSTART.md) for detailed instructions.\n\n## Usage\n\n### 1. Downloading Data\n\n#### Basic Download (ExoMiner Format - Default)\n```bash\n# Download from CSV files in input/ folder (ExoMiner format by default)\npython get-kepler-dr25.py input/your_targets.csv\n\n# Verbose mode (detailed output)\npython get-kepler-dr25.py input/your_targets.csv --verbose\n```\n\n#### Standard MAST Format\n```bash\n# Download with Standard MAST structure (no DVT requirement)\npython get-kepler-dr25.py input/your_targets.csv --no-exominer\n\n# Strict DVT mode - skip KICs without DVT immediately (ExoMiner is default)\npython get-kepler-dr25.py input/your_targets.csv --strict-dvt\n\n# Backup KICs without DVT instead of deleting (ExoMiner is default)\npython get-kepler-dr25.py input/your_targets.csv --backup-no-dvt\n```\n\n#### Advanced Options\n```bash\n# Custom configuration\npython get-kepler-dr25.py input/your_targets.csv \\\n  --workers 8 \\\n  --batch-size 50 \\\n  --output-dir custom_output\n\n# Retry failed downloads from a previous run\npython get-kepler-dr25.py input/your_targets.csv --retry-failed\n```\n\n\n### 2. Filtering Existing Data\n\nThe universal filter script can process any CSV with KIC IDs and intelligently handle mode conversions.\n\n#### Basic Filtering\n```bash\n# Filter existing job with KOI data\npython filter-get-kepler-dr25.py \\\n  --input-csv input_samples/cumulative_koi_2025.09.06_13.27.56.csv \\\n  --source-job kepler_downloads/job-20250906_020543\n\n# Use Standard format instead of default ExoMiner\npython filter-get-kepler-dr25.py \\\n  --input-csv input/custom_kics.csv \\\n  --source-job kepler_downloads/job-20250906_020543 \\\n  --no-exominer\n```\n\n#### Mode Conversion\n```bash\n# Convert from Standard to ExoMiner format (ExoMiner is default target)\npython filter-get-kepler-dr25.py \\\n  --input-csv input/kics.csv \\\n  --source-job kepler_downloads/standard_job \\\n  --force-mode  # Required when modes don't match\n\n# Disable DVT validation for ExoMiner\npython filter-get-kepler-dr25.py \\\n  --input-csv input/kics.csv \\\n  --source-job kepler_downloads/job-20250906 \\\n  --no-validate-dvt\n```\n\n#### Download Missing KICs\n```bash\n# Filter and download missing KICs from MAST\npython filter-get-kepler-dr25.py \\\n  --input-csv input/kics.csv \\\n  --source-job kepler_downloads/job-20250906\n\n# Skip downloading missing KICs\npython filter-get-kepler-dr25.py \\\n  --input-csv input/kics.csv \\\n  --source-job kepler_downloads/job-20250906 \\\n  --no-download-missing\n```\n\n## Command-Line Options\n\n### get-kepler-dr25.py\n\n| Option | Description | Required | Default |\n|--------|-------------|----------|----------|\n| `csv_file` | Input CSV file with KIC IDs | Yes | - |\n| `--output-dir` | Output directory | No | `kepler_downloads` |\n| `--workers` | Number of parallel workers | No | `4` |\n| `--batch-size` | KICs per batch | No | `50` |\n| `--no-exominer` | Use Standard MAST format instead of ExoMiner | No | `False` (ExoMiner enabled) |\n| `--strict-dvt` | Skip KICs without DVT immediately (ExoMiner mode) | No | `False` |\n| `--backup-no-dvt` | Backup instead of delete no-DVT KICs (ExoMiner mode) | No | `False` |\n| `--retry-failed` | Retry failed downloads from a previous run. | No | `False` |\n| `--verbose` | Enable verbose logging | No | `False` |\n\n### filter-get-kepler-dr25.py\n\n| Option | Description | Required | Default |\n|--------|-------------|----------|----------|\n| `--input-csv` | Input CSV with KIC IDs | Yes | - |\n| `--source-job` | Source job folder | Yes | - |\n| `--no-exominer` | Use Standard MAST format instead of ExoMiner | No | `False` (ExoMiner enabled) |\n| `--output-dir` | Output directory | No | Auto-generated timestamp |\n| `--force-mode` | Force mode conversion even if incompatible | No | `False` |\n| `--no-validate-dvt` | Disable DVT validation for ExoMiner mode | No | `False` |\n| `--no-download-missing` | Skip downloading missing KICs from MAST | No | `False` (download enabled) |\n| `--workers` | Number of parallel workers for downloads | No | `4` |\n| `--batch-size` | Batch size for downloads | No | `50` |\n| `--verbose` | Enable verbose logging | No | `False` |\n\n## Mode Detection and Compatibility\n\nThe filter script automatically detects job modes:\n\n### ExoMiner/AstroNet Mode (Default)\n- Structure: `Kepler/XXXX/XXXXXXXXX/`\n- Requires DVT files for each KIC\n- Optimized for machine learning workflows\n- Compatible with [ExoMiner](https://github.com/nasa/ExoMiner), [AstroNet](https://github.com/google-research/exoplanet-ml/tree/master/exoplanet-ml/astronet), and similar ML frameworks\n- Supports custom research pipelines requiring structured data organization\n\n### Standard Mode\n- Structure: `mastDownload/Kepler/kplr*_lc/`\n- MAST's default organization\n- No DVT requirement\n- Compatible with traditional analysis tools\n\n### Mode Compatibility Rules\n1. **Same mode**: Direct copy, no conversion needed\n2. **Different modes**: Requires `--force-mode` flag\n3. **ExoMiner target**: DVT validation enabled by default\n4. **Mode mismatch**: Detailed report explains incompatibility\n\n## Health Reports\n\nBoth scripts generate comprehensive health reports:\n\n### Download Health Report\n- Download statistics (success/failure rates)\n- DVT coverage for ExoMiner mode\n- File inventory by type\n- Performance metrics\n- Failed KIC list with errors\n\n### Filter Health Report\n- Source job analysis (mode, structure, statistics)\n- Mode compatibility assessment\n- Processing statistics\n- DVT validation results (ExoMiner)\n- Recommendations for issues\n\n## DVT Filtering (ExoMiner Mode)\n\nWhen using ExoMiner mode, the system handles DVT (Data Validation) files:\n\n1. **During Download** (`get-kepler-dr25.py --exominer`):\n   - Downloads both LLC and DVT files\n   - Tracks DVT availability\n   - Post-download filtering removes KICs without DVT\n   - Optional backup with `--backup-no-dvt`\n\n2. **During Filtering** (`filter-get-kepler-dr25.py`):\n   - Validates DVT presence for ExoMiner target\n   - Moves no-DVT KICs to backup\n   - Reports DVT coverage statistics\n\n## Performance\n\n### Expected Performance\n\n**Download Performance** (with 4 workers, default settings):\n- **Processing rate**: ~50-60 KICs/minute\n- **Small datasets** (< 100 KICs): 2-5 minutes\n- **Medium datasets** (1,000 KICs): 20-30 minutes  \n- **KOI dataset** (~8,200 KICs): 2.5-3 hours (~200 GB)\n- **Full TCE dataset** (~17,000 KICs): 5-6 hours (~400+ GB)\n\n**Why Traditional Methods Fail at Scale**:\n- No automatic retry for network timeouts\n- Database corruption from concurrent writes\n- No progress tracking or recovery mechanism\n- Missing KIC detection requires manual verification\n- Network interruptions cause incomplete FITS files\n\n### Optimization Tips\n1. Increase workers for faster downloads: `--workers 8`\n2. Use larger batches: `--batch-size 100`\n3. Ensure Redis is running for optimal performance\n4. Use `--strict-dvt` to skip no-DVT KICs early\n5. Run during off-peak hours for better MAST response\n\n## Database Features\n\n### Tables Created\n\n#### download_records\n- KIC ID and success status\n- File counts (LLC and DVT)\n- DVT presence flag\n- Error messages\n- Removal reasons (ExoMiner mode)\n\n#### file_inventory\n- Complete file catalog\n- File types and sizes\n- Download timestamps\n\n#### removed_kics (ExoMiner mode)\n- KICs removed for lacking DVT\n- File statistics before removal\n- Removal timestamps\n\n#### filter_operations (filter script)\n- Source and target modes\n- Operation type (copy/download)\n- Success status\n- DVT validation results\n\n## Utility Tools\n\n### Check Missing KICs\n```bash\n# Compare CSV with downloaded KICs\npython util/check_missing_kics.py input/target.csv kepler_downloads/job-20250907_015817\n\n# Output: Creates missing_kics_job-20250907_015817.csv\n```\n\n### Generate Statistics\n```bash\n# Generate comprehensive statistics for a job\npython util/generate_stats.py kepler_downloads/job-20250907_015817\n\n# Export statistics to CSV\npython util/generate_stats.py kepler_downloads/job-20250907_015817 --export stats.csv\n```\n\n### Rebuild Database\n```bash\n# Rebuild database from filesystem (useful for recovery)\npython util/rebuild_database.py kepler_downloads/job-20250907_015817\n```\n\n### Test Health Report\n```bash\n# Verify database and health report contents\npython util/test_health_report.py\n```\n\n## Troubleshooting\n\n### Redis Connection Issues\n```bash\n# Check Redis status\nredis-cli ping  # Should return PONG\n\n# Start Redis\nbrew services start redis  # macOS\nsudo systemctl start redis  # Linux\n```\n\n### Database Shows All Zeros (Old Downloads)\nThis was a known bug (missing conn.commit()) that has been fixed. For existing downloads:\n```bash\n# Rebuild the database from filesystem\npython util/rebuild_database.py kepler_downloads/job-YYYYMMDD_HHMMSS\n\n# This will scan all FITS files and recreate the database\n```\n\n### Mode Incompatibility\n- Check health report for details\n- Use `--force-mode` to override (use cautiously)\n- Consider target mode requirements\n\n### DVT Missing (ExoMiner)\n- Some KICs don't have DVT files in MAST\n- Use `--backup-no-dvt` to preserve data\n- Consider Standard mode for analysis\n\n### Download Failures\n- Check network connectivity\n- Verify KIC exists in MAST\n- Review error messages in health report\n- Retry with `--retry-failed`\n\n## Related Projects\n\n### Machine Learning Frameworks for Exoplanet Detection\n- **[ExoMiner](https://github.com/nasa/ExoMiner)** - NASA's deep learning model for exoplanet detection\n- **[AstroNet](https://github.com/google-research/exoplanet-ml/tree/master/exoplanet-ml/astronet)** - Google's neural network for identifying exoplanets\n\nThis toolkit provides data in formats compatible with these frameworks while maintaining flexibility for custom research applications.\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.\n\n### Development Setup\n```bash\n# Clone the repository\ngit clone https://github.com/akira921x/Kepler-Downloader-DR25.git\ncd Kepler-Downloader-DR25\n\n# Create virtual environment\npython -m venv venv\nsource venv/bin/activate  # On Windows: venv\\Scripts\\activate\n\n# Install in development mode\npip install -e .\n\n# Run tests (if available)\npython -m pytest tests/\n```\n\n## Version History\n\nSee [CHANGELOG.md](CHANGELOG.md) for a detailed version history.\n\n## License\n\nThis project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details.\n\nCopyright 2025 Kepler-Downloader-DR25 Project\n\n## Acknowledgments\n\n- NASA Kepler Mission Team\n- MAST Archive at STScI\n- ExoMiner and AstroNet teams for ML framework specifications\n- Open source community for invaluable tools and libraries\n",
    "bugtrack_url": null,
    "license": "Apache-2.0",
    "summary": "A comprehensive toolkit for downloading and filtering Kepler DR25 FITS files from NASA's MAST archive",
    "version": "1.5.0",
    "project_urls": {
        "Bug Reports": "https://github.com/akira921x/Kepler-Downloader-DR25/issues",
        "Documentation": "https://github.com/akira921x/Kepler-Downloader-DR25/blob/main/README.md",
        "Homepage": "https://github.com/akira921x/Kepler-Downloader-DR25",
        "Repository": "https://github.com/akira921x/Kepler-Downloader-DR25"
    },
    "split_keywords": [
        "kepler",
        " nasa",
        " astronomy",
        " exoplanet",
        " fits",
        " mast",
        " telescope",
        " space",
        " data",
        " download"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "1936f6a187854b2b9b2ff11c1f860c0a9dad102892126f9e2d2045eedcd8f325",
                "md5": "46df85e2b9d3a42ac66bbadaec009b3f",
                "sha256": "147ab019a02cb8334da54684fe97754d1822bf916ed2400bc3201515e8f12b19"
            },
            "downloads": -1,
            "filename": "kepler_downloader_dr25-1.5.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "46df85e2b9d3a42ac66bbadaec009b3f",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.10",
            "size": 40830,
            "upload_time": "2025-09-08T05:15:57",
            "upload_time_iso_8601": "2025-09-08T05:15:57.468587Z",
            "url": "https://files.pythonhosted.org/packages/19/36/f6a187854b2b9b2ff11c1f860c0a9dad102892126f9e2d2045eedcd8f325/kepler_downloader_dr25-1.5.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "8a3b455f6d896a4a1c924fb248f419a650d60bb5a25340e883fe5b3780f0c844",
                "md5": "43d4ec4bdf52e43acf0c599b1635f88d",
                "sha256": "5a38d0d2b32227f472f6c9734e9bbc781ecbd96f63969369adbeab154927e980"
            },
            "downloads": -1,
            "filename": "kepler_downloader_dr25-1.5.0.tar.gz",
            "has_sig": false,
            "md5_digest": "43d4ec4bdf52e43acf0c599b1635f88d",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.10",
            "size": 3654270,
            "upload_time": "2025-09-08T05:15:59",
            "upload_time_iso_8601": "2025-09-08T05:15:59.406462Z",
            "url": "https://files.pythonhosted.org/packages/8a/3b/455f6d896a4a1c924fb248f419a650d60bb5a25340e883fe5b3780f0c844/kepler_downloader_dr25-1.5.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-09-08 05:15:59",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "akira921x",
    "github_project": "Kepler-Downloader-DR25",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "requirements": [
        {
            "name": "pandas",
            "specs": []
        },
        {
            "name": "astroquery",
            "specs": []
        },
        {
            "name": "redis",
            "specs": []
        },
        {
            "name": "requests",
            "specs": []
        },
        {
            "name": "numpy",
            "specs": []
        },
        {
            "name": "tqdm",
            "specs": []
        }
    ],
    "tox": true,
    "lcname": "kepler-downloader-dr25"
}