Skip to main content

Latest release PyPI version Documentation Status Core-logic / Web-API Tests Web-UI Tests codecov DOI Discord

DESDEO: the open-source software framework for interactive multiobjective optimization

Introduction

DESDEO is an open-source framework for interactive multiobjective optimization methods. The framework contains implementations of both scalarization- and population-based interactive methods. There are currently no other open-source software frameworks that focus solely on the implementation of interactive multiobjective optimization methods.

The mission of DESDEO is to increase awareness of the benefits of interactive multiobjective optimization methods, make interactive methods openly available, and to function as the central hub for implementations of various interactive methods. Apart from existing methods, DESDEO offers various tools to facilitate the development of new methods and their application as well. Another important goal of DESDEO is to answer the needs of decision makers and practitioners when it comes to modeling and solving real-life multiobjective optimization problems.

In the bigger picture, DESDEO will be composed of three major components:

  1. The core-logic, which contains the algorithmic implementation of interactive methods, various tools related to multiobjective optimization, and means to model a variety of multiobjective optimization problems. The core-logic can be considered stable enough for use in research and applications.
  2. The web-API (WIP), which implements a web-based application programming interface (API) to allow the use of the various functionalities found in DESDEO's core-logic through a web connection. The web-API implements also a database, which is a vital component for managing and enabling decision-support using the framework. The web-API is currently under heavy development, and is subject to changes.
  3. The web-GUI (WIP), which implements a web-based interface for utilizing the interactive methods and tools for modeling and solving multiobjective optimization problems.

The web-GUI relies heavily on the web-API, and is also being actively developed currently, and therefore subject to sudden changes.

For developing and experimenting with interactive multiobjective optimization methods on a "grass root" level, the core-logic provides the necessary tools. For deploying interactive methods, the web-API and the web-GUI play a central role.

Users interested in using or developing the web-API and/or web-GUI are highly encouraged to express such intentions on our Discord server!.

DESDEO is an open-source project and everybody is welcome to contribute!

Core-logic: key features

DESDEO's core-logic offers various features that can facilitate the application and development of new interactive multiobjective optimization methods. Some of the key features include, but are not limited to,

  • A powerful, pydantic-based, schema for modeling multiobjective optimization problem of various kinds. Including, analytically defined problems, data-based problems, surrogate-based problems, and simulation-based problems. Both continuous and (mixed-)integer problems are supported as well.
  • Support to interface to many popular and powerful optimization software for solving multiobjective optimization problems. Including Gurobi, various solvers from the COIN-OR project, and nevergrad, for instance.
  • A wide assortment of modular software components for implementing existing and new interactive multiobjective optimization methods. For example, many scalarization functions and evolutionary operators for multiobjective optimization are available.
  • An extensive documentation suitable for both newcomers to DESDEO and interactive multiobjective optimization in general, and seasoned veterans.

For a complete overview of the interactive methods, algorithms, and tools currently implemented, see Implemented methods and features.

Web-API: key features

DESDEO's web-API is currently under active development. Once it stabilized, its key features will be listed here. In the meantime, the interested user can follow (and contribute!) the development progress of the web-API in this issue.

Web-GUI: key features

DESDEO's web-GUI is currently under active development. Once it stabilized, its key features will be listed here. In the meantime, the interested user can follow (and contribute!) the development progress of the web-API in this issue.

Installation instructions (core-logic)

DESDEO is available on PyPI to be installed via pip:

pip install desdeo

However, some of DESDEO's features rely on 3rd party optimizers, which should be available on your system. To read more on these, and on instructions on how to install the latest version of DESDEO directly from Github, check out the documentation.

Documentation

Care has been taken to make sure DESDEO is well documented, making it accessible to both newcomers and seasoned users alike. The documentation of DESDEO is available online.

Documentation for LLMs

An llms.txt and llms-full.txt file are available to appease our AI overlords.

Contributing, reporting issues, and getting support

As DESDEO is an open source-project, anybody is welcome to contribute.

All participation in the project is governed by our Code of Conduct.

License

DESDEO is licensed under the MIT license. For more information, check the LICENSE file.

Citing DESDEO

To cite DESDEO, please include the following reference:

Misitano, G., Saini, B. S., Afsar, B., Shavazipour, B., & Miettinen, K. (2021). DESDEO: The modular and open source framework for interactive multiobjective optimization. IEEE Access, 9, 148277-148295.

@article{misitano2021desdeo,
  title={DESDEO: The modular and open source framework for interactive multiobjective optimization},
  author={Misitano, Giovanni and Saini, Bhupinder Singh and Afsar, Bekir and Shavazipour, Babooshka and Miettinen, Kaisa},
  journal={IEEE Access},
  volume={9},
  pages={148277--148295},
  year={2021},
  publisher={IEEE}
}

Note: A new article describing the latest iteration of the framework, also known as DESDEO 2.0, is currently being prepared for submission to the Journal of Open Source Software (JOSS). The content of this repository's master branch is considered to be DESDEO 2.0. Once the JOSS paper is published it will become the preferred reference. Until then, please use the IEEE Access reference above. See the Citing DESDEO page and the CITATION.cff file for up-to-date citation metadata.

Funding

Currently, DESDEO's development has been funded by projects granted by the Research Council of Finland. The most recent ones include:

  • INDENSYS (project 373063)
  • DESIDES (project 355346)
  • UTOPIA (project 352784)
  • DAEMON (project 322221)
  • DESDEO (project 287496)

Metadata

Release files for desdeo 2.9.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for desdeo 2.9.0
File Size Uploaded Provenance Actions
desdeo-2.9.0.tar.gz 638.8 kB Without provenance Details for desdeo-2.9.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for desdeo 2.9.0
File Interpreter ABI Platform Actions
desdeo-2.9.0-py3-none-any.whl Python 3 none any Details for desdeo-2.9.0-py3-none-any.whl

Total release size: 1.4 MB

Release files / desdeo-2.9.0.tar.gz

Download URL desdeo-2.9.0.tar.gz
Size 638.8 kB
Tags Source
SHA-256 checksum
How to use checksums
40c682f8e149a07e14500732778eecf3afa722801042785e5de38fbd9e5b9364
BLAKE2b-256 checksum
How to use checksums
fdc01a79c98d302161609466ac29879d5f1d91ec45f1614159201a0a44298d8e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / desdeo-2.9.0-py3-none-any.whl

Download URL desdeo-2.9.0-py3-none-any.whl
Size 758.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
9e06c27af64af8863903b6c305e590d908bfe5dd5f1da918b7a41fcb63d857b9
BLAKE2b-256 checksum
How to use checksums
0b7703b67acb4fe159d4679710a2bcb5c7c3ae0baffc57ceed4b703b3ac95583
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for desdeo 2.9.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page