Files
nerfstudio/mattport/utils/writer.py
T

147 lines
4.4 KiB
Python

"""
Generic Writer class
"""
import os
from abc import abstractmethod
from typing import Dict
import imageio
import numpy as np
import torch
from torch.utils.tensorboard import SummaryWriter
from torchtyping import TensorType
from mattport.utils.decorators import check_main_thread
to8b = lambda x: (255 * torch.clamp(x, min=0, max=1)).to(torch.uint8)
class Writer:
"""Writer class"""
def __init__(self, local_rank: int, world_size: int, save_dir: str):
self.save_dir = save_dir
self.is_main_thread = local_rank % world_size == 0
@abstractmethod
def write_image(self, name: str, x: TensorType["H", "W", 3], step: int) -> None:
"""_summary_
Args:
name (str): data identifier
x (TensorType["H", "W", 3]): rendered image to write
"""
raise NotImplementedError
@abstractmethod
def write_text(self, name: str, x: str) -> None:
"""Required method to write a string to summary
Args:
name (str): data identifier
x (str): string to write
"""
raise NotImplementedError
@abstractmethod
def write_scalar(self, name: str, scalar: float, step: float, group: str = None) -> None:
"""Required method to write a single scalar value to the logger
Args:
name (str): data identifier
x (float): x value to write
y (float): y value to write
"""
raise NotImplementedError
def write_scalar_dict(self, scalar_dict: Dict[str, float], step: int, group: str = None) -> None:
"""Function that writes out all scalars from a given dictionary to the logger
Args:
scalar_dict (dict): dictionary containing all scalar values
"""
if self.is_main_thread:
for name, scalar in scalar_dict.items():
self.write_scalar(name, scalar, step, group=group)
class TensorboardWriter(Writer):
"""Tensorboard Writer Class"""
def __init__(self, local_rank: int, world_size: int, save_dir: str):
super().__init__(local_rank, world_size, save_dir)
if self.is_main_thread:
self.tb_writer = SummaryWriter(log_dir=self.save_dir)
@check_main_thread
def write_image(self, name: str, x: TensorType["H", "W", 3], step: int) -> None:
"""_summary_
Args:
name (str): data identifier
x (TensorType["H", "W", 3]): rendered image to write
"""
x = to8b(x)
self.tb_writer.add_image(name, x, step, dataformats="HWC")
@check_main_thread
def write_text(self, name: str, x: str) -> None:
"""Tensorboard method to write a string to summary
Args:
name (str): data identifier
x (str): string to write
"""
self.tb_writer.add_text(name, x)
@check_main_thread
def write_scalar(self, name: str, scalar: float, step: float, group: str = None) -> None:
"""Tensorboard method to write a single scalar value to the logger
Args:
name (str): data identifier
x (float): x value to write
y (float): y value to write
group (str)): a prefix to group tensorboard scalars
"""
prefix = f"{group}/" if group else ""
self.tb_writer.add_scalar(f"{prefix}{name}", scalar, step)
class LocalWriter(Writer):
"""Local Writer Class"""
@check_main_thread
def write_image(self, name: str, x: TensorType["H", "W", 3]) -> None:
"""Logs image to a jpg file in save_directory
Args:
name (str): data identifier to be used as file name
x (TensorType["H", "W", 3]): rendered image to write
"""
x = to8b(x)
image_path = os.path.join(self.save_dir, f"{name}.jpg")
imageio.imwrite(image_path, np.uint8(x.cpu().numpy() * 255.0))
@check_main_thread
def write_text(self, name: str, x: str) -> None:
"""Logs text locally to the terminal in place
Args:
name (str): data identifier
x (str): string to write
"""
print(f"{name}: {x}", end="\r")
@check_main_thread
def write_scalar(self, name: str, x: float, y: float) -> None:
"""Logs scalar locally to the terminal in place
Args:
name (str): data identifier
x (float): x value to write
y (float): y value to write
"""
self.write_text(name, f"x: {x:04f} y: {y:04f}")