index.rst 1.64 KB
Newer Older
Ruilong Li's avatar
Ruilong Li committed
1
NerfAcc Documentation
Ruilong Li(李瑞龙)'s avatar
Ruilong Li(李瑞龙) committed
2
===================================
Ruilong Li(李瑞龙)'s avatar
Ruilong Li(李瑞龙) committed
3

Ruilong Li's avatar
Ruilong Li committed
4
NerfAcc is a PyTorch NeRF acceleration toolbox for both training and inference. 
Ruilong Li's avatar
docs  
Ruilong Li committed
5

Ruilong Li's avatar
Ruilong Li committed
6
Using NerfAcc, 
Ruilong Li's avatar
docs  
Ruilong Li committed
7

Ruilong Li's avatar
Ruilong Li committed
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
- The `vanilla Nerf model`_ with 8-layer MLPs can be trained in **45 minutes** \
  rather than **1~2 days** as in the paper.
- The `instant-ngp Nerf model`_ can be trained to **better quality** (+~1.0 PNSR) \
  in **5 minutes** compare to the paper, and all the training code is in **Python**.
- The `D-Nerf model`_ for **dynamic** objects can also be trained in **45 minutes** \
  rather than **2 days** as in the paper, and with **better quality** (+~2.0 PSNR).
- **Unbounded scenes** from `MipNerf360`_ can be trained in \
  **~1 hour** and get comparable quality to the paper.

And it is pure python interface with flexible apis for any customized Nerf models!

Note:
   This repo is focusing on the single scene situation. Generalizable Nerfs across \
   multiple scenes is currently out of the scope of this repo. But you may still find
   some useful tricks in this repo. :)
Ruilong Li's avatar
docs  
Ruilong Li committed
23

Ruilong Li(李瑞龙)'s avatar
Ruilong Li(李瑞龙) committed
24
25
26
27
28
29
30
31
32
33
Installation:
-------------

.. code-block:: console

   $ pip install nerfacc

.. toctree::
   :glob:
   :maxdepth: 1
34
   :caption: Python API
Ruilong Li(李瑞龙)'s avatar
Ruilong Li(李瑞龙) committed
35

36
   apis/*
Ruilong Li(李瑞龙)'s avatar
Ruilong Li(李瑞龙) committed
37
38
39
40

.. toctree::
   :glob:
   :maxdepth: 1
41
   :caption: Example Usages
Ruilong Li(李瑞龙)'s avatar
Ruilong Li(李瑞龙) committed
42

43
   examples/*
Ruilong Li's avatar
docs  
Ruilong Li committed
44
45

.. toctree::
Ruilong Li(李瑞龙)'s avatar
Ruilong Li(李瑞龙) committed
46
47
   :maxdepth: 1
   :caption: Projects
Ruilong Li's avatar
docs  
Ruilong Li committed
48

Ruilong Li(李瑞龙)'s avatar
Ruilong Li(李瑞龙) committed
49
   NeRFactory <https://plenoptix-nerfactory.readthedocs-hosted.com/>
Ruilong Li's avatar
Ruilong Li committed
50
51
52
53
54
55
56


.. _`vanilla NeRF model`: https://arxiv.org/abs/2003.08934
.. _`instant-ngp NeRF model`: https://arxiv.org/abs/2103.13497
.. _`D-Nerf model`: https://arxiv.org/abs/2104.00677
.. _`MipNerf360`: https://arxiv.org/abs/2111.12077
.. _`pixel-Nerf`: https://arxiv.org/abs/2012.02190