Spaces:
Running
Running
| # Copyright (c) 2021, NVIDIA CORPORATION. All rights reserved. | |
| # | |
| # NVIDIA CORPORATION and its licensors retain all intellectual property | |
| # and proprietary rights in and to this software, related documentation | |
| # and any modifications thereto. Any use, reproduction, disclosure or | |
| # distribution of this software and related documentation without an express | |
| # license agreement from NVIDIA CORPORATION is strictly prohibited. | |
| """Custom PyTorch ops for efficient resampling of 2D images.""" | |
| import os | |
| import warnings | |
| import numpy as np | |
| import torch | |
| import traceback | |
| from .. import custom_ops | |
| from .. import misc | |
| from . import conv2d_gradfix | |
| #---------------------------------------------------------------------------- | |
| _inited = False | |
| _plugin = None | |
| def _init(): | |
| global _inited, _plugin | |
| if not _inited: | |
| sources = ['upfirdn2d.cpp', 'upfirdn2d.cu'] | |
| sources = [os.path.join(os.path.dirname(__file__), s) for s in sources] | |
| try: | |
| _plugin = custom_ops.get_plugin('upfirdn2d_plugin', sources=sources, extra_cuda_cflags=['--use_fast_math']) | |
| except: | |
| warnings.warn('Failed to build CUDA kernels for upfirdn2d. Falling back to slow reference implementation. Details:\n\n' + traceback.format_exc()) | |
| return _plugin is not None | |
| def _parse_scaling(scaling): | |
| if isinstance(scaling, int): | |
| scaling = [scaling, scaling] | |
| assert isinstance(scaling, (list, tuple)) | |
| assert all(isinstance(x, int) for x in scaling) | |
| sx, sy = scaling | |
| assert sx >= 1 and sy >= 1 | |
| return sx, sy | |
| def _parse_padding(padding): | |
| if isinstance(padding, int): | |
| padding = [padding, padding] | |
| assert isinstance(padding, (list, tuple)) | |
| assert all(isinstance(x, int) for x in padding) | |
| if len(padding) == 2: | |
| padx, pady = padding | |
| padding = [padx, padx, pady, pady] | |
| padx0, padx1, pady0, pady1 = padding | |
| return padx0, padx1, pady0, pady1 | |
| def _get_filter_size(f): | |
| if f is None: | |
| return 1, 1 | |
| assert isinstance(f, torch.Tensor) and f.ndim in [1, 2] | |
| fw = f.shape[-1] | |
| fh = f.shape[0] | |
| with misc.suppress_tracer_warnings(): | |
| fw = int(fw) | |
| fh = int(fh) | |
| misc.assert_shape(f, [fh, fw][:f.ndim]) | |
| assert fw >= 1 and fh >= 1 | |
| return fw, fh | |
| #---------------------------------------------------------------------------- | |
| def setup_filter(f, device=torch.device('cpu'), normalize=True, flip_filter=False, gain=1, separable=None): | |
| r"""Convenience function to setup 2D FIR filter for `upfirdn2d()`. | |
| Args: | |
| f: Torch tensor, numpy array, or python list of the shape | |
| `[filter_height, filter_width]` (non-separable), | |
| `[filter_taps]` (separable), | |
| `[]` (impulse), or | |
| `None` (identity). | |
| device: Result device (default: cpu). | |
| normalize: Normalize the filter so that it retains the magnitude | |
| for constant input signal (DC)? (default: True). | |
| flip_filter: Flip the filter? (default: False). | |
| gain: Overall scaling factor for signal magnitude (default: 1). | |
| separable: Return a separable filter? (default: select automatically). | |
| Returns: | |
| Float32 tensor of the shape | |
| `[filter_height, filter_width]` (non-separable) or | |
| `[filter_taps]` (separable). | |
| """ | |
| # Validate. | |
| if f is None: | |
| f = 1 | |
| f = torch.as_tensor(f, dtype=torch.float32) | |
| assert f.ndim in [0, 1, 2] | |
| assert f.numel() > 0 | |
| if f.ndim == 0: | |
| f = f[np.newaxis] | |
| # Separable? | |
| if separable is None: | |
| separable = (f.ndim == 1 and f.numel() >= 8) | |
| if f.ndim == 1 and not separable: | |
| f = f.ger(f) | |
| assert f.ndim == (1 if separable else 2) | |
| # Apply normalize, flip, gain, and device. | |
| if normalize: | |
| f /= f.sum() | |
| if flip_filter: | |
| f = f.flip(list(range(f.ndim))) | |
| f = f * (gain ** (f.ndim / 2)) | |
| f = f.to(device=device) | |
| return f | |
| #---------------------------------------------------------------------------- | |
| def upfirdn2d(x, f, up=1, down=1, padding=0, flip_filter=False, gain=1, impl='cuda'): | |
| r"""Pad, upsample, filter, and downsample a batch of 2D images. | |
| Performs the following sequence of operations for each channel: | |
| 1. Upsample the image by inserting N-1 zeros after each pixel (`up`). | |
| 2. Pad the image with the specified number of zeros on each side (`padding`). | |
| Negative padding corresponds to cropping the image. | |
| 3. Convolve the image with the specified 2D FIR filter (`f`), shrinking it | |
| so that the footprint of all output pixels lies within the input image. | |
| 4. Downsample the image by keeping every Nth pixel (`down`). | |
| This sequence of operations bears close resemblance to scipy.signal.upfirdn(). | |
| The fused op is considerably more efficient than performing the same calculation | |
| using standard PyTorch ops. It supports gradients of arbitrary order. | |
| Args: | |
| x: Float32/float64/float16 input tensor of the shape | |
| `[batch_size, num_channels, in_height, in_width]`. | |
| f: Float32 FIR filter of the shape | |
| `[filter_height, filter_width]` (non-separable), | |
| `[filter_taps]` (separable), or | |
| `None` (identity). | |
| up: Integer upsampling factor. Can be a single int or a list/tuple | |
| `[x, y]` (default: 1). | |
| down: Integer downsampling factor. Can be a single int or a list/tuple | |
| `[x, y]` (default: 1). | |
| padding: Padding with respect to the upsampled image. Can be a single number | |
| or a list/tuple `[x, y]` or `[x_before, x_after, y_before, y_after]` | |
| (default: 0). | |
| flip_filter: False = convolution, True = correlation (default: False). | |
| gain: Overall scaling factor for signal magnitude (default: 1). | |
| impl: Implementation to use. Can be `'ref'` or `'cuda'` (default: `'cuda'`). | |
| Returns: | |
| Tensor of the shape `[batch_size, num_channels, out_height, out_width]`. | |
| """ | |
| assert isinstance(x, torch.Tensor) | |
| assert impl in ['ref', 'cuda'] | |
| if impl == 'cuda' and x.device.type == 'cuda' and _init(): | |
| return _upfirdn2d_cuda(up=up, down=down, padding=padding, flip_filter=flip_filter, gain=gain).apply(x, f) | |
| return _upfirdn2d_ref(x, f, up=up, down=down, padding=padding, flip_filter=flip_filter, gain=gain) | |
| #---------------------------------------------------------------------------- | |
| def _upfirdn2d_ref(x, f, up=1, down=1, padding=0, flip_filter=False, gain=1): | |
| """Slow reference implementation of `upfirdn2d()` using standard PyTorch ops. | |
| """ | |
| # Validate arguments. | |
| assert isinstance(x, torch.Tensor) and x.ndim == 4 | |
| if f is None: | |
| f = torch.ones([1, 1], dtype=torch.float32, device=x.device) | |
| assert isinstance(f, torch.Tensor) and f.ndim in [1, 2] | |
| assert f.dtype == torch.float32 and not f.requires_grad | |
| batch_size, num_channels, in_height, in_width = x.shape | |
| upx, upy = _parse_scaling(up) | |
| downx, downy = _parse_scaling(down) | |
| padx0, padx1, pady0, pady1 = _parse_padding(padding) | |
| # Upsample by inserting zeros. | |
| x = x.reshape([batch_size, num_channels, in_height, 1, in_width, 1]) | |
| x = torch.nn.functional.pad(x, [0, upx - 1, 0, 0, 0, upy - 1]) | |
| x = x.reshape([batch_size, num_channels, in_height * upy, in_width * upx]) | |
| # Pad or crop. | |
| x = torch.nn.functional.pad(x, [max(padx0, 0), max(padx1, 0), max(pady0, 0), max(pady1, 0)]) | |
| x = x[:, :, max(-pady0, 0) : x.shape[2] - max(-pady1, 0), max(-padx0, 0) : x.shape[3] - max(-padx1, 0)] | |
| # Setup filter. | |
| f = f * (gain ** (f.ndim / 2)) | |
| f = f.to(x.dtype) | |
| if not flip_filter: | |
| f = f.flip(list(range(f.ndim))) | |
| # Convolve with the filter. | |
| f = f[np.newaxis, np.newaxis].repeat([num_channels, 1] + [1] * f.ndim) | |
| if f.ndim == 4: | |
| x = conv2d_gradfix.conv2d(input=x, weight=f, groups=num_channels) | |
| else: | |
| x = conv2d_gradfix.conv2d(input=x, weight=f.unsqueeze(2), groups=num_channels) | |
| x = conv2d_gradfix.conv2d(input=x, weight=f.unsqueeze(3), groups=num_channels) | |
| # Downsample by throwing away pixels. | |
| x = x[:, :, ::downy, ::downx] | |
| return x | |
| #---------------------------------------------------------------------------- | |
| _upfirdn2d_cuda_cache = dict() | |
| def _upfirdn2d_cuda(up=1, down=1, padding=0, flip_filter=False, gain=1): | |
| """Fast CUDA implementation of `upfirdn2d()` using custom ops. | |
| """ | |
| # Parse arguments. | |
| upx, upy = _parse_scaling(up) | |
| downx, downy = _parse_scaling(down) | |
| padx0, padx1, pady0, pady1 = _parse_padding(padding) | |
| # Lookup from cache. | |
| key = (upx, upy, downx, downy, padx0, padx1, pady0, pady1, flip_filter, gain) | |
| if key in _upfirdn2d_cuda_cache: | |
| return _upfirdn2d_cuda_cache[key] | |
| # Forward op. | |
| class Upfirdn2dCuda(torch.autograd.Function): | |
| def forward(ctx, x, f): # pylint: disable=arguments-differ | |
| assert isinstance(x, torch.Tensor) and x.ndim == 4 | |
| if f is None: | |
| f = torch.ones([1, 1], dtype=torch.float32, device=x.device) | |
| assert isinstance(f, torch.Tensor) and f.ndim in [1, 2] | |
| y = x | |
| if f.ndim == 2: | |
| y = _plugin.upfirdn2d(y, f, upx, upy, downx, downy, padx0, padx1, pady0, pady1, flip_filter, gain) | |
| else: | |
| y = _plugin.upfirdn2d(y, f.unsqueeze(0), upx, 1, downx, 1, padx0, padx1, 0, 0, flip_filter, np.sqrt(gain)) | |
| y = _plugin.upfirdn2d(y, f.unsqueeze(1), 1, upy, 1, downy, 0, 0, pady0, pady1, flip_filter, np.sqrt(gain)) | |
| ctx.save_for_backward(f) | |
| ctx.x_shape = x.shape | |
| return y | |
| def backward(ctx, dy): # pylint: disable=arguments-differ | |
| f, = ctx.saved_tensors | |
| _, _, ih, iw = ctx.x_shape | |
| _, _, oh, ow = dy.shape | |
| fw, fh = _get_filter_size(f) | |
| p = [ | |
| fw - padx0 - 1, | |
| iw * upx - ow * downx + padx0 - upx + 1, | |
| fh - pady0 - 1, | |
| ih * upy - oh * downy + pady0 - upy + 1, | |
| ] | |
| dx = None | |
| df = None | |
| if ctx.needs_input_grad[0]: | |
| dx = _upfirdn2d_cuda(up=down, down=up, padding=p, flip_filter=(not flip_filter), gain=gain).apply(dy, f) | |
| assert not ctx.needs_input_grad[1] | |
| return dx, df | |
| # Add to cache. | |
| _upfirdn2d_cuda_cache[key] = Upfirdn2dCuda | |
| return Upfirdn2dCuda | |
| #---------------------------------------------------------------------------- | |
| def filter2d(x, f, padding=0, flip_filter=False, gain=1, impl='cuda'): | |
| r"""Filter a batch of 2D images using the given 2D FIR filter. | |
| By default, the result is padded so that its shape matches the input. | |
| User-specified padding is applied on top of that, with negative values | |
| indicating cropping. Pixels outside the image are assumed to be zero. | |
| Args: | |
| x: Float32/float64/float16 input tensor of the shape | |
| `[batch_size, num_channels, in_height, in_width]`. | |
| f: Float32 FIR filter of the shape | |
| `[filter_height, filter_width]` (non-separable), | |
| `[filter_taps]` (separable), or | |
| `None` (identity). | |
| padding: Padding with respect to the output. Can be a single number or a | |
| list/tuple `[x, y]` or `[x_before, x_after, y_before, y_after]` | |
| (default: 0). | |
| flip_filter: False = convolution, True = correlation (default: False). | |
| gain: Overall scaling factor for signal magnitude (default: 1). | |
| impl: Implementation to use. Can be `'ref'` or `'cuda'` (default: `'cuda'`). | |
| Returns: | |
| Tensor of the shape `[batch_size, num_channels, out_height, out_width]`. | |
| """ | |
| padx0, padx1, pady0, pady1 = _parse_padding(padding) | |
| fw, fh = _get_filter_size(f) | |
| p = [ | |
| padx0 + fw // 2, | |
| padx1 + (fw - 1) // 2, | |
| pady0 + fh // 2, | |
| pady1 + (fh - 1) // 2, | |
| ] | |
| return upfirdn2d(x, f, padding=p, flip_filter=flip_filter, gain=gain, impl=impl) | |
| #---------------------------------------------------------------------------- | |
| def upsample2d(x, f, up=2, padding=0, flip_filter=False, gain=1, impl='cuda'): | |
| r"""Upsample a batch of 2D images using the given 2D FIR filter. | |
| By default, the result is padded so that its shape is a multiple of the input. | |
| User-specified padding is applied on top of that, with negative values | |
| indicating cropping. Pixels outside the image are assumed to be zero. | |
| Args: | |
| x: Float32/float64/float16 input tensor of the shape | |
| `[batch_size, num_channels, in_height, in_width]`. | |
| f: Float32 FIR filter of the shape | |
| `[filter_height, filter_width]` (non-separable), | |
| `[filter_taps]` (separable), or | |
| `None` (identity). | |
| up: Integer upsampling factor. Can be a single int or a list/tuple | |
| `[x, y]` (default: 1). | |
| padding: Padding with respect to the output. Can be a single number or a | |
| list/tuple `[x, y]` or `[x_before, x_after, y_before, y_after]` | |
| (default: 0). | |
| flip_filter: False = convolution, True = correlation (default: False). | |
| gain: Overall scaling factor for signal magnitude (default: 1). | |
| impl: Implementation to use. Can be `'ref'` or `'cuda'` (default: `'cuda'`). | |
| Returns: | |
| Tensor of the shape `[batch_size, num_channels, out_height, out_width]`. | |
| """ | |
| upx, upy = _parse_scaling(up) | |
| padx0, padx1, pady0, pady1 = _parse_padding(padding) | |
| fw, fh = _get_filter_size(f) | |
| p = [ | |
| padx0 + (fw + upx - 1) // 2, | |
| padx1 + (fw - upx) // 2, | |
| pady0 + (fh + upy - 1) // 2, | |
| pady1 + (fh - upy) // 2, | |
| ] | |
| return upfirdn2d(x, f, up=up, padding=p, flip_filter=flip_filter, gain=gain*upx*upy, impl=impl) | |
| #---------------------------------------------------------------------------- | |
| def downsample2d(x, f, down=2, padding=0, flip_filter=False, gain=1, impl='cuda'): | |
| r"""Downsample a batch of 2D images using the given 2D FIR filter. | |
| By default, the result is padded so that its shape is a fraction of the input. | |
| User-specified padding is applied on top of that, with negative values | |
| indicating cropping. Pixels outside the image are assumed to be zero. | |
| Args: | |
| x: Float32/float64/float16 input tensor of the shape | |
| `[batch_size, num_channels, in_height, in_width]`. | |
| f: Float32 FIR filter of the shape | |
| `[filter_height, filter_width]` (non-separable), | |
| `[filter_taps]` (separable), or | |
| `None` (identity). | |
| down: Integer downsampling factor. Can be a single int or a list/tuple | |
| `[x, y]` (default: 1). | |
| padding: Padding with respect to the input. Can be a single number or a | |
| list/tuple `[x, y]` or `[x_before, x_after, y_before, y_after]` | |
| (default: 0). | |
| flip_filter: False = convolution, True = correlation (default: False). | |
| gain: Overall scaling factor for signal magnitude (default: 1). | |
| impl: Implementation to use. Can be `'ref'` or `'cuda'` (default: `'cuda'`). | |
| Returns: | |
| Tensor of the shape `[batch_size, num_channels, out_height, out_width]`. | |
| """ | |
| downx, downy = _parse_scaling(down) | |
| padx0, padx1, pady0, pady1 = _parse_padding(padding) | |
| fw, fh = _get_filter_size(f) | |
| p = [ | |
| padx0 + (fw - downx + 1) // 2, | |
| padx1 + (fw - downx) // 2, | |
| pady0 + (fh - downy + 1) // 2, | |
| pady1 + (fh - downy) // 2, | |
| ] | |
| return upfirdn2d(x, f, down=down, padding=p, flip_filter=flip_filter, gain=gain, impl=impl) | |
| #---------------------------------------------------------------------------- | |