index.rst 1.63 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
- The `vanilla Nerf model`_ with 8-layer MLPs can be trained to *better quality* (+~1.0 PNSR) \
  in *45 minutes* rather than *1~2 days* as in the paper.
Ruilong Li(李瑞龙)'s avatar
Ruilong Li(李瑞龙) committed
10
11
- The `instant-ngp Nerf model`_ can be trained to *equal quality* with *9/10th* of the training time \
  comparing to the official pure-CUDA implementation.
Ruilong Li's avatar
Ruilong Li committed
12
13
14
15
- 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 also be trained in \
  *~1 hour* and get comparable quality to the paper.
Ruilong Li's avatar
Ruilong Li committed
16

Ruilong Li's avatar
Ruilong Li committed
17
18
19
*And it is pure python interface with flexible apis!*

.. note::
Ruilong Li's avatar
Ruilong Li committed
20
21
22
23

   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
24

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

.. code-block:: console

   $ pip install nerfacc

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

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

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

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

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

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


.. _`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