zhangshuo32 / s-nerf

S-NeRF: Neural Radiance Fields for Street Views

[Project] [Paper]

We introduce S-NeRF, a robust system to synthesizing large unbounded street views for autonomous driving using Neural Radiance Fields (NeRFs). This project aims to enhance the realism and accuracy of street view synthesis and improve the robustness of NeRFs for real-world applications. (e.g. autonomous driving simulation, robotics, and augmented reality)

Key Features

• Large-scale Street View Synthesis: S-NeRF is able to synthesize large-scale street views with high fidelity and accuracy.

• Improved Realism and Accuracy: S-NeRF significantly improves the realism and accuracy of specular reflections and street view synthesis.

• Robust Geometry and Reprojection: By utilizing noisy and sparse LiDAR points, S-NeRF learns a robust geometry and reprojection based confidence to address the depth outliers.

• Foreground Moving Vehicles: S-NeRF extends its capabilities for reconstructing moving vehicles, a task that is impracticable for conventional NeRFs.

Model Pipline Overview

Demo

TODOs

• Env Installation
• Pose Preparation Scripts
• Depth & Flow Preparation Scripts
• Code for training and testing
• Foreground Vehicle Reconstruction
• Pretrained models (Demo Scenes)

Installation

Create a conda environment:

conda create -n S-NeRF python=3.8 
conda activate S-NeRF

Install predependents:

pip install "git+https://github.com/facebookresearch/pytorch3d.git@stable"

Install the required packages:

pip install -r requiremnets.txt

Data Preparation

1. Prepare Dataset according to the following file tree

data/
├── nuScenes/
│   ├── mini/
│   └── trainval/
└── waymo/
└── scenes/

2. Put scene name and its token in scene_dict.json

{
    "scene-0916": "325cef682f064c55a255f2625c533b75",
    ...
}

2. Prepare the poses, images and depth in S-NeRF format

• nuScenes

python scripts/nuscenes_preprocess.py 
       --version [v1.0-mini / v1.0-trainval] \
       --dataroot ./data/<YOUR DATASET ROOT> \

• Waymo

python scripts/waymo_preprocess.py

3. Prepare the depth data
   Put the first smaple token of the scene in ./data/depth/sample_tokens.txt
   Then follow the Depth Preparation Instruction

Training Snerf

cd s-nerf
python train.py --config [CONFIG FILE]

Citation

If you find this work useful, please cite:

@inproceedings{ziyang2023snerf,
author = {Xie, Ziyang and Zhang, Junge and Li, Wenye and Zhang, Feihu and Zhang, Li},
title = {S-NeRF: Neural Radiance Fields for Street Views},
booktitle = {ICLR 2023},
year = {2023}
}