CyclicConfigSuggestor

mlos_bench/mlos_bench/config/optimizers/manual_opt.jsonc

@@ -0,0 +1,16 @@
+// Manual optimizer to run fixed set of tunable values on repeat via the benchmarking framework.
+{
+    "$schema": "https://raw.githubusercontent.com/microsoft/MLOS/main/mlos_bench/mlos_bench/config/schemas/optimizers/optimizer-schema.json",
+
+    "class": "mlos_bench.optimizers.ManualOptimizer",
+
+    "config": {
+        "max_cycles": 30,
+        "tunable_values_cycle": [
+            // Add one or more set of tunable values here as a dictionary:
+            // {"tunable_param_1": "tunable_value_1", ... },
+            // The empty dictionary {} can be used to represent the default tunable values.
+            {}
+        ]
+    }
+}

mlos_bench/mlos_bench/config/schemas/optimizers/optimizer-schema.json

@@ -55,6 +55,8 @@
             "description": "The name of the optimizer class to use.",
             "$comment": "required",
             "enum": [
+                "mlos_bench.optimizers.ManualOptimizer",
+                "mlos_bench.optimizers.manual_optimizer.ManualOptimizer",
                 "mlos_bench.optimizers.MlosCoreOptimizer",
                 "mlos_bench.optimizers.mlos_core_optimizer.MlosCoreOptimizer",
                 "mlos_bench.optimizers.GridSearchOptimizer",
@@ -201,6 +203,52 @@
                 }
             },
             "else": false
+        },
+
+        {
+            "$comment": "extensions to the 'config' object properties when the manual optimizer is being used",
+            "if": {
+                "properties": {
+                    "class": {
+                        "enum": [
+                            "mlos_bench.optimizers.ManualOptimizer",
+                            "mlos_bench.optimizers.manual_optimizer.ManualOptimizer"
+                        ]
+                    }
+                },
+                "required": ["class"]
+            },
+            "then": {
+                "properties": {
+                    "config": {
+                        "type": "object",
+                        "allOf": [
+                            { "$ref": "#/$defs/config_base_optimizer" },
+                            {
+                                "type": "object",
+                                "properties": {
+                                    "max_cycles": {
+                                        "description": "The maximum number of cycles of tunable values to run the optimizer for.",
+                                        "type": "integer",
+                                        "minimum": 1
+                                    },
+                                    "tunable_values_cycle": {
+                                        "description": "The tunable values to cycle through.",
+                                        "type": "array",
+                                        "items": {
+                                            "$ref": "../tunables/tunable-values-schema.json#/$defs/tunable_values_set"
+                                        },
+                                        "minItems": 1
+                                    }
+                                }
+                            }
+                        ],
+                        "$comment": "disallow other properties",
+                        "unevaluatedProperties": false
+                    }
+                }
+            },
+            "else": false
         }
     ],
     "unevaluatedProperties": false

mlos_bench/mlos_bench/optimizers/__init__.py

@@ -5,12 +5,14 @@
 """Interfaces and wrapper classes for optimizers to be used in Autotune."""
 
 from mlos_bench.optimizers.base_optimizer import Optimizer
+from mlos_bench.optimizers.manual_optimizer import ManualOptimizer
 from mlos_bench.optimizers.mlos_core_optimizer import MlosCoreOptimizer
 from mlos_bench.optimizers.mock_optimizer import MockOptimizer
 from mlos_bench.optimizers.one_shot_optimizer import OneShotOptimizer
 
 __all__ = [
     "Optimizer",
+    "ManualOptimizer",
     "MockOptimizer",
     "OneShotOptimizer",
     "MlosCoreOptimizer",

mlos_bench/mlos_bench/optimizers/manual_optimizer.py

@@ -0,0 +1,49 @@
+#
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
+#
+"""Optimizer for mlos_bench that proposes an explicit sequence of configurations."""
+
+import logging
+from typing import Dict, List, Optional
+
+from mlos_bench.optimizers.mock_optimizer import MockOptimizer
+from mlos_bench.services.base_service import Service
+from mlos_bench.tunables.tunable import TunableValue
+from mlos_bench.tunables.tunable_groups import TunableGroups
+
+_LOG = logging.getLogger(__name__)
+
+
+class ManualOptimizer(MockOptimizer):
+    """Optimizer that proposes an explicit sequence of tunable values."""
+
+    def __init__(
+        self,
+        tunables: TunableGroups,
+        config: dict,
+        global_config: Optional[dict] = None,
+        service: Optional[Service] = None,
+    ):
+        super().__init__(tunables, config, global_config, service)
+        self._tunable_values_cycle: List[Dict[str, TunableValue]] = config.get(
+            "tunable_values_cycle", []
+        )
+        assert len(self._tunable_values_cycle) > 0, "No tunable values provided."
+        max_cycles = int(config.get("max_cycles", 1))
+        self._max_suggestions = min(
+            self._max_suggestions,
+            max_cycles * len(self._tunable_values_cycle),
+        )
+
+    def suggest(self) -> TunableGroups:
+        """Always produce the same sequence of explicit suggestions, in a cycle."""
+        tunables = super().suggest()
+        cycle_index = (self._iter - 1) % len(self._tunable_values_cycle)
+        tunables.assign(self._tunable_values_cycle[cycle_index])
+        _LOG.info("Iteration %d :: Suggest: %s", self._iter, tunables)
+        return tunables
+
+    @property
+    def supports_preload(self) -> bool:
+        return False

mlos_bench/mlos_bench/optimizers/one_shot_optimizer.py

@@ -21,8 +21,6 @@ class OneShotOptimizer(MockOptimizer):
     Explicit configs (partial or full) are possible using configuration files.
     """
 
-    # TODO: Add support for multiple explicit configs (i.e., FewShot or Manual Optimizer) - #344
-
     def __init__(
         self,
         tunables: TunableGroups,

mlos_bench/mlos_bench/tests/config/schemas/optimizers/test-cases/bad/invalid/manual_opt_schema_bad_max_cycles.jsonc

@@ -0,0 +1,10 @@
+{
+
+    "class": "mlos_bench.optimizers.ManualOptimizer",
+
+    "config": {
+        // max_cycles should be at least 1
+        "max_cycles": 0,
+        "tunable_values_cycle": []
+    }
+}

mlos_bench/mlos_bench/tests/config/schemas/optimizers/test-cases/bad/invalid/manual_opt_schema_empty_config.jsonc

@@ -0,0 +1,4 @@
+{
+    "class": "mlos_bench.optimizers.ManualOptimizer",
+    "config": {}
+}

mlos_bench/mlos_bench/tests/config/schemas/optimizers/test-cases/bad/unhandled/manual_opt_extra.jsonc

@@ -0,0 +1,8 @@
+{
+    "class": "mlos_bench.optimizers.ManualOptimizer",
+
+    "config": {
+        "tunable_values_cycle": [],
+        "extra_param": "should not be here"
+    }
+}

mlos_bench/mlos_bench/tests/config/schemas/optimizers/test-cases/good/full/manual_opt_full.jsonc

@@ -0,0 +1,24 @@
+{
+    "class": "mlos_bench.optimizers.ManualOptimizer",
+
+    "config": {
+        // Here we do our best to list the exhaustive set of full configs available for the base optimizer config.
+        "optimization_targets": {"score": "min"},
+        "max_suggestions": 20,
+        "seed": 12345,
+        "start_with_defaults": false,
+        "max_cycles": 10,
+        "tunable_values_cycle": [
+            {
+                "param1": "value1",
+                "param2": 1,
+                "param3": false
+            },
+            {
+                "param1": "value2",
+                "param2": 2,
+                "param3": true
+            },
+        ]
+    }
+}

mlos_bench/mlos_bench/tests/config/schemas/optimizers/test-cases/good/partial/manual_opt_no_schema.jsonc

@@ -0,0 +1,3 @@
+{
+    "class": "mlos_bench.optimizers.ManualOptimizer"
+}

mlos_bench/mlos_bench/tests/config/schemas/optimizers/test-cases/good/partial/manual_opt_schema_partial_config.jsonc

@@ -0,0 +1,7 @@
+{
+
+    "class": "mlos_bench.optimizers.ManualOptimizer",
+    "config": {
+        "tunable_values_cycle": [{}]
+    }
+}

mlos_bench/mlos_bench/tests/optimizers/conftest.py

@@ -8,11 +8,14 @@
 
 import pytest
 
+from mlos_bench.optimizers.manual_optimizer import ManualOptimizer
 from mlos_bench.optimizers.mlos_core_optimizer import MlosCoreOptimizer
 from mlos_bench.optimizers.mock_optimizer import MockOptimizer
 from mlos_bench.tests import SEED
 from mlos_bench.tunables.tunable_groups import TunableGroups
 
+# pylint: disable=redefined-outer-name
+
 
 @pytest.fixture
 def mock_configs() -> List[dict]:
@@ -154,3 +157,16 @@ def smac_opt_max(tunable_groups: TunableGroups) -> MlosCoreOptimizer:
             "max_ratio": 1.0,
         },
     )
+
+
+@pytest.fixture
+def manual_opt(tunable_groups: TunableGroups, mock_configs: List[dict]) -> ManualOptimizer:
+    """Test fixture for ManualOptimizer."""
+    return ManualOptimizer(
+        tunables=tunable_groups,
+        service=None,
+        config={
+            "max_cycles": 2,
+            "tunable_values_cycle": mock_configs,
+        },
+    )

mlos_bench/mlos_bench/tests/optimizers/manual_opt_test.py

@@ -0,0 +1,21 @@
+#
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
+#
+"""Unit tests for mock mlos_bench optimizer."""
+
+from mlos_bench.environments.status import Status
+from mlos_bench.optimizers.manual_optimizer import ManualOptimizer
+
+# pylint: disable=redefined-outer-name
+
+
+def test_manual_optimizer(manual_opt: ManualOptimizer, mock_configs: list) -> None:
+    """Make sure that manual optimizer produces consistent suggestions."""
+
+    i = 0
+    while manual_opt.not_converged():
+        tunables = manual_opt.suggest()
+        assert tunables.get_param_values() == mock_configs[i % len(mock_configs)]
+        manual_opt.register(tunables, Status.SUCCEEDED, {"score": 123.0})
+        i += 1