mirror of
https://github.com/open-mmlab/mmsegmentation.git
synced 2025-06-03 22:03:48 +08:00
e458a467d6
Thanks for your contribution and we appreciate it a lot. The following instructions would make your pull request more healthy and more easily get feedback. If you do not understand some items, don't worry, just make the pull request and seek help from maintainers. ## Motivation Support CAT-Seg open-vocabulary semantic segmentation (CVPR2023). ## Modification Support CAT-Seg open-vocabulary semantic segmentation (CVPR2023). - [x] Support CAT-Seg model training. - [x] CLIP model based `backbone` (R101 & Swin-B), aggregation layers based `neck`, and `decoder` head. - [x] Provide customized coco-stuff164k_384x384 training configs. - [x] Language model supports for `open vocabulary` (OV) tasks. - [x] Support CLIP-based pretrained language model (LM) inference. - [x] Add commonly used prompts templates. - [x] Add README tutorials. - [x] Add zero-shot testing scripts. **Working on the following tasks.** - [x] Add unit test. ## BC-breaking (Optional) Does the modification introduce changes that break the backward-compatibility of the downstream repos? If so, please describe how it breaks the compatibility and how the downstream projects should modify their code to keep compatibility with this PR. ## Use cases (Optional) If this PR introduces a new feature, it is better to list some use cases here, and update the documentation. ## Checklist 1. Pre-commit or other linting tools are used to fix the potential lint issues. 2. The modification is covered by complete unit tests. If not, please add more unit test to ensure the correctness. 3. If the modification has potential influence on downstream projects, this PR should be tested with downstream projects, like MMDet or MMDet3D. 4. The documentation has been modified accordingly, like docstring or example tutorials. --------- Co-authored-by: xiexinch <xiexinch@outlook.com>
117 lines
4.0 KiB
Python
117 lines
4.0 KiB
Python
# Copyright (c) OpenMMLab. All rights reserved.
|
|
import torch
|
|
import torch.nn as nn
|
|
from mmcv.cnn import ConvModule
|
|
|
|
from mmseg.models.decode_heads.decode_head import BaseDecodeHead
|
|
from mmseg.registry import MODELS
|
|
|
|
|
|
class UpBlock(nn.Module):
|
|
"""Upsample Block with two consecutive convolution layers."""
|
|
|
|
def __init__(self, in_channels, out_channels, guidance_channels):
|
|
super().__init__()
|
|
self.up = nn.ConvTranspose2d(
|
|
in_channels,
|
|
in_channels - guidance_channels,
|
|
kernel_size=2,
|
|
stride=2)
|
|
self.conv1 = ConvModule(
|
|
in_channels,
|
|
out_channels,
|
|
3,
|
|
padding=1,
|
|
bias=False,
|
|
norm_cfg=dict(type='GN', num_groups=out_channels // 16))
|
|
self.conv2 = ConvModule(
|
|
out_channels,
|
|
out_channels,
|
|
3,
|
|
padding=1,
|
|
bias=False,
|
|
norm_cfg=dict(type='GN', num_groups=out_channels // 16))
|
|
|
|
def forward(self, x, guidance=None):
|
|
"""Forward function with visual guidance."""
|
|
x = self.up(x)
|
|
if guidance is not None:
|
|
T = x.size(0) // guidance.size(0)
|
|
# guidance = repeat(guidance, "B C H W -> (B T) C H W", T=T)
|
|
guidance = guidance.repeat(T, 1, 1, 1)
|
|
x = torch.cat([x, guidance], dim=1)
|
|
x = self.conv1(x)
|
|
|
|
return self.conv2(x)
|
|
|
|
|
|
@MODELS.register_module()
|
|
class CATSegHead(BaseDecodeHead):
|
|
"""CATSeg Head.
|
|
|
|
This segmentation head is the mmseg implementation of
|
|
`CAT-Seg <https://arxiv.org/abs/2303.11797>`_.
|
|
|
|
Args:
|
|
embed_dims (int): The number of input dimensions.
|
|
decoder_dims (list): The number of decoder dimensions.
|
|
decoder_guidance_proj_dims (list): The number of appearance
|
|
guidance dimensions.
|
|
init_cfg
|
|
"""
|
|
|
|
def __init__(self,
|
|
embed_dims=128,
|
|
decoder_dims=(64, 32),
|
|
decoder_guidance_dims=(256, 128),
|
|
decoder_guidance_proj_dims=(32, 16),
|
|
**kwargs):
|
|
super().__init__(**kwargs)
|
|
self.decoder_guidance_projection = nn.ModuleList([
|
|
nn.Sequential(
|
|
nn.Conv2d(
|
|
dec_dims,
|
|
dec_dims_proj,
|
|
kernel_size=3,
|
|
stride=1,
|
|
padding=1),
|
|
nn.ReLU(),
|
|
) for dec_dims, dec_dims_proj in zip(decoder_guidance_dims,
|
|
decoder_guidance_proj_dims)
|
|
]) if decoder_guidance_dims[0] > 0 else None
|
|
|
|
self.decoder1 = UpBlock(embed_dims, decoder_dims[0],
|
|
decoder_guidance_proj_dims[0])
|
|
self.decoder2 = UpBlock(decoder_dims[0], decoder_dims[1],
|
|
decoder_guidance_proj_dims[1])
|
|
self.conv_seg = nn.Conv2d(
|
|
decoder_dims[1], 1, kernel_size=3, stride=1, padding=1)
|
|
|
|
def forward(self, inputs):
|
|
"""Forward function.
|
|
|
|
Args:
|
|
inputs (dict): Input features including the following features,
|
|
corr_embed: aggregated correlation embeddings.
|
|
appearance_feats: decoder appearance feature guidance.
|
|
"""
|
|
# decoder guidance projection
|
|
if self.decoder_guidance_projection is not None:
|
|
projected_decoder_guidance = [
|
|
proj(g) for proj, g in zip(self.decoder_guidance_projection,
|
|
inputs['appearance_feats'])
|
|
]
|
|
|
|
# decoder layers
|
|
B = inputs['corr_embed'].size(0)
|
|
corr_embed = inputs['corr_embed'].transpose(1, 2).flatten(0, 1)
|
|
corr_embed = self.decoder1(corr_embed, projected_decoder_guidance[0])
|
|
corr_embed = self.decoder2(corr_embed, projected_decoder_guidance[1])
|
|
|
|
output = self.cls_seg(corr_embed)
|
|
|
|
# rearrange the output to (B, T, H, W)
|
|
H_ori, W_ori = output.shape[-2:]
|
|
output = output.reshape(B, -1, H_ori, W_ori)
|
|
return output
|