torch_utils.py 14 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329
  1. # YOLOv5 🚀 by Ultralytics, GPL-3.0 license
  2. """
  3. PyTorch utils
  4. """
  5. import datetime
  6. import math
  7. import os
  8. import platform
  9. import subprocess
  10. import time
  11. from contextlib import contextmanager
  12. from copy import deepcopy
  13. from pathlib import Path
  14. import torch
  15. import torch.distributed as dist
  16. import torch.nn as nn
  17. import torch.nn.functional as F
  18. from utils.general import LOGGER
  19. try:
  20. import thop # for FLOPs computation
  21. except ImportError:
  22. thop = None
  23. @contextmanager
  24. def torch_distributed_zero_first(local_rank: int):
  25. """
  26. Decorator to make all processes in distributed training wait for each local_master to do something.
  27. """
  28. if local_rank not in [-1, 0]:
  29. dist.barrier(device_ids=[local_rank])
  30. yield
  31. if local_rank == 0:
  32. dist.barrier(device_ids=[0])
  33. def date_modified(path=__file__):
  34. # return human-readable file modification date, i.e. '2021-3-26'
  35. t = datetime.datetime.fromtimestamp(Path(path).stat().st_mtime)
  36. return f'{t.year}-{t.month}-{t.day}'
  37. def git_describe(path=Path(__file__).parent): # path must be a directory
  38. # return human-readable git description, i.e. v5.0-5-g3e25f1e https://git-scm.com/docs/git-describe
  39. s = f'git -C {path} describe --tags --long --always'
  40. try:
  41. return subprocess.check_output(s, shell=True, stderr=subprocess.STDOUT).decode()[:-1]
  42. except subprocess.CalledProcessError:
  43. return '' # not a git repository
  44. def device_count():
  45. # Returns number of CUDA devices available. Safe version of torch.cuda.device_count(). Only works on Linux.
  46. assert platform.system() == 'Linux', 'device_count() function only works on Linux'
  47. try:
  48. cmd = 'nvidia-smi -L | wc -l'
  49. return int(subprocess.run(cmd, shell=True, capture_output=True, check=True).stdout.decode().split()[-1])
  50. except Exception:
  51. return 0
  52. def select_device(device='', batch_size=0, newline=True):
  53. # device = 'cpu' or '0' or '0,1,2,3'
  54. s = f'YOLOv5 🚀 {git_describe() or date_modified()} torch {torch.__version__} ' # string
  55. device = str(device).strip().lower().replace('cuda:', '') # to string, 'cuda:0' to '0'
  56. cpu = device == 'cpu'
  57. if cpu:
  58. os.environ['CUDA_VISIBLE_DEVICES'] = '-1' # force torch.cuda.is_available() = False
  59. elif device: # non-cpu device requested
  60. os.environ['CUDA_VISIBLE_DEVICES'] = device # set environment variable - must be before assert is_available()
  61. assert torch.cuda.is_available() and torch.cuda.device_count() >= len(device.replace(',', '')), \
  62. f"Invalid CUDA '--device {device}' requested, use '--device cpu' or pass valid CUDA device(s)"
  63. cuda = not cpu and torch.cuda.is_available()
  64. if cuda:
  65. devices = device.split(',') if device else '0' # range(torch.cuda.device_count()) # i.e. 0,1,6,7
  66. n = len(devices) # device count
  67. if n > 1 and batch_size > 0: # check batch_size is divisible by device_count
  68. assert batch_size % n == 0, f'batch-size {batch_size} not multiple of GPU count {n}'
  69. space = ' ' * (len(s) + 1)
  70. for i, d in enumerate(devices):
  71. p = torch.cuda.get_device_properties(i)
  72. s += f"{'' if i == 0 else space}CUDA:{d} ({p.name}, {p.total_memory / 1024 ** 2:.0f}MiB)\n" # bytes to MB
  73. else:
  74. s += 'CPU\n'
  75. if not newline:
  76. s = s.rstrip()
  77. LOGGER.info(s.encode().decode('ascii', 'ignore') if platform.system() == 'Windows' else s) # emoji-safe
  78. return torch.device('cuda:0' if cuda else 'cpu')
  79. def time_sync():
  80. # pytorch-accurate time
  81. if torch.cuda.is_available():
  82. torch.cuda.synchronize()
  83. return time.time()
  84. def profile(input, ops, n=10, device=None):
  85. # YOLOv5 speed/memory/FLOPs profiler
  86. #
  87. # Usage:
  88. # input = torch.randn(16, 3, 640, 640)
  89. # m1 = lambda x: x * torch.sigmoid(x)
  90. # m2 = nn.SiLU()
  91. # profile(input, [m1, m2], n=100) # profile over 100 iterations
  92. results = []
  93. device = device or select_device()
  94. print(f"{'Params':>12s}{'GFLOPs':>12s}{'GPU_mem (GB)':>14s}{'forward (ms)':>14s}{'backward (ms)':>14s}"
  95. f"{'input':>24s}{'output':>24s}")
  96. for x in input if isinstance(input, list) else [input]:
  97. x = x.to(device)
  98. x.requires_grad = True
  99. for m in ops if isinstance(ops, list) else [ops]:
  100. m = m.to(device) if hasattr(m, 'to') else m # device
  101. m = m.half() if hasattr(m, 'half') and isinstance(x, torch.Tensor) and x.dtype is torch.float16 else m
  102. tf, tb, t = 0, 0, [0, 0, 0] # dt forward, backward
  103. try:
  104. flops = thop.profile(m, inputs=(x,), verbose=False)[0] / 1E9 * 2 # GFLOPs
  105. except Exception:
  106. flops = 0
  107. try:
  108. for _ in range(n):
  109. t[0] = time_sync()
  110. y = m(x)
  111. t[1] = time_sync()
  112. try:
  113. _ = (sum(yi.sum() for yi in y) if isinstance(y, list) else y).sum().backward()
  114. t[2] = time_sync()
  115. except Exception: # no backward method
  116. # print(e) # for debug
  117. t[2] = float('nan')
  118. tf += (t[1] - t[0]) * 1000 / n # ms per op forward
  119. tb += (t[2] - t[1]) * 1000 / n # ms per op backward
  120. mem = torch.cuda.memory_reserved() / 1E9 if torch.cuda.is_available() else 0 # (GB)
  121. s_in = tuple(x.shape) if isinstance(x, torch.Tensor) else 'list'
  122. s_out = tuple(y.shape) if isinstance(y, torch.Tensor) else 'list'
  123. p = sum(list(x.numel() for x in m.parameters())) if isinstance(m, nn.Module) else 0 # parameters
  124. print(f'{p:12}{flops:12.4g}{mem:>14.3f}{tf:14.4g}{tb:14.4g}{str(s_in):>24s}{str(s_out):>24s}')
  125. results.append([p, flops, mem, tf, tb, s_in, s_out])
  126. except Exception as e:
  127. print(e)
  128. results.append(None)
  129. torch.cuda.empty_cache()
  130. return results
  131. def is_parallel(model):
  132. # Returns True if model is of type DP or DDP
  133. return type(model) in (nn.parallel.DataParallel, nn.parallel.DistributedDataParallel)
  134. def de_parallel(model):
  135. # De-parallelize a model: returns single-GPU model if model is of type DP or DDP
  136. return model.module if is_parallel(model) else model
  137. def initialize_weights(model):
  138. for m in model.modules():
  139. t = type(m)
  140. if t is nn.Conv2d:
  141. pass # nn.init.kaiming_normal_(m.weight, mode='fan_out', nonlinearity='relu')
  142. elif t is nn.BatchNorm2d:
  143. m.eps = 1e-3
  144. m.momentum = 0.03
  145. elif t in [nn.Hardswish, nn.LeakyReLU, nn.ReLU, nn.ReLU6, nn.SiLU]:
  146. m.inplace = True
  147. def find_modules(model, mclass=nn.Conv2d):
  148. # Finds layer indices matching module class 'mclass'
  149. return [i for i, m in enumerate(model.module_list) if isinstance(m, mclass)]
  150. def sparsity(model):
  151. # Return global model sparsity
  152. a, b = 0, 0
  153. for p in model.parameters():
  154. a += p.numel()
  155. b += (p == 0).sum()
  156. return b / a
  157. def prune(model, amount=0.3):
  158. # Prune model to requested global sparsity
  159. import torch.nn.utils.prune as prune
  160. print('Pruning model... ', end='')
  161. for name, m in model.named_modules():
  162. if isinstance(m, nn.Conv2d):
  163. prune.l1_unstructured(m, name='weight', amount=amount) # prune
  164. prune.remove(m, 'weight') # make permanent
  165. print(' %.3g global sparsity' % sparsity(model))
  166. def fuse_conv_and_bn(conv, bn):
  167. # Fuse convolution and batchnorm layers https://tehnokv.com/posts/fusing-batchnorm-and-conv/
  168. fusedconv = nn.Conv2d(conv.in_channels,
  169. conv.out_channels,
  170. kernel_size=conv.kernel_size,
  171. stride=conv.stride,
  172. padding=conv.padding,
  173. groups=conv.groups,
  174. bias=True).requires_grad_(False).to(conv.weight.device)
  175. # prepare filters
  176. w_conv = conv.weight.clone().view(conv.out_channels, -1)
  177. w_bn = torch.diag(bn.weight.div(torch.sqrt(bn.eps + bn.running_var)))
  178. fusedconv.weight.copy_(torch.mm(w_bn, w_conv).view(fusedconv.weight.shape))
  179. # prepare spatial bias
  180. b_conv = torch.zeros(conv.weight.size(0), device=conv.weight.device) if conv.bias is None else conv.bias
  181. b_bn = bn.bias - bn.weight.mul(bn.running_mean).div(torch.sqrt(bn.running_var + bn.eps))
  182. fusedconv.bias.copy_(torch.mm(w_bn, b_conv.reshape(-1, 1)).reshape(-1) + b_bn)
  183. return fusedconv
  184. def model_info(model, verbose=False, img_size=640):
  185. # Model information. img_size may be int or list, i.e. img_size=640 or img_size=[640, 320]
  186. n_p = sum(x.numel() for x in model.parameters()) # number parameters
  187. n_g = sum(x.numel() for x in model.parameters() if x.requires_grad) # number gradients
  188. if verbose:
  189. print(f"{'layer':>5} {'name':>40} {'gradient':>9} {'parameters':>12} {'shape':>20} {'mu':>10} {'sigma':>10}")
  190. for i, (name, p) in enumerate(model.named_parameters()):
  191. name = name.replace('module_list.', '')
  192. print('%5g %40s %9s %12g %20s %10.3g %10.3g' %
  193. (i, name, p.requires_grad, p.numel(), list(p.shape), p.mean(), p.std()))
  194. try: # FLOPs
  195. from thop import profile
  196. stride = max(int(model.stride.max()), 32) if hasattr(model, 'stride') else 32
  197. img = torch.zeros((1, model.yaml.get('ch', 3), stride, stride), device=next(model.parameters()).device) # input
  198. flops = profile(deepcopy(model), inputs=(img,), verbose=False)[0] / 1E9 * 2 # stride GFLOPs
  199. img_size = img_size if isinstance(img_size, list) else [img_size, img_size] # expand if int/float
  200. fs = ', %.1f GFLOPs' % (flops * img_size[0] / stride * img_size[1] / stride) # 640x640 GFLOPs
  201. except (ImportError, Exception):
  202. fs = ''
  203. LOGGER.info(f"Model Summary: {len(list(model.modules()))} layers, {n_p} parameters, {n_g} gradients{fs}")
  204. def scale_img(img, ratio=1.0, same_shape=False, gs=32): # img(16,3,256,416)
  205. # scales img(bs,3,y,x) by ratio constrained to gs-multiple
  206. if ratio == 1.0:
  207. return img
  208. else:
  209. h, w = img.shape[2:]
  210. s = (int(h * ratio), int(w * ratio)) # new size
  211. img = F.interpolate(img, size=s, mode='bilinear', align_corners=False) # resize
  212. if not same_shape: # pad/crop img
  213. h, w = (math.ceil(x * ratio / gs) * gs for x in (h, w))
  214. return F.pad(img, [0, w - s[1], 0, h - s[0]], value=0.447) # value = imagenet mean
  215. def copy_attr(a, b, include=(), exclude=()):
  216. # Copy attributes from b to a, options to only include [...] and to exclude [...]
  217. for k, v in b.__dict__.items():
  218. if (len(include) and k not in include) or k.startswith('_') or k in exclude:
  219. continue
  220. else:
  221. setattr(a, k, v)
  222. class EarlyStopping:
  223. # YOLOv5 simple early stopper
  224. def __init__(self, patience=30):
  225. self.best_fitness = 0.0 # i.e. mAP
  226. self.best_epoch = 0
  227. self.patience = patience or float('inf') # epochs to wait after fitness stops improving to stop
  228. self.possible_stop = False # possible stop may occur next epoch
  229. def __call__(self, epoch, fitness):
  230. if fitness >= self.best_fitness: # >= 0 to allow for early zero-fitness stage of training
  231. self.best_epoch = epoch
  232. self.best_fitness = fitness
  233. delta = epoch - self.best_epoch # epochs without improvement
  234. self.possible_stop = delta >= (self.patience - 1) # possible stop may occur next epoch
  235. stop = delta >= self.patience # stop training if patience exceeded
  236. if stop:
  237. LOGGER.info(f'Stopping training early as no improvement observed in last {self.patience} epochs. '
  238. f'Best results observed at epoch {self.best_epoch}, best model saved as best.pt.\n'
  239. f'To update EarlyStopping(patience={self.patience}) pass a new patience value, '
  240. f'i.e. `python train.py --patience 300` or use `--patience 0` to disable EarlyStopping.')
  241. return stop
  242. class ModelEMA:
  243. """ Model Exponential Moving Average from https://github.com/rwightman/pytorch-image-models
  244. Keep a moving average of everything in the model state_dict (parameters and buffers).
  245. This is intended to allow functionality like
  246. https://www.tensorflow.org/api_docs/python/tf/train/ExponentialMovingAverage
  247. A smoothed version of the weights is necessary for some training schemes to perform well.
  248. This class is sensitive where it is initialized in the sequence of model init,
  249. GPU assignment and distributed training wrappers.
  250. """
  251. def __init__(self, model, decay=0.9999, updates=0):
  252. # Create EMA
  253. self.ema = deepcopy(de_parallel(model)).eval() # FP32 EMA
  254. # if next(model.parameters()).device.type != 'cpu':
  255. # self.ema.half() # FP16 EMA
  256. self.updates = updates # number of EMA updates
  257. self.decay = lambda x: decay * (1 - math.exp(-x / 2000)) # decay exponential ramp (to help early epochs)
  258. for p in self.ema.parameters():
  259. p.requires_grad_(False)
  260. def update(self, model):
  261. # Update EMA parameters
  262. with torch.no_grad():
  263. self.updates += 1
  264. d = self.decay(self.updates)
  265. msd = de_parallel(model).state_dict() # model state_dict
  266. for k, v in self.ema.state_dict().items():
  267. if v.dtype.is_floating_point:
  268. v *= d
  269. v += (1 - d) * msd[k].detach()
  270. def update_attr(self, model, include=(), exclude=('process_group', 'reducer')):
  271. # Update EMA attributes
  272. copy_attr(self.ema, model, include, exclude)