Skip to content
Panoramic Annular Semantic Segmentation
Jupyter Notebook Python
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Panoramic Annular Semantic Segmentation

Panoramic Annular Semantic Segmentation in PyTorch

PASS Dataset


New! Google Drive Download Link


For Validation (Most important files):

Unfolded Panoramas for Validation, (400 images)

Annonations, (400 annotation images)


There are 400 panoramas with annotations. Please use the Annotations data for evaluation.

In total, there are 1050 panoramas. Complete Panoramas:

All Unfolded Panoramas

RAW Panoramas: RAW1, RAW2, RAW3

Example segmentation


For instructions please refer to the README on each folder:

  • train contains tools for training the network for semantic segmentation.
  • eval contains tools for evaluating/visualizing the network's output for panoramic annular semantic segmentation.
  • trained_models Contains the trained ERF-PSPNet and ERF-APSPNet models.

CODE Requirements:

  • Dataset (I suggest using Mapillary Vistas or Cityscpaes as training datasets. For evaluation, semantic segmentation on PASS, VISTAS or Cityscapes datasets can be tested using this code.) The Dataset shoudld be structured as the dataset folder indicates.
  • Python 3.6: If you don't have Python3.6 in your system, I suggest installing it with Anaconda.
  • PyTorch: Make sure to install the Pytorch version for Python 3.6 with CUDA support (code tested for CUDA 8.0, CUDA 9.0 and CUDA 10.0). I am using PyTorch 0.4.1.
  • Additional Python packages: numpy, matplotlib, Pillow, torchvision and visdom (optional for --visualize flag)

In Anaconda you can install with:

conda install numpy matplotlib torchvision Pillow
conda install -c conda-forge visdom

If you use Pip (make sure to have it configured for Python3.6) you can install with:

pip install numpy matplotlib torchvision Pillow visdom


If you use our code or dataset, please consider referencing any of the following papers:

PASS: Panoramic Annular Semantic Segmentation. K. Yang, X. Hu, L.M. Bergasa, E. Romera, K. Wang. IEEE Transactions on Intelligent Transportation Systems, September 2019. [PDF]

Can we PASS beyond the Field of View? Panoramic Annular Semantic Segmentation for Real-World Surrounding Perception. K. Yang, X. Hu, L.M. Bergasa, E. Romera, X. Huang, D. Sun, K. Wang. In IEEE Intelligent Vehicles Symposium (IV), Paris, France, June 2019, pp. 446-453. [PDF] [VIDEO]

You can’t perform that action at this time.