mirror of
https://github.com/graphdeco-inria/gaussian-splatting
synced 2025-01-22 18:48:05 +00:00
Merge branch 'main' of https://gitlab.inria.fr/bkerbl/gaussian-splatting
This commit is contained in:
commit
405bb4a9ac
10
README.md
10
README.md
@ -92,7 +92,7 @@ If you can afford the disk space, we recommend using our environment files for s
|
||||
To run the optimizer, simply use
|
||||
|
||||
```shell
|
||||
python train.py -s <path to dataset>
|
||||
python train.py -s <path to COLMAP or NeRF Synthetic dataset>
|
||||
```
|
||||
|
||||
<details>
|
||||
@ -168,7 +168,7 @@ The MipNeRF360 scenes are hosted by the paper authors [here](https://jonbarron.i
|
||||
### Evaluation
|
||||
By default, the trained models use all available images in the dataset. To train them while withholding a test set for evaluation, use the ```--eval``` flag. This way, you can render training/test sets and produce error metrics as follows:
|
||||
```shell
|
||||
python train.py -s <path to dataset> --eval # Train with train/test split
|
||||
python train.py -s <path to COLMAP or NeRF Synthetic dataset> --eval # Train with train/test split
|
||||
python render.py -m <path to trained model> # Generate renderings
|
||||
python metrics.py -m <path to trained model> # Compute error metrics on renderings
|
||||
```
|
||||
@ -262,7 +262,7 @@ We provide two interactive iewers for our method: remote and real-time. Our view
|
||||
- 7zip (only on Windows)
|
||||
|
||||
### Pre-built Windows Binaries
|
||||
We provide pre-build binaries for Windows [here](https://repo-sam.inria.fr/fungraph/3d-gaussian-splatting/binaries/viewers.zip). We recommend using them on Windows for an efficient setup, since the building of SIBR involves several external dependencies that must be downloaded and compiled on-the-fly.
|
||||
We provide pre-built binaries for Windows [here](https://repo-sam.inria.fr/fungraph/3d-gaussian-splatting/binaries/viewers.zip). We recommend using them on Windows for an efficient setup, since the building of SIBR involves several external dependencies that must be downloaded and compiled on-the-fly.
|
||||
|
||||
### Installation from Source
|
||||
If you cloned with submodules (e.g., using ```--recursive```), the source code for the viewers is found in ```SIBR_viewers_(windows|linux)``` (choose whichever fits your OS). The network viewer runs within the SIBR framework for Image-based Rendering applications.
|
||||
@ -291,14 +291,14 @@ cmake --build build --target install
|
||||
The SIBR interface provides several methods of navigating the scene. By default, you will be started with an FPS navigator, which you can control with ```W, A, S, D``` for camera translation and ```Q, E, I, K, J, L``` for rotation. Alternatively, you may want to use a Trackball-style navigator (select from the floating menu). You can also snap to a camera from the data set with the ```Snap to``` button or find the closest camera with ```Snap to closest```. The floating menues also allow you to change the navigation speed. You can use the ```Scaling Modifier``` to control the size of the displayed Gaussians, or show the initial point cloud.
|
||||
|
||||
### Running the Network Viewer
|
||||
You may run the compiled ```SIBR_remoteGaussian_app[_config]``` either by opening the build in your C++ development IDE or by running the installed app in ```<SIBR install dir>/bin```, e.g.:
|
||||
After extracting or installing the viewers, you may run the compiled ```SIBR_remoteGaussian_app[_config]``` app in ```<SIBR install dir>/bin```, e.g.:
|
||||
```shell
|
||||
./<SIBR install dir>/bin/SIBR_remoteGaussian_app
|
||||
```
|
||||
The network viewer allows you to connect to a running training process on the same or a different machine. If you are training on the same machine and OS, no command line parameters should be required: the optimizer communicates the location of the training data to the network viewer. By default, optimizer and network viewer will try to establish a connection on **localhost** on port **6009**. You can change this behavior by providing matching ```--ip``` and ```--port``` parameters to both the optimizer and the network viewer. If for some reason the path used by the optimizer to find the training data is not reachable by the network viewer (e.g., due to them running on different (virtual) machines), you may specify an override location to the viewer by using ```--path <source path>```.
|
||||
|
||||
### Running the Real-Time Viewer
|
||||
You may run the compiled ```SIBR_gaussianViewer_app[_config]``` either by opening the build in your C++ development IDE or by running the installed app in ```<SIBR install dir>/bin```, e.g.:
|
||||
After extracting or installing the viewers, you may run the compiled ```SIBR_gaussianViewer_app[_config]``` app in ```<SIBR install dir>/bin```, e.g.:
|
||||
```shell
|
||||
./<SIBR install dir>/bin/SIBR_gaussianViewer_app --model-path <path to trained model>
|
||||
```
|
||||
|
@ -1 +1 @@
|
||||
Subproject commit 44184daf8bdbbf66e2f646495c5558734c892eb2
|
||||
Subproject commit c9011d1a328dad59ee2f07afbb13ee1629fcc305
|
Loading…
Reference in New Issue
Block a user