codestella
remove hand
df5c49a
|
raw
history blame
11.5 kB

Putting NeRF on a Diet: Semantically Consistent Few-Shot View Synthesis Implementation

แ„‰แ…ณแ„แ…ณแ„…แ…ตแ†ซแ„‰แ…ฃแ†บ 2021-07-04 แ„‹แ…ฉแ„’แ…ฎ 4 11 51

Welcome to Putting NeRF on a Diet Project! This project is the Pytorch, JAX/Flax based code implementation of this paper [Putting NeRF on a Diet : Ajay Jain, Matthew Tancik, Pieter Abbeel, Arxiv : https://arxiv.org/abs/2104.00677] The model generates the novel view synthesis redering (NeRF: Neural Radiances Field) with Fewshot learning scheme. The semantic loss use the pre-trained CLIP Vision Transformer embedding. This information can give a 2D supervision for 3D. The Diet NeRF result outperforms the original NeRF in 3D reconstruction and neural rendering with only few images.

๐Ÿค— Hugging Face Hub Repo URL:

We will also upload our project on the Hugging Face Hub Repository Also. https://huggingface.co/flax-community/putting-nerf-on-a-diet/

Our JAX/Flax implementation currently supports:

Platform Single-Host GPU Multi-Device TPU
Type Single-Device Multi-Device Single-Host Multi-Host
Training Supported Supported Supported Supported
Evaluation Supported Supported Supported Supported

๐Ÿคฉ Demo

You can check our Streamlit Space demo on following site ! https://huggingface.co/spaces/flax-community/DietNerf-Demo

๐Ÿ’ป Installation

# Clone the repo
svn export https://github.com/google-research/google-research/trunk/jaxnerf
# Create a conda environment, note you can use python 3.6-3.8 as
# one of the dependencies (TensorFlow) hasn't supported python 3.9 yet.
conda create --name jaxnerf python=3.6.12; conda activate jaxnerf
# Prepare pip
conda install pip; pip install --upgrade pip
# Install requirements
pip install -r jaxnerf/requirements.txt
# [Optional] Install GPU and TPU support for Jax
# Remember to change cuda101 to your CUDA version, e.g. cuda110 for CUDA 11.0.
pip install --upgrade jax jaxlib==0.1.57+cuda101 -f https://storage.googleapis.com/jax-releases/jax_releases.html
# install flax and flax-transformer
pip install flax transformer[flax]

โšฝ Dataset

Download the datasets from the NeRF official Google Drive. Please download the nerf_synthetic.zip and unzip them in the place you like. Let's assume they are placed under /tmp/jaxnerf/data/.

๐Ÿ’– Methods

You can check more detail explaination about DietNeRF on following Notion Report

แ„‰แ…ณแ„แ…ณแ„…แ…ตแ†ซแ„‰แ…ฃแ†บ 2021-07-04 แ„‹แ…ฉแ„’แ…ฎ 4 11 51

Based on the principle that โ€œa bulldozer is a bulldozer from any perspectiveโ€, Our proposed DietNeRF supervises the radiance field from arbitrary poses (DietNeRF cameras). This is possible because we compute a semantic consistency loss in a feature space capturing high-level scene attributes, not in pixel space. We extract semantic representations of renderings using the CLIP Vision Transformer, then maximize similarity with representations of ground-truth views. In effect, we use prior knowledge about scene semantics learned by single-view 2D image encoders to constrain a 3D representation.

You can check detail information on the author's paper. Also, you can check the CLIP based semantic loss structure on the following image.

แ„‰แ…ณแ„แ…ณแ„…แ…ตแ†ซแ„‰แ…ฃแ†บ 2021-07-04 แ„‹แ…ฉแ„’แ…ฎ 4 11 51

Our code used JAX/FLAX framework for implementation. So that it can achieve much speed up than other NeRF code. Moreover, we implemented multiple GPU distribution ray code. it helps much smaller training time. At last, our code used hugging face, transformer, CLIP model library.

๐ŸคŸ How to use

python -m train \
  --data_dir=/PATH/TO/YOUR/SCENE/DATA \ % e.g., nerf_synthetic/lego
  --train_dir=/PATH/TO/THE/PLACE/YOU/WANT/TO/SAVE/CHECKPOINTS \
  --config=configs/CONFIG_YOU_LIKE

You can toggle the semantic loss by โ€œuse_semantic_lossโ€ in configuration files.

๐Ÿ’Ž Expriment Result

โ— Rendered Rendering images by 8-shot learned Diet-NeRF

DietNeRF has a strong capacity to generalise on novel and challenging views with EXTREMELY SMALL TRAINING SAMPLES!

CHAIR / HOTDOG / DRUM / LEGO / MATERIALS

โ— Rendered GIF by occluded 14-shot learned NeRF and Diet-NeRF

We made aritificial occulusion on the right side of image (Only picked left side training poses). The reconstruction quality can be compared with this experiment. Diet NeRF shows better quailty than Original NeRF when It is occulused.

Training poses

LEGO

[DietNeRF] [NeRF]

SHIP

[DietNeRF] [NeRF]

๐Ÿ‘จโ€๐Ÿ‘งโ€๐Ÿ‘ฆ Our Teams

Teams Members
Project Managing Stella Yang To Watch Our Project Progress, Please Check Our Project Notion
NeRF Team Stella Yang, Alex Lau, Seunghyun Lee, Hyunkyu Kim, Haswanth Aekula, JaeYoung Chung
CLIP Team Seunghyun Lee, Sasikanth Kotti, Khali Sifullah , Sunghyun Kim
Cloud TPU Team Alex Lau, Aswin Pyakurel , JaeYoung Chung, Sunghyun Kim

๐ŸŒฑ References

This project is based on โ€œJAX-NeRFโ€.

@software{jaxnerf2020github,
  author = {Boyang Deng and Jonathan T. Barron and Pratul P. Srinivasan},
  title = {{JaxNeRF}: an efficient {JAX} implementation of {NeRF}},
  url = {https://github.com/google-research/google-research/tree/master/jaxnerf},
  version = {0.0},
  year = {2020},
}

This project is based on โ€œPutting NeRF on a Dietโ€.

@misc{jain2021putting,
      title={Putting NeRF on a Diet: Semantically Consistent Few-Shot View Synthesis}, 
      author={Ajay Jain and Matthew Tancik and Pieter Abbeel},
      year={2021},
      eprint={2104.00677},
      archivePrefix={arXiv},
      primaryClass={cs.CV}
}

๐Ÿ”‘ License

Apache License 2.0

โค๏ธ Special Thanks

Our Project is started in the HuggingFace X GoogleAI (JAX) Community Week Event. https://discuss.huggingface.co/t/open-to-the-community-community-week-using-jax-flax-for-nlp-cv/7104

Thank you for our mentor Suraj and organizers in JAX/Flax Community Week! Our team grows up with this community learning experience. It was wonderful time!

แ„‰แ…ณแ„แ…ณแ„…แ…ตแ†ซแ„‰แ…ฃแ†บ 2021-07-04 แ„‹แ…ฉแ„’แ…ฎ 4 11 51

Common Computer AI(https://comcom.ai/ko/) sponsored the multiple V100 GPUs for our project! Thank you so much for your support! แ„‰แ…ณแ„แ…ณแ„…แ…ตแ†ซแ„‰แ…ฃแ†บ