diff --git a/README.md b/README.md
index 1ef998da1..e65b62336 100644
--- a/README.md
+++ b/README.md
@@ -41,8 +41,8 @@
- [Supported Features](#supported-features)
- [See what's possible](#see-whats-possible)
-
# Philosophy
+
All-in-one repository for state-of-the-art NeRFs.
Nerfactory provides a simple API that allows for a seamless and simplified end-to-end process of creating, training, and visualizing NeRFs. The library supports a **more interpretable implementation of NeRFs by modularizing each component**. With more modular NeRFs, not only does your code become far more user-friendly, but using this framework also makes it easier for the community to build upon your implementation.
@@ -64,52 +64,44 @@ For more complex changes (e.g. running with your own data/ setting up a new NeRF
This repository is tested with CUDA 11.3. Make sure to install [Conda](https://docs.conda.io/en/latest/miniconda.html#linux-installers) before preceding.
-
-Installing Conda
-
-This step is fairly self-explanatory, but here are the basic steps. You can also find countless tutorials online.
-
-```
-cd /path/to/install/miniconda
-
-mkdir -p miniconda3
-wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh -O miniconda3/miniconda.sh
-bash miniconda3/miniconda.sh -b -u -p miniconda3
-rm -rf miniconda/miniconda.sh
-```
-
Create the python environment
+
```
conda create --name nerfactory python=3.8.13
conda activate nerfactory
+python -m pip install --upgrade pip
```
Clone the repo
+
```
git clone git@github.com:plenoptix/nerfactory.git
-cd nerfactory
```
Install dependencies and nerfactory as a library
+
```
-python -m pip install --upgrade pip
+cd nerfactory
pip install -e .
```
Install tiny-cuda-nn (tcnn) to run instant_ngp
+
```
pip install torch==1.12.1+cu113 torchvision==0.13.1+cu113 -f https://download.pytorch.org/whl/torch_stable.html
pip install git+https://github.com/NVlabs/tiny-cuda-nn/#subdirectory=bindings/torch
```
Experimental: install tab completion for nerfactory (bash & zsh)
+
```
python scripts/completions/configure.py install
```
Run the test cases
+
```
pytest tests
```
@@ -210,18 +202,18 @@ python scripts/run_eval.py render-trajectory --load-config=outputs/blender_lego/
For a more in-depth tutorial on how to modify/implement your own NeRF Graph, please see our [walk-through](https://plenoptix-nerfactory.readthedocs-hosted.com/en/latest/tutorials/pipelines/index.html).
-
# Learn More
-| Section | Description |
-|-|-|
-| [Documentation](https://plenoptix-nerfactory.readthedocs-hosted.com/en/latest/) | Full API documentation and tutorials |
-| [Interactive Guides](https://plenoptix-nerfactory.readthedocs-hosted.com/en/latest/guides/index.html) | Go-to spot for learning how NeRFs and each of its modules work.
-| [Quick tour](https://plenoptix-nerfactory.readthedocs-hosted.com/en/latest/tutorials/quickstart_index.html) | Example script on how to navigate Nerfactory from install, train, to test.
-| [Creating pipelines](https://plenoptix-nerfactory.readthedocs-hosted.com/en/latest/tutorials/pipelines/index.html) | Learn how to easily build new neural rendering pipelines by using and/or implementing new modules.
-| [Creating datsets](https://plenoptix-nerfactory.readthedocs-hosted.com/en/latest/tutorials/data/index.html) | Have a new dataset? Learn how to use it with Nerfactory.
-| [Mobile Capture to NerF](#) | Step-by-step tutorial on how to create beautiful renders with just your phone.
-| [Contributing](https://plenoptix-nerfactory.readthedocs-hosted.com/en/latest/reference/contributing.html) | Walk-through for how you can start contributing now.
-| [Slack](https://join.slack.com/t/nerfactory/shared_invite/zt-1fwqsgjgl-OE0VUJWSPtlVtbC5YXKZrg) | Join our community to discuss more. We would love to hear from you!
+
+| Section | Description |
+| ------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------- |
+| [Documentation](https://plenoptix-nerfactory.readthedocs-hosted.com/en/latest/) | Full API documentation and tutorials |
+| [Interactive Guides](https://plenoptix-nerfactory.readthedocs-hosted.com/en/latest/guides/index.html) | Go-to spot for learning how NeRFs and each of its modules work. |
+| [Quick tour](https://plenoptix-nerfactory.readthedocs-hosted.com/en/latest/tutorials/quickstart_index.html) | Example script on how to navigate Nerfactory from install, train, to test. |
+| [Creating pipelines](https://plenoptix-nerfactory.readthedocs-hosted.com/en/latest/tutorials/pipelines/index.html) | Learn how to easily build new neural rendering pipelines by using and/or implementing new modules. |
+| [Creating datsets](https://plenoptix-nerfactory.readthedocs-hosted.com/en/latest/tutorials/data/index.html) | Have a new dataset? Learn how to use it with Nerfactory. |
+| [Mobile Capture to NerF](#) | Step-by-step tutorial on how to create beautiful renders with just your phone. |
+| [Contributing](https://plenoptix-nerfactory.readthedocs-hosted.com/en/latest/reference/contributing.html) | Walk-through for how you can start contributing now. |
+| [Slack](https://join.slack.com/t/nerfactory/shared_invite/zt-1fwqsgjgl-OE0VUJWSPtlVtbC5YXKZrg) | Join our community to discuss more. We would love to hear from you! |
# Supported Features
@@ -229,16 +221,16 @@ We provide the following support strucutures to make life easier for getting sta
**If you are looking for a feature that is not currently supported, please do not hesitate to contact the Plenoptix team!**
-* :mag_right: Web-based visualizer that allows you to:
- * Visualize training in real-time + interact with the scene
- * Create and render out scenes with custom camera trajectories
- * View different output types
- * And more!
-* :pencil2: Support for multiple logging interfaces (Tensorboard, Wandb), code profiling, and other built-in debugging tools
-* :chart_with_upwards_trend: Easy-to-use benchmarking scripts on the Blender dataset
-* :iphone: Full pipeline support (w/ Colmap or Record3D) for going from a video on your phone to a full 3D render. Follow our step-by-step tutorial. (TODO: walk-through page on end-to-end pipeline from capture -> render)
-
+- :mag_right: Web-based visualizer that allows you to:
+ - Visualize training in real-time + interact with the scene
+ - Create and render out scenes with custom camera trajectories
+ - View different output types
+ - And more!
+- :pencil2: Support for multiple logging interfaces (Tensorboard, Wandb), code profiling, and other built-in debugging tools
+- :chart_with_upwards_trend: Easy-to-use benchmarking scripts on the Blender dataset
+- :iphone: Full pipeline support (w/ Colmap or Record3D) for going from a video on your phone to a full 3D render. Follow our step-by-step tutorial. (TODO: walk-through page on end-to-end pipeline from capture -> render)
# See what's possible
+
TODO: insert some gallery stuff here (gifs/pretty pictures w/ visualizer)
TODO: For more see gallery
diff --git a/docs/tutorials/quickstart.md b/docs/tutorials/quickstart.md
index 0ce158f6b..0e71ab9a3 100644
--- a/docs/tutorials/quickstart.md
+++ b/docs/tutorials/quickstart.md
@@ -2,20 +2,6 @@
This repository is tested with CUDA 11.3. Make sure to install [Conda](https://docs.conda.io/en/latest/miniconda.html#linux-installers) before preceding.
-
-Installing Conda
-
-This step is fairly self-explanatory, but here are the basic steps. You can also find countless tutorials online.
-
-```bash
-cd /path/to/install/miniconda
-
-mkdir -p miniconda3
-wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh -O miniconda3/miniconda.sh
-bash miniconda3/miniconda.sh -b -u -p miniconda3
-rm -rf miniconda/miniconda.sh
-```
-
Create the python environment
@@ -23,19 +9,19 @@ Create the python environment
```bash
conda create --name nerfactory python=3.8.13
conda activate nerfactory
+python -m pip install --upgrade pip
```
Clone the repo
```bash
git clone git@github.com:plenoptix/nerfactory.git
-cd nerfactory
```
Install dependencies and nerfactory as a library
```bash
-python -m pip install --upgrade pip
+cd nerfactory
pip install -e .
```
@@ -50,7 +36,7 @@ Experimental: install tab completion for nerfactory (bash and zsh)
```bash
# If the CLI changes, we can also re-install to synchronize completions
-python scripts/completion/configure.py install
+python scripts/completions/configure.py install
```
# Downloading data
@@ -121,27 +107,31 @@ Please note, this quickstart allows you to preform everything in a headless mann
# FAQ
-* [TinyCUDA installation errors out with cuda mismatch](tiny-cuda-error)
+- [TinyCUDA installation errors out with cuda mismatch](tiny-cuda-error)
(tiny-cuda-error)=
+
#### TinyCUDA installation errors out with cuda mismatch
While installing tiny-cuda, you run into: `The detected CUDA version mismatches the version that was used to compile PyTorch (10.2). Please make sure to use the same CUDA versions.`
**Solution**:
+
```
pip install torch==1.12.1+cu113 torchvision==0.13.1+cu113 -f https://download.pytorch.org/whl/torch_stable.html
```
-* [Installation errors, File "setup.py" not found](pip-install-error)
+- [Installation errors, File "setup.py" not found](pip-install-error)
(pip-install-error)=
+
#### Installation errors, File "setup.py" not found
When installing dependencies and nerfactory with `pip install -e .`, you run into: `ERROR: File "setup.py" not found. Directory cannot be installed in editable mode`
**Solution**:
This can be fixed by upgrading pip to the latest version:
+
```
python -m pip install --upgrade pip
```
diff --git a/nerfactory/configs/base.py b/nerfactory/configs/base.py
index 6bedec042..26a36de7d 100644
--- a/nerfactory/configs/base.py
+++ b/nerfactory/configs/base.py
@@ -117,7 +117,7 @@ class WandbWriterConfig(InstantiateConfig):
"""target class to instantiate"""
enable: bool = False
"""if True enables wandb logging, else disables"""
- relative_log_dir: Path = Path("./wandb")
+ relative_log_dir: Path = Path("./")
"""relative path to save all wandb events"""
log_dir: dcargs.conf.Fixed[Path] = dcargs.MISSING
"""auto-populated absolute path to saved wandb events"""