class_docstr: ``TrainContext`` gives access to report training and validation metrics to the Determined master
  during trial tasks.
class_docstr_tok: ["``","TrainContext","``","gives","access","to","report","training","and","validation","metrics","to","the","Determined","master","during","trial","tasks","."]
docstr: Get the best reported validation metric reported so far, across the whole experiment.
  
  The returned value is the highest or lowest reported validation metric value, using the
  ``searcher.metric`` field of the experiment config as the key and
  ``searcher.smaller_is_better`` for the comparison.
docstr_tok: ["Get","the","best","reported","validation","metric","reported","so","far",",","across","the","whole","experiment",".","The","returned","value","is","the","highest","or","lowest","reported","validation","metric","value",",","using","the","``","searcher.metric","``","field","of","the","experiment","config","as","the","key","and","``","searcher.smaller_is_better","``","for","the","comparison","."]
code: def get_experiment_best_validation(self) -> Optional[float]:
      """
      Get the best reported validation metric reported so far, across the whole experiment.
  
      The returned value is the highest or lowest reported validation metric value, using the
      ``searcher.metric`` field of the experiment config as the key and
      ``searcher.smaller_is_better`` for the comparison.
      """
  
      logger.debug("get_experiment_best_validation()")
      try:
          r = self._session.get(
              f"/api/v1/experiments/{self._exp_id}/searcher/best_searcher_validation_metric"
          )
      except errors.NotFoundException:
          # 404 means 'no validations yet'.
          return None
      return float(r.json()["metric"])
  
imports: import enum
  import logging
  import pathlib
  from typing import Any, Callable, Dict, List, Optional, Set
  import determined
  from determined import core, tensorboard
  from determined.common import api, util
  from determined.common.api import bindings, errors
label_desc: Use image node_id 12 for calling the TrainContext obj's underlying member method code with example usage: obj.get_experiment_best_validation() and returns: float, None