Skip to content

An interactive web application for exploring the electromagnetic spectrum from radio waves to gamma rays. This educational tool provides real-time visualization, unit conversion, and comprehensive information about each region of the electromagnetic spectrum.

License

Notifications You must be signed in to change notification settings

cameronrye/electromagnetic-spectrum-explorer

Repository files navigation

Electromagnetic Spectrum Explorer Logo

Electromagnetic Spectrum Explorer

An interactive web application for exploring the electromagnetic spectrum from radio waves to gamma rays. This educational tool provides real-time visualization, unit conversion, and comprehensive information about each region of the electromagnetic spectrum.

Deploy to GitHub Pages React Vite License

🌐 Live Demo

🚀 Explore the Electromagnetic Spectrum

Experience the interactive electromagnetic spectrum explorer directly in your browser!

✨ Key Features

  • 🌈 Interactive Spectrum Visualization - Full-range display with logarithmic scaling
  • 🔄 Real-time Unit Conversion - Convert between wavelength, frequency, and energy
  • 📚 Educational Content - Detailed information for each electromagnetic region
  • 🎨 Modern UI - Responsive design with light/dark theme support
  • 🧪 Scientific Accuracy - Based on NIST physics constants and peer-reviewed data
  • 📱 Cross-platform - Optimized for desktop and mobile devices

📖 Documentation

For comprehensive documentation, please visit our Documentation Hub:

🚀 Quick Start

# Clone the repository
git clone https://github.com/cameronrye/electromagnetic-spectrum-explorer.git
cd electromagnetic-spectrum-explorer

# Install dependencies
npm install

# Start development server
npm run dev

Open http://localhost:5173 in your browser to explore the electromagnetic spectrum!

For detailed setup instructions, see the Developer Guide.

🎯 Usage

Click on any region of the electromagnetic spectrum to explore its properties, or use the conversion panel to input specific wavelength, frequency, or energy values. The application provides real-time visualization and educational content for each region.

For detailed usage instructions and tutorials, see the User Guide.

🔬 Scientific Foundation

Built on fundamental physics relationships and NIST-certified constants, ensuring scientific accuracy across all calculations and visualizations.

For detailed physics background and technical specifications, see the Architecture Documentation.

🛠️ Technology Stack

Built with modern web technologies: React 18, Vite, D3.js, Styled Components, and Framer Motion.

For detailed technical information, see the Developer Guide and Architecture Documentation.

🧪 Testing

Comprehensive test suite ensuring physics accuracy and application reliability. Tests run automatically in development mode.

For testing details, see the Testing Guide.

🚀 Deployment

This project is automatically deployed to GitHub Pages using GitHub Actions. The deployment workflow:

Manual Deployment

To deploy manually or to other platforms:

# Build for production
npm run build

# The dist/ folder contains all static files ready for deployment
# Upload the contents of dist/ to your hosting provider

For detailed deployment instructions and other hosting options, see the Deployment Guide.

🤝 Contributing

Contributions are welcome! Please see our Contributing Guide for development guidelines and submission process.

📚 Educational Use

Perfect for students, educators, researchers, and anyone curious about electromagnetic radiation and physics.

📞 Support & Issues

For support, troubleshooting, and bug reports, please see our Support Documentation or open an issue on GitHub.

📄 License

MIT License - see the LICENSE file for details.


Made with ❤️

Copyright © 2025 Cameron Rye

For complete documentation, visit the Documentation Hub

About

An interactive web application for exploring the electromagnetic spectrum from radio waves to gamma rays. This educational tool provides real-time visualization, unit conversion, and comprehensive information about each region of the electromagnetic spectrum.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published