Update docs (#244)

* Update docs

* black

docs/models/nerf.md

@@ -52,6 +52,6 @@ How we sample the rays in space is an important design decision.
 
 | Implementation                                                                    |    Mic    | Ficus     |   Chair   | Hotdog    | Materials | Drums     | Ship      | Lego      | Average   |
 | --------------------------------------------------------------------------------- | :-------: | --------- | :-------: | --------- | --------- | --------- | --------- | --------- | --------- |
-| nerfactory                                                                        |   34.28   | **30.63** | **36.16** | 36.49     | 28.36     | **25.44** | 28.69     | **33.67** | **31.71** |
+| nerfactory                                                                        |   33.76   | **31.98** | **34.35** | 36.57     | **31.00** | **25.11** | 29.87     | **34.46** | **32.14** |
 | [TF NeRF](https://github.com/bmild/nerf)                                          |   32.91   | 30.13     |   33.00   | 36.18     | 29.62     | 25.01     | 28.65     | 32.54     | 31.04     |
-| [JaxNeRF](https://github.com/google-research/google-research/tree/master/jaxnerf) | **34.53** | 30.43     |   34.08   | **36.92** | **29.91** | 25.03     | **29.36** | 33.28     | 31.69     |
+| [JaxNeRF](https://github.com/google-research/google-research/tree/master/jaxnerf) | **34.53** | 30.43     |   34.08   | **36.92** | 29.91     | 25.03     | **29.36** | 33.28     | 31.69     |

docs/notebooks/index.rst

@@ -7,8 +7,8 @@ Components
     :maxdepth: 1
 
     visualize_cameras.ipynb
-    visualize_samplers.ipynb
     visualize_samples.ipynb
+    visualize_samplers.ipynb
     visualize_spatial_distortions.ipynb
     visualize_encoders.ipynb
     

scripts/docs/build_docs.py

@@ -19,8 +19,12 @@ def run_command(command: str) -> None:
         sys.exit(1)
 
 
-def main():
-    """Run the github actions locally."""
+def main(clean_cache: bool = False):
+    """Run the github actions locally.
+
+    Args:
+        clean_cache: whether to clean the cache before building docs.
+    """
 
     print_green = lambda x: print(f"\033[32m{x}\033[0m")
 
@@ -29,7 +33,10 @@ def main():
 
     # Add checks for building documentation
     print_green("Building Documentation")
-    run_command("cd docs/; make html SPHINXOPTS='-W;'")
+    if clean_cache:
+        run_command("cd docs/; make clean; make html SPHINXOPTS='-W;'")
+    else:
+        run_command("cd docs/; make html SPHINXOPTS='-W;'")
 
     print("\n")
     print_green("=" * 100)