Skip to content

Reference for ultralytics/utils/callbacks/tensorboard.py

Note

Full source code for this file is available at https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/callbacks/tensorboard.py. Help us fix any issues you see by submitting a Pull Request 🛠️. Thank you 🙏!


ultralytics.utils.callbacks.tensorboard._log_scalars(scalars, step=0)

Logs scalar values to TensorBoard.

Source code in ultralytics/utils/callbacks/tensorboard.py
def _log_scalars(scalars, step=0):
    """Logs scalar values to TensorBoard."""
    if WRITER:
        for k, v in scalars.items():
            WRITER.add_scalar(k, v, step)




ultralytics.utils.callbacks.tensorboard._log_tensorboard_graph(trainer)

Log model graph to TensorBoard.

Source code in ultralytics/utils/callbacks/tensorboard.py
def _log_tensorboard_graph(trainer):
    """Log model graph to TensorBoard."""
    try:
        import warnings

        from ultralytics.utils.torch_utils import de_parallel, torch

        imgsz = trainer.args.imgsz
        imgsz = (imgsz, imgsz) if isinstance(imgsz, int) else imgsz
        p = next(trainer.model.parameters())  # for device, type
        im = torch.zeros((1, 3, *imgsz), device=p.device, dtype=p.dtype)  # input image (must be zeros, not empty)
        with warnings.catch_warnings():
            warnings.simplefilter('ignore', category=UserWarning)  # suppress jit trace warning
            WRITER.add_graph(torch.jit.trace(de_parallel(trainer.model), im, strict=False), [])
    except Exception as e:
        LOGGER.warning(f'WARNING ⚠️ TensorBoard graph visualization failure {e}')




ultralytics.utils.callbacks.tensorboard.on_pretrain_routine_start(trainer)

Initialize TensorBoard logging with SummaryWriter.

Source code in ultralytics/utils/callbacks/tensorboard.py
def on_pretrain_routine_start(trainer):
    """Initialize TensorBoard logging with SummaryWriter."""
    if SummaryWriter:
        try:
            global WRITER
            WRITER = SummaryWriter(str(trainer.save_dir))
            prefix = colorstr('TensorBoard: ')
            LOGGER.info(f"{prefix}Start with 'tensorboard --logdir {trainer.save_dir}', view at http://localhost:6006/")
        except Exception as e:
            LOGGER.warning(f'WARNING ⚠️ TensorBoard not initialized correctly, not logging this run. {e}')




ultralytics.utils.callbacks.tensorboard.on_train_start(trainer)

Log TensorBoard graph.

Source code in ultralytics/utils/callbacks/tensorboard.py
def on_train_start(trainer):
    """Log TensorBoard graph."""
    if WRITER:
        _log_tensorboard_graph(trainer)




ultralytics.utils.callbacks.tensorboard.on_batch_end(trainer)

Logs scalar statistics at the end of a training batch.

Source code in ultralytics/utils/callbacks/tensorboard.py
def on_batch_end(trainer):
    """Logs scalar statistics at the end of a training batch."""
    _log_scalars(trainer.label_loss_items(trainer.tloss, prefix='train'), trainer.epoch + 1)




ultralytics.utils.callbacks.tensorboard.on_fit_epoch_end(trainer)

Logs epoch metrics at end of training epoch.

Source code in ultralytics/utils/callbacks/tensorboard.py
def on_fit_epoch_end(trainer):
    """Logs epoch metrics at end of training epoch."""
    _log_scalars(trainer.metrics, trainer.epoch + 1)




Created 2023-07-16, Updated 2023-08-24
Authors: glenn-jocher (7), Laughing-q (1)