How ashwanth007-d/q-shield works
Q-SHIELD is an educational Streamlit simulator for demonstrating Bell-pair correlations, Eve-style interception, and CHSH measurements as intrusion indicators. A user selects a lab and run settings in the dashboard; the app runs quantum experiments, analyzes measurement counts, and presents security metrics and visualizations. Session history records experiment results. The graph preserves documented CHSH and visualization capabilities, but the excerpts do not show every UI-to-feature call, so some links are marked unverified rather than asserted as confirmed.
Main entry points: app.py Streamlit Dashboard · quantum_engine.py Bell Experiment · security_engine.py Security Metrics · visualization.py Outcome Chart
Components 15
Interactive Dashboard
- Streamlit Dashboard
app.py - Lab Controls
app.py - Session History
app.py
Quantum Experiments
- Bell Experiment
quantum_engine.py - Eve Attack Circuit
quantum_engine.py - CHSH Experiment
quantum_engine.py - Qiskit Simulator
quantum_engine.py
Security Analysis
- Security Metrics
security_engine.py - Live Explanation
security_engine.py
Results Visualization
- Outcome Chart
visualization.py - Comparison Chart
visualization.py - Risk Gauge
visualization.py - CHSH Breakdown
visualization.py - Channel Flow View
visualization.py
Other components
- Dashboard User
Connections 15
- Dashboard User → Streamlit Dashboard: uses
README.md - Streamlit Dashboard → Lab Controls: presents
app.py - Lab Controls → Bell Experiment: runs
app.py - Bell Experiment → Qiskit Simulator: executes on
quantum_engine.py - Bell Experiment → Eve Attack Circuit: selects for attack
quantum_engine.py - Lab Controls → Security Metrics: analyzes counts
app.py - Streamlit Dashboard → Session History: records runs
app.py - Streamlit Dashboard → Outcome Chart: renders
app.py - Streamlit Dashboard → CHSH Experiment: runs CHSH
app.py - Streamlit Dashboard → Live Explanation: requests summary
app.py - Streamlit Dashboard → Comparison Chart: renders comparison
app.py - Streamlit Dashboard → Risk Gauge: renders risk
app.py - Streamlit Dashboard → CHSH Breakdown: renders breakdown
app.py - Streamlit Dashboard → Channel Flow View: renders flow
app.py - CHSH Experiment → Qiskit Simulator: executes on
quantum_engine.py