Citing mcdakit

If you use mcdakit in academic work, please cite it. The repository’s CITATION.cff holds the metadata, and GitHub renders a “Cite this repository” button from it:

cff-version: 1.2.0
title: "mcdakit: multi-criteria decision analysis with stable rankings"
message: "If you use this software in research, please cite it."
type: software
authors:
  - family-names: Ait-Mlouk
    given-names: Addi
    email: aitmlouk@gmail.com
repository-code: "https://github.com/aitmlouk/mcdakit"
url: "https://aitmlouk.github.io/mcdakit"
license: Apache-2.0
version: 0.2.0
date-released: "2026-09-18"
keywords:
  - multi-criteria decision analysis
  - rank reversal
  - sensitivity analysis
  - SPOTIS
  - TOPSIS
# The paper describing this software. Once it is published, replace the
# journal, year, volume, pages and DOI with the real values and delete the
# `notes` line; until then this records the work as submitted rather than
# implying a citation that does not yet exist.
preferred-citation:
  type: article
  title: "mcdakit: a Python package for multi-criteria decision analysis with stability guarantees"
  authors:
    - family-names: Ait-Mlouk
      given-names: Addi
      email: aitmlouk@gmail.com/addi.ait-mlouk@his.se
  journal: "SoftwareX"
  year: 2026
  notes: "Submitted; not yet published. Volume, pages and DOI to be announced."

preferred-citation names the paper describing the software. It is recorded as submitted and not yet published, so the journal volume, pages and DOI are still to be announced; citation tools reading this file will reproduce that status rather than implying a publication that does not yet exist.

Citing a method, not the package

Every method names its source in its docstring, and those are the citations a methods paper needs. The package implements them; it did not invent them. SPOTIS is due to Dezert et al. (2020), TOPSIS to Hwang and Yoon (1981), VIKOR to Opricovic and Tzeng (2004), PROMETHEE to Brans and Vincke (1985), ELECTRE to Roy (1968), and AHP to Saaty (1980). The remainder are listed in the API reference with their references.

mcdakit is released under the Apache License 2.0.