README.md 1.47 KB
Newer Older
1
# NerfAcc
Matthew Tancik's avatar
Matthew Tancik committed
2
[![Core Tests.](https://github.com/KAIR-BAIR/nerfacc/actions/workflows/code_checks.yml/badge.svg)](https://github.com/KAIR-BAIR/nerfacc/actions/workflows/code_checks.yml)
3
[![Documentation Status](https://readthedocs.com/projects/plenoptix-nerfacc/badge/?version=latest)](https://www.nerfacc.com/en/latest/?badge=latest)
Ruilong Li's avatar
readme  
Ruilong Li committed
4

5
https://www.nerfacc.com/
Ruilong Li(李瑞龙)'s avatar
Ruilong Li(李瑞龙) committed
6

Sara Fridovich-Keil's avatar
Sara Fridovich-Keil committed
7
This is a **tiny** toolbox  for **accelerating** NeRF training & rendering using PyTorch CUDA extensions. Plug-and-play for most of the NeRFs!
Ruilong Li's avatar
readme  
Ruilong Li committed
8

9
10
11
12
13
14
## Installation

```
pip install nerfacc
```

Ruilong Li(李瑞龙)'s avatar
Ruilong Li(李瑞龙) committed
15
## Examples: 
Ruilong Li's avatar
readme  
Ruilong Li committed
16

Ruilong Li(李瑞龙)'s avatar
Ruilong Li(李瑞龙) committed
17
18
19
Note: Before running those example scripts, please check in the script which dataset it is needed, and download
the dataset first.

Ruilong Li's avatar
Ruilong Li committed
20
``` bash
21
22
# Instant-NGP NeRF in 4.5 minutes.
# See results at here: https://www.nerfacc.com/en/latest/examples/ngp.html
Ruilong Li(李瑞龙)'s avatar
Ruilong Li(李瑞龙) committed
23
python examples/train_ngp_nerf.py --train_split trainval --scene lego
Ruilong Li's avatar
readme  
Ruilong Li committed
24
25
```

Ruilong Li's avatar
Ruilong Li committed
26
``` bash
27
28
# Vanilla MLP NeRF in 1 hour.
# See results at here: https://www.nerfacc.com/en/latest/examples/vanilla.html
Ruilong Li(李瑞龙)'s avatar
Ruilong Li(李瑞龙) committed
29
python examples/train_mlp_nerf.py --train_split train --scene lego
Ruilong Li's avatar
Ruilong Li committed
30
31
```

Ruilong Li(李瑞龙)'s avatar
Ruilong Li(李瑞龙) committed
32
```bash
33
34
# T-NeRF for Dynamic objects in 1 hour.
# See results at here: https://www.nerfacc.com/en/latest/examples/dnerf.html
Ruilong Li(李瑞龙)'s avatar
Ruilong Li(李瑞龙) committed
35
python examples/train_mlp_dnerf.py --train_split train --scene lego
36
37
```

Ruilong Li(李瑞龙)'s avatar
Ruilong Li(李瑞龙) committed
38
```bash
39
40
# Unbounded scene in 1 hour.
# See results at here: https://www.nerfacc.com/en/latest/examples/unbounded.html
Ruilong Li(李瑞龙)'s avatar
Ruilong Li(李瑞龙) committed
41
python examples/train_ngp_nerf.py --train_split train --scene garden --auto_aabb --unbounded --cone_angle=0.004
Ruilong Li(李瑞龙)'s avatar
Ruilong Li(李瑞龙) committed
42
```