{"id":13737176,"url":"https://github.com/7ossam81/EvoloPy","last_synced_at":"2025-05-08T13:33:14.331Z","repository":{"id":43371283,"uuid":"59107909","full_name":"7ossam81/EvoloPy","owner":"7ossam81","description":"EvoloPy toolbox provides classical and recent nature-inspired metaheuristic for the global optimization.","archived":false,"fork":false,"pushed_at":"2024-05-26T18:38:49.000Z","size":279,"stargazers_count":435,"open_issues_count":27,"forks_count":223,"subscribers_count":23,"default_branch":"master","last_synced_at":"2024-08-04T03:08:23.423Z","etag":null,"topics":["evolutionary-algorithms","framework","metaheuristics","optimization","swarm-intelligence"],"latest_commit_sha":null,"homepage":"","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/7ossam81.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2016-05-18T11:03:21.000Z","updated_at":"2024-08-03T17:36:30.000Z","dependencies_parsed_at":"2022-07-14T14:31:19.386Z","dependency_job_id":"fa04db2d-f3d9-4d72-b53d-b4da11f725d7","html_url":"https://github.com/7ossam81/EvoloPy","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/7ossam81%2FEvoloPy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/7ossam81%2FEvoloPy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/7ossam81%2FEvoloPy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/7ossam81%2FEvoloPy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/7ossam81","download_url":"https://codeload.github.com/7ossam81/EvoloPy/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224737431,"owners_count":17361345,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["evolutionary-algorithms","framework","metaheuristics","optimization","swarm-intelligence"],"created_at":"2024-08-03T03:01:36.945Z","updated_at":"2025-05-08T13:33:14.323Z","avatar_url":"https://github.com/7ossam81.png","language":"Jupyter Notebook","readme":"\u003cdiv align=\"center\"\u003e\n\u003cimg width=\"200\" alt=\"EvoloPy-logo\" src=\"https://github.com/user-attachments/assets/496f9a76-1fcc-4e4f-9586-8f327a434134\"\u003e\n\u003c/div\u003e\n\n# EvoloPy: An open source nature-inspired optimization toolbox for global optimization in Python\n\nThe EvoloPy toolbox provides classical and recent nature-inspired metaheuristic for the global optimization. The list of optimizers that have been implemented includes Particle Swarm Optimization (PSO), Multi-Verse Optimizer (MVO), Grey Wolf Optimizer (GWO), and Moth Flame Optimization (MFO). The full list of implemented optimizers is available here https://github.com/7ossam81/EvoloPy/wiki/List-of-optimizers\n\nIf you like our framework then we would really appreciate **a Star ⭐!**\n\n\n## Features\n- Fourteen nature-inspired metaheuristic optimizers were implemented.\n- The implementation uses the fast array manipulation using `NumPy`.\n- Matrix support using `SciPy`'s package.\n- More optimizers is coming soon.\n\n## Installation\n- Python 3.6 or higher is required.\n\nRun\n\n    pip install -r requirements.txt\n\n(possibly with `sudo`)\n\nThis command will install `sklearn`, `NumPy`, `SciPy`, and other dependencies for you.\n\n- **For Windows**: Please install Anaconda from [here](https://www.continuum.io/downloads), which is the leading open data science platform powered by Python.\n- **For Ubuntu or Debian (Python 3)**:\n  \n      sudo apt-get install python3-numpy python3-scipy liblapack-dev libatlas-base-dev libgsl0-dev fftw-dev libglpk-dev libdsdp-dev\n\n## Get the source\n\nClone the Git repository from GitHub\n\n    git clone https://github.com/7ossam81/EvoloPy.git\n\n\n## Quick User Guide\n\nEvoloPy toolbox contains twenty three benchmarks (F1-F24). The main file is the optimizer.py, which considered the interface of the toolbox. In the optimizer.py you can setup your experiment by selecting the optimizers, the benchmarks, number of runs, number of iterations, and population size. \nThe following is a sample example to use the EvoloPy toolbox.  \nSelect optimizers from the list of available ones: \"SSA\",\"PSO\",\"GA\",\"BAT\",\"FFA\",\"GWO\",\"WOA\",\"MVO\",\"MFO\",\"CS\",\"HHO\",\"SCA\",\"JAYA\",\"DE\". For example:\n```\noptimizer=[\"SSA\",\"PSO\",\"GA\"]  \n```\n\nAfter that, Select benchmark function from the list of available ones: \"F1\",\"F2\",\"F3\",\"F4\",\"F5\",\"F6\",\"F7\",\"F8\",\"F9\",\"F10\",\"F11\",\"F12\",\"F13\",\"F14\",\"F15\",\"F16\",\"F17\",\"F18\",\"F19\". For example:\n```\nobjectivefunc=[\"F3\",\"F4\"]  \n```\n\nSelect the number of repetitions for each experiment. To obtain meaningful statistical results, usually 30 independent runs are executed for each algorithm.  For example:\n```\nNumOfRuns=10  \n```\nSelect general parameters for all optimizers (population size, number of iterations). For example:\n```\nparams = {'PopulationSize' : 30, 'Iterations' : 50}\n```\nChoose whether to Export the results in different formats. For example:\n```\nexport_flags = {'Export_avg':True, 'Export_details':True, 'Export_convergence':True, 'Export_boxplot':True}\n```\n\nNow your experiment is ready to run. Enjoy!\n\nRun the example file:\n```\npython examples/example.py\n```\n\n\n## Contribute\n- **Issue Tracker**: https://github.com/7ossam81/EvoloPy/issues  \n- **Source Code**: https://github.com/7ossam81/EvoloPy\n\n## Useful Links\n- **Video Demo**:https://www.youtube.com/watch?v=8t10SyrhDjQ\n- **Paper source**: https://github.com/7ossam81/EvoloPy\n- **Paper**: https://www.scitepress.org/Papers/2016/60482/60482.pdf\n- **Poster source**: https://github.com/7ossam81/EvoloPy-poster\n- **Live Demo**: http://evo-ml.com/evolopy-live-demo/\n\n## List of contributors\n- 7ossam81\n- RaneemQaddoura\n- aljarrahcs\n- jbae11\n- dietmarwo\n- bionboy\n- deepak-158\n- JJ\n\n## Reference\n\nFor more information about EvoloPy, please refer to our paper: \n\nFaris, Hossam, Ibrahim Aljarah, Seyedali Mirjalili, Pedro A. Castillo, and Juan Julián Merelo Guervós. \"EvoloPy: An Open-source Nature-inspired Optimization Framework in Python.\" In IJCCI (ECTA), pp. 171-177. 2016.\nhttps://www.scitepress.org/Papers/2016/60482/60482.pdf\n\nPlease include the following related citations:\n\n- Qaddoura, Raneem, Hossam Faris, Ibrahim Aljarah, and Pedro A. Castillo. \"EvoCluster: An Open-Source Nature-Inspired Optimization Clustering Framework in Python.\" In International Conference on the Applications of Evolutionary Computation (Part of EvoStar), pp. 20-36. Springer, Cham, 2020.\n- Ruba Abu Khurma, Ibrahim Aljarah, Ahmad Sharieh, and Seyedali Mirjalili. Evolopy-fs: An open-source nature-inspired optimization framework in python for feature selection. In Evolutionary Machine Learning Techniques, pages 131–173. Springer, 2020\n\n\n\n## Support\n\nUse the [issue tracker](https://github.com/7ossam81/EvoloPy/issues) to report bugs or request features. \n\n\n","funding_links":[],"categories":["Jupyter Notebook"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F7ossam81%2FEvoloPy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F7ossam81%2FEvoloPy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F7ossam81%2FEvoloPy/lists"}