JayAtriahf-7/moon-crater-navigation-complete

Moon Crater Navigation - Complete Project

This repository contains the complete Moon Crater Navigation system with crater detection and path planning for lunar surface exploration.

🌟 Project Overview

An AI-powered system for detecting craters on the lunar surface and planning safe navigation paths for autonomous rovers.

Key Features

• 🔍 YOLOv8 Crater Detection: State-of-the-art deep learning for crater identification
• 🗺️ Path Planning: A* algorithm with terrain-aware cost functions
• 🎨 Interactive Visualization: 3D terrain visualization and path animation
• 🖥️ GUI Application: User-friendly interface for mission planning
• 📊 Complete Pipeline: From data processing to deployment

📂 Project Structure

moon-crater-navigation/
├── src/                          # Source code
│   ├── data_processing/          # Data preprocessing and augmentation
│   ├── models/                   # YOLO training and inference
│   ├── navigation/               # Pathfinding algorithms
│   ├── visualization/            # Plotting and animation
│   └── utils/                    # Helper functions
├── scripts/                      # Standalone scripts
│   ├── train_model.py           # Model training script
│   ├── run_inference.py         # Run inference on images
│   └── generate_navigation_path.py
├── notebooks/                    # Jupyter notebooks
│   ├── 01_data_preparation.ipynb
│   ├── 02_model_training.ipynb
│   ├── 03_inference_visualization.ipynb
│   └── 04_path_planning.ipynb
├── tests/                        # Unit tests
├── app.py                        # Gradio web demo
├── models/                       # Trained model weights
│   └── best.pt                  # Best YOLOv8 checkpoint
├── samples/                      # Sample images
└── data/                         # Data configurations
    ├── config.json
    └── data.yaml

🚀 Quick Start

Installation

# Clone the repository
git clone https://huggingface.co/JayAtriahf-7/moon-crater-navigation-complete
cd moon-crater-navigation-complete

# Install dependencies
pip install -r requirements.txt

Usage

1. Run the GUI Application

python src/main.py

2. Run the Web Demo

python app.py

Then open http://localhost:7860 in your browser.

3. Use in Code

from src.models.inference import run_inference
from src.navigation.pathfinding import AStarPathfinder
from src.terrain import MoonTerrain

# Detect craters
results = run_inference("path/to/lunar_image.jpg", "models/best.pt")

# Plan navigation path
terrain = MoonTerrain(image_path="path/to/terrain.jpg")
pathfinder = AStarPathfinder(terrain)
path = pathfinder.find_path(start=(10, 10), goal=(90, 90))

📊 Model Details

• Architecture: YOLOv8s
• Training Data: Chandrayaan + Roboflow lunar crater datasets
• Input Size: 416x416
• Performance: See training notebooks for metrics

🛠️ Development

Training Your Own Model

python scripts/train_model.py --epochs 50 --batch-size 16

Running Tests

pytest tests/

📚 Documentation

• USER_GUIDE.md - Complete user guide
• DEMO_GUIDE.md - Demo instructions
• DEPLOYMENT_GUIDE.md - How to deploy
• START_HERE.md - Getting started guide

🌐 Live Demo

Try the interactive demo: Hugging Face Space

📝 Citation

If you use this project in your research, please cite:

@software{moon_crater_navigation,
  title = {Moon Crater Navigation System},
  author = {JayAtriahf-7},
  year = {2025},
  url = {https://huggingface.co/JayAtriahf-7/moon-crater-navigation-complete}
}

🎯 Applications

• Autonomous lunar rover navigation
• Landing site selection and safety analysis
• Mission route planning
• Educational demonstrations
• Research in planetary exploration

🤝 Contributing

Contributions are welcome! Feel free to:

• Report bugs
• Suggest features
• Submit pull requests
• Share improvements

📄 License

MIT License - See LICENSE file for details

🙏 Acknowledgments

• Chandrayaan mission for lunar imagery
• Roboflow for crater detection dataset
• Ultralytics for YOLOv8 framework

📞 Contact

For questions or collaborations, please open an issue on this repository.

---

Made with ❤️ for lunar exploration 🌙🚀

Complete project repository - Ready to clone and use!