Reorganize documentation (#631)

restructure_docs
This commit is contained in:
Matthew Tancik authored and GitHub committed 2022-10-03 12:59:46 -07:00
1 parent 5a76b955cd
commit d7c34ca2bd
68 files changed
+87 -148

No files matched your search

+100
View File
@@ -0,0 +1,100 @@
# Using Custom Data
Training model on existing datasets is only so fun. If you would like to train on self captured data you will need to process the data into an existing format. Specifically we need to know the camera poses for each image. [COLMAP](https://github.com/colmap/colmap) is a standard tool for extracting poses. It is possible to use other methods like [SLAM](https://en.wikipedia.org/wiki/Simultaneous_localization_and_mapping) or hardware recorded poses. We intend to add documentation for these other methods in the future.
## nerfstudio dataset
To assist running on custom data we have a script that will process a video or folder of images into a format that is compatible with nerfstudio. We use [COLMAP](https://colmap.github.io) and [FFmpeg](https://ffmpeg.org/download.html) in our data processing script, please have these installed. We have provided a quickstart to installing COLMAP below, FFmpeg can be downloaded from [here](https://ffmpeg.org/download.html)
To process your data run:
```bash
ns-process-data --data FOLDER_OR_VIDEO --output-dir PROCESSED_DATA_DIR
```
A full set of arguments can be found {doc}`here</reference/cli/ns_process_data>`.
:::{admonition} Tip
:class: info
- COLMAP can be finicky. Try your best to capture overlapping, non-blurry images.
:::
### Training on your data
Simply specify that you are using the `nerfstudio` dataparser and point the data directory to your processed data.
```bash
python scripts/train.py instant-ngp nerfstudio-data --pipeline.datamanager.dataparser.data-directory PROCESSED_DATA_DIR
```
### Installing COLMAP
The COLMAP maintainers recommend using VCPKG to install COLAMP. If the following command do not work, please refer to the [COLMAP installation guide](https://colmap.github.io/install.html) for additional installation methods.
::::::{tab-set}
:::::{tab-item} Linux
::::{tab-set}
:::{tab-item} CUDA
```bash
git clone https://github.com/microsoft/vcpkg
cd vcpkg
./bootstrap-vcpkg.sh
./vcpkg install colmap[cuda]:x64-linux
```
:::
:::{tab-item} CPU
```bash
git clone https://github.com/microsoft/vcpkg
cd vcpkg
./bootstrap-vcpkg.sh
./vcpkg install colmap:x64-linux
```
:::
::::
:::::
:::::{tab-item} OSX
```bash
git clone https://github.com/microsoft/vcpkg
cd vcpkg
./bootstrap-vcpkg.sh
./vcpkg install colmap
```
:::::
:::::{tab-item} Windows
::::{tab-set}
:::{tab-item} CUDA
```bash
git clone https://github.com/microsoft/vcpkg
cd vcpkg
./bootstrap-vcpkg.sh
./vcpkg install colmap[cuda]:x64-windows
```
:::
:::{tab-item} CPU
```bash
git clone https://github.com/microsoft/vcpkg
cd vcpkg
./bootstrap-vcpkg.sh
./vcpkg install colmap:x64-windows
```
:::
::::
:::::
::::::