Skip to content

Latest commit

 

History

History
63 lines (37 loc) · 2.71 KB

README.md

File metadata and controls

63 lines (37 loc) · 2.71 KB
Raw

GeoNet - PyTorch version

This codebase recreates the Rigid Flow Reconstructor of the following paper:

GeoNet: Unsupervised Learning of Dense Depth, Optical Flow, and Camera Pose (CVPR 2018)

Zhichao Yin and Jianping Shi (SenseTime Research)

The official TensorFlow implementation can be found here.

This repository contains the code corresponding to train_rigid=True in the original paper, i.e. for reconstructing rigid flow to train depth and pose.

Requirements

This codebase was tested using PyTorch 1.0.0, CUDA 9.0, Python 3.6 in Ubuntu 18.04 LTS.

You can install the following packages using pip:

torch >= 1.0.0
numpy
argparse
imageio
opencv-python
tensorboardX==1.7

Data Preparation

Follow the instructions given in the official repo for KITTI to download the training and testing datasets.

For evaluation, you will have to insert a gt_depth.npy file in the folder models/gt_data This ground truth depth file can be found here. You are also welcome to use your own depth file - it's just a python list of depth maps for the KITTI testing dataset.

Running

You can specify the parameters is_train, ckpt_dir, data_dir, test_dir, graphs_dir, models_dir, and outputs_dir in the bash file or through the command line.

Further information can be found in GeoNet_main.py.

To train DepthNet and PoseNet: bash run.sh

To test and evaluate depth: python3 test_disp.py

Results

Training has only been done for depth.

Loss and image warping visualizations can be visualized using tensorboardX, for which functionality has been implemented.

The current code achieves an absolute relative error of 0.173 on KITTI with an SfmLearner VGG backbone for the DepthNet and same hyperparameters as the original paper. These results have been achieved without experimenting with the random seed. I expect that doing so will result in matching with the result of the paper.

The original paper reports an absolute relative error of 0.164.

Contributing

There are a number of things which can be added:

  • Adding a function to test pose (since the pose network is already trained)
  • The ResFlowNet for the NonRigid Motion Localizer can be implemented.

Acknowledgements

The DepthNet and some utility functions were taken from Clement Pinard's implementation of SFMLearner in PyTorch. I have followed a similar file hierarchy as specified in this unnoficial implementation.