# PanoBasic

**Repository Path**: vanlemon/PanoBasic

## Basic Information

- **Project Name**: PanoBasic
- **Description**: Matlab Toolbox for Panorama Image Processing
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-03-31
- **Last Updated**: 2024-12-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Toolbox for panorama image processing

This toolbox provides useful functions to process panorama images. Please see **Quick start** below for details.

If using this code as parts of your project, please cite:

Y. Zhang, S. Song, P. Tan, and J. Xiao  
PanoContext: A Whole-room 3D Context Model for Panoramic Scene Understanding  
Proceedings of the 13th European Conference on Computer Vision (ECCV2014)

    @article{zhang2014panocontext,
      title={Panocontext: A whole-room 3d context model for panoramic scene understanding},
      author={Zhang, Yinda and Song, Shuran and Tan, Ping and Xiao, Jianxiong},
      booktitle={European Conference on Computer Vision},
      pages={668--686},
      year={2014},
      organization={Springer}
    }



If you have any question about the code, please feel free to contact:
Yinda Zhang, yindaz at gmail.



## Quick start:
Run `demo_full.m` to see an "almost" complete list of functions in this toolbox. Some (not all) featured functions are:
- Combine perspective images to a panorama.
- Project a region on panorama to a perspective image.
- Line segment detection.
- Color segmentation.
- Find vanishing point.
- Reconstruct 3D cuboid.

For a full list of functions, please see `instruction.pdf`.

## Matterport3D support:
Run `demo_matterport.m` to see how to stitch panorama for Matterport3D dataset. Note that:
- If you wish to have seamless good looking color panorama, you should stitch skybox images.
- If you wish to have aligned color and depth panorama, you should stitch undistorted_color/depth_images.

If you stitch from undistorted_color/depth_images:
- The color panorama from undistorted_color_images may contain visible artifacts near stitching boundaries because of different exposure between images.
- The demo only takes the 6 horizontal views as example, and assumes 60 degrees between each pair of adjacent views. This may not be true in practice, and a perfectly accurate panorama stitching requires accurate calculation of (vx,vy) from camera extrinsic matrices.
- Given more accurate (vx/vy) calculated for upward/downward looking views, you may stitch 18 views together for a more complete panorama.



## FAQ:
Q: Windows users will get an error when calling function "lsdWrap.m".  
A: The Windows command line does not support '/'. Please change all '/' in commands line to '\\' before sending them to "system" function in Matlab.


## License:
This toolbox is under the MIT License: http://opensource.org/licenses/MIT.