Optimisation modules built for optimization problem during thesis

Jérôme BUISINE 6ce14b10e2 Merge branch 'release/v1.0.7' 2 weeks ago
.github f0203a9d3f check build content 2 weeks ago
docs 2b1151e24b update of references into paper and figure 2 weeks ago
examples 52e603abe9 documentation updates for evaluator / opetators 2 weeks ago
macop 26ccf57175 paper file updated 2 weeks ago
.gitignore 52e603abe9 documentation updates for evaluator / opetators 2 weeks ago
CONTRIBUTING.md 26ccf57175 paper file updated 2 weeks ago
LICENSE 1bb5cb9f48 start of new documentation explanation 3 weeks ago
README.md 26ccf57175 paper file updated 2 weeks ago
__init__.py 0a1b108095 First version of OR framework 1 year ago
build.sh 899ec8e7d3 rename all paramaters as protected 1 month ago
paper.bib 26ccf57175 paper file updated 2 weeks ago
paper.md 67d95286fb update caption of image 2 weeks ago
requirements.txt 4fbbbf39d3 documentation updates for algorithms 5 months ago
setup.py 2b1151e24b update of references into paper and figure 2 weeks ago

README.md

Minimalist And Customisable Optimisation Package

Description

Macop is a python package for solving discrete optimisation problems in nature. Continuous optimisation can also applicable if needed. The objective is to allow a user to exploit the basic structure proposed by this package to solve a problem specific to him. The interest is that he can quickly abstract himself from the complications related to the way of evaluating, comparing, saving the progress of the search for good solutions but rather concentrate if necessary on his own algorithm. Indeed, Macop offers the following main and basic features:

  • solutions: representation of the solution ;
  • validator: such as constraint programmig, a validator is function which is used for validate or not a solution data state ;
  • evaluator: stores problem instance data and implement a compute method in order to evaluate a solution ;
  • operators: mutators, crossovers update of solution ;
  • policies: the way you choose the available operators (might be using reinforcement learning) ;
  • algorithms: generic and implemented optimisation research algorithms ;
  • callbacks: callbacks to automatically keep track of the search space advancement.

Based on all of these generic and/or implemented functionalities, the user will be able to quickly develop a solution to his problem while retaining the possibility of remaining in control of his development by overloading existing functionalities if necessary.

Main idea about this Python package is that it does not which doesn't implement every algorithm in the literature but let the possibility to the user to quickly develop and test its own algorithms and strategies. The main objective of this package is to provide maximum flexibility, which allows for easy experimentation in implementation..

Documentation

Fully documentation of package with examples is available.

You can also see examples of use:

Add as dependency

git submodule add https://github.com/jbuisine/macop.git

License

The MIT License