🌌 CosmoArchitects - CosmicVue 🌌

View Demo · Report Bug · Request Feature

🏆 Global Finalist - 2024 NASA International Space Apps Challenge 🏆

🚀 About The Project

CosmicVue is our award-nominated submission for the 2024 NASA International Space Apps Challenge - an interactive orrery web application that brings the solar system to life. Experience real-time visualization of planets, Near-Earth Asteroids (NEAs), Potentially Hazardous Asteroids (PHAs), and Near-Earth Comets (NECs) in stunning 3D.

🏆 Recognition & Challenge Details

Award: Global Finalist - 2024 NASA International Space Apps Challenge
Event: 2024 NASA Space Apps Challenge
Categories: Astrophysics, Space Exploration, Software, Games, Planets & Moons
Difficulty: Intermediate to Advanced
Team: CosmoArchitects

✨ Features

🌍 Core Features

3D Interactive Visualization
- Real-time solar system rendering
- Smooth zoom, pan, and rotation controls
- Dynamic camera perspectives

🛸 Advanced Capabilities

NASA Data Integration
- Live celestial body positioning
- Accurate Keplerian orbital parameters
- Real-time trajectory calculations

🎮 User Controls

Simulation Management
- Adjustable time flow controls
- Orbital path toggles
- Customizable object labels
- Multiple viewing modes

🛠️ Built With

Core Technologies

📊 Three.js - 3D graphics engine
🚀 Vue.js - Frontend framework
📡 NASA APIs - Data sources

Data Sources

🛰️ NASA's Small Body Database
🌠 NASA's Horizon API
🌍 NASA's Open API

💻 Getting Started

Prerequisites

Node.js (v14 or higher)
npm (v6 or higher)
Modern web browser

Installation

Clone the repository

git clone https://github.com/KhamessiTaha/CosmoArchitects.git
cd CosmoArchitects

Install dependencies

npm install

Start development server

npm run start

Open http://localhost:3000 in your browser

🎮 User Guide

Basic Controls

🖱️ Mouse Controls
- Left Click + Drag: Rotate view
- Right Click + Drag: Pan view
- Scroll: Zoom in/out

Advanced Features

⚙️ Control Panel
- Speed adjustment
- Object filters
- Label toggles
- Orbital path visualization

🔬 Technical Details

Orbital Mechanics

Implements Keplerian orbital parameters
- Eccentricity
- Semi-major axis
- Inclination
- Argument of periapsis
- True anomaly

Performance Optimizations

Dynamic level of detail
Efficient render cycles
Optimized data structures

🎯 Objectives

Interactive Education: Create an engaging platform for solar system exploration
Real-time Visualization: Accurately represent celestial object positions
Scientific Accuracy: Implement precise orbital mechanics calculations
User Engagement: Provide intuitive controls for space exploration

🚧 Roadmap

AI Enhancement
- Advanced orbit predictions
- Collision detection systems
- Machine learning for trajectory optimization
Feature Expansion
- Extended celestial database
- Advanced visualization modes
- Time travel simulations
Mobile Optimization
- Responsive design improvements
- Touch controls enhancement
- Progressive Web App implementation

🤝 Contributing

We welcome contributions! Please follow these steps:

Fork the repository
Create your feature branch (git checkout -b feature/AmazingFeature)
Commit changes (git commit -m 'Add AmazingFeature')
Push to branch (git push origin feature/AmazingFeature)
Open a Pull Request

See CONTRIBUTING.md for detailed guidelines.

🌟 Acknowledgments

NASA - For providing invaluable data and APIs
Space Apps Challenge - For the opportunity and inspiration
Three.js Community - For excellent documentation and support
AI Tools - For assistance in debugging and optimization

🏆 Awards & Recognition

Global Finalist - 2024 NASA International Space Apps Challenge
- Selected as one of the global nominees from thousands of international submissions
- Selected as one of the Global Finalists (Top 40 from 10000 submissions )

📄 License

Licensed under the LGPL-2.1 License - see LICENSE for details.

📞 Contact

Project Link: https://github.com/KhamessiTaha/CosmoArchitects

Demo: https://cosmicvue.netlify.app/

Space Apps Project Page: View our NASA Space Apps submission

KhamessiTaha/CosmoArchitects