examples/model_selection/Trails/internal/ml/model_selection/src/controller/core/sample.py

#
# Licensed to the Apache Software Foundation (ASF) under one
# or more contributor license agreements.  See the NOTICE file
# distributed with this work for additional information
# regarding copyright ownership.  The ASF licenses this file
# to you under the Apache License, Version 2.0 (the
# "License"); you may not use this file except in compliance
# with the License.  You may obtain a copy of the License at
#
#     http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#


from abc import abstractmethod

from src.search_space.core.model_params import ModelMicroCfg
from src.search_space.core.space import SpaceWrapper


class Sampler:

    def __init__(self, space: SpaceWrapper):
        self.space = space

    @abstractmethod
    def sample_next_arch(self, sorted_model: list) -> (str, ModelMicroCfg):
        """
        Sample next architecture,
        :param sorted_model: the scoted model,
        :return:
        """
        raise NotImplementedError

    @abstractmethod
    def fit_sampler(self, score: float):
        """
        Fit the sampler with architecture's score.
        :param score:
        :return:
        """
        raise NotImplementedError