跳至内容

参考资料 ultralytics/utils/callbacks/tensorboard.py

备注

该文件可在https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/callbacks/tensorboard .py 下找到。如果您发现问题,请通过提交 Pull Request🛠️ 帮助修复。谢谢🙏!



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

将标量值记录到 TensorBoard。

源代码 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)

将模型图记录到 TensorBoard。

源代码 ultralytics/utils/callbacks/tensorboard.py
def _log_tensorboard_graph(trainer):
    """Log model graph to TensorBoard."""

    # Input image
    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
        warnings.simplefilter("ignore", category=torch.jit.TracerWarning)  # suppress jit trace warning

        # Try simple method first (YOLO)
        with contextlib.suppress(Exception):
            WRITER.add_graph(torch.jit.trace(de_parallel(trainer.model), im, strict=False), [])
            LOGGER.info(f"{PREFIX}model graph visualization added ✅")
            return

        # Fallback to TorchScript export steps (RTDETR)
        try:
            model = deepcopy(de_parallel(trainer.model))
            model.eval()
            model = model.fuse(verbose=False)
            for m in model.modules():
                if hasattr(m, "export"):  # Detect, RTDETRDecoder (Segment and Pose use Detect base class)
                    m.export = True
                    m.format = "torchscript"
            model(im)  # dry run
            WRITER.add_graph(torch.jit.trace(model, im, strict=False), [])
            LOGGER.info(f"{PREFIX}model graph visualization added ✅")
        except Exception as e:
            LOGGER.warning(f"{PREFIX}WARNING ⚠️ TensorBoard graph visualization failure {e}")



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

使用 SummaryWriter 初始化 TensorBoard 日志。

源代码 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))
            LOGGER.info(f"{PREFIX}Start with 'tensorboard --logdir {trainer.save_dir}', view at http://localhost:6006/")
        except Exception as e:
            LOGGER.warning(f"{PREFIX}WARNING ⚠️ TensorBoard not initialized correctly, not logging this run. {e}")



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

对数 TensorBoard 图形。

源代码 ultralytics/utils/callbacks/tensorboard.py
def on_train_start(trainer):
    """Log TensorBoard graph."""
    if WRITER:
        _log_tensorboard_graph(trainer)



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

记录训练历元结束时的标量统计数据。

源代码 ultralytics/utils/callbacks/tensorboard.py
def on_train_epoch_end(trainer):
    """Logs scalar statistics at the end of a training epoch."""
    _log_scalars(trainer.label_loss_items(trainer.tloss, prefix="train"), trainer.epoch + 1)
    _log_scalars(trainer.lr, trainer.epoch + 1)



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

在训练历元结束时记录历元指标。

源代码 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)





创建于 2023-11-12,更新于 2023-12-01
作者:glenn-jocher(4),Laughing-q(1)