Skip to content

Commit c03c15d

Browse files
authored
Update README.md
1 parent 03d309c commit c03c15d

File tree

1 file changed

+0
-279
lines changed

1 file changed

+0
-279
lines changed

README.md

Lines changed: 0 additions & 279 deletions
Original file line numberDiff line numberDiff line change
@@ -410,282 +410,3 @@ Distributed under the **MIT License**. See `LICENSE` for more information.
410410

411411
</div>
412412

413-
---
414-
415-
## ✨ Key Features
416-
417-
<table>
418-
<tr>
419-
<td width="50%">
420-
421-
### 🎮 Interactive Simulation
422-
- **Adjustable Qubit Count** with smooth slider controls
423-
- **Real-time Protocol Execution** with visual feedback
424-
- **Step-by-step visualization** of quantum states
425-
- **Alice & Bob character representation**
426-
427-
</td>
428-
<td width="50%">
429-
430-
### 🔬 Quantum Physics in Action
431-
- **Random Basis Selection** (Z-basis & X-basis)
432-
- **Quantum State Encoding** simulation
433-
- **Measurement & Collapse** demonstration
434-
- **Basis Reconciliation** process
435-
436-
</td>
437-
</tr>
438-
<tr>
439-
<td width="50%">
440-
441-
### 👁️ Eavesdropper Detection
442-
- **Toggle Eve mode** to simulate attacks
443-
- **Automatic error rate calculation**
444-
- **Visual indication** of compromised channels
445-
- **Security threshold visualization**
446-
447-
</td>
448-
<td width="50%">
449-
450-
### 📊 Results & Analytics
451-
- **Secret Key Generation** display
452-
- **Matching Basis Statistics**
453-
- **QBER (Quantum Bit Error Rate)** computation
454-
- **Interactive results table**
455-
456-
</td>
457-
</tr>
458-
</table>
459-
460-
---
461-
462-
## 🚀 How It Works
463-
464-
<div align="center">
465-
466-
```mermaid
467-
graph LR
468-
A[Alice Generates Random Bits] --> B[Alice Encodes in Random Bases]
469-
B --> C[Qubits Sent via Quantum Channel]
470-
C --> D{Eve Intercepting?}
471-
D -->|Yes| E[Eve Measures & Disturbs]
472-
D -->|No| F[Bob Receives Clean Qubits]
473-
E --> F
474-
F --> G[Bob Measures in Random Bases]
475-
G --> H[Public Basis Comparison]
476-
H --> I[Keep Matching Bases Only]
477-
I --> J[Error Rate Check]
478-
J --> K{QBER > 25%?}
479-
K -->|Yes| L[❌ Abort - Eve Detected]
480-
K -->|No| M[✅ Secure Key Generated]
481-
```
482-
483-
</div>
484-
485-
### 🎯 Protocol Steps
486-
487-
1. **🎲 Random Generation**: Alice creates random bits (0s and 1s) and randomly chooses encoding bases (Z or X)
488-
2. **📡 Quantum Transmission**: Each bit is encoded into a quantum state and sent to Bob
489-
3. **🔍 Random Measurement**: Bob randomly selects measurement bases for each qubit
490-
4. **📢 Basis Reconciliation**: Alice and Bob publicly compare which bases they used (NOT the bit values)
491-
5. **🔑 Key Sifting**: They keep only bits where both used the same basis
492-
6. **🛡️ Eavesdropping Check**: A subset is compared to calculate the error rate
493-
7. **✅ Secure Key**: If error rate is below threshold (25%), the key is secure!
494-
495-
---
496-
497-
## 🎨 Visual Features
498-
499-
<div align="center">
500-
501-
### 🌈 Modern Animated UI
502-
503-
</div>
504-
505-
- **3D Card Effects** with smooth hover animations
506-
- **Gradient Backgrounds** with dynamic color transitions
507-
- **Particle Effects** for quantum state visualization
508-
- **Smooth Transitions** for all interactive elements
509-
- **Responsive Design** optimized for all screen sizes
510-
- **Neon Glow Effects** for quantum-themed aesthetics
511-
- **Interactive Tables** with color-coded results
512-
513-
---
514-
515-
## 💻 Tech Stack
516-
517-
<div align="center">
518-
519-
![HTML5](https://img.shields.io/badge/HTML5-%23E34F26.svg?style=for-the-badge&logo=html5&logoColor=white)
520-
![CSS3](https://img.shields.io/badge/CSS3-%231572B6.svg?style=for-the-badge&logo=css3&logoColor=white)
521-
![JavaScript](https://img.shields.io/badge/JavaScript-%23323330.svg?style=for-the-badge&logo=javascript&logoColor=%23F7DF1E)
522-
![Quantum](https://img.shields.io/badge/Quantum-Physics-blueviolet?style=for-the-badge)
523-
524-
</div>
525-
526-
---
527-
528-
## 🎓 Educational Value
529-
530-
This simulator is perfect for:
531-
532-
- 📚 **Students** learning quantum cryptography fundamentals
533-
- 🔬 **Researchers** demonstrating QKD concepts
534-
- 👨‍🏫 **Educators** teaching quantum information theory
535-
- 💼 **Portfolio Projects** showcasing quantum computing knowledge
536-
- 🎯 **Cybersecurity Enthusiasts** exploring post-quantum cryptography
537-
538-
---
539-
540-
## 🔬 The Science Behind BB84
541-
542-
### Quantum States Used
543-
544-
| Bit Value | Z-Basis (Rectilinear) | X-Basis (Diagonal) |
545-
|-----------|----------------------|-------------------|
546-
| **0** | \|0⟩ (Horizontal) | \|+⟩ (Diagonal) |
547-
| **1** | \|1⟩ (Vertical) | \|-⟩ (Anti-diagonal) |
548-
549-
### Why It's Secure
550-
551-
**Heisenberg Uncertainty Principle**: Measuring a quantum state in the wrong basis yields random results and disturbs the state.
552-
553-
**No-Cloning Theorem**: Unknown quantum states cannot be perfectly copied, preventing silent eavesdropping.
554-
555-
**Observable Disturbance**: Any measurement by Eve introduces detectable errors in Bob's results.
556-
557-
---
558-
559-
## 🛠️ Installation & Usage
560-
561-
### Quick Start
562-
563-
```bash
564-
# Clone the repository
565-
git clone https://github.com/PRODHOSH/qkd_simulation
566-
567-
# Navigate to project directory
568-
cd qkd_simulation
569-
570-
# Open in browser
571-
open index.html
572-
```
573-
574-
### Live Demo
575-
576-
🌐 **[Check it out !](https://prodhosh.github.io/qkd_simulation/)**
577-
578-
### Usage Instructions
579-
580-
1. **Set Qubit Count**: Use the slider to choose how many qubits to simulate (default: 8)
581-
2. **Toggle Eve**: Check the box to include an eavesdropper in the simulation
582-
3. **Run Simulation**: Click the "Run BB84 Simulation" button
583-
4. **View Results**: Examine the:
584-
- Qubit-by-qubit breakdown table
585-
- Final secret key generated
586-
- Error rate statistics
587-
- Matching basis count
588-
589-
---
590-
591-
## 📊 Example Output
592-
593-
```
594-
🔐 BB84 Simulation Results
595-
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
596-
597-
📡 Total Qubits Transmitted: 8
598-
✅ Matching Bases: 4
599-
🔑 Secret Key Length: 4 bits
600-
601-
🔐 Final Secret Key: 1011
602-
603-
📈 Statistics:
604-
• QBER (Quantum Bit Error Rate): 0.00%
605-
• Security Status: ✅ SECURE
606-
• Eve Detected: No
607-
```
608-
609-
---
610-
611-
## 🌟 Project Highlights
612-
613-
<div align="center">
614-
615-
### 🏆 What Makes This Special
616-
617-
</div>
618-
619-
**First Principles Implementation** - Built from quantum mechanics fundamentals
620-
**Educational Focus** - Clear explanations and visual feedback
621-
**Interactive Learning** - Hands-on experience with quantum protocols
622-
**Production Quality** - Professional UI/UX design
623-
**Open Source** - Free for educational and research use
624-
625-
---
626-
627-
## 🔮 Future Enhancements
628-
629-
- [ ] **Bloch Sphere Visualization** for quantum state representation
630-
- [ ] **E91 Protocol** implementation (entanglement-based QKD)
631-
- [ ] **Noise Simulation** for realistic quantum channel modeling
632-
- [ ] **Backend Integration** for storing simulation results
633-
- [ ] **Multi-language Support** for international accessibility
634-
- [ ] **Advanced Analytics** dashboard with statistical analysis
635-
- [ ] **Mobile App** version for on-the-go learning
636-
637-
---
638-
639-
## 📚 Resources & References
640-
641-
### Learn More About BB84
642-
643-
- 📖 [Original BB84 Paper (1984)](https://arxiv.org/abs/2003.06557)
644-
- 🎓 [Quantum Key Distribution - Wikipedia](https://en.wikipedia.org/wiki/Quantum_key_distribution)
645-
- 🔬 [IBM Quantum Experience](https://quantum-computing.ibm.com/)
646-
- 📺 [BB84 Explained - YouTube](https://www.youtube.com/results?search_query=bb84+protocol)
647-
648-
### Quantum Computing Tools
649-
650-
- ⚛️ [Qiskit](https://qiskit.org/) - IBM's Quantum Computing Framework
651-
- 🔵 [Cirq](https://quantumai.google/cirq) - Google's Quantum Programming Framework
652-
- 🌊 [Amazon Braket](https://aws.amazon.com/braket/) - AWS Quantum Computing Service
653-
654-
---
655-
656-
## 🤝 Contributing
657-
658-
Contributions are welcome! Feel free to:
659-
660-
- 🐛 Report bugs
661-
- 💡 Suggest new features
662-
- 🔧 Submit pull requests
663-
- 📖 Improve documentation
664-
665-
---
666-
667-
## 📄 License
668-
669-
This project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.
670-
671-
---
672-
673-
## 👨‍💻 Author
674-
675-
**Your Name**
676-
677-
[![GitHub](https://img.shields.io/badge/GitHub-Profile-181717?style=for-the-badge&logo=github)](https://github.com/PRODHOSH)
678-
[![LinkedIn](https://img.shields.io/badge/LinkedIn-Connect-0077B5?style=for-the-badge&logo=linkedin)](https://linkedin.com/in/prodhoshvs)
679-
[![Portfolio](https://img.shields.io/badge/Portfolio-Visit-FF6B6B?style=for-the-badge&logo=google-chrome&logoColor=white)](https://prodhosh.github.io/portfolio/)
680-
681-
---
682-
683-
<div align="center">
684-
685-
### 🌟 If you found this project helpful, please give it a ⭐ star!
686-
687-
Made with ❤️ and Quantum Physics
688-
689-
![Wave](https://raw.githubusercontent.com/mayhemantt/mayhemantt/Update/svg/Bottom.svg)
690-
691-
</div>

0 commit comments

Comments
 (0)