crfseg 0.1.2

PyTorch implementation of conditional random field for multiclass semantic segmenation.

crfseg: CRF layer for segmentation in PyTorch

Conditional random field (CRF) is a classical graphical model which allows to make structured predictions in such tasks as image semantic segmentation or sequence labeling.

You can learn about it in papers:

• Efficient Inference in Fully Connected CRFs with Gaussian Edge Potentials
• Conditional Random Fields as Recurrent Neural Networks

Installation

pip install crfseg

Usage

Can be easily used as differentiable (and moreover learnable) postprocessing layer of your NN for segmentation. It is adaptive to a number of input's spatial dimensions.

import torch
from crfseg import MeanFieldCRF

model = nn.Sequential(
    nn.Identity(),  # your foken awesome NN
    MeanFieldCRF()
)

batch_size, n_channels, spatial = 10, 1, (100, 100)
x = torch.zeros((batch_size, n_channels, *spatial))
log_proba = model(x)