Update README_SPACES.md

README_SPACES.md

@@ -1,177 +1,164 @@
----
-title: NSN Integration Dashboard
-emoji: 🚀
-colorFrom: blue
-colorTo: purple
-sdk: gradio
-sdk_version: 4.0.0
-app_file: app.py
-pinned: false
-license: mit
----
-
-# Quantum LIMIT-Graph v2.4.0: NSN Integration Dashboard
-
-Interactive dashboard for contributor challenges in Nested Subspace Networks (NSN) integration with quantum backends.
-
-## 🎯 Features
-
-### Panel 1: Backend Telemetry Rank Adaptation
-- **Function**: Adjust NSN rank based on backend health metrics
-- **Visualization**: Line chart of rank vs reliability across backend states
-- **Contributor Task**: Submit edits optimized for dynamic rank shifts
-- **Metric**: Responsiveness vs reliability trade-off
-
-### Panel 2: Multilingual Accuracy Heatmap
-- **Function**: Track accuracy across languages and ranks
-- **Visualization**: Heatmap showing performance matrix
-- **Contributor Task**: Optimize edits for multilingual scenarios
-- **Metric**: Average accuracy across language-rank pairs
-
-### Panel 3: Cross-Lingual Edit Propagation
-- **Function**: Transfer edits from high-resource to low-resource languages
-- **Visualization**: Containment heatmap with flow arrows
-- **Contributor Task**: Submit propagation strategies
-- **Metric**: Quality score of propagated edits
-
-### Panel 4: Pareto Frontier
-- **Function**: Visualize efficiency vs expressiveness trade-offs
-- **Visualization**: Scatter plot with Pareto frontier
-- **Contributor Task**: Optimize for compute-performance balance
-- **Metric**: Position on Pareto frontier
-
-### Panel 5: Contributor Leaderboard
-- **Function**: Track contributor performance and provide feedback
-- **Visualization**: Leaderboard table + personalized feedback
-- **Contributor Task**: Submit edits across ranks and languages
-- **Metric**: Efficiency badge (accuracy/FLOPs)
-
-### Panel 6: Ensemble Inference
-- **Function**: Run edits across multiple quantum backends
-- **Visualization**: Agreement matrix heatmap
-- **Contributor Task**: Submit ensemble edits
-- **Metric**: Agreement score + reliability boost
-
-## 🚀 Quick Start
-
-### Using the Dashboard
-
-1. **Select a Panel**: Choose from the 6 tabs
-2. **Configure Parameters**: Adjust backends, languages, ranks
-3. **Generate Visualizations**: Click the refresh button
-4. **Analyze Results**: Review metrics and insights
-5. **Submit Contributions**: Export your results
-
-### Example Workflow
-
-```python
-# 1. Test backend adaptation
-backend = 'ibm_washington'
-# View FLOPs vs Reliability chart
-
-# 2. Analyze multilingual performance
-languages = ['english', 'chinese', 'indonesian']
-# View accuracy heatmap
-
-# 3. Test edit propagation
-source = 'english'
-target = 'indonesian'
-rank = 128
-# View containment scores
-
-# 4. Check your position on Pareto frontier
-# Submit your data and see your ranking
-
-# 5. Get personalized feedback
-contributor_id = 'your_id'
-# View recommendations and badges
-
-# 6. Run ensemble inference
-backends = ['ibm_manila', 'ibm_washington', 'russian_simulator']
-# View agreement matrix
-```
-
-## 📊 Leaderboard Metrics
-
-### Scenario 1: Telemetry Adaptation
-- **Responsiveness**: Adaptation speed (higher is better)
-- **Reliability**: Predicted reliability score (0-1)
-- **Score**: `0.6 * reliability + 0.4 * (responsiveness / 1000)`
-
-### Scenario 2: Edit Propagation
-- **Quality**: Propagated edit quality (0-1)
-- **Containment**: Subspace containment score (0-1)
-- **Score**: `0.7 * quality + 0.3 * containment`
-
-### Scenario 3: Rank Feedback
-- **Efficiency**: `accuracy / flops`
-- **Diversity**: Unique rank-language pairs
-- **Score**: `0.6 * efficiency * 1e8 + 0.4 * diversity`
-
-### Scenario 4: Ensemble Inference
-- **Agreement**: Backend consensus (0-1)
-- **Reliability Boost**: Ensemble improvement (0-1)
-- **Score**: `0.5 * agreement + 0.5 * reliability_boost`
-
-## 🏆 Badges
-
-- 🏆 **Master Contributor**: 50+ submissions, 10+ languages
-- ⚡ **Efficiency Expert**: Efficiency > 1e-7
-- 🎯 **Accuracy Champion**: Avg accuracy > 0.95
-- 🔬 **Rank Explorer**: Tested 5+ ranks
-- 🌍 **Multilingual Specialist**: 8+ languages
-- 💪 **Active Contributor**: 20+ submissions
-- 📈 **Rising Star**: 10+ submissions
-- 🚀 **Getting Started**: First submissions
-- 🌟 **Newcomer**: Welcome!
-
-## 📚 Documentation
-
-- **Full Documentation**: [GitHub Repository](https://github.com/your-repo/quantum-limit-graph)
-- **Contributor Guide**: [CONTRIBUTOR_GUIDE.md](https://github.com/your-repo/quantum-limit-graph/blob/main/quantum_integration/nsn_integration/CONTRIBUTOR_GUIDE.md)
-- **API Reference**: [V2.4.0_SCENARIOS_SUMMARY.md](https://github.com/your-repo/quantum-limit-graph/blob/main/quantum_integration/nsn_integration/V2.4.0_SCENARIOS_SUMMARY.md)
-
-## 🤝 Contributing
-
-We welcome contributions! See our [Contributor Guide](https://github.com/your-repo/quantum-limit-graph/blob/main/quantum_integration/nsn_integration/CONTRIBUTOR_GUIDE.md) for details.
-
-### How to Contribute
-
-1. Fork the repository
-2. Run experiments using the modules
-3. Export your results
-4. Submit a pull request
-5. See your name on the leaderboard!
-
-## 🎁 Rewards
-
-### Monthly Prizes
-- 🥇 1st Place: Featured in research paper + $500
-- 🥈 2nd Place: GitHub sponsor badge + $300
-- 🥉 3rd Place: Contributor spotlight + $200
-
-### Special Awards
-- 🌟 Innovation Award
-- 🔬 Research Award
-- 🌍 Impact Award
-
-## 📝 Citation
-
-```bibtex
-@software{nsn_limit_graph_v2_4_0,
-  title={Quantum LIMIT-Graph v2.4.0: NSN Integration Dashboard},
-  author={AI Research Agent Team},
-  year={2025},
-  url={https://huggingface.co/spaces/your-org/nsn-integration-dashboard}
-}
-```
-
-## 📧 Contact
-
-- **GitHub**: [Issues](https://github.com/your-repo/quantum-limit-graph/issues)
-- **Discord**: [Join Server](https://discord.gg/quantum-limit-graph)
-- **Email**: nurcholisadam@gmail.com
-
----
-
-**Built with ❤️ for the quantum computing and multilingual NLP community**
+---
+title: NSN Integration Dashboard
+emoji: 🚀
+colorFrom: blue
+colorTo: purple
+sdk: gradio
+sdk_version: 4.0.0
+app_file: app.py
+pinned: false
+license: mit
+---
+
+# Quantum LIMIT-Graph v2.4.0: NSN Integration Dashboard
+
+Interactive dashboard for contributor challenges in Nested Subspace Networks (NSN) integration with quantum backends.
+
+## 🎯 Features
+
+### Panel 1: Backend Telemetry Rank Adaptation
+- **Function**: Adjust NSN rank based on backend health metrics
+- **Visualization**: Line chart of rank vs reliability across backend states
+- **Contributor Task**: Submit edits optimized for dynamic rank shifts
+- **Metric**: Responsiveness vs reliability trade-off
+
+### Panel 2: Multilingual Accuracy Heatmap
+- **Function**: Track accuracy across languages and ranks
+- **Visualization**: Heatmap showing performance matrix
+- **Contributor Task**: Optimize edits for multilingual scenarios
+- **Metric**: Average accuracy across language-rank pairs
+
+### Panel 3: Cross-Lingual Edit Propagation
+- **Function**: Transfer edits from high-resource to low-resource languages
+- **Visualization**: Containment heatmap with flow arrows
+- **Contributor Task**: Submit propagation strategies
+- **Metric**: Quality score of propagated edits
+
+### Panel 4: Pareto Frontier
+- **Function**: Visualize efficiency vs expressiveness trade-offs
+- **Visualization**: Scatter plot with Pareto frontier
+- **Contributor Task**: Optimize for compute-performance balance
+- **Metric**: Position on Pareto frontier
+
+### Panel 5: Contributor Leaderboard
+- **Function**: Track contributor performance and provide feedback
+- **Visualization**: Leaderboard table + personalized feedback
+- **Contributor Task**: Submit edits across ranks and languages
+- **Metric**: Efficiency badge (accuracy/FLOPs)
+
+### Panel 6: Ensemble Inference
+- **Function**: Run edits across multiple quantum backends
+- **Visualization**: Agreement matrix heatmap
+- **Contributor Task**: Submit ensemble edits
+- **Metric**: Agreement score + reliability boost
+
+## 🚀 Quick Start
+
+### Using the Dashboard
+
+1. **Select a Panel**: Choose from the 6 tabs
+2. **Configure Parameters**: Adjust backends, languages, ranks
+3. **Generate Visualizations**: Click the refresh button
+4. **Analyze Results**: Review metrics and insights
+5. **Submit Contributions**: Export your results
+
+### Example Workflow
+
+```python
+# 1. Test backend adaptation
+backend = 'ibm_washington'
+# View FLOPs vs Reliability chart
+
+# 2. Analyze multilingual performance
+languages = ['english', 'chinese', 'indonesian']
+# View accuracy heatmap
+
+# 3. Test edit propagation
+source = 'english'
+target = 'indonesian'
+rank = 128
+# View containment scores
+
+# 4. Check your position on Pareto frontier
+# Submit your data and see your ranking
+
+# 5. Get personalized feedback
+contributor_id = 'your_id'
+# View recommendations and badges
+
+# 6. Run ensemble inference
+backends = ['ibm_manila', 'ibm_washington', 'russian_simulator']
+# View agreement matrix
+```
+
+## 📊 Leaderboard Metrics
+
+### Scenario 1: Telemetry Adaptation
+- **Responsiveness**: Adaptation speed (higher is better)
+- **Reliability**: Predicted reliability score (0-1)
+- **Score**: `0.6 * reliability + 0.4 * (responsiveness / 1000)`
+
+### Scenario 2: Edit Propagation
+- **Quality**: Propagated edit quality (0-1)
+- **Containment**: Subspace containment score (0-1)
+- **Score**: `0.7 * quality + 0.3 * containment`
+
+### Scenario 3: Rank Feedback
+- **Efficiency**: `accuracy / flops`
+- **Diversity**: Unique rank-language pairs
+- **Score**: `0.6 * efficiency * 1e8 + 0.4 * diversity`
+
+### Scenario 4: Ensemble Inference
+- **Agreement**: Backend consensus (0-1)
+- **Reliability Boost**: Ensemble improvement (0-1)
+- **Score**: `0.5 * agreement + 0.5 * reliability_boost`
+
+## 🏆 Badges
+
+- 🏆 **Master Contributor**: 50+ submissions, 10+ languages
+- ⚡ **Efficiency Expert**: Efficiency > 1e-7
+- 🎯 **Accuracy Champion**: Avg accuracy > 0.95
+- 🔬 **Rank Explorer**: Tested 5+ ranks
+- 🌍 **Multilingual Specialist**: 8+ languages
+- 💪 **Active Contributor**: 20+ submissions
+- 📈 **Rising Star**: 10+ submissions
+- 🚀 **Getting Started**: First submissions
+- 🌟 **Newcomer**: Welcome!
+
+## 📚 Documentation
+
+- **Full Documentation**: [GitHub Repository](https://github.com/your-repo/quantum-limit-graph)
+- **Contributor Guide**: [CONTRIBUTOR_GUIDE.md](https://github.com/your-repo/quantum-limit-graph/blob/main/quantum_integration/nsn_integration/CONTRIBUTOR_GUIDE.md)
+- **API Reference**: [V2.4.0_SCENARIOS_SUMMARY.md](https://github.com/your-repo/quantum-limit-graph/blob/main/quantum_integration/nsn_integration/V2.4.0_SCENARIOS_SUMMARY.md)
+
+## 🤝 Contributing
+
+We welcome contributions! See our [Contributor Guide](https://github.com/your-repo/quantum-limit-graph/blob/main/quantum_integration/nsn_integration/CONTRIBUTOR_GUIDE.md) for details.
+
+### How to Contribute
+
+1. Fork the repository
+2. Run experiments using the modules
+3. Export your results
+4. Submit a pull request
+5. See your name on the leaderboard!
+
+
+## 📝 Citation
+
+```bibtex
+@software{nsn_limit_graph_v2_4_0,
+  title={Quantum LIMIT-Graph v2.4.0: NSN Integration Dashboard},
+  author={AI Research Agent Team},
+  year={2025},
+  url={https://huggingface.co/spaces/AIResAgTeam/quantum-nsn-integration}
+```
+
+## 📧 Contact
+
+- **GitHub**: [Issues](https://github.com/NurcholishAdam/Quantum-LIMIT-Graph-v2.4.0-NSN/issues)
+- **Email**: nurcholisadam@gmail.com
+
+---
+
+**Built with ❤️ for the quantum computing and multilingual NLP community**