From 27035d8be7d9f725bedd52f5a8c5e7ecec49e95a Mon Sep 17 00:00:00 2001
From: Dennis Eichhorn <spl1nes.com@googlemail.com>
Date: Fri, 6 Sep 2019 21:25:09 +0200
Subject: [PATCH] prepare for more algorithms

---
 Account/AccountManager.php                    |  4 +-
 Algorithm/CoinMatching/MinimumCoinProblem.php | 76 +++++++++++++++++++
 Algorithm/JobScheduling/Job.php               |  0
 Algorithm/JobScheduling/Weighted.php          |  0
 Algorithm/Knappsack/Backpack.php              | 63 +++++++++++++++
 Algorithm/Knappsack/Bounded.php               |  0
 Algorithm/Knappsack/Continuous.php            |  0
 Algorithm/Knappsack/Item.php                  | 40 ++++++++++
 Algorithm/Knappsack/Unbounded.php             |  0
 .../CoinMatching/MinimumCoinProblemTest.php   | 40 ++++++++++
 .../PathFinding/JumpPointSearchTest.php       |  2 +-
 11 files changed, 222 insertions(+), 3 deletions(-)
 create mode 100644 Algorithm/CoinMatching/MinimumCoinProblem.php
 create mode 100644 Algorithm/JobScheduling/Job.php
 create mode 100644 Algorithm/JobScheduling/Weighted.php
 create mode 100644 Algorithm/Knappsack/Backpack.php
 create mode 100644 Algorithm/Knappsack/Bounded.php
 create mode 100644 Algorithm/Knappsack/Continuous.php
 create mode 100644 Algorithm/Knappsack/Item.php
 create mode 100644 Algorithm/Knappsack/Unbounded.php
 create mode 100644 tests/Algorithm/CoinMatching/MinimumCoinProblemTest.php

diff --git a/Account/AccountManager.php b/Account/AccountManager.php
index c743978f9..41aec18ed 100644
--- a/Account/AccountManager.php
+++ b/Account/AccountManager.php
@@ -41,10 +41,10 @@ final class AccountManager implements \Countable
     /**
      * Session.
      *
-     * @var null|SessionInterface
+     * @var SessionInterface
      * @since 1.0.0
      */
-    private ?SessionInterface $session = null;
+    private SessionInterface $session;
 
     /**
      * Constructor.
diff --git a/Algorithm/CoinMatching/MinimumCoinProblem.php b/Algorithm/CoinMatching/MinimumCoinProblem.php
new file mode 100644
index 000000000..036c01cfe
--- /dev/null
+++ b/Algorithm/CoinMatching/MinimumCoinProblem.php
@@ -0,0 +1,76 @@
+<?php
+/**
+ * Orange Management
+ *
+ * PHP Version 7.4
+ *
+ * @package    phpOMS\Algorithm\CoinMatching
+ * @copyright  Dennis Eichhorn
+ * @license    OMS License 1.0
+ * @version    1.0.0
+ * @link       https://orange-management.org
+ */
+declare(strict_types=1);
+
+namespace phpOMS\Algorithm\CoinMatching;
+
+/**
+ * Matching a value with a set of coins
+ *
+ * @package    phpOMS\Algorithm\CoinMatching
+ * @license    OMS License 1.0
+ * @link       https://orange-management.org
+ * @since      1.0.0
+ */
+class MinimumCoinProblem
+{
+	private function __construct()
+	{
+
+	}
+
+	/**
+	 * Find the minimum amount of coins that are required to match a value
+	 *
+	 * @param array $coins Types of coins available (every coin has infinite availablity)
+	 * @param int   $value Value to match with the coins
+	 *
+	 * @return array
+	 *
+	 * @since  1.0.0
+	 */
+    public static function getMinimumCoinsForValueI(array $coins, int $value) : array
+    {
+        // amount of required coins for different values
+        $table      = [0];
+        $usedCoins  = [];
+
+        for ($i = 1; $i <= $value; ++$i) {
+            $table[$i] = \PHP_INT_MAX;
+        }
+
+        $m = \count($coins);
+
+        for ($i = 1; $i <= $value; ++$i) {
+            for ($j = 0; $j < $m; ++$j) {
+                if ($coins[$j] <= $i) {
+					if ($coins[$j] === null) {
+						continue;
+					}
+
+                    $subRes = $table[$i - $coins[$j]];
+
+                    if ($subRes !== \PHP_INT_MAX
+                        && $subRes + 1 < $table[$i]
+                    ) {
+                        $table[$i]      = $subRes + 1;
+						$usedCoins[$i]  = \array_merge($usedCoins[$i - $coins[$j]], [$coins[$j]]);
+						$coins[$j]      = null;
+                    }
+                }
+            }
+        }
+
+        return $usedCoins[$value];
+	}
+}
diff --git a/Algorithm/JobScheduling/Job.php b/Algorithm/JobScheduling/Job.php
new file mode 100644
index 000000000..e69de29bb
diff --git a/Algorithm/JobScheduling/Weighted.php b/Algorithm/JobScheduling/Weighted.php
new file mode 100644
index 000000000..e69de29bb
diff --git a/Algorithm/Knappsack/Backpack.php b/Algorithm/Knappsack/Backpack.php
new file mode 100644
index 000000000..5b77606a7
--- /dev/null
+++ b/Algorithm/Knappsack/Backpack.php
@@ -0,0 +1,63 @@
+<?php
+
+/**
+ * Orange Management
+ *
+ * PHP Version 7.4
+ *
+ * @package    phpOMS\Algorithm\Knappsack
+ * @copyright  Dennis Eichhorn
+ * @license    OMS License 1.0
+ * @version    1.0.0
+ * @link       https://orange-management.org
+ */
+
+declare(strict_types=1);
+
+namespace phpOMS\Algorithm\Backpack;
+
+/**
+ * Matching a value with a set of coins
+ *
+ * @package    phpOMS\Algorithm\Knappsack
+ * @license    OMS License 1.0
+ * @link       https://orange-management.org
+ * @since      1.0.0
+ */
+class Backpack
+{
+    private $maxCost = 0.0;
+
+    private $value = 0.0;
+
+    private $cost = 0.0;
+
+    private array $items = [];
+
+    public function __construct($maxCost)
+    {
+        $this->maxCost = $maxCost;
+    }
+
+    public function getValue()
+    {
+        return $this->value;
+    }
+
+    public function getCost()
+    {
+        return $this->cost;
+    }
+
+    public function getItems() : array
+    {
+        return $this->items;
+    }
+
+    public function addItem(Item $item) : void
+    {
+        $this->items[] = $item;
+        $this->value += $item->getValue();
+        $this->cost += $item->getCost();
+    }
+}
diff --git a/Algorithm/Knappsack/Bounded.php b/Algorithm/Knappsack/Bounded.php
new file mode 100644
index 000000000..e69de29bb
diff --git a/Algorithm/Knappsack/Continuous.php b/Algorithm/Knappsack/Continuous.php
new file mode 100644
index 000000000..e69de29bb
diff --git a/Algorithm/Knappsack/Item.php b/Algorithm/Knappsack/Item.php
new file mode 100644
index 000000000..79e93472a
--- /dev/null
+++ b/Algorithm/Knappsack/Item.php
@@ -0,0 +1,40 @@
+<?php
+/**
+ * Orange Management
+ *
+ * PHP Version 7.4
+ *
+ * @package    phpOMS\Algorithm\Knappsack
+ * @copyright  Dennis Eichhorn
+ * @license    OMS License 1.0
+ * @version    1.0.0
+ * @link       https://orange-management.org
+ */
+declare(strict_types=1);
+
+namespace phpOMS\Algorithm\Knappsack;
+
+/**
+ * Matching a value with a set of coins
+ *
+ * @package    phpOMS\Algorithm\Knappsack
+ * @license    OMS License 1.0
+ * @link       https://orange-management.org
+ * @since      1.0.0
+ */
+class Item
+{
+    private $value = 0.0;
+
+    private $cost = 0.0;
+
+    public function getValue()
+    {
+        return $this->value;
+    }
+
+    public function getCost()
+    {
+        return $this->cost;
+    }
+}
diff --git a/Algorithm/Knappsack/Unbounded.php b/Algorithm/Knappsack/Unbounded.php
new file mode 100644
index 000000000..e69de29bb
diff --git a/tests/Algorithm/CoinMatching/MinimumCoinProblemTest.php b/tests/Algorithm/CoinMatching/MinimumCoinProblemTest.php
new file mode 100644
index 000000000..0f4eb13d4
--- /dev/null
+++ b/tests/Algorithm/CoinMatching/MinimumCoinProblemTest.php
@@ -0,0 +1,40 @@
+<?php
+/**
+ * Orange Management
+ *
+ * PHP Version 7.4
+ *
+ * @package    tests
+ * @copyright  Dennis Eichhorn
+ * @license    OMS License 1.0
+ * @version    1.0.0
+ * @link       https://orange-management.org
+ */
+ declare(strict_types=1);
+
+namespace phpOMS\Algorithm\CoinMatching;
+
+use phpOMS\Algorithm\CoinMatching\MinimumCoinProblem;
+
+require_once __DIR__ . '/../../Autoloader.php';
+
+/**
+ * @testdox phpOMS\Algorithm\CoinMatching\MinimumCoinProblem: Test coin matching a value problem
+ *
+ * @internal
+ */
+class MinimumCoinProblemTest extends \PHPUnit\Framework\TestCase
+{
+    public function testMinimumCoins() : void
+    {
+        self::assertEquals(
+            [9, 6, 5, 1],
+            MinimumCoinProblem::getMinimumCoinsForValueI([6, 6, 5], 17)
+        );
+
+        self::assertEquals(
+            [9, 6, 5, 6, 1],
+            MinimumCoinProblem::getMinimumCoinsForValueI([6, 6, 5], 17)
+        );
+    }
+}
diff --git a/tests/Algorithm/PathFinding/JumpPointSearchTest.php b/tests/Algorithm/PathFinding/JumpPointSearchTest.php
index 0808e9b94..93d9b44dc 100644
--- a/tests/Algorithm/PathFinding/JumpPointSearchTest.php
+++ b/tests/Algorithm/PathFinding/JumpPointSearchTest.php
@@ -12,7 +12,7 @@
  */
  declare(strict_types=1);
 
-namespace phpOMS\tests\Algorithm\Sort;
+namespace phpOMS\tests\Algorithm\PathFinding;
 
 use phpOMS\Algorithm\PathFinding\Grid;
 use phpOMS\Algorithm\PathFinding\MovementType;