This is a fork of the surround360 with python binding of the optical flow algorithms used in the system.
The code is modified to be compatible with both opencv3.x and opencv4.x
After installing all the dependencies of surround360-render, run (preferably in a virtual environment)
pip install pybind11 pybind11-cmake
Proceed to build surround360_render and install if necessary. Finally add the newly generated library to your PYTHONPATH as follows,
export PYTHONPATH=$PYTHONPATH:*path_to_SUrround360*/surround360_render/lib
You may want to add this to your .bashrc
Surround360 is a hardware and software system for capturing and rendering 3D (stereo) 360 videos and photos, suitable for viewing in VR. We divide the open source components of the system into three subdirectories:
- /surround360_design -- hardware designs and assembly instructions
- /surround360_camera_ctl_ui -- Linux desktop application for controlling the camera to capture raw data
- /surround360_render -- software for rendering the raw data that is captured into a format suitable for viewing in VR.
Please refer to our instruction manual (which covers use of both hardware and software) here:
We provide a sample dataset for those who are interested in testing the rendering software without first building a camera.
-
"Palace of Fine Arts Take 1" - 2 frames - (337.4MB)
- Raw data: http://surround360.hacktv.xyz/sample/sample_dataset.zip
- Sample result: https://s3-us-west-2.amazonaws.com/surround360/sample/sample_result.zip
- NOTE: The Surround 360 hardware and camera control software records to a RAW binary format which needs to be unpacked to get to the individual images. In this smaller dataset, the 'unpack' and 'arrange' steps of the pipeline have already been run (see run_all.py), so you do not need to run them again.
-
"Facebook Building 20" - 190 frames - (21.15GB)
- Binary file 1: https://s3-us-west-2.amazonaws.com/surround360/github_samples/test/0.bin (10.76GB)
- Binary file 2: https://s3-us-west-2.amazonaws.com/surround360/github_samples/test/1.bin (9.56GB)
- Sample result: https://s3-us-west-2.amazonaws.com/surround360/github_samples/test/render.zip (823.6MB)
- NOTE: the render directory contains calibrated config files and two rendered frames
- The file NOTES.txt contains sample commands to process the binaries
See the CONTRIBUTING file in each subdirectory for how to help out.
The hardware designs, camera control software, and rendering software are subject to different licenses. Please refer to the LICENSE file in each subdirectory. We also provide an additional patent grant.