mirror of
https://github.com/nerfstudio-project/nerfstudio.git
synced 2026-11-16 21:03:46 +08:00
Update 360 docs (#1593)
* Update 360 docs * Update custom_dataset.md * Update custom_dataset.md
This commit is contained in:
1 parent
2b8d5a9e5c
commit
1b18b44d81
2 files changed
+10
-4
No files matched your search
@@ -15,6 +15,7 @@ We Currently support the following custom data types:
|
||||
| ----------------------------- | -------------- | ----------------------------------------------- | ----------------------- |
|
||||
| 📷 [Images](images_and_video) | Any | [COLMAP](https://colmap.github.io/install.html) | 🐢 |
|
||||
| 📹 [Video](images_and_video) | Any | [COLMAP](https://colmap.github.io/install.html) | 🐢 |
|
||||
| 🌎 [360 Data](360_data) | Any | [COLMAP](https://colmap.github.io/install.html) | 🐢 |
|
||||
| 📱 [Polycam](polycam) | IOS with LiDAR | [Polycam App](https://poly.cam/) | 🐇 |
|
||||
| 📱 [KIRI Engine](kiri) | IOS or Android | [KIRI Engine App](https://www.kiriengine.com/) | 🐇 |
|
||||
| 📱 [Record3D](record3d) | IOS with LiDAR | [Record3D app](https://record3d.app/) | 🐇 |
|
||||
@@ -291,11 +292,14 @@ ns-process-data metashape --data {data directory} --xml {xml file} --output-dir
|
||||
ns-train nerfacto --data {output directory}
|
||||
```
|
||||
|
||||
## Equirectangular data
|
||||
(360_data)=
|
||||
|
||||
## 360 Data (Equirectangular)
|
||||
|
||||
Equirectangular data is data that has been taken by a 360 camera such as Insta360. Both equirectangular image sets and videos can be processed by nerfstudio.
|
||||
|
||||
### Images
|
||||
|
||||
For a set of equirectangular images, process the data using the following command:
|
||||
|
||||
```bash
|
||||
@@ -305,20 +309,21 @@ ns-process-data images --camera-type equirectangular --images-per-equirect {8, o
|
||||
The images-per-equirect argument is the number of images that will be sampled from each equirectangular image. We have found that 8 images per equirectangular image is sufficient for most use cases so it defaults to that. However, if you find that there isn't enough detail in the nerf or that colmap is having trouble aligning the images, you can try increasing the number of images per equirectangular image to 14.
|
||||
|
||||
### Videos
|
||||
For videos we reccomend taking a video with the camera held on top of your head. This will result in any unwanted capturer to just be in the bottom of each frame image and therefore can be cropped out.
|
||||
|
||||
For videos we recommend taking a video with the camera held on top of your head. This will result in any unwanted capturer to just be in the bottom of each frame image and therefore can be cropped out.
|
||||
|
||||
For a video, process the data using the following command:
|
||||
|
||||
```bash
|
||||
ns-process-data video --camera-type equirectangular --images-per-equirect {8, or 14} --num-frames-target {num equirectangular frames to sample from} --crop-factor {top bottom left right} --data {data directory} --output-dir {output directory}
|
||||
```
|
||||
|
||||
See the equirectangular images section above for a description of the `--images-per-equirect` argument.
|
||||
|
||||
The `num-frames-target` argument is optional but it is recomended to set it to 3*(seconds of video) frames. For example, if you have a 30 second video, you would use `--num-frames-target 90` (3*30=90). This number was chosen from a bit of experimentation and seems to work well for most videos. It is by no means a hard rule and you can experiment with different values.
|
||||
The `num-frames-target` argument is optional but it is recommended to set it to 3*(seconds of video) frames. For example, if you have a 30 second video, you would use `--num-frames-target 90` (3*30=90). This number was chosen from a bit of experimentation and seems to work well for most videos. It is by no means a hard rule and you can experiment with different values.
|
||||
|
||||
The `crop-factor` argument is optional but often very helpful. This is because equirectangular videos taken by 360 cameras tend to have a portion of the bottom of the image that is the person who was holding the camera over their head.
|
||||
|
||||
<img src="imgs/equirect_crop.jpg">
|
||||
|
||||
This obscene mesh of human is obviously not helpful in training a nerf so we can remove it by cropping the bottom 20% of the image. This can be done by using the `--crop-factor 0 0.2 0 0` argument.
|
||||
|
||||
Reference in new issue
Block a user