Skip to content

An implementation of the Hungarian algorithm also known as the Kuhn–Munkres algorithm or Munkres assignment algorithm in PHP.

License

Notifications You must be signed in to change notification settings

ElGigi/HungarianAlgorithm

 
 

Repository files navigation

Hungarian Algorithm

Latest Version Software License Build Status Codacy Grade Total Downloads

An implementation of the Hungarian algorithm in PHP. The Hungarian algorithm can be used to find the optimal (minimal cost) assignment between two types of entities given a cost matrix. The Hungarian algorithm is also known as the Kuhn–Munkres algorithm or Munkres assignment algorithm.

This fork is based on rpfk's implementation. Addition of original repository is visible on changelog.

Installation

You can install the library with Composer:

composer require elgigi/hungarian-algorithm

Usage

Define a square matrix with scores as input for the Hungarian class. A square matrix must be an array consisting of n arrays (rows), with each array consisting of n scores. The key of each element in the row array must be equal to the key of the column.

// Define the score matrix as n arrays consisting of n numerical values
$array = [
    [1, ··· ,1],
    ···
    [3, ··· ,0],
];

// Create a new Hungarian problem using the score matrix as input
$hungarian  = new Hungarian($array);

// Solve the problem using the Hungarian algorithm and get the solution as an array with the row and column as key and value, respectively
$allocation = $hungarian->solve();

About

An implementation of the Hungarian algorithm also known as the Kuhn–Munkres algorithm or Munkres assignment algorithm in PHP.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • PHP 100.0%