class_docstr: The ``Logger`` class is the ClearML console log and metric statistics interface, and contains methods for explicit
  reporting.
  
  Explicit reporting extends ClearML automagical capturing of inputs and output. Explicit reporting
  methods include scalar plots, line plots, histograms, confusion matrices, 2D and 3D scatter
  diagrams, text logging, tables, and image uploading and reporting.
  
  In the **ClearML Web-App (UI)**, ``Logger`` output appears in the **RESULTS** tab, **CONSOLE**, **SCALARS**,
  **PLOTS**, and **DEBUG SAMPLES** sub-tabs. When you compare experiments, ``Logger`` output appears in the
  comparisons.
  
  .. warning::
  
     Do not construct Logger objects directly.
  
  You must get a Logger object before calling any of the other ``Logger`` class methods by calling
  :meth:`.Task.get_logger` or :meth:`Logger.current_logger`.
class_docstr_tok: ["The","``","Logger","``","class","is","the","ClearML","console","log","and","metric","statistics","interface",",","and","contains","methods","for","explicit","reporting",".","Explicit","reporting","extends","ClearML","automagical","capturing","of","inputs","and","output",".","Explicit","reporting","methods","include","scalar","plots",",","line","plots",",","histograms",",","confusion","matrices",",","2D","and","3D","scatter","diagrams",",","text","logging",",","tables",",","and","image","uploading","and","reporting",".","In","the","*","*","ClearML","Web-App","(","UI",")","*","*",",","``","Logger","``","output","appears","in","the","*","*","RESULTS","*","*","tab",",","*","*","CONSOLE","*","*",",","*","*","SCALARS","*","*",",","*","*","PLOTS","*","*",",","and","*","*","DEBUG","SAMPLES","*","*","sub-tabs",".","When","you","compare","experiments",",","``","Logger","``","output","appears","in","the","comparisons",".","..","warning",":",":","Do","not","construct","Logger","objects","directly",".","You","must","get","a","Logger","object","before","calling","any","of","the","other","``","Logger","``","class","methods","by","calling",":","meth",":","`",".Task.get_logger","`","or",":","meth",":","`","Logger.current_logger","`","."]
docstr: For explicit reporting, plot a scalar series.
  
  For example, plot a scalar series:
  
  .. code-block:: py
  
     logger = Logger.current_logger()
     scalar_series = [random.randint(0,10) for i in range(10)]
     for iteration in range(10):
         logger.report_scalar(
             title='scalar metrics', series='series', value=scalar_series[iteration], iteration=iteration
         )
  
  You can view the scalar plots in the **ClearML Web-App (UI)**, **RESULTS** tab, **SCALARS** sub-tab.
  
  :param str title: The title (metric) of the plot. Plot more than one scalar series on the same plot by using
      the same ``title`` for each call to this method.
  :param str series: The series name (variant) of the reported scalar.
  :param float value: The value to plot per iteration.
  :param int iteration: The reported iteration / step (x-axis of the reported time series)
docstr_tok: ["For","explicit","reporting",",","plot","a","scalar","series",".","For","example",",","plot","a","scalar","series",":","..","code-block",":",":","py","logger","=","Logger.current_logger","(",")","scalar_series","=","[","random.randint","(","0,10",")","for","i","in","range","(","10",")","]","for","iteration","in","range","(","10",")",":","logger.report_scalar","(","title='scalar","metrics","'",",","series='series","'",",","value=scalar_series","[","iteration","]",",","iteration=iteration",")","You","can","view","the","scalar","plots","in","the","*","*","ClearML","Web-App","(","UI",")","*","*",",","*","*","RESULTS","*","*","tab",",","*","*","SCALARS","*","*","sub-tab",".",":","param","str","title",":","The","title","(","metric",")","of","the","plot",".","Plot","more","than","one","scalar","series","on","the","same","plot","by","using","the","same","``","title","``","for","each","call","to","this","method",".",":","param","str","series",":","The","series","name","(","variant",")","of","the","reported","scalar",".",":","param","float","value",":","The","value","to","plot","per","iteration",".",":","param","int","iteration",":","The","reported","iteration","\/","step","(","x-axis","of","the","reported","time","series",")"]
code: def report_scalar(self, title, series, value, iteration):
      # type: (str, str, float, int) -> None
      """
      For explicit reporting, plot a scalar series.
  
      For example, plot a scalar series:
  
      .. code-block:: py
  
         logger = Logger.current_logger()
         scalar_series = [random.randint(0,10) for i in range(10)]
         for iteration in range(10):
             logger.report_scalar(
                 title='scalar metrics', series='series', value=scalar_series[iteration], iteration=iteration
             )
  
      You can view the scalar plots in the **ClearML Web-App (UI)**, **RESULTS** tab, **SCALARS** sub-tab.
  
      :param str title: The title (metric) of the plot. Plot more than one scalar series on the same plot by using
          the same ``title`` for each call to this method.
      :param str series: The series name (variant) of the reported scalar.
      :param float value: The value to plot per iteration.
      :param int iteration: The reported iteration / step (x-axis of the reported time series)
      """
  
      # if task was not started, we have to start it
      self._start_task_if_needed()
      self._touch_title_series(title, series)
      # noinspection PyProtectedMember
      return self._task._reporter.report_scalar(
          title=title, series=series, value=float(value), iter=iteration
      )
  
imports: import logging
  import math
  import warnings
  from typing import Any, Sequence, Union, List, Optional, Tuple, Dict, TYPE_CHECKING
  import numpy
  import six
  from PIL import Image
  from pathlib2 import Path
  from .debugging.log import LoggerRoot
  from .backend_interface.logger import StdStreamPatch
  from .backend_interface.task import Task
  from .backend_interface.task.log import TaskHandler
  from .backend_interface.util import mutually_exclusive
  from .backend_interface.metrics.events import UploadEvent, MetricsEventAdapter
  from .config import running_remotely, get_cache_dir, config, DEBUG_SIMULATE_REMOTE_TASK, deferred_config
  from .errors import UsageError
  from .storage.helper import StorageHelper
  from .utilities.plotly_reporter import SeriesInfo
label_desc: Use image node_id 4 for calling the Logger obj's underlying member method code with example usage: obj.report_scalar(title, series, value, iteration) and returns: self