HRNet阅读笔记及代码理解

5次阅读

共计 10726 个字符,预计需要花费 27 分钟才能阅读完成。

摘要:

大多数现有方法从由高到低分辨率网络产生的低分辨率表示中恢复高分辨率表示。相反,本文在整个过程中保持高分辨率的表示。我们将高分辨率子网开始作为第一阶段,逐步添加高到低分辨率子网以形成更多阶段,并行连接多个子网,每个子网具有不同的分辨率。我们进行重复的多尺度融合,使得高到低分辨率表示可以重复从其他分辨率的表示获取信息,从而导致丰富的高分辨率表示。因此,预测的关键点热图可能更准确,空间更精确。

1. 简介

1.1 现有方法

  • (a) 对称结构,先下采样,再上采样,同时使用跳层连接恢复下采样丢失的信息;
  • (b) 级联金字塔;
  • (c) 先下采样,转置卷积上采样,不使用跳层连接进行数据融合;
  • (d) 扩张卷积,减少下采样次数,不使用跳层连接进行数据融合;

1.2 HRNet

简要描述

HighResolution Net(HRNet),它能够在整个过程中保持高分辨率表示。以高分辨率子网开始作为第一阶段,逐个添加高到低分辨率子网以形成更多阶段,并且 并行连接多分辨率子网 。在整个过程中反复交换并行多分辨率子网络中的信息来进行 重复的多尺度融合

优点

  • (a)并行连接高低分辨率子网 ,而不是像大多数现有解决方案那样串联连接。因此,我们的方法能够 保持高分辨率 而不是通过从低到高的过程恢复分辨率,因此预测的热图可能在空间上更精确
  • (b)大多数现有的融合方案汇总了低级别和高级别的表示。相反,我们在相同深度和相似水平的低分辨率表示的帮助下执行 重复的多尺度融合 以提升高分辨率表示,反之亦然,导致高分辨率表示对于姿势估计也是丰富的。因此,我们预测的热图可能更准确。个人感觉增加多尺度信息之间的融合是正确的,例如原图像和模糊图像进行联合双边滤波可以得到介于两者之间的模糊程度的图像,而 RGF 滤波就是重复将联合双边滤波的结果作为那张模糊的引导图,这样得到的结果会越来越趋近于原图。此处同样的道理,不同分辨率的图像采样到相同的尺度反复的融合,加之网络的学习能力,会使得多次融合后的结果更加趋近于正确的表示

2. 方法描述

2.1 并行高分辨率子网

2.2 重复多尺度融合

3. 实验部分

3.1 消融研究

3.1.1 重复多尺度融合

  • (a) W / o 中间交换单元(1 个融合):除最后一个交换单元外,多分辨率子网之间没有交换;
  • (b) 仅 W / 跨阶段交换单元(3 个融合):每个阶段内并行子网之间没有交换;
  • (c) W / 跨阶段和阶段内交换单元(共 8 个融合):这是我们提出的方法;

3.1.2 分辨率保持

所有四个高到低分辨率子网都在开头添加,深度相同,融合方案与我们的相同。该变体实现了 72.5 的 AP,低于我们的小型网 HRNet-W32 的 73.4 AP。我们认为原因是从低分辨率子网上的早期阶段提取的低级功能不太有用。此外,没有低分辨率并行子网的类似参数和计算复杂度的简单高分辨率网络表现出低得多的性能。

3.1.3 分辨率表示质量

检查从每个分辨率的特征图估计的热图的质量。

4. 代码学习(源码地址)

4.1 ResNet 模块

虽然很熟悉了,但是还是介绍一下 resnet 网络的基本模块。如下的左图对应于 resnet-18/34 使用的基本块,右图是 50/101/152 所使用的,由于他们都比较深,所以有图相比于左图使用了 1 ×1 卷积来降维。

  • (a) conv3x3: 没啥好解释的,将原有的 pytorch 函数固定卷积和尺寸为 3 重新封装了一次;
  • (b) BasicBlock: 搭建上图左边的模块。

    (1) 每个卷积块后面连接 BN 层进行归一化;

    (2) 残差连接前的 3 ×3 卷积之后只接入 BN,不使用 ReLU,避免加和之后的特征皆为正,保持特征的多样;

    (3) 跳层连接:两种情况,当模块输入和残差支路(3×3->3×3)的通道数一致时,直接相加;当两者通道不一致时(一般发生在分辨率降低之后,同分辨率一般通道数一致),需要对模块输入特征使用 1 ×1 卷积进行升 / 降维(步长为 2,上面说了分辨率会降低),之后同样接 BN,不用 ReLU。

  • (c) Bottleneck: 搭建上图右边的模块。

    (1) 使用 1 ×1 卷积先降维,再使用 3 ×3 卷积进行特征提取,最后再使用 1 ×1 卷积把维度升回去;

    (2) 每个卷积块后面连接 BN 层进行归一化;

    (2) 残差连接前的 1 ×1 卷积之后只接入 BN,不使用 ReLU,避免加和之后的特征皆为正,保持特征的多样性。

    (3) 跳层连接:两种情况,当模块输入和残差支路(1×1->3×3->1×1)的通道数一致时,直接相加;当两者通道不一致时(一般发生在分辨率降低之后,同分辨率一般通道数一致),需要对模块输入特征使用 1 ×1 卷积进行升 / 降维(步长为 2,上面说了分辨率会降低),之后同样接 BN,不用 ReLU。

def conv3x3(in_planes, out_planes, stride=1):
    """3x3 convolution with padding"""
    return nn.Conv2d(in_planes, out_planes, kernel_size=3, stride=stride,
                     padding=1, bias=False)


class BasicBlock(nn.Module):
    expansion = 1

    def __init__(self, inplanes, planes, stride=1, downsample=None):
        super(BasicBlock, self).__init__()
        self.conv1 = conv3x3(inplanes, planes, stride)
        self.bn1 = nn.BatchNorm2d(planes, momentum=BN_MOMENTUM)
        self.relu = nn.ReLU(inplace=True)
        self.conv2 = conv3x3(planes, planes)
        self.bn2 = nn.BatchNorm2d(planes, momentum=BN_MOMENTUM)
        self.downsample = downsample
        self.stride = stride

    def forward(self, x):
        residual = x

        out = self.conv1(x)
        out = self.bn1(out)
        out = self.relu(out)

        out = self.conv2(out)
        out = self.bn2(out)

        if self.downsample is not None:
            residual = self.downsample(x)

        out += residual
        out = self.relu(out)

        return out


class Bottleneck(nn.Module):
    expansion = 4

    def __init__(self, inplanes, planes, stride=1, downsample=None):
        super(Bottleneck, self).__init__()
        self.conv1 = nn.Conv2d(inplanes, planes, kernel_size=1, bias=False)
        self.bn1 = nn.BatchNorm2d(planes, momentum=BN_MOMENTUM)
        self.conv2 = nn.Conv2d(planes, planes, kernel_size=3, stride=stride,
                               padding=1, bias=False)
        self.bn2 = nn.BatchNorm2d(planes, momentum=BN_MOMENTUM)
        self.conv3 = nn.Conv2d(planes, planes * self.expansion, kernel_size=1,
                               bias=False)
        self.bn3 = nn.BatchNorm2d(planes * self.expansion,
                                  momentum=BN_MOMENTUM)
        self.relu = nn.ReLU(inplace=True)
        self.downsample = downsample
        self.stride = stride

    def forward(self, x):
        residual = x

        out = self.conv1(x)
        out = self.bn1(out)
        out = self.relu(out)

        out = self.conv2(out)
        out = self.bn2(out)
        out = self.relu(out)

        out = self.conv3(out)
        out = self.bn3(out)

        if self.downsample is not None:
            residual = self.downsample(x)

        out += residual
        out = self.relu(out)

        return out

4.2 HighResolutionModule (高分辨率模块)

当仅包含一个分支时,生成该分支,没有融合模块,直接返回;当包含不仅一个分支时,先将对应分支的输入特征输入到对应分支,得到对应分支的输出特征;紧接着执行融合模块。

  • (a) _check_branches: 判断num_branches (int)num_blocks, num_inchannels, num_channels (list) 三者的长度是否一致,否则报错;
  • (b) _make_one_branch: 搭建一个分支,单个分支内部分辨率相等,一个分支由 num_blocks[branch_index] 个 block 组成,block 可以是两种 ResNet 模块中的一种;

    • (1) 首先判断是否降维或者输入输出的通道 (num_inchannels[branch_index] 和 num_channels[branch_index] * block.expansion(通道扩张率))是否一致,不一致使用 1z1 卷积进行维度升 / 降,后接 BN,不使用 ReLU;
    • (2) 顺序搭建 num_blocks[branch_index] 个 block,第一个 block 需要考虑是否降维的情况,所以单独拿出来,后面 1 到 num_blocks[branch_index] 个 block 完全一致,使用循环搭建就行。此时注意在执行完第一个 block 后将 num_inchannels[branch_index 重新赋值为 num_channels[branch_index] * block.expansion
  • (c) _make_branches: 循环调用 _make_one_branch 函数创建多个分支;
  • (d) _make_fuse_layers:

    • (1) 如果分支数等于 1,返回 None,说明此事不需要使用融合模块;
    • (2) 双层循环:for i in range(num_branches if self.multi_scale_output else 1):的作用是,如果需要产生多分辨率的结果,就双层循环 num_branches 次,如果只需要产生最高分辨率的表示,就将 i 确定为 0。

      • (2.1) 如果 j > i,此时的目标是将所有分支上采样到和i 分支相同的分辨率并融合,也就是说 j 所代表的分支分辨率比 i 分支低,2**(j-i)表示 j 分支上采样这么多倍才能和 i 分支分辨率相同。先使用 1 ×1 卷积将 j 分支的通道数变得和 i 分支一致,进而跟着 BN,然后依据上采样因子将 j 分支分辨率上采样到和 i 分支分辨率相同,此处使用最近邻插值;

      • (2.2) 如果j = i,也就是说自身与自身之间不需要融合,nothing to do;
      • (2.3) 如果 j < i,转换角色,此时最终目标是将所有分支采样到和i 分支相同的分辨率并融合,注意,此时 j 所代表的分支分辨率比 i 分支高,正好和 (2.1) 相反。此时再次内嵌了一个循环,这层循环的作用是当 i-j > 1 时,也就是说两个分支的分辨率差了不止二倍,此时还是两倍两倍往上采样,例如 i-j = 2 时,j分支的分辨率比 i 分支大 4 倍,就需要上采样两次,循环次数就是 2;

        • (2.3.1) 当 k == i - j - 1 时,举个例子,i = 2,j = 1, 此时仅循环一次,并采用当前模块,此时直接将 j 分支使用 3 ×3 的步长为 2 的卷积下采样(不使用 bias),后接 BN,不使用 ReLU;

        • (2.3.2) 当 k != i - j - 1 时,举个例子,i = 3,j = 1, 此时循环两次,先采用当前模块,将 j 分支使用 3 ×3 的步长为 2 的卷积下采样 (不使用 bias) 两倍,后接 BN 和 ReLU,紧跟着再使用 (2.3.1) 中的模块,这是为了保证最后一次二倍下采样的卷积操作不使用 ReLU,猜测也是为了保证融合后特征的多样性;

  • (e) forward: 前向传播函数,利用以上函数的功能搭建一个HighResolutionModule

    • (1) 当仅包含一个分支时,生成该分支,没有融合模块,直接返回;
    • (2) 当包含不仅一个分支时,先将对应分支的输入特征输入到对应分支,得到对应分支的输出特征;紧接着执行融合模块;

      • (2.1) 循环将对应分支的输入特征输入到对应分支模型中,得到对应分支的输出特征;
      • (2.2) 融合模块:对着这张图看,很容易看懂。每次多尺度之间的加法运算都是从最上面的尺度开始往下加,所以 y = x[0] if i == 0 else self.fuse_layers[i][0](x[0]);加到他自己的时候,不需要经过融合函数的处理,直接加,所以if i == j: y = y + x[j];遇到不是最上面的尺度那个特征图或者它本身相同分辨率的那个特征图时,需要经过融合函数处理再加,所以y = y + self.fuse_layers[i][j](x[j])。最后将 ReLU 激活后的融合(加法) 特征 append 到 x_fusex_fuse 的长度等于1(单尺度输出)或者num_branches(多尺度输出)。

class HighResolutionModule(nn.Module):
    def __init__(self, num_branches, blocks, num_blocks, num_inchannels,
                 num_channels, fuse_method, multi_scale_output=True):
        super(HighResolutionModule, self).__init__()
        self._check_branches(num_branches, blocks, num_blocks, num_inchannels, num_channels)

        self.num_inchannels = num_inchannels
        self.fuse_method = fuse_method
        self.num_branches = num_branches

        self.multi_scale_output = multi_scale_output

        self.branches = self._make_branches(num_branches, blocks, num_blocks, num_channels)
        self.fuse_layers = self._make_fuse_layers()
        self.relu = nn.ReLU(True)

    def _check_branches(self, num_branches, blocks, num_blocks,
                        num_inchannels, num_channels):
        if num_branches != len(num_blocks):
            error_msg = 'NUM_BRANCHES({}) <> NUM_BLOCKS({})'.format(num_branches, len(num_blocks))
            logger.error(error_msg)
            raise ValueError(error_msg)

        if num_branches != len(num_channels):
            error_msg = 'NUM_BRANCHES({}) <> NUM_CHANNELS({})'.format(num_branches, len(num_channels))
            logger.error(error_msg)
            raise ValueError(error_msg)

        if num_branches != len(num_inchannels):
            error_msg = 'NUM_BRANCHES({}) <> NUM_INCHANNELS({})'.format(num_branches, len(num_inchannels))
            logger.error(error_msg)
            raise ValueError(error_msg)

    def _make_one_branch(self, branch_index, block, num_blocks, num_channels,
                         stride=1):
        # ---------------------------(1) begin---------------------------- #
        downsample = None
        if stride != 1 or \
           self.num_inchannels[branch_index] != num_channels[branch_index] * block.expansion:
            downsample = nn.Sequential(
                nn.Conv2d(self.num_inchannels[branch_index],
                    num_channels[branch_index] * block.expansion,
                    kernel_size=1, stride=stride, bias=False
                ),
                nn.BatchNorm2d(num_channels[branch_index] * block.expansion,
                    momentum=BN_MOMENTUM
                ),
            )
        # ---------------------------(1) end---------------------------- #
        
        # ---------------------------(2) begin---------------------------- #
        layers = []
        layers.append(
            block(self.num_inchannels[branch_index],
                num_channels[branch_index],
                stride,
                downsample
            )
        )
        # ---------------------------(2) middle---------------------------- #
        self.num_inchannels[branch_index] = num_channels[branch_index] * block.expansion
        for i in range(1, num_blocks[branch_index]):
            layers.append(
                block(self.num_inchannels[branch_index],
                    num_channels[branch_index]
                )
            )
        # ---------------------------(2) end---------------------------- #
        return nn.Sequential(*layers)

    def _make_branches(self, num_branches, block, num_blocks, num_channels):
        branches = []

        for i in range(num_branches):
            branches.append(self._make_one_branch(i, block, num_blocks, num_channels)
            )

        return nn.ModuleList(branches)

    def _make_fuse_layers(self):
        # ---------------------------(1) begin---------------------------- #
        if self.num_branches == 1:
            return None
        # ---------------------------(1) end---------------------------- #

        
        num_branches = self.num_branches
        num_inchannels = self.num_inchannels
        # ---------------------------(2) begin---------------------------- #
        fuse_layers = []
        for i in range(num_branches if self.multi_scale_output else 1):
            fuse_layer = []
            for j in range(num_branches):
                # ---------------------------(2.1) begin---------------------------- #
                if j > i:
                    fuse_layer.append(
                        nn.Sequential(
                            nn.Conv2d(num_inchannels[j],
                                num_inchannels[i],
                                1, 1, 0, bias=False
                            ),
                            nn.BatchNorm2d(num_inchannels[i]),
                            nn.Upsample(scale_factor=2**(j-i), mode='nearest')
                        )
                    )
                # ---------------------------(2.1) end---------------------------- #
                
                # ---------------------------(2.2) begin---------------------------- #
                elif j == i:
                    fuse_layer.append(None)
                # ---------------------------(2.2) end---------------------------- #
                
                # ---------------------------(2.3) begin---------------------------- #
                else:
                    conv3x3s = []
                    for k in range(i-j):
                        # ---------------------------(2.3.1) begin---------------------------- #
                        if k == i - j - 1:
                            num_outchannels_conv3x3 = num_inchannels[i]
                            conv3x3s.append(
                                nn.Sequential(
                                    nn.Conv2d(num_inchannels[j],
                                        num_outchannels_conv3x3,
                                        3, 2, 1, bias=False
                                    ),
                                    nn.BatchNorm2d(num_outchannels_conv3x3)
                                )
                            )
                        # ---------------------------(2.3.1) end---------------------------- #
                        
                        # ---------------------------(2.3.1) begin---------------------------- #
                        else:
                            num_outchannels_conv3x3 = num_inchannels[j]
                            conv3x3s.append(
                                nn.Sequential(
                                    nn.Conv2d(num_inchannels[j],
                                        num_outchannels_conv3x3,
                                        3, 2, 1, bias=False
                                    ),
                                    nn.BatchNorm2d(num_outchannels_conv3x3),
                                    nn.ReLU(True)
                                )
                            )
                        # ---------------------------(2.3.1) end---------------------------- #
                    # ---------------------------(2.3) end---------------------------- #
                    fuse_layer.append(nn.Sequential(*conv3x3s))
            fuse_layers.append(nn.ModuleList(fuse_layer))
            # ---------------------------(2) end---------------------------- #

        return nn.ModuleList(fuse_layers)

    def get_num_inchannels(self):
        return self.num_inchannels

    def forward(self, x):
        # ---------------------------(1) begin---------------------------- #
        if self.num_branches == 1:
            return [self.branches[0](x[0])]
        # ---------------------------(1) end---------------------------- #

        # ---------------------------(2) begin---------------------------- #
        # ---------------------------(2.1) begin---------------------------- #
        for i in range(self.num_branches):
            x[i] = self.branches[i](x[i])
        # ---------------------------(2.1) end---------------------------- #

        # ---------------------------(2.2) begin---------------------------- #
        x_fuse = []

        for i in range(len(self.fuse_layers)):
            y = x[0] if i == 0 else self.fuse_layers[i][0](x[0])
            for j in range(1, self.num_branches):
                if i == j:
                    y = y + x[j]
                else:
                    y = y + self.fuse_layers[i][j](x[j])
            x_fuse.append(self.relu(y))
        # ---------------------------(2.2) end---------------------------- #
        # ---------------------------(2) end---------------------------- #

        return x_fuse

正文完
 0

HRNet阅读笔记及代码理解

5次阅读

共计 10726 个字符,预计需要花费 27 分钟才能阅读完成。

摘要:

大多数现有方法从由高到低分辨率网络产生的低分辨率表示中恢复高分辨率表示。相反,本文在整个过程中保持高分辨率的表示。我们将高分辨率子网开始作为第一阶段,逐步添加高到低分辨率子网以形成更多阶段,并行连接多个子网,每个子网具有不同的分辨率。我们进行重复的多尺度融合,使得高到低分辨率表示可以重复从其他分辨率的表示获取信息,从而导致丰富的高分辨率表示。因此,预测的关键点热图可能更准确,空间更精确。

1. 简介

1.1 现有方法

  • (a) 对称结构,先下采样,再上采样,同时使用跳层连接恢复下采样丢失的信息;
  • (b) 级联金字塔;
  • (c) 先下采样,转置卷积上采样,不使用跳层连接进行数据融合;
  • (d) 扩张卷积,减少下采样次数,不使用跳层连接进行数据融合;

1.2 HRNet

简要描述

HighResolution Net(HRNet),它能够在整个过程中保持高分辨率表示。以高分辨率子网开始作为第一阶段,逐个添加高到低分辨率子网以形成更多阶段,并且 并行连接多分辨率子网 。在整个过程中反复交换并行多分辨率子网络中的信息来进行 重复的多尺度融合

优点

  • (a)并行连接高低分辨率子网 ,而不是像大多数现有解决方案那样串联连接。因此,我们的方法能够 保持高分辨率 而不是通过从低到高的过程恢复分辨率,因此预测的热图可能在空间上更精确
  • (b)大多数现有的融合方案汇总了低级别和高级别的表示。相反,我们在相同深度和相似水平的低分辨率表示的帮助下执行 重复的多尺度融合 以提升高分辨率表示,反之亦然,导致高分辨率表示对于姿势估计也是丰富的。因此,我们预测的热图可能更准确。个人感觉增加多尺度信息之间的融合是正确的,例如原图像和模糊图像进行联合双边滤波可以得到介于两者之间的模糊程度的图像,而 RGF 滤波就是重复将联合双边滤波的结果作为那张模糊的引导图,这样得到的结果会越来越趋近于原图。此处同样的道理,不同分辨率的图像采样到相同的尺度反复的融合,加之网络的学习能力,会使得多次融合后的结果更加趋近于正确的表示

2. 方法描述

2.1 并行高分辨率子网

2.2 重复多尺度融合

3. 实验部分

3.1 消融研究

3.1.1 重复多尺度融合

  • (a) W / o 中间交换单元(1 个融合):除最后一个交换单元外,多分辨率子网之间没有交换;
  • (b) 仅 W / 跨阶段交换单元(3 个融合):每个阶段内并行子网之间没有交换;
  • (c) W / 跨阶段和阶段内交换单元(共 8 个融合):这是我们提出的方法;

3.1.2 分辨率保持

所有四个高到低分辨率子网都在开头添加,深度相同,融合方案与我们的相同。该变体实现了 72.5 的 AP,低于我们的小型网 HRNet-W32 的 73.4 AP。我们认为原因是从低分辨率子网上的早期阶段提取的低级功能不太有用。此外,没有低分辨率并行子网的类似参数和计算复杂度的简单高分辨率网络表现出低得多的性能。

3.1.3 分辨率表示质量

检查从每个分辨率的特征图估计的热图的质量。

4. 代码学习(源码地址)

4.1 ResNet 模块

虽然很熟悉了,但是还是介绍一下 resnet 网络的基本模块。如下的左图对应于 resnet-18/34 使用的基本块,右图是 50/101/152 所使用的,由于他们都比较深,所以有图相比于左图使用了 1 ×1 卷积来降维。

  • (a) conv3x3: 没啥好解释的,将原有的 pytorch 函数固定卷积和尺寸为 3 重新封装了一次;
  • (b) BasicBlock: 搭建上图左边的模块。

    (1) 每个卷积块后面连接 BN 层进行归一化;

    (2) 残差连接前的 3 ×3 卷积之后只接入 BN,不使用 ReLU,避免加和之后的特征皆为正,保持特征的多样;

    (3) 跳层连接:两种情况,当模块输入和残差支路(3×3->3×3)的通道数一致时,直接相加;当两者通道不一致时(一般发生在分辨率降低之后,同分辨率一般通道数一致),需要对模块输入特征使用 1 ×1 卷积进行升 / 降维(步长为 2,上面说了分辨率会降低),之后同样接 BN,不用 ReLU。

  • (c) Bottleneck: 搭建上图右边的模块。

    (1) 使用 1 ×1 卷积先降维,再使用 3 ×3 卷积进行特征提取,最后再使用 1 ×1 卷积把维度升回去;

    (2) 每个卷积块后面连接 BN 层进行归一化;

    (2) 残差连接前的 1 ×1 卷积之后只接入 BN,不使用 ReLU,避免加和之后的特征皆为正,保持特征的多样性。

    (3) 跳层连接:两种情况,当模块输入和残差支路(1×1->3×3->1×1)的通道数一致时,直接相加;当两者通道不一致时(一般发生在分辨率降低之后,同分辨率一般通道数一致),需要对模块输入特征使用 1 ×1 卷积进行升 / 降维(步长为 2,上面说了分辨率会降低),之后同样接 BN,不用 ReLU。

def conv3x3(in_planes, out_planes, stride=1):
    """3x3 convolution with padding"""
    return nn.Conv2d(in_planes, out_planes, kernel_size=3, stride=stride,
                     padding=1, bias=False)


class BasicBlock(nn.Module):
    expansion = 1

    def __init__(self, inplanes, planes, stride=1, downsample=None):
        super(BasicBlock, self).__init__()
        self.conv1 = conv3x3(inplanes, planes, stride)
        self.bn1 = nn.BatchNorm2d(planes, momentum=BN_MOMENTUM)
        self.relu = nn.ReLU(inplace=True)
        self.conv2 = conv3x3(planes, planes)
        self.bn2 = nn.BatchNorm2d(planes, momentum=BN_MOMENTUM)
        self.downsample = downsample
        self.stride = stride

    def forward(self, x):
        residual = x

        out = self.conv1(x)
        out = self.bn1(out)
        out = self.relu(out)

        out = self.conv2(out)
        out = self.bn2(out)

        if self.downsample is not None:
            residual = self.downsample(x)

        out += residual
        out = self.relu(out)

        return out


class Bottleneck(nn.Module):
    expansion = 4

    def __init__(self, inplanes, planes, stride=1, downsample=None):
        super(Bottleneck, self).__init__()
        self.conv1 = nn.Conv2d(inplanes, planes, kernel_size=1, bias=False)
        self.bn1 = nn.BatchNorm2d(planes, momentum=BN_MOMENTUM)
        self.conv2 = nn.Conv2d(planes, planes, kernel_size=3, stride=stride,
                               padding=1, bias=False)
        self.bn2 = nn.BatchNorm2d(planes, momentum=BN_MOMENTUM)
        self.conv3 = nn.Conv2d(planes, planes * self.expansion, kernel_size=1,
                               bias=False)
        self.bn3 = nn.BatchNorm2d(planes * self.expansion,
                                  momentum=BN_MOMENTUM)
        self.relu = nn.ReLU(inplace=True)
        self.downsample = downsample
        self.stride = stride

    def forward(self, x):
        residual = x

        out = self.conv1(x)
        out = self.bn1(out)
        out = self.relu(out)

        out = self.conv2(out)
        out = self.bn2(out)
        out = self.relu(out)

        out = self.conv3(out)
        out = self.bn3(out)

        if self.downsample is not None:
            residual = self.downsample(x)

        out += residual
        out = self.relu(out)

        return out

4.2 HighResolutionModule (高分辨率模块)

当仅包含一个分支时,生成该分支,没有融合模块,直接返回;当包含不仅一个分支时,先将对应分支的输入特征输入到对应分支,得到对应分支的输出特征;紧接着执行融合模块。

  • (a) _check_branches: 判断num_branches (int)num_blocks, num_inchannels, num_channels (list) 三者的长度是否一致,否则报错;
  • (b) _make_one_branch: 搭建一个分支,单个分支内部分辨率相等,一个分支由 num_blocks[branch_index] 个 block 组成,block 可以是两种 ResNet 模块中的一种;

    • (1) 首先判断是否降维或者输入输出的通道 (num_inchannels[branch_index] 和 num_channels[branch_index] * block.expansion(通道扩张率))是否一致,不一致使用 1z1 卷积进行维度升 / 降,后接 BN,不使用 ReLU;
    • (2) 顺序搭建 num_blocks[branch_index] 个 block,第一个 block 需要考虑是否降维的情况,所以单独拿出来,后面 1 到 num_blocks[branch_index] 个 block 完全一致,使用循环搭建就行。此时注意在执行完第一个 block 后将 num_inchannels[branch_index 重新赋值为 num_channels[branch_index] * block.expansion
  • (c) _make_branches: 循环调用 _make_one_branch 函数创建多个分支;
  • (d) _make_fuse_layers:

    • (1) 如果分支数等于 1,返回 None,说明此事不需要使用融合模块;
    • (2) 双层循环:for i in range(num_branches if self.multi_scale_output else 1):的作用是,如果需要产生多分辨率的结果,就双层循环 num_branches 次,如果只需要产生最高分辨率的表示,就将 i 确定为 0。

      • (2.1) 如果 j > i,此时的目标是将所有分支上采样到和i 分支相同的分辨率并融合,也就是说 j 所代表的分支分辨率比 i 分支低,2**(j-i)表示 j 分支上采样这么多倍才能和 i 分支分辨率相同。先使用 1 ×1 卷积将 j 分支的通道数变得和 i 分支一致,进而跟着 BN,然后依据上采样因子将 j 分支分辨率上采样到和 i 分支分辨率相同,此处使用最近邻插值;

      • (2.2) 如果j = i,也就是说自身与自身之间不需要融合,nothing to do;
      • (2.3) 如果 j < i,转换角色,此时最终目标是将所有分支采样到和i 分支相同的分辨率并融合,注意,此时 j 所代表的分支分辨率比 i 分支高,正好和 (2.1) 相反。此时再次内嵌了一个循环,这层循环的作用是当 i-j > 1 时,也就是说两个分支的分辨率差了不止二倍,此时还是两倍两倍往上采样,例如 i-j = 2 时,j分支的分辨率比 i 分支大 4 倍,就需要上采样两次,循环次数就是 2;

        • (2.3.1) 当 k == i - j - 1 时,举个例子,i = 2,j = 1, 此时仅循环一次,并采用当前模块,此时直接将 j 分支使用 3 ×3 的步长为 2 的卷积下采样(不使用 bias),后接 BN,不使用 ReLU;

        • (2.3.2) 当 k != i - j - 1 时,举个例子,i = 3,j = 1, 此时循环两次,先采用当前模块,将 j 分支使用 3 ×3 的步长为 2 的卷积下采样 (不使用 bias) 两倍,后接 BN 和 ReLU,紧跟着再使用 (2.3.1) 中的模块,这是为了保证最后一次二倍下采样的卷积操作不使用 ReLU,猜测也是为了保证融合后特征的多样性;

  • (e) forward: 前向传播函数,利用以上函数的功能搭建一个HighResolutionModule

    • (1) 当仅包含一个分支时,生成该分支,没有融合模块,直接返回;
    • (2) 当包含不仅一个分支时,先将对应分支的输入特征输入到对应分支,得到对应分支的输出特征;紧接着执行融合模块;

      • (2.1) 循环将对应分支的输入特征输入到对应分支模型中,得到对应分支的输出特征;
      • (2.2) 融合模块:对着这张图看,很容易看懂。每次多尺度之间的加法运算都是从最上面的尺度开始往下加,所以 y = x[0] if i == 0 else self.fuse_layers[i][0](x[0]);加到他自己的时候,不需要经过融合函数的处理,直接加,所以if i == j: y = y + x[j];遇到不是最上面的尺度那个特征图或者它本身相同分辨率的那个特征图时,需要经过融合函数处理再加,所以y = y + self.fuse_layers[i][j](x[j])。最后将 ReLU 激活后的融合(加法) 特征 append 到 x_fusex_fuse 的长度等于1(单尺度输出)或者num_branches(多尺度输出)。

class HighResolutionModule(nn.Module):
    def __init__(self, num_branches, blocks, num_blocks, num_inchannels,
                 num_channels, fuse_method, multi_scale_output=True):
        super(HighResolutionModule, self).__init__()
        self._check_branches(num_branches, blocks, num_blocks, num_inchannels, num_channels)

        self.num_inchannels = num_inchannels
        self.fuse_method = fuse_method
        self.num_branches = num_branches

        self.multi_scale_output = multi_scale_output

        self.branches = self._make_branches(num_branches, blocks, num_blocks, num_channels)
        self.fuse_layers = self._make_fuse_layers()
        self.relu = nn.ReLU(True)

    def _check_branches(self, num_branches, blocks, num_blocks,
                        num_inchannels, num_channels):
        if num_branches != len(num_blocks):
            error_msg = 'NUM_BRANCHES({}) <> NUM_BLOCKS({})'.format(num_branches, len(num_blocks))
            logger.error(error_msg)
            raise ValueError(error_msg)

        if num_branches != len(num_channels):
            error_msg = 'NUM_BRANCHES({}) <> NUM_CHANNELS({})'.format(num_branches, len(num_channels))
            logger.error(error_msg)
            raise ValueError(error_msg)

        if num_branches != len(num_inchannels):
            error_msg = 'NUM_BRANCHES({}) <> NUM_INCHANNELS({})'.format(num_branches, len(num_inchannels))
            logger.error(error_msg)
            raise ValueError(error_msg)

    def _make_one_branch(self, branch_index, block, num_blocks, num_channels,
                         stride=1):
        # ---------------------------(1) begin---------------------------- #
        downsample = None
        if stride != 1 or \
           self.num_inchannels[branch_index] != num_channels[branch_index] * block.expansion:
            downsample = nn.Sequential(
                nn.Conv2d(self.num_inchannels[branch_index],
                    num_channels[branch_index] * block.expansion,
                    kernel_size=1, stride=stride, bias=False
                ),
                nn.BatchNorm2d(num_channels[branch_index] * block.expansion,
                    momentum=BN_MOMENTUM
                ),
            )
        # ---------------------------(1) end---------------------------- #
        
        # ---------------------------(2) begin---------------------------- #
        layers = []
        layers.append(
            block(self.num_inchannels[branch_index],
                num_channels[branch_index],
                stride,
                downsample
            )
        )
        # ---------------------------(2) middle---------------------------- #
        self.num_inchannels[branch_index] = num_channels[branch_index] * block.expansion
        for i in range(1, num_blocks[branch_index]):
            layers.append(
                block(self.num_inchannels[branch_index],
                    num_channels[branch_index]
                )
            )
        # ---------------------------(2) end---------------------------- #
        return nn.Sequential(*layers)

    def _make_branches(self, num_branches, block, num_blocks, num_channels):
        branches = []

        for i in range(num_branches):
            branches.append(self._make_one_branch(i, block, num_blocks, num_channels)
            )

        return nn.ModuleList(branches)

    def _make_fuse_layers(self):
        # ---------------------------(1) begin---------------------------- #
        if self.num_branches == 1:
            return None
        # ---------------------------(1) end---------------------------- #

        
        num_branches = self.num_branches
        num_inchannels = self.num_inchannels
        # ---------------------------(2) begin---------------------------- #
        fuse_layers = []
        for i in range(num_branches if self.multi_scale_output else 1):
            fuse_layer = []
            for j in range(num_branches):
                # ---------------------------(2.1) begin---------------------------- #
                if j > i:
                    fuse_layer.append(
                        nn.Sequential(
                            nn.Conv2d(num_inchannels[j],
                                num_inchannels[i],
                                1, 1, 0, bias=False
                            ),
                            nn.BatchNorm2d(num_inchannels[i]),
                            nn.Upsample(scale_factor=2**(j-i), mode='nearest')
                        )
                    )
                # ---------------------------(2.1) end---------------------------- #
                
                # ---------------------------(2.2) begin---------------------------- #
                elif j == i:
                    fuse_layer.append(None)
                # ---------------------------(2.2) end---------------------------- #
                
                # ---------------------------(2.3) begin---------------------------- #
                else:
                    conv3x3s = []
                    for k in range(i-j):
                        # ---------------------------(2.3.1) begin---------------------------- #
                        if k == i - j - 1:
                            num_outchannels_conv3x3 = num_inchannels[i]
                            conv3x3s.append(
                                nn.Sequential(
                                    nn.Conv2d(num_inchannels[j],
                                        num_outchannels_conv3x3,
                                        3, 2, 1, bias=False
                                    ),
                                    nn.BatchNorm2d(num_outchannels_conv3x3)
                                )
                            )
                        # ---------------------------(2.3.1) end---------------------------- #
                        
                        # ---------------------------(2.3.1) begin---------------------------- #
                        else:
                            num_outchannels_conv3x3 = num_inchannels[j]
                            conv3x3s.append(
                                nn.Sequential(
                                    nn.Conv2d(num_inchannels[j],
                                        num_outchannels_conv3x3,
                                        3, 2, 1, bias=False
                                    ),
                                    nn.BatchNorm2d(num_outchannels_conv3x3),
                                    nn.ReLU(True)
                                )
                            )
                        # ---------------------------(2.3.1) end---------------------------- #
                    # ---------------------------(2.3) end---------------------------- #
                    fuse_layer.append(nn.Sequential(*conv3x3s))
            fuse_layers.append(nn.ModuleList(fuse_layer))
            # ---------------------------(2) end---------------------------- #

        return nn.ModuleList(fuse_layers)

    def get_num_inchannels(self):
        return self.num_inchannels

    def forward(self, x):
        # ---------------------------(1) begin---------------------------- #
        if self.num_branches == 1:
            return [self.branches[0](x[0])]
        # ---------------------------(1) end---------------------------- #

        # ---------------------------(2) begin---------------------------- #
        # ---------------------------(2.1) begin---------------------------- #
        for i in range(self.num_branches):
            x[i] = self.branches[i](x[i])
        # ---------------------------(2.1) end---------------------------- #

        # ---------------------------(2.2) begin---------------------------- #
        x_fuse = []

        for i in range(len(self.fuse_layers)):
            y = x[0] if i == 0 else self.fuse_layers[i][0](x[0])
            for j in range(1, self.num_branches):
                if i == j:
                    y = y + x[j]
                else:
                    y = y + self.fuse_layers[i][j](x[j])
            x_fuse.append(self.relu(y))
        # ---------------------------(2.2) end---------------------------- #
        # ---------------------------(2) end---------------------------- #

        return x_fuse

正文完
 0