Skip to content

Commit 98d3ebf

Browse files
authored
Update README.md
1 parent cb5ffd8 commit 98d3ebf

File tree

1 file changed

+18
-1
lines changed

1 file changed

+18
-1
lines changed

README.md

Lines changed: 18 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -50,10 +50,17 @@ To optimize a low-res Fern NeRF:
5050
```
5151
python run_nerf.py --config config_fern.txt
5252
```
53+
After 200k iterations (about 15 hours), you should get a video like this at `logs/fern_test/fern_test_spiral_200000_rgb.mp4`:
54+
55+
![ferngif](https://people.eecs.berkeley.edu/~bmild/nerf/fern_200k_256w.gif)
56+
5357
To optimize a low-res Lego NeRF:
5458
```
5559
python run_nerf.py --config config_lego.txt
5660
```
61+
After 200k iterations, you should get a video like this:
62+
63+
![legogif](https://people.eecs.berkeley.edu/~bmild/nerf/lego_200k_256w.gif)
5764

5865
### Rendering a NeRF
5966

@@ -66,4 +73,14 @@ to get a pretrained high-res NeRF for the Fern dataset. Now you can use the `ren
6673

6774
## Generating poses for your own scenes
6875

69-
We recommend using the `imgs2poses.py` script from the [LLFF code](https://github.com/fyusion/llff). Then you can pass the base scene directory into our code using `--datadir <myscene>` along with `-dataset_type llff`. You can take a look at the `config_fern.txt` config file for example settings to use for a forward facing scene.
76+
### Don't have poses?
77+
78+
We recommend using the `imgs2poses.py` script from the [LLFF code](https://github.com/fyusion/llff). Then you can pass the base scene directory into our code using `--datadir <myscene>` along with `-dataset_type llff`. You can take a look at the `config_fern.txt` config file for example settings to use for a forward facing scene. For a spherically captured 360 scene, we recomment adding the `--no_ndc --spherify --lindisp` flags.
79+
80+
### Already have poses!
81+
82+
In `run_nerf.py` and all other code, we use the same pose coordinate system as in [COLMAP](https://colmap.github.io/format.html#images-txt):
83+
84+
> The local camera coordinate system of an image is defined in a way that the X axis points to the right, the Y axis to the bottom, and the Z axis to the front as seen from the image.
85+
86+
Poses are stored as 3x4 numpy arrays (not quaternions) that represent camera-to-world transformation matrices. The other data you will need is simple pinhole camera intrinsics (`hwf = [height, width, focal length]`) and near/far scene bounds. Take a look at [our data loading code](https://github.com/bmild/nerf/blob/master/run_nerf.py#L406) to see more.

0 commit comments

Comments
 (0)