Add exporting docs (#940)

docs/reference/cli/index.md

@@ -14,6 +14,7 @@ Here are the popular commands that we offer. If you've cloned the repo, you can
 | ns-train         | Generate a NeRF                        | scripts/train.py                   |
 | ns-eval          | Run evaluation metrics for your Model  | scripts/eval.py                    |
 | ns-render        | Render out a video of your NeRF        | scripts/render.py                  |
+| ns-export        | Export a NeRF into other formats       | scripts/exporter.py                |
 
 ```{toctree}
 :maxdepth: 1
@@ -23,5 +24,6 @@ ns_process_data
 ns_download_data
 ns_train
 ns_render
+ns_export
 ns_eval
 ```

docs/reference/cli/ns_export.md

@@ -0,0 +1,9 @@
+# ns-export
+
+```{eval-rst}
+.. argparse::
+    :module: scripts.exporter
+    :func: get_parser_fn
+    :prog: ns-export
+    :nodefault:
+```

scripts/exporter.py

@@ -31,7 +31,7 @@ class Exporter:
 
 @dataclass
 class ExportPointCloud(Exporter):
-    """Class to export meshes with the poisson algorithm."""
+    """Export NeRF as a point cloud."""
 
     num_points: int = 1000000
     """Number of points to generate. May result in less if outlier removal is used."""
@@ -84,7 +84,10 @@ class ExportPointCloud(Exporter):
 
 @dataclass
 class ExportTSDFMesh(Exporter):
-    """Class to export meshes with the poisson algorithm."""
+    """
+    NOT YET IMPLEMENTED
+    Export a mesh using TSDF processing.
+    """
 
     def main(self) -> None:
         """Export mesh"""
@@ -93,7 +96,10 @@ class ExportTSDFMesh(Exporter):
 
 @dataclass
 class ExportPoissonMesh(Exporter):
-    """Exports a mesh using poisson mesh reconstruction."""
+    """
+    NOT YET IMPLEMENTED
+    Export a mesh using poisson surface reconstruction.
+    """
 
     def main(self) -> None:
         """Export mesh"""
@@ -102,7 +108,10 @@ class ExportPoissonMesh(Exporter):
 
 @dataclass
 class ExportMarchingCubesMesh(Exporter):
-    """Exports a mesh using marching cubes."""
+    """
+    NOT YET IMPLEMENTED
+    Export a mesh using marching cubes.
+    """
 
     def main(self) -> None:
         """Export mesh"""
@@ -125,3 +134,6 @@ def entrypoint():
 
 if __name__ == "__main__":
     entrypoint()
+
+# For sphinx docs
+get_parser_fn = lambda: tyro.extras.get_parser(Commands)  # noqa