class_docstr: Interleaves a random configuration according to a given probability which is decreased
  according to a cosine annealing schedule.
  
  Parameters
  ----------
  max_probability : float
      Initial (maximum) probability of a random configuration.
  min_probability : float
      Final (minimal) probability of a random configuration used in iteration `restart_iteration`.
  restart_iteration : int
      Restart the annealing schedule every `restart_iteration` iterations.
  seed : int
      Integer used to initialize random state.
class_docstr_tok: ["Interleaves","a","random","configuration","according","to","a","given","probability","which","is","decreased","according","to","a","cosine","annealing","schedule",".","Parameters","--","--","--","--","--","max_probability",":","float","Initial","(","maximum",")","probability","of","a","random","configuration",".","min_probability",":","float","Final","(","minimal",")","probability","of","a","random","configuration","used","in","iteration","`","restart_iteration","`",".","restart_iteration",":","int","Restart","the","annealing","schedule","every","`","restart_iteration","`","iterations",".","seed",":","int","Integer","used","to","initialize","random","state","."]
docstr: Moves to the next iteration and set ``self._probability``.
docstr_tok: ["Moves","to","the","next","iteration","and","set","``","self._probability","``","."]
code: def next_iteration(self) -> None:  # noqa: D102
      """Moves to the next iteration and set ``self._probability``."""
      self._iteration += 1
      if self._iteration > self._restart_iteration:
          self._iteration = 0
          logger.debug("Perform a restart.")
  
      self._probability = self._min_probability + (
          0.5
          * (self._max_probability - self._min_probability)
          * (
              1
              + np.cos(
                  self._iteration * np.pi / self._restart_iteration
              )
          )
      )
      logger.debug(
          f"Probability for random configs: {self._probability}"
      )
  
file_path: SMAC3/smac/random_design/annealing_design.py
imports: from __future__ import annotations
  from typing import Any
  import numpy
  from smac.random_design.abstract_random_design import AbstractRandomDesign
  from smac.utils.logging import get_logger
label_desc: Use image node_id 3 for calling the CosineAnnealingRandomDesign obj's underlying member method code with example usage: obj.next_iteration() without return types