# ORruns: Redefining Operations Research Experiment Management 🚀
<p align="center">
<img src="orruns/assets/logo.png" alt="ORruns Logo" width="200"/>
<br>
<em>Next-generation Experiment Management Platform for Operations Research</em>
</p>
> 🌱 ORruns is in its vibrant early stages. As a newly launched open-source project, we welcome every Operations Research researcher to participate and contribute. Your ideas and code will help this project grow better. Let's build the future of the Operations Research community together!
<p align="center">
<a href="#quick-start">Quick Start</a> •
<a href="#why-orruns">Why ORruns</a> •
<a href="#community">Community</a> •
<a href="#features">Features</a>
</p>
---
## Why ORruns?
Have you encountered these challenges in Operations Research?
- 📊 Experimental data scattered everywhere, difficult to manage and track
- 🔄 Tedious experiment repetition and chaotic parameter management
- 📈 Repetitive code writing for visualization
- 🤝 Lack of unified experiment management and sharing platform
**ORruns** is born to solve these problems! We are committed to providing Operations Research researchers with a modern, intuitive, and powerful experiment management tool.
## ✨ Features
### Elegant Experiment Tracking
```python
from orruns import ExperimentTracker
with ExperimentTracker("nsga2_optimization") as tracker:
tracker.log_params({
"population_size": 100,
"generations": 1000
})
# Your optimization code
result = optimize()
tracker.log_metrics({
"pareto_front_size": len(result.pareto_front),
"hypervolume": result.hypervolume
})
```
### Powerful Parallel Experiment Support
```python
@repeat_experiment(times=5, parallel=True)
def optimize_with_different_seeds(tracker):
# Automatic parallelization, result collection and visualization
return your_optimization_algorithm()
```
### Intuitive Visualization Interface
<p align="center">
<img src="IMG\PixPin_2024-11-14_00-03-57.png" alt="Dashboard Screenshot" width="600"/>
</p>
## 🚀 Making Operations Research Better
We believe that the Operations Research community deserves modern and open tooling ecosystems like those in the machine learning community. ORruns is not just a tool, but a vision - let's together:
- 🌟 Build an open, active Operations Research community
- 🔧 Create better experiment management tools
- 📚 Share knowledge and best practices
- 🤝 Promote academic exchange and collaboration
## 💡 Join the Journey
> "The future of Operations Research needs our collective effort. Let's build an open-source community for Operations Research researchers!"
### 🌱 Growing Together from Zero
ORruns is still a young project, which means:
- You can participate in core feature design and development
- Your ideas and suggestions are more likely to be adopted
- You can witness and influence every step of the project's growth
- You'll be among the earliest contributors
### 💪 How to Contribute
Whether you are:
- 🎓 A student new to Operations Research
- 👨🔬 An experienced researcher
- 👩💻 A passionate developer
- 📚 An enthusiastic documentation writer
We welcome your participation:
- 🎯 **Use and Feedback**: Every suggestion drives ORruns to become better
- 🛠️ **Development**: Whether fixing bugs or adding features, all contributions are welcome
- 📝 **Documentation**: Help others understand and use ORruns
- 🌍 **Promotion**: Spread the word to more Operations Research researchers
## 🎯 Roadmap
We're planning exciting features to build a more comprehensive Operations Research experiment ecosystem:
### Coming Soon
- 📊 **Enhanced Analytics** (v0.2.0)
- Dynamic Pareto Front Visualization
- Advanced Statistical Analysis Tools
- Experiment Comparison System
- 🛠️ **Improved User Experience** (v0.3.0)
- Experiment Backup and Recovery
- Publication-Ready Results Export
- Powerful Command Line Tools
> Check out the complete [roadmap document](ROADMAP.md) for more details and future plans!
## 🚀 Quick Start
```bash
pip install orruns
```
Check out our [Quick Start Guide](docs/quickstart.md) to begin your first experiment!
## 📄 License
ORruns is licensed under the GNU General Public License v3.0 (GPL-3.0) with additional non-commercial terms. This means: if you need to use this software for commercial purposes, please contact the project maintainers for a commercial license.
See the full license text in the [LICENSE](LICENSE) file.
## 🌟 Join the Community
- 💬 [Join Discussions](https://github.com/lengff123/ORruns/discussions)
- 🐛 [Report Issues](https://github.com/lengff123/ORruns/issues)
- 📫 [Mailing List](mailto:your-email@example.com)
---
<p align="center">
<em>By Operations Researchers, For Operations Researchers</em>
<br>
<br>
If you like this project, please give us a ⭐️
</p>
Raw data
{
"_id": null,
"home_page": "https://github.com/yourusername/orruns",
"name": "orruns",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "operations research, optimization, experiment tracking, scientific computing, mathematical optimization, research tools, experiment management, reproducible research",
"author": "ffxdd",
"author_email": "your.email@example.com",
"download_url": "https://files.pythonhosted.org/packages/4c/7e/f616eaffde8aafc103bb70d1ec4fbde58acc139546d03cfcabe16acd6d00/orruns-0.1.1.tar.gz",
"platform": "any",
"description": "# ORruns: Redefining Operations Research Experiment Management \ud83d\ude80\r\n\r\n<p align=\"center\">\r\n <img src=\"orruns/assets/logo.png\" alt=\"ORruns Logo\" width=\"200\"/>\r\n <br>\r\n <em>Next-generation Experiment Management Platform for Operations Research</em>\r\n</p>\r\n\r\n> \ud83c\udf31 ORruns is in its vibrant early stages. As a newly launched open-source project, we welcome every Operations Research researcher to participate and contribute. Your ideas and code will help this project grow better. Let's build the future of the Operations Research community together!\r\n\r\n<p align=\"center\">\r\n <a href=\"#quick-start\">Quick Start</a> \u2022\r\n <a href=\"#why-orruns\">Why ORruns</a> \u2022\r\n <a href=\"#community\">Community</a> \u2022\r\n <a href=\"#features\">Features</a>\r\n</p>\r\n\r\n---\r\n\r\n## Why ORruns?\r\n\r\nHave you encountered these challenges in Operations Research?\r\n\r\n- \ud83d\udcca Experimental data scattered everywhere, difficult to manage and track\r\n- \ud83d\udd04 Tedious experiment repetition and chaotic parameter management\r\n- \ud83d\udcc8 Repetitive code writing for visualization\r\n- \ud83e\udd1d Lack of unified experiment management and sharing platform\r\n\r\n**ORruns** is born to solve these problems! We are committed to providing Operations Research researchers with a modern, intuitive, and powerful experiment management tool.\r\n\r\n## \u2728 Features\r\n\r\n### Elegant Experiment Tracking\r\n```python\r\nfrom orruns import ExperimentTracker\r\n\r\nwith ExperimentTracker(\"nsga2_optimization\") as tracker:\r\n tracker.log_params({\r\n \"population_size\": 100,\r\n \"generations\": 1000\r\n })\r\n \r\n # Your optimization code\r\n result = optimize()\r\n \r\n tracker.log_metrics({\r\n \"pareto_front_size\": len(result.pareto_front),\r\n \"hypervolume\": result.hypervolume\r\n })\r\n```\r\n\r\n### Powerful Parallel Experiment Support\r\n```python\r\n@repeat_experiment(times=5, parallel=True)\r\ndef optimize_with_different_seeds(tracker):\r\n # Automatic parallelization, result collection and visualization\r\n return your_optimization_algorithm()\r\n```\r\n\r\n### Intuitive Visualization Interface\r\n<p align=\"center\">\r\n <img src=\"IMG\\PixPin_2024-11-14_00-03-57.png\" alt=\"Dashboard Screenshot\" width=\"600\"/>\r\n</p>\r\n\r\n## \ud83d\ude80 Making Operations Research Better\r\n\r\nWe believe that the Operations Research community deserves modern and open tooling ecosystems like those in the machine learning community. ORruns is not just a tool, but a vision - let's together:\r\n\r\n- \ud83c\udf1f Build an open, active Operations Research community\r\n- \ud83d\udd27 Create better experiment management tools\r\n- \ud83d\udcda Share knowledge and best practices\r\n- \ud83e\udd1d Promote academic exchange and collaboration\r\n\r\n## \ud83d\udca1 Join the Journey\r\n\r\n> \"The future of Operations Research needs our collective effort. Let's build an open-source community for Operations Research researchers!\"\r\n\r\n### \ud83c\udf31 Growing Together from Zero\r\n\r\nORruns is still a young project, which means:\r\n- You can participate in core feature design and development\r\n- Your ideas and suggestions are more likely to be adopted\r\n- You can witness and influence every step of the project's growth\r\n- You'll be among the earliest contributors\r\n\r\n### \ud83d\udcaa How to Contribute\r\n\r\nWhether you are:\r\n- \ud83c\udf93 A student new to Operations Research\r\n- \ud83d\udc68\u200d\ud83d\udd2c An experienced researcher\r\n- \ud83d\udc69\u200d\ud83d\udcbb A passionate developer\r\n- \ud83d\udcda An enthusiastic documentation writer\r\n\r\nWe welcome your participation:\r\n\r\n- \ud83c\udfaf **Use and Feedback**: Every suggestion drives ORruns to become better\r\n- \ud83d\udee0\ufe0f **Development**: Whether fixing bugs or adding features, all contributions are welcome\r\n- \ud83d\udcdd **Documentation**: Help others understand and use ORruns\r\n- \ud83c\udf0d **Promotion**: Spread the word to more Operations Research researchers\r\n\r\n## \ud83c\udfaf Roadmap\r\n\r\nWe're planning exciting features to build a more comprehensive Operations Research experiment ecosystem:\r\n\r\n### Coming Soon\r\n- \ud83d\udcca **Enhanced Analytics** (v0.2.0)\r\n - Dynamic Pareto Front Visualization\r\n - Advanced Statistical Analysis Tools\r\n - Experiment Comparison System\r\n\r\n- \ud83d\udee0\ufe0f **Improved User Experience** (v0.3.0)\r\n - Experiment Backup and Recovery\r\n - Publication-Ready Results Export\r\n - Powerful Command Line Tools\r\n\r\n> Check out the complete [roadmap document](ROADMAP.md) for more details and future plans!\r\n\r\n## \ud83d\ude80 Quick Start\r\n\r\n```bash\r\npip install orruns\r\n```\r\n\r\nCheck out our [Quick Start Guide](docs/quickstart.md) to begin your first experiment!\r\n\r\n## \ud83d\udcc4 License\r\n\r\nORruns is licensed under the GNU General Public License v3.0 (GPL-3.0) with additional non-commercial terms. This means: if you need to use this software for commercial purposes, please contact the project maintainers for a commercial license.\r\nSee the full license text in the [LICENSE](LICENSE) file.\r\n\r\n## \ud83c\udf1f Join the Community\r\n\r\n- \ud83d\udcac [Join Discussions](https://github.com/lengff123/ORruns/discussions)\r\n- \ud83d\udc1b [Report Issues](https://github.com/lengff123/ORruns/issues)\r\n- \ud83d\udceb [Mailing List](mailto:your-email@example.com)\r\n\r\n---\r\n\r\n<p align=\"center\">\r\n <em>By Operations Researchers, For Operations Researchers</em>\r\n <br>\r\n <br>\r\n If you like this project, please give us a \u2b50\ufe0f\r\n</p>\r\n",
"bugtrack_url": null,
"license": "GNU Affero General Public License v3",
"summary": "Experiment Management Tool for Operations Research and Optimization",
"version": "0.1.1",
"project_urls": {
"Bug Reports": "https://github.com/yourusername/orruns/issues",
"Changelog": "https://github.com/yourusername/orruns/blob/main/CHANGELOG.md",
"Documentation": "https://orruns.readthedocs.io/",
"Homepage": "https://github.com/yourusername/orruns",
"Source Code": "https://github.com/yourusername/orruns"
},
"split_keywords": [
"operations research",
" optimization",
" experiment tracking",
" scientific computing",
" mathematical optimization",
" research tools",
" experiment management",
" reproducible research"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c3237b91634f411e31e10bad090b2446aac5d8cf93c051df24d3a74f29cfee13",
"md5": "69313258f3fa75467322ac1d0023ebab",
"sha256": "3b852f37e6fb34dbd5a5c3e5d30574e3b091fcf6c9ba1c92f464b73617094bd0"
},
"downloads": -1,
"filename": "orruns-0.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "69313258f3fa75467322ac1d0023ebab",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 37784,
"upload_time": "2024-11-14T08:00:12",
"upload_time_iso_8601": "2024-11-14T08:00:12.764507Z",
"url": "https://files.pythonhosted.org/packages/c3/23/7b91634f411e31e10bad090b2446aac5d8cf93c051df24d3a74f29cfee13/orruns-0.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "4c7ef616eaffde8aafc103bb70d1ec4fbde58acc139546d03cfcabe16acd6d00",
"md5": "ba1868353c5771ff6892bebdfaf0a789",
"sha256": "c0637948564278bd8459fd276ad4112c4707175cade372a7c3234939ff677bf3"
},
"downloads": -1,
"filename": "orruns-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "ba1868353c5771ff6892bebdfaf0a789",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 34021,
"upload_time": "2024-11-14T08:00:16",
"upload_time_iso_8601": "2024-11-14T08:00:16.667459Z",
"url": "https://files.pythonhosted.org/packages/4c/7e/f616eaffde8aafc103bb70d1ec4fbde58acc139546d03cfcabe16acd6d00/orruns-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-14 08:00:16",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "yourusername",
"github_project": "orruns",
"github_not_found": true,
"lcname": "orruns"
}
JSON
