Skip to content

mork-optimization/mork

Repository files navigation

MORK: Metaheuristic Optimization framewoRK

Maven Central Bugs Vulnerabilities Coverage Duplicated Lines (%)

What

Mork is a framework for developing approaches for NP-Hard problems using the JVM. It is currently under heavy development.

Why use it

The idea of the project is to provide both high quality and tested componentes that can be used as is, and a developing framework to create new metaheuristic approaches for different kind of problems. A non extensive list of its current main benefits are:

  • Automatic experiment parallelization
  • Automatic results report generation
  • Guaranteed reproducibility, even in high concurrency environments, by using the provided RandomManager.
  • Can execute anywhere (at least, anywhere where Java and Docker can!). Easily build Docker containers that can execute almost anywhere.
  • Automatic benchmarking and optional timings adjustment.
  • Nice web interface to visualize solution quality and experiment progress.
  • And more!

Getting started

TLDR: Automatically generate a project using https://generator.mork-optimization.com/, import in your favourite IDE and start working!

See Getting started page in the Official Documentation for more details.

Citing

If this project is useful for any research, please consider citing the original paper https://doi.org/10.1162/evco_a_00317

Bibtext

@article{10.1162/evco_a_00317,
    author = {Martín-Santamaría, Raúl and Cavero, Sergio and Herrán, Alberto and Duarte, Abraham and Colmenar, J. Manuel},
    title = "{A practical methodology for reproducible experimentation: an application to the Double-row Facility Layout Problem}",
    journal = {Evolutionary Computation},
    pages = {1-35},
    year = {2022},
    month = {11},
    abstract = "{Reproducibility of experiments is a complex task in stochastic methods such as evolutionary algorithms or metaheuristics in general. Many works from the literature give general guidelines to favor reproducibility. However, none of them provide both a practical set of steps and also software tools to help on this process. In this paper, we propose a practical methodology to favor reproducibility in optimization problems tackled with stochastic methods. This methodology is divided into three main steps, where the researcher is assisted by software tools which implement state-of-theart techniques related to this process. The methodology has been applied to study the Double Row Facility Layout Problem, where we propose a new algorithm able to obtain better results than the state-of-the-art methods. To this aim, we have also replicated the previous methods in order to complete the study with a new set of larger instances. All the produced artifacts related to the methodology and the study of the target problem are available in Zenodo.}",
    issn = {1063-6560},
    doi = {10.1162/evco_a_00317},
    url = {https://doi.org/10.1162/evco\_a\_00317},
    eprint = {https://direct.mit.edu/evco/article-pdf/doi/10.1162/evco\_a\_00317/2057545/evco\_a\_00317.pdf},
}

Citing artifacts

Artifacts, docs, and source code are automatically archived in Zenodo with each release. See: DOI for more information.

Contributing

Issues, suggestions or any contribution in general are welcome! Before doing any mayor refactor / contribution, get in touch!

The current development version is a Maven project structured in the following modules:

Module Description
common Basic and fundamental Mork classes / building blocks: algorithms, solutions, instances, helper methods, etc.
core Mork engine: this is where the magic happens. Parallelization, report generation, web interface, dependency injection, and much more!
autoconfig Automatic configuration procedures that allow you to easily tune algorithms.
template Base project used by the web generator to create the project zip files.
example-tsp Example project implementation using Mork, the classic Travelling Salesman Problem.
integration-tests Integration tests used by Mork developers to validate the whole framework interactions and behaviour.

Remember depending on your needs when developing approaches using Mork you may easily add/remove module dependencies in the pom.xml file.

Powered by Mork

Below is a list of research articles leveraging Mork to tackle optimization problems: