Giter VIP home page Giter VIP logo

torch-nerf's Introduction

torch-NeRF

Overview

Pytorch implementation of NeRF: Representing Scenes as Neural Radiance Fields for View Synthesis (Mildenhall et al., ECCV 2020 Oral, Best Paper Honorable Mention) and its extension to follow-up research projects.

NeRF_Overview
NeRF Overview. Figure from the project page of NeRF: Representing Scenes as Neural Radiance Fields for View Synthesis, Mildenhall et al., ECCV 2020.

Getting Started

To configure the Python virtual environment and install dependencies, open the shell and run the following commands:

# Clone the repository
git clone https://github.com/DveloperY0115/torch-NeRF.git
cd torch-NeRF

# Create virtual environment
virtualenv venv -p=3.8
source venv/bin/activate

# Install dependencies
pip3 install -r requirements.txt

You may use any tools of your preference such as conda. Our code should reproduce the results regardless of which dependency management tool is used as long as the same versions of dependencies are installed.

To download the synthetic dataset for training, issue the following command in the shell:

sh scripts/data/download_example_data.sh

This should create data directory under the project root (torch-NeRF by default) and download datasets provided by the authors of NeRF (ECCV 2020).

The configuration is set for lego scene included in Blender dataset. Executing the following command initiates training:

python torch_nerf/runners/run_train.py

Once a scene representation is learned, you can render it using the script run_render.py under torch_nerf/runners directory. Note that you need to specify the path to the checkpoint file by modifying the yaml file under config/train_params.

The rendering script stores rendered images in render_out directory under the project root. To create a video from the collection of consecutive frames, use the script scripts/utils/create_video.py.

Gallery

NOTE: All images shown below are produced using our code.

Progress

Interesting Topics

torch-nerf's People

Contributors

dvelopery0115 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.