SkyWeaver is an advanced prototype system for correlating astrophysical events across multiple observational channels. It combines gravitational wave detections, gamma-ray bursts, optical transients, and other multi-messenger astronomy data to identify potentially related cosmic events.
🚀 Ready to Use: No configuration required! The app works immediately with demo data.
- Multi-Source Integration: Fetches data from GWOSC (gravitational waves), ZTF/TNS (optical transients), NASA HEASARC (gamma-ray bursts), and SIMBAD/Vizier (contextual catalogs)
- Unified Schema: Normalizes all events into a common format with event_id, source, event_type, coordinates, time, and metadata
- Real-time Processing: Supports both batch processing and streaming event correlation
- Time Correlation: Matches events within user-defined time windows (±10 minutes to ±1 day)
- Spatial Correlation: Correlates events by sky position within angular thresholds (<1° to 10°)
- Cross-Messenger Detection: Identifies multi-messenger events across different observation types
- Confidence Scoring: Calculates correlation confidence based on temporal and spatial proximity
- Sky Map Visualization: Interactive scatter plot showing event positions in RA/Dec coordinates
- Event Timeline: Chronological view of detected events with filtering capabilities
- Correlation Network: Visual representation of correlated event pairs and clusters
- Dynamic Controls: Real-time adjustment of correlation parameters
- Event Clustering: Groups related events into multi-messenger clusters
- Statistical Analysis: Provides correlation statistics and confidence metrics
- Export Capabilities: Download results in various formats for further analysis
- Clone the repository:
git clone https://github.com/ashvin2005/skyweaver.git
cd skyweaver- Install dependencies:
npm install- Start the application:
npm run dev- Open http://localhost:3000 to view the dashboard
That's it! The application will automatically load with demo data showcasing various astronomical events.
To enable real-time features and authentication, you can optionally set up Supabase:
-
Create a new Supabase project
- Click "Connect to Supabase" in the top right of the application
- The database schema will be automatically created
-
Run the development server:
npm run dev- Open http://localhost:3000 to access SkyWeaver
- Interactive Dashboard: React components for data visualization
- Sky Map: Plotly.js-based celestial coordinate plotting
- Event Management: Real-time event list with filtering and search
- Correlation Controls: Dynamic parameter adjustment interface
/api/events- Event data management (GET/POST)/api/correlate- Correlation analysis endpoint/api/sources- Observatory/data source management
- astro_events: Main event storage with spatial/temporal indexing
- event_correlations: Correlation results with confidence scores
- Row Level Security: Secure data access with proper authentication
- LIGO-Virgo collaboration data
- Binary black hole and neutron star mergers
- Strain data and parameter estimation
- Fermi-GBM and Swift-BAT detections
- Short and long GRB classifications
- Spectral and temporal analysis data
- Zwicky Transient Facility discoveries
- Supernovae, kilonovae, and other transients
- Photometric and spectroscopic follow-up
- Host galaxy information
- Stellar catalogs and object classifications
- Distance measurements and proper motions
- Data Loading: Click "Refresh Data" to load the latest events
- Parameter Adjustment: Use the correlation panel to set time windows and angular thresholds
- Correlation Analysis: Click "Find Correlations" to identify related events
- Visualization: Explore results on the interactive sky map
- Event Details: Click on events for detailed metadata and analysis
- Custom Time Windows: Adjust from seconds to days based on physics expectations
- Angular Correlation: Set thresholds based on localization uncertainties
- Multi-Messenger Filtering: Focus on specific event type combinations
- Confidence Thresholding: Filter results by correlation strength
The system includes synthetic test data representing:
- GW150914: First gravitational wave detection
- GW170817: Neutron star merger with electromagnetic counterparts
- GRB170817A: Associated gamma-ray burst
- AT2017gfo: Optical kilonova counterpart
- Additional simulated events for testing correlation algorithms
// Fetch events with filters
GET /api/events?start_time=2017-08-17T00:00:00Z&event_type=gravitational_wave
// Add new events
POST /api/events
{
"events": [
{
"event_id": "GW123456",
"source": "LIGO-Virgo",
"event_type": "gravitational_wave",
"ra": 197.45,
"dec": -23.38,
"time_utc": "2023-01-01T12:00:00Z",
"metadata": { "snr": 15.2, "distance": 100 }
}
]
}// Run correlation analysis
POST /api/correlate
{
"timeWindowSeconds": 600,
"angularThresholdDeg": 1.0,
"minConfidenceScore": 0.1
}- Connect your GitHub repository to Vercel
- Set environment variables for Supabase connection
- Deploy with automatic builds on push
- Database and API are automatically managed
- Real-time subscriptions for live event updates
- Built-in authentication and security
Multi-messenger astronomy combines observations from different "messengers":
- Gravitational Waves: Spacetime distortions from accelerating masses
- Electromagnetic Radiation: Photons across all wavelengths
- Neutrinos: Nearly massless particles from nuclear processes
- Cosmic Rays: High-energy particles from extreme environments
- Binary Neutron Star Mergers: Produce GWs, GRBs, and optical transients
- Black Hole Mergers: Primarily gravitational wave sources
- Core-Collapse Supernovae: Multi-wavelength electromagnetic emission
- Active Galactic Nuclei: Variable across multiple messengers
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
- Machine Learning: Automated event classification and correlation
- Real-time Alerts: Push notifications for high-confidence correlations
- Advanced Visualization: 3D sky maps and time-series analysis
- API Integration: Direct connections to live observatory data streams
- Collaborative Features: Multi-user analysis and annotation tools
This project is licensed under the MIT License - see the LICENSE file for details.
- LIGO-Virgo-KAGRA Collaboration for gravitational wave data
- Zwicky Transient Facility for optical transient discoveries
- NASA HEASARC for high-energy astrophysics data
- SIMBAD/CDS for astronomical catalogs
- The multi-messenger astronomy community
For questions, suggestions, or collaboration opportunities, please open an issue or contact the development team.
SkyWeaver - Weaving together the cosmic web of multi-messenger astronomy 🌌
- Next.js Documentation - learn about Next.js features and API.
- Learn Next.js - an interactive Next.js tutorial.
You can check out the Next.js GitHub repository - your feedback and contributions are welcome!
The easiest way to deploy your Next.js app is to use the Vercel Platform from the creators of Next.js.
Check out our Next.js deployment documentation for more details..
