"graphbolt/src/cuda/insubgraph.hip" did not exist on "3795a006b91c94291b911f0daa261c0598d7ffd8"
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
Before running those example scripts, please check the script about which dataset it is needed, and download
Ruilong Li(李瑞龙)'s avatar
Ruilong Li(李瑞龙) committed
18
19
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
```