index.rst 1.56 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
- The `vanilla Nerf`_ model with 8-layer MLPs can be trained to *better quality* (+~0.5 PNSR) \
9
  in *1 hour* rather than *1~2 days* as in the paper.
Ruilong Li(李瑞龙)'s avatar
Ruilong Li(李瑞龙) committed
10
- The `Instant-NGP Nerf`_ model can be trained to *equal quality* with *9/10th* of the training time (4.5 minutes) \
Ruilong Li(李瑞龙)'s avatar
Ruilong Li(李瑞龙) committed
11
  comparing to the official pure-CUDA implementation.
Ruilong Li(李瑞龙)'s avatar
Ruilong Li(李瑞龙) committed
12
- The `D-Nerf`_ model for *dynamic* objects can also be trained in *1 hour* \
13
  rather than *2 days* as in the paper, and with *better quality* (+~0.5 PSNR).
Ruilong Li(李瑞龙)'s avatar
Ruilong Li(李瑞龙) committed
14
- Both the *bounded* and *unbounded* scenes are supported.
Ruilong Li's avatar
Ruilong Li committed
15

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

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

   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


Ruilong Li(李瑞龙)'s avatar
Ruilong Li(李瑞龙) committed
52
53
54
.. _`vanilla Nerf`: https://arxiv.org/abs/2003.08934
.. _`Instant-NGP Nerf`: https://arxiv.org/abs/2103.13497
.. _`D-Nerf`: https://arxiv.org/abs/2104.00677
Ruilong Li's avatar
Ruilong Li committed
55
56
.. _`MipNerf360`: https://arxiv.org/abs/2111.12077
.. _`pixel-Nerf`: https://arxiv.org/abs/2012.02190