From f9fa26accf8e154b72fa721df583f557dcd329e5 Mon Sep 17 00:00:00 2001 From: Alexander Kristoffersen Date: Sat, 29 Oct 2022 14:30:03 -0700 Subject: [PATCH 01/68] New Colab Added to README and Docs (#848) * readme and doc updated. * added readme button. --- README.md | 4 ++++ docs/_static/imgs/readme_colab.png | Bin 0 -> 10033 bytes docs/quickstart/google_colab.md | 2 +- 3 files changed, 5 insertions(+), 1 deletion(-) create mode 100644 docs/_static/imgs/readme_colab.png diff --git a/README.md b/README.md index 966ceea5e..1a26e4baa 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,10 @@

+ + + Nerfstudio Colab Documentation Status diff --git a/docs/_static/imgs/readme_colab.png b/docs/_static/imgs/readme_colab.png new file mode 100644 index 0000000000000000000000000000000000000000..2ba11d76896aebe6920c4831b8b389539461d437 GIT binary patch literal 10033 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 literal 0 HcmV?d00001 diff --git a/docs/quickstart/google_colab.md b/docs/quickstart/google_colab.md index b086e5e59..f953d7f63 100644 --- a/docs/quickstart/google_colab.md +++ b/docs/quickstart/google_colab.md @@ -1,3 +1,3 @@ # Google Colab -Nerfstudio works in Google Colab using their hosted GPUs! Here is [the link](https://colab.research.google.com/drive/1l-QDYEcv759kUNJQrJ8z1CI8o1iIiU-l?usp=sharing). Make a copy of this file and go from there! +Nerfstudio works in Google Colab using their hosted GPUs! Here is [the link](https://colab.research.google.com/drive/13ZUOVo9N4fjZcoS_R9N0BsYa2kV6ywuq?usp=sharing). Make a copy of this file and go from there! From 225fd763391d2ea640982f8fc81fb3b1cb62ca39 Mon Sep 17 00:00:00 2001 From: Alexander Kristoffersen Date: Sat, 29 Oct 2022 14:41:12 -0700 Subject: [PATCH 02/68] Hotfix: add button to master readme (#849) --- README.md | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 1a26e4baa..7e80bcfd9 100644 --- a/README.md +++ b/README.md @@ -1,10 +1,6 @@

- - - Nerfstudio Colab Documentation Status @@ -46,6 +42,9 @@ viewer + + colab +

From 6b1251f094de4b039360f56068d93bb7ea3e2382 Mon Sep 17 00:00:00 2001 From: Matthew Tancik Date: Sun, 30 Oct 2022 01:49:57 +0300 Subject: [PATCH 03/68] Add github pypi publish action (#850) --- .github/workflows/publish.yml | 31 +++++++++++++++++++++++++++++++ README.md | 4 ++++ 2 files changed, 35 insertions(+) create mode 100644 .github/workflows/publish.yml diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml new file mode 100644 index 000000000..b75984535 --- /dev/null +++ b/.github/workflows/publish.yml @@ -0,0 +1,31 @@ +# This workflows will upload a Python Package using twine when a release is created +# For more information see: https://help.github.com/en/actions/language-and-framework-guides/using-python-with-github-actions#publishing-to-package-registries + +name: Upload Python Package + +on: + release: + types: [created] + +jobs: + deploy: + runs-on: ubuntu-latest + + steps: + - uses: actions/checkout@v2 + - name: Set up Python + uses: actions/setup-python@v1 + with: + python-version: '3.8' + - name: Install dependencies + run: | + python -m pip install build twine + - name: Strip unsupported tags in README + run: | + sed -i '//,//d' README.md + - name: Build and publish + env: + PYPI_TOKEN: ${{ secrets.PYPI_TOKEN }} + run: | + python -m build + twine upload --username __token__ --password $PYPI_TOKEN dist/* diff --git a/README.md b/README.md index 7e80bcfd9..21162926b 100644 --- a/README.md +++ b/README.md @@ -21,11 +21,15 @@

+ + nerfstudio + +

From 5b157b851d59e61972e143c423a643055aa5e9fa Mon Sep 17 00:00:00 2001 From: Matthew Tancik Date: Sun, 30 Oct 2022 02:14:11 +0300 Subject: [PATCH 04/68] Add option to render frames (#851) --- scripts/render.py | 26 +++++++++++++++++++------- 1 file changed, 19 insertions(+), 7 deletions(-) diff --git a/scripts/render.py b/scripts/render.py index b37d7dfdb..b852a8cf2 100644 --- a/scripts/render.py +++ b/scripts/render.py @@ -41,6 +41,7 @@ def _render_trajectory_video( rendered_output_name: str, rendered_resolution_scaling_factor: float = 1.0, seconds: float = 5.0, + output_format: Literal["images", "video"] = "video", ) -> None: """Helper function to create a video of the spiral trajectory. @@ -50,7 +51,8 @@ def _render_trajectory_video( output_filename: Name of the output file. rendered_output_name: Name of the renderer output to use. rendered_resolution_scaling_factor: Scaling factor to apply to the camera image resolution. - seconds: Number for the output video. + seconds: Length of output video. + output_format: How to save output data. """ CONSOLE.print("[bold green]Creating trajectory video") images = [] @@ -63,6 +65,9 @@ def _render_trajectory_video( ItersPerSecColumn(suffix="fps"), TimeRemainingColumn(elapsed_when_finished=True, compact=True), ) + output_image_dir = output_filename.parent / output_filename.stem + if output_format == "images": + output_image_dir.mkdir(parents=True, exist_ok=True) with progress: for camera_idx in progress.track(range(cameras.size), description=""): camera_ray_bundle = cameras.generate_rays(camera_indices=camera_idx).to(pipeline.device) @@ -74,13 +79,17 @@ def _render_trajectory_video( CONSOLE.print(f"Please set --rendered_output_name to one of: {outputs.keys()}", justify="center") sys.exit(1) image = outputs[rendered_output_name].cpu().numpy() - images.append(image) + if output_format == "images": + media.write_image(output_image_dir / f"{camera_idx:05d}.png", image) + else: + images.append(image) - fps = len(images) / seconds - # make the folder if it doesn't exist - output_filename.parent.mkdir(parents=True, exist_ok=True) - with CONSOLE.status("[yellow]Saving video", spinner="bouncingBall"): - media.write_video(output_filename, images, fps=fps) + if output_format == "video": + fps = len(images) / seconds + # make the folder if it doesn't exist + output_filename.parent.mkdir(parents=True, exist_ok=True) + with CONSOLE.status("[yellow]Saving video", spinner="bouncingBall"): + media.write_video(output_filename, images, fps=fps) CONSOLE.rule("[green] :tada: :tada: :tada: Success :tada: :tada: :tada:") CONSOLE.print(f"[green]Saved video to {output_filename}", justify="center") @@ -103,6 +112,8 @@ class RenderTrajectory: output_path: Path = Path("renders/output.mp4") # How long the video should be. seconds: float = 5.0 + # How to save output data. + output_format: Literal["images", "video"] = "video" # Specifies number of rays per chunk during eval. eval_num_rays_per_chunk: Optional[int] = None @@ -142,6 +153,7 @@ class RenderTrajectory: rendered_output_name=self.rendered_output_name, rendered_resolution_scaling_factor=1.0 / self.downscale_factor, seconds=seconds, + output_format=self.output_format, ) From 7aa28d0f8d20fc5cd009f82e6814ece094a523ab Mon Sep 17 00:00:00 2001 From: Matthew Tancik Date: Sun, 30 Oct 2022 02:15:39 +0300 Subject: [PATCH 05/68] v0.1.7 (#852) --- pyproject.toml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pyproject.toml b/pyproject.toml index 4e9dee650..85de64ec9 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta" [project] name = "nerfstudio" -version = "0.1.6" +version = "0.1.7" description = "All-in-one repository for state-of-the-art NeRFs" readme = "README.md" license = { text="Apache 2.0"} From a32b2d539124e2dfb7082cf74231a847c96d53c3 Mon Sep 17 00:00:00 2001 From: Matthew Tancik Date: Sun, 30 Oct 2022 09:16:26 -0700 Subject: [PATCH 06/68] Fix ffmpeg call (#856) --- scripts/process_data.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/scripts/process_data.py b/scripts/process_data.py index 0bab86e4a..1b114a782 100755 --- a/scripts/process_data.py +++ b/scripts/process_data.py @@ -223,7 +223,7 @@ def convert_insta360_to_images( else: CONSOLE.print("[bold red]Can't satify requested number of frames. Extracting all frames.") - vf_cmds.append(f"crop=iw*({crop_percentage}):ih*({crop_percentage})") + vf_cmds.append(f"crop=iw*{crop_percentage}:ih*{crop_percentage}") front_vf_cmds = vf_cmds + ["transpose=2"] back_vf_cmds = vf_cmds + ["transpose=1"] From 724ec17d755fad36223f88de09876f859e944468 Mon Sep 17 00:00:00 2001 From: Matthew Tancik Date: Sun, 30 Oct 2022 19:52:24 -0700 Subject: [PATCH 07/68] Fix camera interpolation bug (#858) --- .../viewer/app/src/modules/SidePanel/CameraPanel/curve.js | 3 +++ 1 file changed, 3 insertions(+) diff --git a/nerfstudio/viewer/app/src/modules/SidePanel/CameraPanel/curve.js b/nerfstudio/viewer/app/src/modules/SidePanel/CameraPanel/curve.js index 4a6fa8608..c5cd68676 100644 --- a/nerfstudio/viewer/app/src/modules/SidePanel/CameraPanel/curve.js +++ b/nerfstudio/viewer/app/src/modules/SidePanel/CameraPanel/curve.js @@ -60,6 +60,9 @@ export function get_curve_object_from_cameras( export function get_transform_matrix(position, lookat, up) { // normalize the vectors lookat.normalize(); + // make up orthogonal to lookat + const up_proj = lookat.clone().multiplyScalar(up.dot(lookat)); + up.sub(up_proj); up.normalize(); // create a copy of the vector up From 3cc521d0d64e4faf46f0932645164f9d7a39d3a3 Mon Sep 17 00:00:00 2001 From: Matthew Tancik Date: Mon, 31 Oct 2022 09:30:39 -0700 Subject: [PATCH 08/68] Add colab notebook to repo (#864) * Created using Colaboratory * Update demo.ipynb --- colab/demo.ipynb | 377 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 377 insertions(+) create mode 100644 colab/demo.ipynb diff --git a/colab/demo.ipynb b/colab/demo.ipynb new file mode 100644 index 000000000..86e286caa --- /dev/null +++ b/colab/demo.ipynb @@ -0,0 +1,377 @@ +{ + "nbformat": 4, + "nbformat_minor": 0, + "metadata": { + "colab": { + "provenance": [], + "collapsed_sections": [], + "include_colab_link": true + }, + "kernelspec": { + "name": "python3", + "display_name": "Python 3" + }, + "language_info": { + "name": "python" + }, + "accelerator": "GPU", + "gpuClass": "standard" + }, + "cells": [ + { + "cell_type": "markdown", + "metadata": { + "id": "view-in-github", + "colab_type": "text" + }, + "source": [ + "\"Open" + ] + }, + { + "cell_type": "markdown", + "source": [ + "

\n", + " \n", + " \n", + " \n", + " \"nerfstudio\"\n", + " \n", + "

\n", + "\n", + "\n", + "# Nerfstudio: A collaboration friendly studio for NeRFs\n", + "\n", + "\n", + "![GitHub stars](https://img.shields.io/github/stars/nerfstudio-project/nerfstudio?color=gold&style=social)\n", + "\n", + "This colab shows how to train and view NeRFs from Nerfstudio both on pre-made datasets or from your own videos/images.\n", + "\n", + "\\\\\n", + "\n", + "Credit to [NeX](https://nex-mpi.github.io/) for Google Colab format." + ], + "metadata": { + "id": "SiiXJ7K_fePG" + } + }, + { + "cell_type": "markdown", + "source": [ + "## Frequently Asked Questions\n", + "\n", + "* **Downloading custom data is stalling (no output):**\n", + " * This is a bug in Colab. The data is processing, but may take a while to complete. You will know processing completed if `data/nerfstudio/custom_data/transforms.json` exists.\n", + "* **Training is not showing progress**:\n", + " * The lack of output is a bug in Colab. You can see the training progress from the viewer.\n", + "\n", + "* **Viewer Quality is bad / Low resolution**:\n", + " * This may be because more GPU is being used on training that rendering the viewer. Try pausing training or decreasing training utilization.\n", + "\n", + "* **Other problems?**\n", + " * Feel free to create an issue on our [GitHub repo](https://github.com/nerfstudio-project/nerfstudio).\n" + ], + "metadata": { + "id": "Yyx5h6kz5ga7" + } + }, + { + "cell_type": "code", + "source": [ + "#@title # Install Conda (requires runtime restart) { vertical-output: true, display-mode: \"form\" }\n", + "\n", + "!pip install -q condacolab\n", + "import condacolab\n", + "condacolab.install()" + ], + "metadata": { + "id": "RGr33zHaHak0", + "colab": { + "base_uri": "https://localhost:8080/" + }, + "outputId": "86df0e7f-35fe-4b79-8c0e-83692d42b124" + }, + "execution_count": null, + "outputs": [ + { + "output_type": "stream", + "name": "stdout", + "text": [ + "⏬ Downloading https://github.com/jaimergp/miniforge/releases/latest/download/Mambaforge-colab-Linux-x86_64.sh...\n", + "📦 Installing...\n", + "📌 Adjusting configuration...\n", + "🩹 Patching environment...\n", + "⏲ Done in 0:00:23\n", + "🔁 Restarting kernel...\n" + ] + } + ] + }, + { + "cell_type": "code", + "source": [ + "#@title # Install Nerfstudio and Dependencies (~10 min) { vertical-output: true, display-mode: \"form\" }\n", + "\n", + "%cd /content/\n", + "!pip install --upgrade pip\n", + "!pip install torch==1.12.1+cu113 torchvision==0.13.1+cu113 -f https://download.pytorch.org/whl/torch_stable.html\n", + "\n", + "# Installing TinyCuda\n", + "%cd /content/\n", + "!gdown \"https://drive.google.com/u/1/uc?id=1q8fuc-Mqiev5GTBTRA5UPgCaQDzuqKqj\" \n", + "!pip install tinycudann-1.6-cp37-cp37m-linux_x86_64.whl\n", + "\n", + "# Installing COLMAP\n", + "%cd /content/\n", + "!conda install -c conda-forge colmap\n", + "\n", + "# Install nerfstudio\n", + "%cd /content/\n", + "!pip install nerfstudio" + ], + "metadata": { + "id": "9oyLHl8QfYwP" + }, + "execution_count": null, + "outputs": [] + }, + { + "cell_type": "code", + "source": [ + "#@markdown

Downloading Data

\n", + "#@markdown

Pick the preset scene or upload your own images/video

\n", + "import os\n", + "from google.colab import files\n", + "from IPython.core.display import display, HTML\n", + "\n", + "scene = '\\uD83D\\uDDBC poster' #@param ['🖼 poster', '🚜 dozer', '🌄 desolation', '📤 upload your images' , '🎥 upload your own video']\n", + "scene = ' '.join(scene.split(' ')[1:])\n", + "\n", + "if scene not in ['upload your images', 'upload your own video']:\n", + " %cd /content/\n", + " !ns-download-data --dataset=nerfstudio --capture=$scene\n", + "else:\n", + " display(HTML('

Select your custom data

'))\n", + " display(HTML('

You can select multiple images by pressing ctrl, cmd or shift and click.

'))\n", + " display(HTML('

Note: This may take time, especially on hires inputs, so we recommend to download dataset after creation.

'))\n", + " !mkdir -p /content/data/nerfstudio/custom_data\n", + " if scene == 'upload your images':\n", + " !mkdir -p /content/data/nerfstudio/custom_data/raw_images\n", + " %cd /content/data/nerfstudio/custom_data/raw_images\n", + " uploaded = files.upload()\n", + " dir = os.getcwd()\n", + " else:\n", + " %cd /content/data/nerfstudio/custom_data/\n", + " uploaded = files.upload()\n", + " dir = os.getcwd()\n", + " preupload_datasets = [os.path.join(dir, f) for f in uploaded.keys()]\n", + " del uploaded\n", + " %cd /content/\n", + "\n", + " if scene == 'upload your images':\n", + " !ns-process-data images --data /content/data/nerfstudio/custom_data/raw_images --output-dir /content/data/nerfstudio/custom_data/\n", + " else:\n", + " video_path = preupload_datasets[0]\n", + " !ns-process-data video --data $video_path --output-dir /content/data/nerfstudio/custom_data/\n", + "\n", + " scene = \"custom_data\"" + ], + "metadata": { + "id": "msVLprI4gRA4", + "cellView": "form", + "colab": { + "base_uri": "https://localhost:8080/" + }, + "outputId": "c5eb5997-37d9-4c9f-a3d2-7b67f4b6d346" + }, + "execution_count": null, + "outputs": [ + { + "output_type": "stream", + "name": "stdout", + "text": [ + "/content\n", + "Downloading...\n", + "From: https://drive.google.com/uc?id=1dmjWGXlJnUxwosN6MVooCDQe970PkD-1\n", + "To: /content/data/nerfstudio/poster.zip\n", + "100% 750M/750M [00:03<00:00, 218MB/s]\n", + "\u001b[0m" + ] + } + ] + }, + { + "cell_type": "code", + "source": [ + "#@title # Set Up Viewer\n", + "\n", + "%cd /content\n", + "\n", + "# Install localtunnel\n", + "# We are using localtunnel https://github.com/localtunnel/localtunnel but ngrok could also be used\n", + "!npm install -g localtunnel\n", + "\n", + "# Tunnel port 7007, the default for\n", + "!rm url.txt 2> /dev/null\n", + "get_ipython().system_raw('lt --port 7007 >> url.txt 2>&1 &')" + ], + "metadata": { + "id": "Eju-3p2hjcB2", + "cellView": "form", + "colab": { + "base_uri": "https://localhost:8080/" + }, + "outputId": "c9ff081c-2436-44c6-d292-f22dc3ef78b5" + }, + "execution_count": null, + "outputs": [ + { + "output_type": "stream", + "name": "stdout", + "text": [ + "/content\n", + "\u001b[K\u001b[?25h/tools/node/bin/lt -> /tools/node/lib/node_modules/localtunnel/bin/lt.js\n", + "+ localtunnel@2.0.2\n", + "added 22 packages from 22 contributors in 1.536s\n" + ] + } + ] + }, + { + "cell_type": "code", + "source": [ + "#@title # Start Viewer\n", + "\n", + "with open('url.txt') as f:\n", + " lines = f.readlines()\n", + "websocket_url = lines[0].split(\": \")[1].strip().replace(\"https\", \"wss\")\n", + "# from nerfstudio.utils.io import load_from_json\n", + "# from pathlib import Path\n", + "# json_filename = \"nerfstudio/nerfstudio/viewer/app/package.json\"\n", + "# version = load_from_json(Path(json_filename))[\"version\"]\n", + "url = f\"https://viewer.nerf.studio/?websocket_url={websocket_url}\"\n", + "print(url)\n", + "print(\"You may need to click Refresh Page after you start training!\")\n", + "from IPython import display\n", + "display.IFrame(src=url, height=800, width=\"100%\")" + ], + "metadata": { + "id": "VoKDxqEcjmfC", + "cellView": "form", + "colab": { + "base_uri": "https://localhost:8080/", + "height": 857 + }, + "outputId": "b966821b-7d18-43ee-ceb3-724ac2d0c022" + }, + "execution_count": null, + "outputs": [ + { + "output_type": "stream", + "name": "stdout", + "text": [ + "https://viewer.nerf.studio/?websocket_url=wss://good-ways-ask-34-83-255-230.loca.lt\n", + "You may need to click Refresh Page after you start training!\n" + ] + }, + { + "output_type": "execute_result", + "data": { + "text/plain": [ + "" + ], + "text/html": [ + "\n", + " \n", + " " + ] + }, + "metadata": {}, + "execution_count": 4 + } + ] + }, + { + "cell_type": "code", + "source": [ + "#@title # Start Training { vertical-output: true }\n", + "\n", + "%cd /content\n", + "!ns-train nerfacto --viewer.websocket-port 7007 nerfstudio-data --data data/nerfstudio/$scene --downscale-factor 4" + ], + "metadata": { + "id": "m_N8_cLfjoXD", + "cellView": "form" + }, + "execution_count": null, + "outputs": [] + }, + { + "cell_type": "code", + "source": [ + "#@title # Render Video { vertical-output: true }\n", + "#@markdown

Export the camera path from within the viewer, then run this cell.

\n", + "#@markdown
The rendered video should be at renders/output.mp4!
\n", + "\n", + "\n", + "base_dir = \"/content/outputs/data-nerfstudio-\" + scene + \"/nerfacto/\"\n", + "training_run_dir = base_dir + os.listdir(base_dir)[0]\n", + "\n", + "from IPython.core.display import display, HTML\n", + "display(HTML('

Upload the camera path JSON.

'))\n", + "%cd $training_run_dir\n", + "uploaded = files.upload()\n", + "uploaded_camera_path_filename = list(uploaded.keys())[0]\n", + "\n", + "config_filename = training_run_dir + \"/config.yml\"\n", + "camera_path_filename = training_run_dir + \"/\" + uploaded_camera_path_filename\n", + "camera_path_filename = camera_path_filename.replace(\" \", \"\\\\ \").replace(\"(\", \"\\\\(\").replace(\")\", \"\\\\)\")\n", + "\n", + "%cd /content/\n", + "!ns-render --load-config $config_filename --traj filename --camera-path-filename $camera_path_filename --output-path renders/output.mp4" + ], + "metadata": { + "id": "WGt8ukG6Htg3", + "colab": { + "base_uri": "https://localhost:8080/" + }, + "outputId": "fa946890-c7d8-4e46-a54e-7231bc5a2059", + "cellView": "form" + }, + "execution_count": null, + "outputs": [ + { + "output_type": "stream", + "name": "stdout", + "text": [ + "\u001b[2;36m[19:48:48]\u001b[0m\u001b[2;36m \u001b[0mSkipping \u001b[1;36m0\u001b[0m files in dataset split train. \u001b]8;id=527413;file:///content/nerfstudio/nerfstudio/data/dataparsers/nerfstudio_dataparser.py\u001b\\\u001b[2mnerfstudio_dataparser.py\u001b[0m\u001b]8;;\u001b\\\u001b[2m:\u001b[0m\u001b]8;id=243595;file:///content/nerfstudio/nerfstudio/data/dataparsers/nerfstudio_dataparser.py#91\u001b\\\u001b[2m91\u001b[0m\u001b]8;;\u001b\\\n", + "\u001b[2;36m \u001b[0m\u001b[2;36m \u001b[0mSkipping \u001b[1;36m0\u001b[0m files in dataset split test. \u001b]8;id=109270;file:///content/nerfstudio/nerfstudio/data/dataparsers/nerfstudio_dataparser.py\u001b\\\u001b[2mnerfstudio_dataparser.py\u001b[0m\u001b]8;;\u001b\\\u001b[2m:\u001b[0m\u001b]8;id=464675;file:///content/nerfstudio/nerfstudio/data/dataparsers/nerfstudio_dataparser.py#91\u001b\\\u001b[2m91\u001b[0m\u001b]8;;\u001b\\\n", + "\u001b[2KLoading data batch \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[35m100%\u001b[0m \u001b[36m0:00:00\u001b[0m\n", + "\u001b[?25h/usr/local/lib/python3.7/site-packages/torch/utils/data/dataloader.py:566: UserWarning: This DataLoader will create 4 worker processes in total. Our suggested max number of worker in current system is 2, which is smaller than what this DataLoader is going to create. Please be aware that excessive worker creation might get DataLoader running slow or even freeze, lower the worker number to avoid potential slowness/freeze if necessary.\n", + " cpuset_checked))\n", + "\u001b[2KLoading data batch \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[35m100%\u001b[0m \u001b[36m0:00:00\u001b[0m\n", + "\u001b[?25h/usr/local/lib/python3.7/site-packages/torchvision/models/_utils.py:209: UserWarning: The parameter 'pretrained' is deprecated since 0.13 and will be removed in 0.15, please use 'weights' instead.\n", + " f\"The parameter '{pretrained_param}' is deprecated since 0.13 and will be removed in 0.15, \"\n", + "/usr/local/lib/python3.7/site-packages/torchvision/models/_utils.py:223: UserWarning: Arguments other than a weight enum or `None` for 'weights' are deprecated since 0.13 and will be removed in 0.15. The current behavior is equivalent to passing `weights=AlexNet_Weights.IMAGENET1K_V1`. You can also use `weights=AlexNet_Weights.DEFAULT` to get the most up-to-date weights.\n", + " warnings.warn(msg)\n", + "Loading latest checkpoint from load_dir\n", + "✅ Done loading checkpoint from \n", + "outputs/data-nerfstudio-poster/nerfacto/\u001b[1;36m2022\u001b[0m-\u001b[1;36m10\u001b[0m-29_192844/nerfstudio_models/step-\u001b[1;36m000014000.\u001b[0mckpt\n", + "\u001b[1;32mCreating trajectory video\u001b[0m\n", + "\u001b[2K🎥 Rendering 🎥 \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[35m100%\u001b[0m \u001b[31m0.14 fps\u001b[0m \u001b[33m11:47\u001b[0m\n", + "\u001b[2K\u001b[32m( ● )\u001b[0m \u001b[33mSaving video\u001b[0m\n", + "\u001b[1A\u001b[2K\u001b[92m────────────────────────────────────────────── \u001b[0m\u001b[32m 🎉 🎉 🎉 Success 🎉 🎉 🎉\u001b[0m\u001b[92m ──────────────────────────────────────────────\u001b[0m\n", + " \u001b[32mSaved video to renders/output.mp4\u001b[0m \n", + "\u001b[0m" + ] + } + ] + } + ] +} From b088e230f6749f683c2bf5059cff84155753a32d Mon Sep 17 00:00:00 2001 From: Thomas Wang <24695242+thomasw21@users.noreply.github.com> Date: Mon, 31 Oct 2022 17:30:55 +0100 Subject: [PATCH 09/68] Viewer visualization crashes when using DDP (#863) Setup viewer only in rank 0 --- nerfstudio/engine/trainer.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/nerfstudio/engine/trainer.py b/nerfstudio/engine/trainer.py index 5b9b60c73..a3162ff32 100644 --- a/nerfstudio/engine/trainer.py +++ b/nerfstudio/engine/trainer.py @@ -90,7 +90,7 @@ class Trainer: # set up viewer if enabled viewer_log_path = self.base_dir / config.viewer.relative_log_filename self.viewer_state, banner_messages = None, None - if self.config.is_viewer_enabled(): + if self.config.is_viewer_enabled() and local_rank == 0: self.viewer_state, banner_messages = viewer_utils.setup_viewer(config.viewer, log_filename=viewer_log_path) self._check_viewer_warnings() # set up writers/profilers if enabled From e3e766c5ca11f893444d2f7c04b1b1df8e749c32 Mon Sep 17 00:00:00 2001 From: Matthew Tancik Date: Mon, 31 Oct 2022 10:22:25 -0700 Subject: [PATCH 10/68] Update colab links to use repo colab (#866) --- README.md | 2 +- colab/demo.ipynb | 337 +++++++++++++++-------------- docs/_templates/sidebar/brand.html | 55 +++++ docs/index.md | 1 - docs/quickstart/google_colab.md | 3 - 5 files changed, 228 insertions(+), 170 deletions(-) delete mode 100644 docs/quickstart/google_colab.md diff --git a/README.md b/README.md index 21162926b..532d04eca 100644 --- a/README.md +++ b/README.md @@ -46,7 +46,7 @@ viewer - + colab

diff --git a/colab/demo.ipynb b/colab/demo.ipynb index 86e286caa..1dceefaa6 100644 --- a/colab/demo.ipynb +++ b/colab/demo.ipynb @@ -1,35 +1,20 @@ { - "nbformat": 4, - "nbformat_minor": 0, - "metadata": { - "colab": { - "provenance": [], - "collapsed_sections": [], - "include_colab_link": true - }, - "kernelspec": { - "name": "python3", - "display_name": "Python 3" - }, - "language_info": { - "name": "python" - }, - "accelerator": "GPU", - "gpuClass": "standard" - }, "cells": [ { "cell_type": "markdown", "metadata": { - "id": "view-in-github", - "colab_type": "text" + "colab_type": "text", + "id": "view-in-github" }, "source": [ - "\"Open" + "\"Open" ] }, { "cell_type": "markdown", + "metadata": { + "id": "SiiXJ7K_fePG" + }, "source": [ "

\n", " \n", @@ -50,13 +35,13 @@ "\\\\\n", "\n", "Credit to [NeX](https://nex-mpi.github.io/) for Google Colab format." - ], - "metadata": { - "id": "SiiXJ7K_fePG" - } + ] }, { "cell_type": "markdown", + "metadata": { + "id": "Yyx5h6kz5ga7" + }, "source": [ "## Frequently Asked Questions\n", "\n", @@ -70,32 +55,22 @@ "\n", "* **Other problems?**\n", " * Feel free to create an issue on our [GitHub repo](https://github.com/nerfstudio-project/nerfstudio).\n" - ], - "metadata": { - "id": "Yyx5h6kz5ga7" - } + ] }, { "cell_type": "code", - "source": [ - "#@title # Install Conda (requires runtime restart) { vertical-output: true, display-mode: \"form\" }\n", - "\n", - "!pip install -q condacolab\n", - "import condacolab\n", - "condacolab.install()" - ], + "execution_count": null, "metadata": { - "id": "RGr33zHaHak0", "colab": { "base_uri": "https://localhost:8080/" }, + "id": "RGr33zHaHak0", "outputId": "86df0e7f-35fe-4b79-8c0e-83692d42b124" }, - "execution_count": null, "outputs": [ { - "output_type": "stream", "name": "stdout", + "output_type": "stream", "text": [ "⏬ Downloading https://github.com/jaimergp/miniforge/releases/latest/download/Mambaforge-colab-Linux-x86_64.sh...\n", "📦 Installing...\n", @@ -105,10 +80,22 @@ "🔁 Restarting kernel...\n" ] } + ], + "source": [ + "#@title # Install Conda (requires runtime restart) { vertical-output: true, display-mode: \"form\" }\n", + "\n", + "!pip install -q condacolab\n", + "import condacolab\n", + "condacolab.install()" ] }, { "cell_type": "code", + "execution_count": null, + "metadata": { + "id": "9oyLHl8QfYwP" + }, + "outputs": [], "source": [ "#@title # Install Nerfstudio and Dependencies (~10 min) { vertical-output: true, display-mode: \"form\" }\n", "\n", @@ -128,15 +115,33 @@ "# Install nerfstudio\n", "%cd /content/\n", "!pip install nerfstudio" - ], - "metadata": { - "id": "9oyLHl8QfYwP" - }, - "execution_count": null, - "outputs": [] + ] }, { "cell_type": "code", + "execution_count": null, + "metadata": { + "cellView": "form", + "colab": { + "base_uri": "https://localhost:8080/" + }, + "id": "msVLprI4gRA4", + "outputId": "c5eb5997-37d9-4c9f-a3d2-7b67f4b6d346" + }, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "/content\n", + "Downloading...\n", + "From: https://drive.google.com/uc?id=1dmjWGXlJnUxwosN6MVooCDQe970PkD-1\n", + "To: /content/data/nerfstudio/poster.zip\n", + "100% 750M/750M [00:03<00:00, 218MB/s]\n", + "\u001b[0m" + ] + } + ], "source": [ "#@markdown

Downloading Data

\n", "#@markdown

Pick the preset scene or upload your own images/video

\n", @@ -175,33 +180,31 @@ " !ns-process-data video --data $video_path --output-dir /content/data/nerfstudio/custom_data/\n", "\n", " scene = \"custom_data\"" - ], - "metadata": { - "id": "msVLprI4gRA4", - "cellView": "form", - "colab": { - "base_uri": "https://localhost:8080/" - }, - "outputId": "c5eb5997-37d9-4c9f-a3d2-7b67f4b6d346" - }, - "execution_count": null, - "outputs": [ - { - "output_type": "stream", - "name": "stdout", - "text": [ - "/content\n", - "Downloading...\n", - "From: https://drive.google.com/uc?id=1dmjWGXlJnUxwosN6MVooCDQe970PkD-1\n", - "To: /content/data/nerfstudio/poster.zip\n", - "100% 750M/750M [00:03<00:00, 218MB/s]\n", - "\u001b[0m" - ] - } ] }, { "cell_type": "code", + "execution_count": null, + "metadata": { + "cellView": "form", + "colab": { + "base_uri": "https://localhost:8080/" + }, + "id": "Eju-3p2hjcB2", + "outputId": "c9ff081c-2436-44c6-d292-f22dc3ef78b5" + }, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "/content\n", + "\u001b[K\u001b[?25h/tools/node/bin/lt -> /tools/node/lib/node_modules/localtunnel/bin/lt.js\n", + "+ localtunnel@2.0.2\n", + "added 22 packages from 22 contributors in 1.536s\n" + ] + } + ], "source": [ "#@title # Set Up Viewer\n", "\n", @@ -214,31 +217,51 @@ "# Tunnel port 7007, the default for\n", "!rm url.txt 2> /dev/null\n", "get_ipython().system_raw('lt --port 7007 >> url.txt 2>&1 &')" - ], - "metadata": { - "id": "Eju-3p2hjcB2", - "cellView": "form", - "colab": { - "base_uri": "https://localhost:8080/" - }, - "outputId": "c9ff081c-2436-44c6-d292-f22dc3ef78b5" - }, - "execution_count": null, - "outputs": [ - { - "output_type": "stream", - "name": "stdout", - "text": [ - "/content\n", - "\u001b[K\u001b[?25h/tools/node/bin/lt -> /tools/node/lib/node_modules/localtunnel/bin/lt.js\n", - "+ localtunnel@2.0.2\n", - "added 22 packages from 22 contributors in 1.536s\n" - ] - } ] }, { "cell_type": "code", + "execution_count": null, + "metadata": { + "cellView": "form", + "colab": { + "base_uri": "https://localhost:8080/", + "height": 857 + }, + "id": "VoKDxqEcjmfC", + "outputId": "b966821b-7d18-43ee-ceb3-724ac2d0c022" + }, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "https://viewer.nerf.studio/?websocket_url=wss://good-ways-ask-34-83-255-230.loca.lt\n", + "You may need to click Refresh Page after you start training!\n" + ] + }, + { + "data": { + "text/html": [ + "\n", + " \n", + " " + ], + "text/plain": [ + "" + ] + }, + "execution_count": 4, + "metadata": {}, + "output_type": "execute_result" + } + ], "source": [ "#@title # Start Viewer\n", "\n", @@ -254,101 +277,38 @@ "print(\"You may need to click Refresh Page after you start training!\")\n", "from IPython import display\n", "display.IFrame(src=url, height=800, width=\"100%\")" - ], - "metadata": { - "id": "VoKDxqEcjmfC", - "cellView": "form", - "colab": { - "base_uri": "https://localhost:8080/", - "height": 857 - }, - "outputId": "b966821b-7d18-43ee-ceb3-724ac2d0c022" - }, - "execution_count": null, - "outputs": [ - { - "output_type": "stream", - "name": "stdout", - "text": [ - "https://viewer.nerf.studio/?websocket_url=wss://good-ways-ask-34-83-255-230.loca.lt\n", - "You may need to click Refresh Page after you start training!\n" - ] - }, - { - "output_type": "execute_result", - "data": { - "text/plain": [ - "" - ], - "text/html": [ - "\n", - " \n", - " " - ] - }, - "metadata": {}, - "execution_count": 4 - } ] }, { "cell_type": "code", + "execution_count": null, + "metadata": { + "cellView": "form", + "id": "m_N8_cLfjoXD" + }, + "outputs": [], "source": [ "#@title # Start Training { vertical-output: true }\n", "\n", "%cd /content\n", "!ns-train nerfacto --viewer.websocket-port 7007 nerfstudio-data --data data/nerfstudio/$scene --downscale-factor 4" - ], - "metadata": { - "id": "m_N8_cLfjoXD", - "cellView": "form" - }, - "execution_count": null, - "outputs": [] + ] }, { "cell_type": "code", - "source": [ - "#@title # Render Video { vertical-output: true }\n", - "#@markdown

Export the camera path from within the viewer, then run this cell.

\n", - "#@markdown
The rendered video should be at renders/output.mp4!
\n", - "\n", - "\n", - "base_dir = \"/content/outputs/data-nerfstudio-\" + scene + \"/nerfacto/\"\n", - "training_run_dir = base_dir + os.listdir(base_dir)[0]\n", - "\n", - "from IPython.core.display import display, HTML\n", - "display(HTML('

Upload the camera path JSON.

'))\n", - "%cd $training_run_dir\n", - "uploaded = files.upload()\n", - "uploaded_camera_path_filename = list(uploaded.keys())[0]\n", - "\n", - "config_filename = training_run_dir + \"/config.yml\"\n", - "camera_path_filename = training_run_dir + \"/\" + uploaded_camera_path_filename\n", - "camera_path_filename = camera_path_filename.replace(\" \", \"\\\\ \").replace(\"(\", \"\\\\(\").replace(\")\", \"\\\\)\")\n", - "\n", - "%cd /content/\n", - "!ns-render --load-config $config_filename --traj filename --camera-path-filename $camera_path_filename --output-path renders/output.mp4" - ], + "execution_count": null, "metadata": { - "id": "WGt8ukG6Htg3", + "cellView": "form", "colab": { "base_uri": "https://localhost:8080/" }, - "outputId": "fa946890-c7d8-4e46-a54e-7231bc5a2059", - "cellView": "form" + "id": "WGt8ukG6Htg3", + "outputId": "fa946890-c7d8-4e46-a54e-7231bc5a2059" }, - "execution_count": null, "outputs": [ { - "output_type": "stream", "name": "stdout", + "output_type": "stream", "text": [ "\u001b[2;36m[19:48:48]\u001b[0m\u001b[2;36m \u001b[0mSkipping \u001b[1;36m0\u001b[0m files in dataset split train. \u001b]8;id=527413;file:///content/nerfstudio/nerfstudio/data/dataparsers/nerfstudio_dataparser.py\u001b\\\u001b[2mnerfstudio_dataparser.py\u001b[0m\u001b]8;;\u001b\\\u001b[2m:\u001b[0m\u001b]8;id=243595;file:///content/nerfstudio/nerfstudio/data/dataparsers/nerfstudio_dataparser.py#91\u001b\\\u001b[2m91\u001b[0m\u001b]8;;\u001b\\\n", "\u001b[2;36m \u001b[0m\u001b[2;36m \u001b[0mSkipping \u001b[1;36m0\u001b[0m files in dataset split test. \u001b]8;id=109270;file:///content/nerfstudio/nerfstudio/data/dataparsers/nerfstudio_dataparser.py\u001b\\\u001b[2mnerfstudio_dataparser.py\u001b[0m\u001b]8;;\u001b\\\u001b[2m:\u001b[0m\u001b]8;id=464675;file:///content/nerfstudio/nerfstudio/data/dataparsers/nerfstudio_dataparser.py#91\u001b\\\u001b[2m91\u001b[0m\u001b]8;;\u001b\\\n", @@ -371,7 +331,54 @@ "\u001b[0m" ] } + ], + "source": [ + "#@title # Render Video { vertical-output: true }\n", + "#@markdown

Export the camera path from within the viewer, then run this cell.

\n", + "#@markdown
The rendered video should be at renders/output.mp4!
\n", + "\n", + "\n", + "base_dir = \"/content/outputs/data-nerfstudio-\" + scene + \"/nerfacto/\"\n", + "training_run_dir = base_dir + os.listdir(base_dir)[0]\n", + "\n", + "from IPython.core.display import display, HTML\n", + "display(HTML('

Upload the camera path JSON.

'))\n", + "%cd $training_run_dir\n", + "uploaded = files.upload()\n", + "uploaded_camera_path_filename = list(uploaded.keys())[0]\n", + "\n", + "config_filename = training_run_dir + \"/config.yml\"\n", + "camera_path_filename = training_run_dir + \"/\" + uploaded_camera_path_filename\n", + "camera_path_filename = camera_path_filename.replace(\" \", \"\\\\ \").replace(\"(\", \"\\\\(\").replace(\")\", \"\\\\)\")\n", + "\n", + "%cd /content/\n", + "!ns-render --load-config $config_filename --traj filename --camera-path-filename $camera_path_filename --output-path renders/output.mp4" ] } - ] + ], + "metadata": { + "accelerator": "GPU", + "colab": { + "collapsed_sections": [], + "include_colab_link": true, + "provenance": [] + }, + "gpuClass": "standard", + "kernelspec": { + "display_name": "Python 3.8.12 ('nerfactory')", + "language": "python", + "name": "python3" + }, + "language_info": { + "name": "python", + "version": "3.8.12" + }, + "vscode": { + "interpreter": { + "hash": "34c28001ff35fb390494047002768a8182dcf55b1b11415165e62ea61557ab83" + } + } + }, + "nbformat": 4, + "nbformat_minor": 0 } diff --git a/docs/_templates/sidebar/brand.html b/docs/_templates/sidebar/brand.html index 14772296b..7a0140a98 100644 --- a/docs/_templates/sidebar/brand.html +++ b/docs/_templates/sidebar/brand.html @@ -44,4 +44,59 @@ going well. :) -#} > Github +
+ + + + + + + + + + +  colab diff --git a/docs/index.md b/docs/index.md index c6bbb80c8..faffde5c9 100644 --- a/docs/index.md +++ b/docs/index.md @@ -50,7 +50,6 @@ quickstart/installation quickstart/first_nerf quickstart/custom_dataset quickstart/viewer_quickstart -quickstart/google_colab Contributing ``` diff --git a/docs/quickstart/google_colab.md b/docs/quickstart/google_colab.md deleted file mode 100644 index f953d7f63..000000000 --- a/docs/quickstart/google_colab.md +++ /dev/null @@ -1,3 +0,0 @@ -# Google Colab - -Nerfstudio works in Google Colab using their hosted GPUs! Here is [the link](https://colab.research.google.com/drive/13ZUOVo9N4fjZcoS_R9N0BsYa2kV6ywuq?usp=sharing). Make a copy of this file and go from there! From 44500a7d97e638ac9b361036a13a0128386155e3 Mon Sep 17 00:00:00 2001 From: Matthew Tancik Date: Mon, 31 Oct 2022 11:15:52 -0700 Subject: [PATCH 11/68] Add more debug logs to data processing (#867) --- scripts/process_data.py | 52 +++++++++++++++++++++++++++++++++-------- 1 file changed, 42 insertions(+), 10 deletions(-) diff --git a/scripts/process_data.py b/scripts/process_data.py index 1b114a782..2bcd6a3d4 100755 --- a/scripts/process_data.py +++ b/scripts/process_data.py @@ -134,7 +134,7 @@ def get_num_frames_in_video(video: Path) -> int: def convert_video_to_images( video_path: Path, image_dir: Path, num_frames_target: int, verbose: bool = False -) -> List[str]: +) -> Tuple[List[str], int]: """Converts a video into a sequence of images. Args: @@ -143,7 +143,7 @@ def convert_video_to_images( num_frames_target: Number of frames to extract. verbose: If True, logs the output of the command. Returns: - A summary of the conversion. + A tuple containing summary of the conversion and the number of extracted frames. """ with status(msg="Converting video to images...", spinner="bouncingBall", verbose=verbose): @@ -172,12 +172,13 @@ def convert_video_to_images( run_command(ffmpeg_cmd, verbose=verbose) + num_final_frames = len(list(image_dir.glob("*.png"))) summary_log = [] summary_log.append(f"Starting with {num_frames} video frames") - summary_log.append(f"We extracted {len(list(image_dir.glob('*.png')))} images") + summary_log.append(f"We extracted {num_final_frames} images") CONSOLE.log("[bold green]:tada: Done converting video to images.") - return summary_log + return summary_log, num_final_frames def convert_insta360_to_images( @@ -187,7 +188,7 @@ def convert_insta360_to_images( num_frames_target: int, crop_percentage: float = 0.7, verbose: bool = False, -) -> List[str]: +) -> Tuple[List[str], int]: """Converts a video into a sequence of images. Args: @@ -197,7 +198,7 @@ def convert_insta360_to_images( num_frames_target: Number of frames to extract. verbose: If True, logs the output of the command. Returns: - A summary of the conversion. + A tuple containing summary of the conversion and the number of extracted frames. """ with status(msg="Converting video to images...", spinner="bouncingBall", verbose=verbose): @@ -240,12 +241,13 @@ def convert_insta360_to_images( for i, img in enumerate(image_dir.glob("back_frame_*.png")): img.rename(image_dir / f"frame_{i+1+num_extracted_front_frames:05d}.png") + num_final_frames = len(list(image_dir.glob("*.png"))) summary_log = [] summary_log.append(f"Starting with {num_frames_front + num_frames_back} video frames") - summary_log.append(f"We extracted {len(list(image_dir.glob('*.png')))} images") + summary_log.append(f"We extracted {num_final_frames} images") CONSOLE.log("[bold green]:tada: Done converting insta360 to images.") - return summary_log + return summary_log, num_final_frames def copy_images(data: Path, image_dir: Path, verbose) -> int: @@ -514,6 +516,33 @@ def get_insta360_filenames(data: Path) -> Tuple[Path, Path]: return filename_back, filename_front +def get_matching_summary(num_intial_frames: int, num_matched_frames: int) -> str: + """Returns a summary of the matching results. + + Args: + num_intial_frames: The number of initial frames. + num_matched_frames: The number of matched frames. + + Returns: + A summary of the matching results. + """ + match_ratio = num_matched_frames / num_intial_frames + if match_ratio == 1: + return "[bold green]COLAMP found poses for all images, CONGRATS!" + if match_ratio < 0.4: + result = f"[bold red]COLMAP only found poses for {num_matched_frames / num_intial_frames * 100:.2f}%" + result += " of the images. This is low.\nThis can be caused by a variety of reasons," + result += " such poor scene coverage, blurry images, or large exposure changes." + return result + if match_ratio < 0.8: + result = f"[bold yellow]COLMAP only found poses for {num_matched_frames / num_intial_frames * 100:.2f}%" + result += " of the images.\nThis isn't great, but may be ok." + result += "\nMissing poses can be caused by a variety of reasons, such poor scene coverage, blurry images," + result += " or large exposure changes." + return result + return f"[bold green]COLMAP found poses for {num_matched_frames / num_intial_frames * 100:.2f}% of the images." + + @dataclass class ProcessImages: """Process images into a nerfstudio dataset. @@ -585,6 +614,7 @@ class ProcessImages: camera_model=CAMERA_MODELS[self.camera_type], ) summary_log.append(f"Colmap matched {num_matched_frames} images") + summary_log.append(get_matching_summary(num_frames, num_matched_frames)) else: CONSOLE.log("[bold yellow]Warning: could not find existing COLMAP results. Not generating transforms.json") @@ -637,7 +667,7 @@ class ProcessVideo: image_dir.mkdir(parents=True, exist_ok=True) # Convert video to images - summary_log = convert_video_to_images( + summary_log, num_extracted_frames = convert_video_to_images( self.data, image_dir=image_dir, num_frames_target=self.num_frames_target, verbose=self.verbose ) @@ -668,6 +698,7 @@ class ProcessVideo: camera_model=CAMERA_MODELS[self.camera_type], ) summary_log.append(f"Colmap matched {num_matched_frames} images") + summary_log.append(get_matching_summary(num_extracted_frames, num_matched_frames)) else: CONSOLE.log("[bold yellow]Warning: could not find existing COLMAP results. Not generating transforms.json") @@ -724,7 +755,7 @@ class ProcessInsta360: filename_back, filename_front = get_insta360_filenames(self.data) # Convert video to images - summary_log = convert_insta360_to_images( + summary_log, num_extracted_frames = convert_insta360_to_images( video_front=filename_front, video_back=filename_back, image_dir=image_dir, @@ -759,6 +790,7 @@ class ProcessInsta360: camera_model=CAMERA_MODELS["fisheye"], ) summary_log.append(f"Colmap matched {num_matched_frames} images") + summary_log.append(get_matching_summary(num_extracted_frames, num_matched_frames)) else: CONSOLE.log("[bold yellow]Warning: could not find existing COLMAP results. Not generating transforms.json") From 96a7853cd03038e8158f13d0e70f91420278610d Mon Sep 17 00:00:00 2001 From: Matthew Tancik Date: Mon, 31 Oct 2022 11:53:29 -0700 Subject: [PATCH 12/68] Update readme (#869) --- README.md | 23 +++++++++++++++++++++-- docs/index.md | 35 +++++++++++++++++++++++++++++++++-- 2 files changed, 54 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 532d04eca..19a0dc839 100644 --- a/README.md +++ b/README.md @@ -205,6 +205,7 @@ If you're interested in learning more on how to create your own pipelines, devel | 🏃 **Tutorials** | | [Getting Started](https://docs.nerf.studio/en/latest/quickstart/installation.html) | A more in-depth guide on how to get started with nerfstudio from installation to contributing. | | [Using the Viewer](https://docs.nerf.studio/en/latest/quickstart/viewer_quickstart.html) | A quick demo video on how to navigate the viewer. | +| [Using Record3D](https://www.youtube.com/watch?v=XwKq7qDQCQk) | Demo video on how to run nerfstudio without using COLMAP. | | 💻 **For Developers** | | [Creating pipelines](https://docs.nerf.studio/en/latest/developer_guides/pipelines/index.html) | Learn how to easily build new neural rendering pipelines by using and/or implementing new modules. | | [Creating datasets](https://docs.nerf.studio/en/latest/quickstart/custom_dataset.html) | Have a new dataset? Learn how to run it with nerfstudio. | @@ -231,12 +232,30 @@ We provide the following support structures to make life easier for getting star # Built On -#### [tyro](https://github.com/brentyi/tyro) + + + + + + tyro logo + + + + - Easy-to-use config system - Developed by [Brent Yi](https://brentyi.com/) -#### [nerfacc](https://www.nerfacc.com/en/latest/) + + + + + + tyro logo + + + + - Library for accelerating NeRF renders - Developed by [Ruilong Li](https://www.liruilong.cn/) diff --git a/docs/index.md b/docs/index.md index faffde5c9..c5c75a64a 100644 --- a/docs/index.md +++ b/docs/index.md @@ -107,14 +107,45 @@ We'll be constantly growing this list! So make sure to check back in to see our | [Discord](https://discord.com/invite/NHGtYRAW) | Join Discord Community | | [Viewer](https://viewer.nerf.studio/) | Web-based Nerf Viewer | +### How-to Videos + +| | | +| --------------------------------------------------------------- | --------------------------------------------------------- | +| [Using the Viewer](https://www.youtube.com/watch?v=nSFsugarWzk) | Demo video on how to run nerfstudio and use the viewer. | +| [Using Record3D](https://www.youtube.com/watch?v=XwKq7qDQCQk) | Demo video on how to run nerfstudio without using COLMAP. | + ## Built On -[**tyro**](https://github.com/brentyi/tyro) +```{image} https://brentyi.github.io/tyro/_static/logo-light.svg +:width: 150 +:alt: tyro +:class: only-light +:target: https://github.com/brentyi/tyro +``` + +```{image} https://brentyi.github.io/tyro/_static/logo-dark.svg +:width: 150 +:alt: tyro +:class: only-dark +:target: https://github.com/brentyi/tyro +``` - Easy to use config system - Developed by [Brent Yi](https://brentyi.com/) -[**nerfacc**](https://www.nerfacc.com/en/latest/) +```{image} https://user-images.githubusercontent.com/3310961/199084143-0d63eb40-3f35-48d2-a9d5-78d1d60b7d66.png +:width: 250 +:alt: tyro +:class: only-light +:target: https://github.com/KAIR-BAIR/nerfacc +``` + +```{image} https://user-images.githubusercontent.com/3310961/199083722-881a2372-62c1-4255-8521-31a95a721851.png +:width: 250 +:alt: tyro +:class: only-dark +:target: https://github.com/KAIR-BAIR/nerfacc +``` - Library for accelerating NeRF renders - Developed by [Ruilong Li](https://www.liruilong.cn/) From cd468a8e941302a2c5d68b72a3e4c4e90cf102f8 Mon Sep 17 00:00:00 2001 From: Matthew Tancik Date: Mon, 31 Oct 2022 12:27:58 -0700 Subject: [PATCH 13/68] Don't add relative paths to experiment name (#871) dont add relative paths to exp name --- nerfstudio/configs/base_config.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/nerfstudio/configs/base_config.py b/nerfstudio/configs/base_config.py index 340806577..7b02e1a24 100644 --- a/nerfstudio/configs/base_config.py +++ b/nerfstudio/configs/base_config.py @@ -241,7 +241,7 @@ class Config(PrintableConfig): def set_experiment_name(self) -> None: """Dynamically set the experiment name""" if self.experiment_name is None: - self.experiment_name = str(self.pipeline.datamanager.dataparser.data).replace("/", "-") + self.experiment_name = str(self.pipeline.datamanager.dataparser.data).replace("../", "").replace("/", "-") def get_base_dir(self) -> Path: """Retrieve the base directory to set relative paths""" From e8487a078512eb8ebe3699b496b51090de5e1e02 Mon Sep 17 00:00:00 2001 From: Kevin Chen <79341521+kevinddchen@users.noreply.github.com> Date: Mon, 31 Oct 2022 12:34:13 -0700 Subject: [PATCH 14/68] Add control for resampling images (#847) --- nerfstudio/data/datamanagers.py | 17 ++++++++++--- .../data/dataparsers/record3d_dataparser.py | 6 ++--- nerfstudio/data/utils/dataloaders.py | 24 +++++++++++++++---- 3 files changed, 37 insertions(+), 10 deletions(-) diff --git a/nerfstudio/data/datamanagers.py b/nerfstudio/data/datamanagers.py index c3cf367c3..774808bde 100644 --- a/nerfstudio/data/datamanagers.py +++ b/nerfstudio/data/datamanagers.py @@ -15,6 +15,7 @@ """ Data loader. """ + from __future__ import annotations from abc import abstractmethod @@ -23,6 +24,7 @@ from typing import Dict, List, Optional, Tuple, Type, Union import torch import tyro +from rich.progress import Console from torch import nn from torch.nn import Parameter from torch.utils.data import Dataset @@ -49,6 +51,8 @@ from nerfstudio.engine.callbacks import TrainingCallback, TrainingCallbackAttrib from nerfstudio.model_components.ray_generators import RayGenerator from nerfstudio.utils.misc import IterableWrapper +CONSOLE = Console(width=120) + AnnotatedDataParserUnion = tyro.conf.OmitSubcommandPrefixes[ # Omit prefixes of flags in subcommands. tyro.extras.subcommand_type_from_defaults( { @@ -242,10 +246,16 @@ class VanillaDataManagerConfig(InstantiateConfig): """Number of rays per batch to use per training iteration.""" train_num_images_to_sample_from: int = -1 """Number of images to sample during training iteration.""" + train_num_times_to_repeat_images: int = -1 + """When not training on all images, number of iterations before picking new + images. If -1, never pick new images.""" eval_num_rays_per_batch: int = 1024 """Number of rays per batch to use per eval iteration.""" eval_num_images_to_sample_from: int = -1 """Number of images to sample during eval iteration.""" + eval_num_times_to_repeat_images: int = -1 + """When not evaluating on all images, number of iterations before picking + new images. If -1, never pick new images.""" eval_image_indices: Optional[Tuple[int, ...]] = (0,) """Specifies the image indices to use during eval; if None, uses all.""" camera_optimizer: CameraOptimizerConfig = CameraOptimizerConfig() @@ -294,9 +304,11 @@ class VanillaDataManager(DataManager): # pylint: disable=abstract-method def setup_train(self): """Sets up the data loaders for training""" assert self.train_dataset is not None + CONSOLE.print("Setting up training dataset...") self.train_image_dataloader = CacheDataloader( self.train_dataset, num_images_to_sample_from=self.config.train_num_images_to_sample_from, + num_times_to_repeat_images=self.config.train_num_times_to_repeat_images, device=self.device, num_workers=self.world_size * 4, pin_memory=True, @@ -314,9 +326,11 @@ class VanillaDataManager(DataManager): # pylint: disable=abstract-method def setup_eval(self): """Sets up the data loader for evaluation""" assert self.eval_dataset is not None + CONSOLE.print("Setting up evaluation dataset...") self.eval_image_dataloader = CacheDataloader( self.eval_dataset, num_images_to_sample_from=self.config.eval_num_images_to_sample_from, + num_times_to_repeat_images=self.config.eval_num_times_to_repeat_images, device=self.device, num_workers=self.world_size * 4, pin_memory=True, @@ -340,9 +354,6 @@ class VanillaDataManager(DataManager): # pylint: disable=abstract-method num_workers=self.world_size * 4, ) - # TODO: eval dataloader should be separate from train - self.iter_eval_dataloader = iter(self.eval_image_dataloader) - def next_train(self, step: int) -> Tuple[RayBundle, Dict]: """Returns the next batch of data from the train dataloader.""" self.train_count += 1 diff --git a/nerfstudio/data/dataparsers/record3d_dataparser.py b/nerfstudio/data/dataparsers/record3d_dataparser.py index 513f9b4c6..cd3a94039 100644 --- a/nerfstudio/data/dataparsers/record3d_dataparser.py +++ b/nerfstudio/data/dataparsers/record3d_dataparser.py @@ -51,8 +51,8 @@ class Record3DDataParserConfig(DataParserConfig): orientation_method: Literal["pca", "up"] = "up" """The method to use for orientation""" max_dataset_size: int = 300 - """Max number of images to train on. If the dataset has - more, images will be sampled approximately evenly.""" + """Max number of images to train on. If the dataset has more, images will be sampled approximately evenly. If -1, + use all images.""" @dataclass @@ -86,7 +86,7 @@ class Record3D(DataParser): axis=-1, ).astype(np.float32) - if num_images > self.config.max_dataset_size: + if self.config.max_dataset_size != -1 and num_images > self.config.max_dataset_size: # Evenly select max_dataset_size images from dataset, including first # and last indices. idx = np.round(np.linspace(0, num_images - 1, self.config.max_dataset_size)).astype(int) diff --git a/nerfstudio/data/utils/dataloaders.py b/nerfstudio/data/utils/dataloaders.py index fab0db183..825cb65a1 100644 --- a/nerfstudio/data/utils/dataloaders.py +++ b/nerfstudio/data/utils/dataloaders.py @@ -21,7 +21,7 @@ from abc import abstractmethod from typing import Dict, Optional, Tuple, Union import torch -from rich.progress import track +from rich.progress import Console, track from torch.utils.data import Dataset, default_collate from torch.utils.data.dataloader import DataLoader @@ -30,6 +30,8 @@ from nerfstudio.cameras.rays import RayBundle from nerfstudio.data.utils.datasets import InputDataset from nerfstudio.utils.misc import get_dict_to_torch +CONSOLE = Console(width=120) + class CacheDataloader(DataLoader): """Collated image dataset that implements caching of default-pytorch-collatable data. @@ -38,7 +40,7 @@ class CacheDataloader(DataLoader): Args: dataset: Dataset to sample from. num_samples_to_collate: How many images to sample rays for each batch. -1 for all images. - num_times_to_repeat_images: How often to collate new images. + num_times_to_repeat_images: How often to collate new images. -1 to never pick new images. device: Device to perform computation. """ @@ -46,13 +48,13 @@ class CacheDataloader(DataLoader): self, dataset: Dataset, num_images_to_sample_from: int = -1, - num_times_to_repeat_images: int = 0, + num_times_to_repeat_images: int = -1, device: Union[torch.device, str] = "cpu", **kwargs, ): self.dataset = dataset self.num_times_to_repeat_images = num_times_to_repeat_images - self.cache_all_images = num_images_to_sample_from == -1 + self.cache_all_images = (num_images_to_sample_from == -1) or (num_images_to_sample_from >= len(self.dataset)) self.num_images_to_sample_from = len(self.dataset) if self.cache_all_images else num_images_to_sample_from self.device = device @@ -61,7 +63,21 @@ class CacheDataloader(DataLoader): self.cached_collated_batch = None if self.cache_all_images: + CONSOLE.print(f"Caching all {len(self.dataset)} images.") + if len(self.dataset) > 500: + CONSOLE.print( + "[bold yellow]Warning: If you run out of memory, try reducing the number of images to sample from." + ) self.cached_collated_batch = self._get_collated_batch() + elif self.num_times_to_repeat_images == -1: + CONSOLE.print( + f"Caching {self.num_images_to_sample_from} out of {len(self.dataset)} images, without resampling." + ) + else: + CONSOLE.print( + f"Caching {self.num_images_to_sample_from} out of {len(self.dataset)} images, " + f"resampling every {self.num_times_to_repeat_images} iters." + ) super().__init__(dataset=dataset, **kwargs) def __getitem__(self, idx): From ddd7fc1d42d324e7d9f09ced9f7d0dac0d5ff8da Mon Sep 17 00:00:00 2001 From: Terrance Wang Date: Mon, 31 Oct 2022 13:46:34 -0700 Subject: [PATCH 15/68] always list paths as posix paths (#860) --- scripts/process_data.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/scripts/process_data.py b/scripts/process_data.py index 2bcd6a3d4..d83d1d762 100755 --- a/scripts/process_data.py +++ b/scripts/process_data.py @@ -445,7 +445,7 @@ def colmap_to_json(cameras_path: Path, images_path: Path, output_dir: Path, came name = Path(f"./images/{im_data.name}") frame = { - "file_path": str(name), + "file_path": name.as_posix(), "transform_matrix": c2w.tolist(), } frames.append(frame) From d9f6426e0da555d42ad3017850a52dad8e5f7749 Mon Sep 17 00:00:00 2001 From: Thomas Wang <24695242+thomasw21@users.noreply.github.com> Date: Tue, 1 Nov 2022 00:45:20 +0100 Subject: [PATCH 16/68] Check main thread when always rendering. (#865) Check main thread --- nerfstudio/engine/trainer.py | 2 ++ 1 file changed, 2 insertions(+) diff --git a/nerfstudio/engine/trainer.py b/nerfstudio/engine/trainer.py index a3162ff32..8959b27c7 100644 --- a/nerfstudio/engine/trainer.py +++ b/nerfstudio/engine/trainer.py @@ -174,12 +174,14 @@ class Trainer: self.save_checkpoint(step) self._always_render(step) + @check_main_thread def _always_render(self, step): if self.config.is_viewer_enabled(): while True: self.viewer_state.vis["renderingState/isTraining"].write(False) self._update_viewer_state(step) + @check_main_thread def _check_viewer_warnings(self) -> None: """Helper to print out any warnings regarding the way the viewer/loggers are enabled""" if self.config.is_viewer_enabled(): From ca69adaaec02f347f650804371623198d30af562 Mon Sep 17 00:00:00 2001 From: Matthew Tancik Date: Tue, 1 Nov 2022 15:05:16 -0700 Subject: [PATCH 17/68] Add median depth calculation (#877) * Add median depth calculation * lint * Fix test --- nerfstudio/model_components/renderers.py | 21 ++++++++++++++++++--- nerfstudio/models/instant_ngp.py | 2 +- tests/model_components/test_renderers.py | 7 +++++-- 3 files changed, 24 insertions(+), 6 deletions(-) diff --git a/nerfstudio/model_components/renderers.py b/nerfstudio/model_components/renderers.py index 9604a1d5f..21726acc5 100644 --- a/nerfstudio/model_components/renderers.py +++ b/nerfstudio/model_components/renderers.py @@ -200,11 +200,15 @@ class AccumulationRenderer(nn.Module): class DepthRenderer(nn.Module): """Calculate depth along ray. + Depth Method: + - median: Depth is set to the distance where the accumulated weight reaches 0.5. + - expected: Expected depth along ray. Same procedure as rendering rgb, but with depth. + Args: - method (str, optional): Depth calculation method. + method: Depth calculation method. """ - def __init__(self, method: Literal["expected"] = "expected") -> None: + def __init__(self, method: Literal["median", "expected"] = "median") -> None: super().__init__() self.method = method @@ -215,7 +219,7 @@ class DepthRenderer(nn.Module): ray_indices: Optional[TensorType["num_samples"]] = None, num_rays: Optional[int] = None, ) -> TensorType[..., 1]: - """Composite samples along ray and calculate disparities. + """Composite samples along ray and calculate depths. Args: weights: Weights for each sample. @@ -227,6 +231,17 @@ class DepthRenderer(nn.Module): Outputs of depth values. """ + if self.method == "median": + steps = (ray_samples.frustums.starts + ray_samples.frustums.ends) / 2 + + if ray_indices is not None and num_rays is not None: + raise NotImplementedError("Median depth calculation is not implemented for packed samples.") + cumulative_weights = torch.cumsum(weights[..., 0], dim=-1) # [..., num_samples] + split = torch.ones((*weights.shape[:-2], 1), device=weights.device) * 0.5 # [..., 1] + median_index = torch.searchsorted(cumulative_weights, split, side="left") # [..., 1] + median_index = torch.clamp(median_index, 0, steps.shape[-2] - 1) # [..., 1] + median_depth = torch.gather(steps[..., 0], dim=-1, index=median_index) # [..., 1] + return median_depth if self.method == "expected": eps = 1e-10 steps = (ray_samples.frustums.starts + ray_samples.frustums.ends) / 2 diff --git a/nerfstudio/models/instant_ngp.py b/nerfstudio/models/instant_ngp.py index 480c52ee8..f30d2ad9a 100644 --- a/nerfstudio/models/instant_ngp.py +++ b/nerfstudio/models/instant_ngp.py @@ -125,7 +125,7 @@ class NGPModel(Model): background_color = "random" if self.config.randomize_background else colors.WHITE self.renderer_rgb = RGBRenderer(background_color=background_color) self.renderer_accumulation = AccumulationRenderer() - self.renderer_depth = DepthRenderer() + self.renderer_depth = DepthRenderer(method="expected") # losses self.rgb_loss = MSELoss() diff --git a/tests/model_components/test_renderers.py b/tests/model_components/test_renderers.py index 26417e4e4..984a45e7c 100644 --- a/tests/model_components/test_renderers.py +++ b/tests/model_components/test_renderers.py @@ -60,7 +60,7 @@ def test_depth_renderer(): """Test depth rendering""" num_samples = 10 - weights = torch.ones((3, num_samples, 1)) + weights = torch.ones((num_samples, 1)) weights /= torch.sum(weights, dim=-2, keepdim=True) frustums = Frustums.get_mock_frustum() @@ -73,8 +73,11 @@ def test_depth_renderer(): deltas=torch.ones((num_samples, 1)), ) - depth_renderer = renderers.DepthRenderer() + depth_renderer = renderers.DepthRenderer(method="median") + depth = depth_renderer(weights=weights, ray_samples=ray_samples) + assert torch.min(depth) > 0 + depth_renderer = renderers.DepthRenderer(method="expected") depth = depth_renderer(weights=weights, ray_samples=ray_samples) assert torch.min(depth) > 0 From be70b86b181457fbf98329c74721f092b7715e2d Mon Sep 17 00:00:00 2001 From: Terrance Wang Date: Tue, 1 Nov 2022 16:58:23 -0700 Subject: [PATCH 18/68] remove sf street (#876) --- scripts/downloads/download_data.py | 1 - 1 file changed, 1 deletion(-) diff --git a/scripts/downloads/download_data.py b/scripts/downloads/download_data.py index 5a8c80727..0c37255ab 100755 --- a/scripts/downloads/download_data.py +++ b/scripts/downloads/download_data.py @@ -65,7 +65,6 @@ nerfstudio_file_ids = { "library": grab_file_id("https://drive.google.com/file/d/1Hjbh_-BuaWETQExn2x2qGD74UwrFugHx/view?usp=sharing"), "poster": grab_file_id("https://drive.google.com/file/d/1dmjWGXlJnUxwosN6MVooCDQe970PkD-1/view?usp=sharing"), "redwoods2": grab_file_id("https://drive.google.com/file/d/1rg-4NoXT8p6vkmbWxMOY6PSG4j3rfcJ8/view?usp=sharing"), - "sf_street": grab_file_id("https://drive.google.com/file/d/1DbLyptL6my2QprEVtYuW2uzgp9JAK5Wz/view?usp=sharing"), "storefront": grab_file_id("https://drive.google.com/file/d/16b792AguPZWDA_YC4igKCwXJqW0Tb21o/view?usp=sharing"), "vegetation": grab_file_id("https://drive.google.com/file/d/1wBhLQ2odycrtU39y2akVurXEAt9SsVI3/view?usp=sharing"), } From c53df92b9ced18adc6a2ef31b940db68cb924149 Mon Sep 17 00:00:00 2001 From: Daniel Crispell Date: Wed, 2 Nov 2022 13:04:04 -0400 Subject: [PATCH 19/68] disallow fars <= nears (#881) --- nerfstudio/model_components/scene_colliders.py | 1 + 1 file changed, 1 insertion(+) diff --git a/nerfstudio/model_components/scene_colliders.py b/nerfstudio/model_components/scene_colliders.py index 88428f650..b1f1eecf1 100644 --- a/nerfstudio/model_components/scene_colliders.py +++ b/nerfstudio/model_components/scene_colliders.py @@ -84,6 +84,7 @@ class AABBBoxCollider(SceneBoxCollider): # clamp to near plane near_plane = self.near_plane if self.training else 0 nears = torch.clamp(nears, min=near_plane) + fars = torch.maximum(fars, nears + 1e-6) return nears, fars From 6f158a3e684bc554b2b80f3138bab9b5c29158bb Mon Sep 17 00:00:00 2001 From: Nikhil Mohan <47728081+nikmo33@users.noreply.github.com> Date: Wed, 2 Nov 2022 17:20:26 +0000 Subject: [PATCH 20/68] add correct none check to distortion params (#878) * add none check * black formatting --- nerfstudio/cameras/cameras.py | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/nerfstudio/cameras/cameras.py b/nerfstudio/cameras/cameras.py index 8d66e3ae4..edc8da0a0 100644 --- a/nerfstudio/cameras/cameras.py +++ b/nerfstudio/cameras/cameras.py @@ -420,7 +420,7 @@ class Cameras: self.cy[indices], height=self._image_heights[indices], width=self._image_widths[indices], - distortion_params=self.distortion_params[indices] if self.distortion_params else None, + distortion_params=self.distortion_params[indices] if self.distortion_params is not None else None, camera_type=self.camera_type[indices], ) if isinstance(indices, (int, slice)): @@ -433,6 +433,8 @@ class Cameras: self.cy[indices + (slice(None),)], height=self._image_heights[indices + (slice(None),)], width=self._image_widths[indices + (slice(None),)], - distortion_params=self.distortion_params[indices + (slice(None),)] if self.distortion_params else None, + distortion_params=self.distortion_params[indices + (slice(None),)] + if self.distortion_params is not None + else None, camera_type=self.camera_type[indices + (slice(None),)], ) From 35610cb9e2cfe1e8872b7fc40328ef71c16bed68 Mon Sep 17 00:00:00 2001 From: Julian Knodt Date: Wed, 2 Nov 2022 12:23:13 -0700 Subject: [PATCH 21/68] DNeRF Data Parser (#817) * Add dnerf dataparser * Switch time to be stored per camera I realized it would be better downstream to store times on the ray bundle, and in order to store them on the ray bundle it's much easier to store them on the camera. Rather than having to revert this change, I just made it here. --- nerfstudio/cameras/cameras.py | 23 ++-- nerfstudio/data/datamanagers.py | 2 + .../data/dataparsers/base_dataparser.py | 2 + .../data/dataparsers/dnerf_dataparser.py | 108 ++++++++++++++++++ 4 files changed, 122 insertions(+), 13 deletions(-) create mode 100644 nerfstudio/data/dataparsers/dnerf_dataparser.py diff --git a/nerfstudio/cameras/cameras.py b/nerfstudio/cameras/cameras.py index edc8da0a0..7cf107f2f 100644 --- a/nerfstudio/cameras/cameras.py +++ b/nerfstudio/cameras/cameras.py @@ -81,6 +81,7 @@ class Cameras: camera_type: Optional[ Union[TensorType["num_cameras"], int, List[CameraType], CameraType] ] = CameraType.PERSPECTIVE, + times: Optional[TensorType["num_cameras"]] = None, ): self._num_cameras = camera_to_worlds.shape[0] self.camera_to_worlds = camera_to_worlds # This comes first since it determines @property self.device @@ -121,6 +122,8 @@ class Cameras: self.camera_type = self._init_get_camera_type(camera_type) + self.times = times + def _init_get_camera_type( self, camera_type: Union[TensorType["num_cameras"], int, List[CameraType], CameraType] ) -> TensorType["num_cameras"]: @@ -223,6 +226,7 @@ class Cameras: height=self.image_height.to(device), distortion_params=distortion_params.to(device) if distortion_params is not None else None, camera_type=self.camera_type.to(device), + times=self.times.to(device) if self.times is not None else None, ) def get_image_coords(self, pixel_offset: float = 0.5) -> TensorType["height", "width", 2]: @@ -305,11 +309,7 @@ class Cameras: sin_theta = torch.sin(theta) directions_stack = torch.stack( - [ - coord_stack[..., 0] * sin_theta / theta, - coord_stack[..., 1] * sin_theta / theta, - -torch.cos(theta), - ], + [coord_stack[..., 0] * sin_theta / theta, coord_stack[..., 1] * sin_theta / theta, -torch.cos(theta)], dim=-1, ) else: @@ -338,17 +338,11 @@ class Cameras: ray_bundle_camera_indices = camera_indices.view(pixel_area.shape) return RayBundle( - origins=origins, - directions=directions, - pixel_area=pixel_area, - camera_indices=ray_bundle_camera_indices, + origins=origins, directions=directions, pixel_area=pixel_area, camera_indices=ray_bundle_camera_indices ) def to_json( - self, - camera_idx: int, - image: Optional[TensorType["height", "width", 2]] = None, - max_size: Optional[int] = None, + self, camera_idx: int, image: Optional[TensorType["height", "width", 2]] = None, max_size: Optional[int] = None ) -> Dict: """Convert a camera to a json dictionary. @@ -368,6 +362,7 @@ class Cameras: "fy": self.fy[camera_idx].tolist(), "camera_to_world": self.camera_to_worlds[camera_idx].tolist(), "camera_index": camera_idx, + "times": self.times[camera_idx] if self.times is not None else None, } if image is not None: image_uint8 = (image * 255).detach().type(torch.uint8) @@ -422,6 +417,7 @@ class Cameras: width=self._image_widths[indices], distortion_params=self.distortion_params[indices] if self.distortion_params is not None else None, camera_type=self.camera_type[indices], + times=self.times[indices] if self.times is not None else None, ) if isinstance(indices, (int, slice)): indices = (indices,) @@ -437,4 +433,5 @@ class Cameras: if self.distortion_params is not None else None, camera_type=self.camera_type[indices + (slice(None),)], + times=self.times[indices + (slice(None),)] if self.times is not None else None, ) diff --git a/nerfstudio/data/datamanagers.py b/nerfstudio/data/datamanagers.py index 774808bde..2e908ad35 100644 --- a/nerfstudio/data/datamanagers.py +++ b/nerfstudio/data/datamanagers.py @@ -34,6 +34,7 @@ from nerfstudio.cameras.camera_optimizers import CameraOptimizerConfig from nerfstudio.cameras.rays import RayBundle from nerfstudio.configs.base_config import InstantiateConfig from nerfstudio.data.dataparsers.blender_dataparser import BlenderDataParserConfig +from nerfstudio.data.dataparsers.dnerf_dataparser import DNeRFDataParserConfig from nerfstudio.data.dataparsers.friends_dataparser import FriendsDataParserConfig from nerfstudio.data.dataparsers.instant_ngp_dataparser import ( InstantNGPDataParserConfig, @@ -61,6 +62,7 @@ AnnotatedDataParserUnion = tyro.conf.OmitSubcommandPrefixes[ # Omit prefixes of "friends-data": FriendsDataParserConfig(), "instant-ngp-data": InstantNGPDataParserConfig(), "record3d-data": Record3DDataParserConfig(), + "dnerf-data": DNeRFDataParserConfig(), }, prefix_names=False, # Omit prefixes in subcommands themselves. ) diff --git a/nerfstudio/data/dataparsers/base_dataparser.py b/nerfstudio/data/dataparsers/base_dataparser.py index f671f17ea..5f19f126c 100644 --- a/nerfstudio/data/dataparsers/base_dataparser.py +++ b/nerfstudio/data/dataparsers/base_dataparser.py @@ -63,6 +63,8 @@ class DataparserOutputs: """Scene box of dataset. Used to bound the scene or provide the scene scale depending on model.""" semantics: Optional[Semantics] = None """Semantics information.""" + times: Optional[TensorType[1]] = None + """Time in range [0,1] for when each image was taken.""" additional_inputs: Dict[str, Any] = to_immutable_dict({}) """Dictionary of additional dataset information (e.g. semantics/point clouds/masks). {input_name: diff --git a/nerfstudio/data/dataparsers/dnerf_dataparser.py b/nerfstudio/data/dataparsers/dnerf_dataparser.py new file mode 100644 index 000000000..56a9f232b --- /dev/null +++ b/nerfstudio/data/dataparsers/dnerf_dataparser.py @@ -0,0 +1,108 @@ +# Copyright 2022 The Nerfstudio Team. All rights reserved. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +"""Data parser for blender dataset""" +from __future__ import annotations + +from dataclasses import dataclass, field +from pathlib import Path +from typing import Type + +import imageio +import numpy as np +import torch + +from nerfstudio.cameras.cameras import Cameras, CameraType +from nerfstudio.data.dataparsers.base_dataparser import ( + DataParser, + DataParserConfig, + DataparserOutputs, +) +from nerfstudio.data.scene_box import SceneBox +from nerfstudio.utils.colors import get_color +from nerfstudio.utils.io import load_from_json + + +@dataclass +class DNeRFDataParserConfig(DataParserConfig): + """D-NeRF dataset parser config""" + + _target: Type = field(default_factory=lambda: DNeRF) + """target class to instantiate""" + data: Path = Path("data/dnerf/lego") + """Directory specifying location of data.""" + scale_factor: float = 1.0 + """How much to scale the camera origins by.""" + alpha_color: str = "white" + """alpha color of background""" + + +@dataclass +class DNeRF(DataParser): + """DNeRF Dataset""" + + config: DNeRFDataParserConfig + + def __init__(self, config: DNeRFDataParserConfig): + super().__init__(config=config) + self.data: Path = config.data + self.scale_factor: float = config.scale_factor + self.alpha_color = config.alpha_color + + def _generate_dataparser_outputs(self, split="train"): + if self.alpha_color is not None: + alpha_color_tensor = get_color(self.alpha_color) + else: + alpha_color_tensor = None + + meta = load_from_json(self.data / f"transforms_{split}.json") + image_filenames = [] + poses = [] + times = [] + for frame in meta["frames"]: + fname = self.data / Path(frame["file_path"].replace("./", "") + ".png") + image_filenames.append(fname) + poses.append(np.array(frame["transform_matrix"])) + times.append(frame["time"]) + poses = np.array(poses).astype(np.float32) + times = torch.tensor(times, dtype=torch.float32) + + img_0 = imageio.imread(image_filenames[0]) + image_height, image_width = img_0.shape[:2] + camera_angle_x = float(meta["camera_angle_x"]) + focal_length = 0.5 * image_width / np.tan(0.5 * camera_angle_x) + + cx = image_width / 2.0 + cy = image_height / 2.0 + camera_to_world = torch.from_numpy(poses[:, :3]) # camera to world transform + + # in x,y,z order + camera_to_world[..., 3] *= self.scale_factor + scene_box = SceneBox(aabb=torch.tensor([[-1.5, -1.5, -1.5], [1.5, 1.5, 1.5]], dtype=torch.float32)) + + cameras = Cameras( + camera_to_worlds=camera_to_world, + fx=focal_length, + fy=focal_length, + cx=cx, + cy=cy, + camera_type=CameraType.PERSPECTIVE, + times=times, + ) + + dataparser_outputs = DataparserOutputs( + image_filenames=image_filenames, cameras=cameras, alpha_color=alpha_color_tensor, scene_box=scene_box + ) + + return dataparser_outputs From 7106f42fcc67456009502eccbeac96a2c5d2b623 Mon Sep 17 00:00:00 2001 From: Terrance Wang Date: Wed, 2 Nov 2022 14:32:03 -0700 Subject: [PATCH 22/68] tensorf (#586) * tensorf wip * model changes * tuning model * changing imports * merging * changing rff encoding to nerfencoding, basis matrix should be properly updated, changed density activation, lr scheduler * debugging tensorf * debugging tensorf * tensorf debugging * tensorf debugging * tensorf debugging * tensorf debug * debugging tensorf, fixed bug with collider * tuning model, ray sampling * adding thresholding for ray computations * removing unused imports * making more params configurable in config, adding spherical harmonics * removing scene contraction, adding arg docstrings * fixing style * Fixing bug Co-authored-by: Matthew Tancik --- nerfstudio/configs/method_configs.py | 29 ++- nerfstudio/field_components/encodings.py | 3 +- nerfstudio/fields/tensorf_field.py | 135 +++++++++++ nerfstudio/models/tensorf.py | 280 +++++++++++++++++++++++ 4 files changed, 444 insertions(+), 3 deletions(-) create mode 100644 nerfstudio/fields/tensorf_field.py create mode 100644 nerfstudio/models/tensorf.py diff --git a/nerfstudio/configs/method_configs.py b/nerfstudio/configs/method_configs.py index f4a95f027..f99110569 100644 --- a/nerfstudio/configs/method_configs.py +++ b/nerfstudio/configs/method_configs.py @@ -23,7 +23,12 @@ from typing import Dict import tyro from nerfstudio.cameras.camera_optimizers import CameraOptimizerConfig -from nerfstudio.configs.base_config import Config, TrainerConfig, ViewerConfig +from nerfstudio.configs.base_config import ( + Config, + SchedulerConfig, + TrainerConfig, + ViewerConfig, +) from nerfstudio.data.datamanagers import VanillaDataManagerConfig from nerfstudio.data.dataparsers.blender_dataparser import BlenderDataParserConfig from nerfstudio.data.dataparsers.friends_dataparser import FriendsDataParserConfig @@ -34,6 +39,7 @@ from nerfstudio.models.instant_ngp import InstantNGPModelConfig from nerfstudio.models.mipnerf import MipNerfModel from nerfstudio.models.nerfacto import NerfactoModelConfig from nerfstudio.models.semantic_nerfw import SemanticNerfWModelConfig +from nerfstudio.models.tensorf import TensoRFModelConfig from nerfstudio.models.vanilla_nerf import NeRFModel from nerfstudio.pipelines.base_pipeline import VanillaPipelineConfig from nerfstudio.pipelines.dynamic_batch import DynamicBatchPipelineConfig @@ -45,6 +51,7 @@ descriptions = { "mipnerf": "High quality model for bounded scenes. (slow)", "semantic-nerfw": "Predicts semantic segmentations and filters out transient objects.", "vanilla-nerf": "Original NeRF model. (slow)", + "tensorf": "tensorf", } method_configs["nerfacto"] = Config( @@ -155,6 +162,26 @@ method_configs["vanilla-nerf"] = Config( }, ) +method_configs["tensorf"] = Config( + method_name="tensorf", + trainer=TrainerConfig(mixed_precision=False), + pipeline=VanillaPipelineConfig( + datamanager=VanillaDataManagerConfig( + dataparser=BlenderDataParserConfig(), + ), + model=TensoRFModelConfig(), + ), + optimizers={ + "fields": { + "optimizer": AdamOptimizerConfig(lr=0.001), + "scheduler": SchedulerConfig(lr_final=0.0001, max_steps=30000), + }, + "encodings": { + "optimizer": AdamOptimizerConfig(lr=0.02), + "scheduler": SchedulerConfig(lr_final=0.002, max_steps=30000), + }, + }, +) AnnotatedBaseConfigUnion = tyro.conf.SuppressFixed[ # Don't show unparseable (fixed) arguments in helptext. tyro.extras.subcommand_type_from_defaults(defaults=method_configs, descriptions=descriptions) diff --git a/nerfstudio/field_components/encodings.py b/nerfstudio/field_components/encodings.py index 7e149e531..65bff8244 100644 --- a/nerfstudio/field_components/encodings.py +++ b/nerfstudio/field_components/encodings.py @@ -416,7 +416,6 @@ class TensorVMEncoding(Encoding): self.resolution = resolution self.num_components = num_components - # TODO(terrance): Learning rates should be different for these self.plane_coef = nn.Parameter(init_scale * torch.randn((3, num_components, resolution, resolution))) self.line_coef = nn.Parameter(init_scale * torch.randn((3, num_components, resolution, 1))) @@ -424,7 +423,6 @@ class TensorVMEncoding(Encoding): return self.num_components * 3 def forward(self, in_tensor: TensorType["bs":..., "input_dim"]) -> TensorType["bs":..., "output_dim"]: - in_tensor = in_tensor / 4.0 + 0.5 plane_coord = torch.stack([in_tensor[..., [0, 1]], in_tensor[..., [0, 2]], in_tensor[..., [1, 2]]]) # [3,...,2] line_coord = torch.stack([in_tensor[..., 2], in_tensor[..., 1], in_tensor[..., 0]]) # [3, ...] line_coord = torch.stack([torch.zeros_like(line_coord), line_coord], dim=-1) # [3, ...., 2] @@ -452,6 +450,7 @@ class TensorVMEncoding(Encoding): self.plane_coef.data, size=(resolution, resolution), mode="bilinear", align_corners=True ) line_coef = F.interpolate(self.line_coef.data, size=(resolution, 1), mode="bilinear", align_corners=True) + # TODO(ethan): are these torch.nn.Parameters needed? self.plane_coef, self.line_coef = torch.nn.Parameter(plane_coef), torch.nn.Parameter(line_coef) self.resolution = resolution diff --git a/nerfstudio/fields/tensorf_field.py b/nerfstudio/fields/tensorf_field.py new file mode 100644 index 000000000..d5cc9ba3b --- /dev/null +++ b/nerfstudio/fields/tensorf_field.py @@ -0,0 +1,135 @@ +# Copyright 2022 The Plenoptix Team. All rights reserved. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +"""TensoRF Field""" + + +from typing import Optional + +import torch +from torch import nn +from torch.nn.parameter import Parameter +from torchtyping import TensorType + +from nerfstudio.cameras.rays import RaySamples +from nerfstudio.data.scene_box import SceneBox +from nerfstudio.field_components.encodings import Encoding, Identity, SHEncoding +from nerfstudio.field_components.field_heads import FieldHeadNames, RGBFieldHead +from nerfstudio.field_components.mlp import MLP +from nerfstudio.fields.base_field import Field + + +class TensoRFField(Field): + """TensoRF Field""" + + def __init__( + self, + aabb, + # the aabb bounding box of the dataset + feature_encoding: Encoding = Identity(in_dim=3), + # the encoding method used for appearance encoding outputs + direction_encoding: Encoding = Identity(in_dim=3), + # the encoding method used for ray direction + density_encoding: Encoding = Identity(in_dim=3), + # the tensor encoding method used for scene density + color_encoding: Encoding = Identity(in_dim=3), + # the tensor encoding method used for scene color + appearance_dim: int = 27, + # the number of dimensions for the appearance embedding + head_mlp_num_layers: int = 2, + # number of layers for the MLP + head_mlp_layer_width: int = 128, + # layer width for the MLP + use_sh: bool = False, + # whether to use spherical harmonics as the feature decoding function + sh_levels: int = 2, + # number of levels to use for spherical harmonics + ) -> None: + super().__init__() + self.aabb = Parameter(aabb, requires_grad=False) + self.feature_encoding = feature_encoding + self.direction_encoding = direction_encoding + self.density_encoding = density_encoding + self.color_encoding = color_encoding + + self.mlp_head = MLP( + in_dim=appearance_dim + 3 + self.direction_encoding.get_out_dim() + self.feature_encoding.get_out_dim(), + num_layers=head_mlp_num_layers, + layer_width=head_mlp_layer_width, + activation=nn.ReLU(), + ) + + self.use_sh = use_sh + + if self.use_sh: + self.sh = SHEncoding(sh_levels) + self.B = nn.Linear( + in_features=self.color_encoding.get_out_dim(), out_features=3 * self.sh.get_out_dim(), bias=False + ) + else: + self.B = nn.Linear(in_features=self.color_encoding.get_out_dim(), out_features=appearance_dim, bias=False) + + self.field_output_rgb = RGBFieldHead(in_dim=self.mlp_head.get_out_dim(), activation=nn.Sigmoid()) + + def get_density(self, ray_samples: RaySamples): + positions = SceneBox.get_normalized_positions(ray_samples.frustums.get_positions(), self.aabb) + density = self.density_encoding(positions) + density_enc = torch.sum(density, dim=-1)[:, :, None] + relu = torch.nn.ReLU() + density_enc = relu(density_enc) + return density_enc + + def get_outputs(self, ray_samples: RaySamples, density_embedding: Optional[TensorType] = None) -> TensorType: + d = ray_samples.frustums.directions + positions = SceneBox.get_normalized_positions(ray_samples.frustums.get_positions(), self.aabb) + rgb_features = self.color_encoding(positions) + rgb_features = self.B(rgb_features) + + d_encoded = self.direction_encoding(d) + rgb_features_encoded = self.feature_encoding(rgb_features) + + if self.use_sh: + sh_mult = self.sh(d)[:, :, None] + rgb_sh = rgb_features.view(sh_mult.shape[0], sh_mult.shape[1], 3, sh_mult.shape[-1]) + rgb = torch.relu(torch.sum(sh_mult * rgb_sh, dim=-1) + 0.5) + else: + out = self.mlp_head(torch.cat([rgb_features, d, rgb_features_encoded, d_encoded], dim=-1)) # type: ignore + rgb = self.field_output_rgb(out) + + return rgb + + def forward( + self, ray_samples: RaySamples, mask: Optional[TensorType] = None, bg_color: Optional[TensorType] = None + ): + if mask is not None and bg_color is not None: + base_density = torch.zeros(ray_samples.shape)[:, :, None].to(mask.device) + base_rgb = bg_color.repeat(ray_samples[:, :, None].shape) + if mask.any(): + input_rays = ray_samples[mask, :] + density = self.get_density(input_rays) + rgb = self.get_outputs(input_rays, None) + + base_density[mask] = density + base_rgb[mask] = rgb + + base_density.requires_grad_() + base_rgb.requires_grad_() + + density = base_density + rgb = base_rgb + else: + density = self.get_density(ray_samples) + rgb = self.get_outputs(ray_samples, None) + + return {FieldHeadNames.DENSITY: density, FieldHeadNames.RGB: rgb} diff --git a/nerfstudio/models/tensorf.py b/nerfstudio/models/tensorf.py new file mode 100644 index 000000000..a0c771d2c --- /dev/null +++ b/nerfstudio/models/tensorf.py @@ -0,0 +1,280 @@ +# Copyright 2022 The Nerfstudio Team. All rights reserved. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +""" +TensorRF implementation. +""" + +from __future__ import annotations + +from dataclasses import dataclass, field +from typing import Dict, List, Tuple, Type + +import numpy as np +import torch +from torch.nn import Parameter +from torchmetrics import PeakSignalNoiseRatio +from torchmetrics.functional import structural_similarity_index_measure +from torchmetrics.image.lpip import LearnedPerceptualImagePatchSimilarity + +from nerfstudio.cameras.rays import RayBundle +from nerfstudio.configs.config_utils import to_immutable_dict +from nerfstudio.engine.callbacks import ( + TrainingCallback, + TrainingCallbackAttributes, + TrainingCallbackLocation, +) +from nerfstudio.field_components.encodings import NeRFEncoding, TensorVMEncoding +from nerfstudio.field_components.field_heads import FieldHeadNames +from nerfstudio.fields.tensorf_field import TensoRFField +from nerfstudio.model_components.losses import MSELoss +from nerfstudio.model_components.ray_samplers import PDFSampler, UniformSampler +from nerfstudio.model_components.renderers import ( + AccumulationRenderer, + DepthRenderer, + RGBRenderer, +) +from nerfstudio.model_components.scene_colliders import AABBBoxCollider +from nerfstudio.models.base_model import Model, VanillaModelConfig +from nerfstudio.utils import colormaps, colors, misc + + +@dataclass +class TensoRFModelConfig(VanillaModelConfig): + """TensoRF model config""" + + _target: Type = field(default_factory=lambda: TensoRFModel) + """target class to instantiate""" + init_resolution: int = 128 + """initial render resolution""" + final_resolution: int = 300 + """final render resolution""" + upsampling_iters: Tuple[int, ...] = (2000, 3000, 4000, 5500, 7000) + """specifies a list of iteration step numbers to perform upsampling""" + loss_coefficients: Dict[str, float] = to_immutable_dict({"rgb_loss": 1.0}) + """Loss specific weights.""" + num_samples: int = 256 + """Number of samples in field evaluation""" + num_den_components: int = 16 + """Number of components in density encoding""" + num_color_components: int = 48 + """Number of components in color encoding""" + appearance_dim: int = 27 + """Number of channels for color encoding""" + + +class TensoRFModel(Model): + """TensoRF Model + + Args: + config: TensoRF configuration to instantiate model + """ + + def __init__( + self, + config: TensoRFModelConfig, + **kwargs, + ) -> None: + self.init_resolution = config.init_resolution + self.upsampling_iters = config.upsampling_iters + self.num_den_components = config.num_den_components + self.num_color_components = config.num_color_components + self.appearance_dim = config.appearance_dim + self.upsampling_steps = ( + np.round( + np.exp( + np.linspace( + np.log(config.init_resolution), + np.log(config.final_resolution), + len(config.upsampling_iters) + 1, + ) + ) + ) + .astype("int") + .tolist()[1:] + ) + super().__init__(config=config, **kwargs) + + def get_training_callbacks( + self, training_callback_attributes: TrainingCallbackAttributes + ) -> List[TrainingCallback]: + + # the callback that we want to run every X iterations after the training iteration + def reinitialize_optimizer( + self, training_callback_attributes: TrainingCallbackAttributes, step: int # pylint: disable=unused-argument + ): + resolution = self.upsampling_steps.pop(0) + + # upsample the position and direction grids + self.field.density_encoding.upsample_grid(resolution) + self.field.color_encoding.upsample_grid(resolution) + + # reinitialize the encodings optimizer + optimizers_config = training_callback_attributes.optimizers.config + enc = training_callback_attributes.pipeline.get_param_groups()["encodings"] + lr_init = optimizers_config["encodings"]["optimizer"].lr + + training_callback_attributes.optimizers.optimizers["encodings"] = optimizers_config["encodings"][ + "optimizer" + ].setup(params=enc) + if optimizers_config["encodings"]["scheduler"]: + training_callback_attributes.optimizers.schedulers["encodings"] = optimizers_config["encodings"][ + "scheduler" + ].setup(optimizer=training_callback_attributes.optimizers.optimizers["encodings"], lr_init=lr_init) + + callbacks = [ + TrainingCallback( + where_to_run=[TrainingCallbackLocation.AFTER_TRAIN_ITERATION], + iters=self.upsampling_iters, + func=reinitialize_optimizer, + args=[self, training_callback_attributes], + ) + ] + return callbacks + + def populate_modules(self): + """Set the fields and modules""" + super().populate_modules() + + # setting up fields + density_encoding = TensorVMEncoding( + resolution=self.init_resolution, + num_components=self.num_den_components, + ) + color_encoding = TensorVMEncoding( + resolution=self.init_resolution, + num_components=self.num_color_components, + ) + + feature_encoding = NeRFEncoding(in_dim=self.appearance_dim, num_frequencies=2, min_freq_exp=0, max_freq_exp=2) + direction_encoding = NeRFEncoding(in_dim=3, num_frequencies=2, min_freq_exp=0, max_freq_exp=2) + + self.field = TensoRFField( + self.scene_box.aabb, + feature_encoding=feature_encoding, + direction_encoding=direction_encoding, + density_encoding=density_encoding, + color_encoding=color_encoding, + appearance_dim=self.appearance_dim, + head_mlp_num_layers=2, + head_mlp_layer_width=128, + use_sh=False, + ) + + # samplers + self.sampler_uniform = UniformSampler(num_samples=self.config.num_samples, single_jitter=True) + self.sampler_pdf = PDFSampler(num_samples=self.config.num_samples // 2, single_jitter=True) + + # renderers + self.renderer_rgb = RGBRenderer(background_color=colors.WHITE) + self.renderer_accumulation = AccumulationRenderer() + self.renderer_depth = DepthRenderer() + + # losses + self.rgb_loss = MSELoss() + + # metrics + self.psnr = PeakSignalNoiseRatio(data_range=1.0) + self.ssim = structural_similarity_index_measure + self.lpips = LearnedPerceptualImagePatchSimilarity() + + # colliders + if self.config.enable_collider: + self.collider = AABBBoxCollider(scene_box=self.scene_box) + + def get_param_groups(self) -> Dict[str, List[Parameter]]: + param_groups = {} + + param_groups["fields"] = ( + list(self.field.mlp_head.parameters()) + + list(self.field.B.parameters()) + + list(self.field.field_output_rgb.parameters()) + ) + param_groups["encodings"] = list(self.field.color_encoding.parameters()) + list( + self.field.density_encoding.parameters() + ) + + return param_groups + + def get_outputs(self, ray_bundle: RayBundle): + # uniform sampling + ray_samples_uniform = self.sampler_uniform(ray_bundle) + dens = self.field.get_density(ray_samples_uniform) + weights = ray_samples_uniform.get_weights(dens) + coarse_accumulation = self.renderer_accumulation(weights) + acc_mask = torch.where(coarse_accumulation < 0.0001, False, True).reshape(-1) + + # pdf sampling + ray_samples_pdf = self.sampler_pdf(ray_bundle, ray_samples_uniform, weights) + + # fine field: + field_outputs_fine = self.field.forward(ray_samples_pdf, acc_mask, colors.WHITE.to(weights.device)) + + weights_fine = ray_samples_pdf.get_weights(field_outputs_fine[FieldHeadNames.DENSITY]) + + accumulation = self.renderer_accumulation(weights_fine) + depth = self.renderer_depth(weights_fine, ray_samples_pdf) + + rgb = self.renderer_rgb( + rgb=field_outputs_fine[FieldHeadNames.RGB], + weights=weights_fine, + ) + + rgb = torch.where(accumulation < 0, colors.WHITE.to(rgb.device), rgb) + accumulation = torch.clamp(accumulation, min=0) + + outputs = {"rgb": rgb, "accumulation": accumulation, "depth": depth} + return outputs + + def get_loss_dict(self, outputs, batch, metrics_dict=None) -> Dict[str, torch.Tensor]: + # Scaling metrics by coefficients to create the losses. + device = outputs["rgb"].device + image = batch["image"].to(device) + + rgb_loss = self.rgb_loss(image, outputs["rgb"]) + + loss_dict = {"rgb_loss": rgb_loss} + loss_dict = misc.scale_dict(loss_dict, self.config.loss_coefficients) + return loss_dict + + def get_image_metrics_and_images( + self, outputs: Dict[str, torch.Tensor], batch: Dict[str, torch.Tensor] + ) -> Tuple[Dict[str, float], Dict[str, torch.Tensor]]: + image = batch["image"].to(outputs["rgb"].device) + rgb = outputs["rgb"] + acc = colormaps.apply_colormap(outputs["accumulation"]) + depth = colormaps.apply_depth_colormap( + outputs["depth"], + accumulation=outputs["accumulation"], + near_plane=self.config.collider_params["near_plane"], + far_plane=self.config.collider_params["far_plane"], + ) + + combined_rgb = torch.cat([image, rgb], dim=1) + + # Switch images from [H, W, C] to [1, C, H, W] for metrics computations + image = torch.moveaxis(image, -1, 0)[None, ...] + rgb = torch.moveaxis(rgb, -1, 0)[None, ...] + + psnr = self.psnr(image, rgb) + ssim = self.ssim(image, rgb) + lpips = self.lpips(image, rgb) + + metrics_dict = { + "psnr": float(psnr.item()), + "ssim": float(ssim.item()), + "lpips": float(lpips.item()), + } + images_dict = {"img": combined_rgb, "accumulation": acc, "depth": depth} + return metrics_dict, images_dict From 121771d126a1c90cf39013d8016e16effbfe8efc Mon Sep 17 00:00:00 2001 From: Matthew Tancik Date: Wed, 2 Nov 2022 22:17:45 -0700 Subject: [PATCH 23/68] Update render UI (#885) * Update render UI * update text --- nerfstudio/viewer/app/src/index.scss | 65 +++++++++++++ .../src/modules/RenderModal/RenderModal.jsx | 93 +++++++++++++++++++ .../app/src/modules/RenderModal/index.jsx | 3 + .../SidePanel/CameraPanel/CameraPanel.jsx | 32 +++---- 4 files changed, 177 insertions(+), 16 deletions(-) create mode 100644 nerfstudio/viewer/app/src/modules/RenderModal/RenderModal.jsx create mode 100644 nerfstudio/viewer/app/src/modules/RenderModal/index.jsx diff --git a/nerfstudio/viewer/app/src/index.scss b/nerfstudio/viewer/app/src/index.scss index c39522b58..a27610a81 100644 --- a/nerfstudio/viewer/app/src/index.scss +++ b/nerfstudio/viewer/app/src/index.scss @@ -96,6 +96,29 @@ $sidebar-color: $accent-color3 !default; $sidebar-width: 100% !default; @import '~react-pro-sidebar/dist/scss/styles.scss'; +// Scrollbar + +/* width */ +::-webkit-scrollbar { + width: 8px; + height: 6px; +} + +/* Track */ +::-webkit-scrollbar-track { + background: #454651; +} + +/* Handle */ +::-webkit-scrollbar-thumb { + background: $accent-color3; +} + +/* Handle on hover */ +::-webkit-scrollbar-thumb:hover { + background: $highlight-color2; +} + // ------------------------------------ // Status Panel styling .StatusPanel { @@ -161,6 +184,41 @@ $sidebar-width: 100% !default; margin: 3px; } +// ------------------------------------ +// Render Modal styling + +.RenderModal-box { + position: absolute; + top: 50%; + left: 50%; + transform: translate(-50%, -50%); + width: 600px; // 400 + background-color: $base-color2; + border: 2px solid #000; + // box-shadow: 24px 24px; + padding: 32px; +} + +.RenderModal-code { + padding: 10px; + background-color: $base-color3; + overflow-x: scroll; + font-family: monospace; + white-space: pre; + margin-top: 16px; +} + +.RenderModal-inline-code { + font-size: 0.9rem; + color: $accent-color3; +} + +.RenderModal-box .RenderModal-button { + width: 50%; + padding: 5px; + margin-top: 20px; +} + // ------------------------------------ // Camera Pane @@ -173,6 +231,13 @@ $sidebar-width: 100% !default; margin-top: 8px; } +.CameraPanel-render-button { + display: inline-block; + width: 70%; + margin: 4px; + margin-top: 8px; +} + .CameraPanel-slider-container { margin-top: 40px; margin-left: auto; diff --git a/nerfstudio/viewer/app/src/modules/RenderModal/RenderModal.jsx b/nerfstudio/viewer/app/src/modules/RenderModal/RenderModal.jsx new file mode 100644 index 000000000..6305d4043 --- /dev/null +++ b/nerfstudio/viewer/app/src/modules/RenderModal/RenderModal.jsx @@ -0,0 +1,93 @@ +/* eslint-disable react/jsx-props-no-spreading */ +import * as React from 'react'; + +import { Box, Button, Modal, TextField, Typography } from '@mui/material'; +import { useSelector } from 'react-redux'; +import ContentCopyRoundedIcon from '@mui/icons-material/ContentCopyRounded'; + +interface RenderModalProps { + open: object; + setOpen: object; +} + +export default function RenderModal(props: RenderModalProps) { + const open = props.open; + const setOpen = props.setOpen; + + // redux store state + const config_base_dir = useSelector( + (state) => state.renderingState.config_base_dir, + ); + + // react state + const [filename, setFilename] = React.useState('render_output'); + + const handleClose = () => setOpen(false); + + // Copy the text inside the text field + const config_filename = `${config_base_dir}/config.yml`; + const camera_path_filename = `${config_base_dir}/camera_path.json`; + const cmd = `ns-render --load-config ${config_filename} --traj filename --camera-path-filename ${camera_path_filename} --output-path renders/${filename}.mp4`; + + const text_intro = `To render a full resolution video, run the following command in a terminal.`; + + const handleCopy = () => { + navigator.clipboard.writeText(cmd); + }; + + return ( +
+ + + +
+

Rendering

+

+ {text_intro} +
+ The video will be saved to{' '} + + ./renders/{filename}.mp4 + + . +

+ { + setFilename(e.target.value); + }} + value={filename} + variant="standard" + /> +
{cmd}
+
+ +
+
+
+
+
+
+ ); +} diff --git a/nerfstudio/viewer/app/src/modules/RenderModal/index.jsx b/nerfstudio/viewer/app/src/modules/RenderModal/index.jsx new file mode 100644 index 000000000..347dbeb7a --- /dev/null +++ b/nerfstudio/viewer/app/src/modules/RenderModal/index.jsx @@ -0,0 +1,3 @@ +import RenderModal from './RenderModal'; + +export default RenderModal; diff --git a/nerfstudio/viewer/app/src/modules/SidePanel/CameraPanel/CameraPanel.jsx b/nerfstudio/viewer/app/src/modules/SidePanel/CameraPanel/CameraPanel.jsx index 9f1cf207d..d55915ab0 100644 --- a/nerfstudio/viewer/app/src/modules/SidePanel/CameraPanel/CameraPanel.jsx +++ b/nerfstudio/viewer/app/src/modules/SidePanel/CameraPanel/CameraPanel.jsx @@ -19,12 +19,10 @@ import AddAPhotoIcon from '@mui/icons-material/AddAPhoto'; import ArrowBackIosNewIcon from '@mui/icons-material/ArrowBackIosNew'; import ArrowForwardIosIcon from '@mui/icons-material/ArrowForwardIos'; import { CSS2DObject } from 'three/examples/jsm/renderers/CSS2DRenderer'; -import ContentPasteGoIcon from '@mui/icons-material/ContentPasteGo'; import DeleteIcon from '@mui/icons-material/Delete'; import FirstPageIcon from '@mui/icons-material/FirstPage'; import FileDownloadOutlinedIcon from '@mui/icons-material/FileDownloadOutlined'; import FileUploadOutlinedIcon from '@mui/icons-material/FileUploadOutlined'; -import IconButton from '@mui/material/IconButton'; import LastPageIcon from '@mui/icons-material/LastPage'; import PauseIcon from '@mui/icons-material/Pause'; import PlayArrowIcon from '@mui/icons-material/PlayArrow'; @@ -32,9 +30,11 @@ import { Stack } from '@mui/system'; import TextField from '@mui/material/TextField'; import Tooltip from '@mui/material/Tooltip'; import VisibilityIcon from '@mui/icons-material/Visibility'; +import VideoCameraBackIcon from '@mui/icons-material/VideoCameraBack'; import { CameraHelper } from './CameraHelper'; import { get_curve_object_from_cameras, get_transform_matrix } from './curve'; import { WebSocketContext } from '../../WebSocket/WebSocket'; +import RenderModal from '../../RenderModal'; const msgpack = require('msgpack-lite'); @@ -198,6 +198,7 @@ export default function CameraPanel(props) { const [is_linear, setIsLinear] = React.useState(false); const [seconds, setSeconds] = React.useState(4); const [fps, setFps] = React.useState(24); + const [render_modal_open, setRenderModalOpen] = React.useState(false); const dispatch = useDispatch(); const render_height = useSelector( @@ -529,16 +530,11 @@ export default function CameraPanel(props) { fr.readAsText(fileUpload); }; - const copy_cmd_to_clipboard = () => { - console.log('copy_cmd_to_clipboard'); + const open_render_modal = () => { + setRenderModalOpen(true); const camera_path_object = get_camera_path(); - - // Copy the text inside the text field - const config_filename = `${config_base_dir}/config.yml`; const camera_path_filename = `${config_base_dir}/camera_path.json`; - const cmd = `ns-render --load-config ${config_filename} --traj filename --camera-path-filename ${camera_path_filename} --output-path renders/output.mp4`; - navigator.clipboard.writeText(cmd); const camera_path_payload = { camera_path_filename, @@ -597,13 +593,17 @@ export default function CameraPanel(props) { Export Path -
- - - - - -
+
+ +
Date: Thu, 3 Nov 2022 10:43:52 -0700 Subject: [PATCH 24/68] Record3D Dataparser moved to ns-process-data script. (#872) * init commit. * added docstring. * added tyro command. * bugfix. * added max dataset size logic. * string cleanup. * updated depracation warning. * typo. --- .../data/dataparsers/record3d_dataparser.py | 9 + scripts/process_data.py | 197 ++++++++++++++++-- 2 files changed, 188 insertions(+), 18 deletions(-) diff --git a/nerfstudio/data/dataparsers/record3d_dataparser.py b/nerfstudio/data/dataparsers/record3d_dataparser.py index cd3a94039..099470d01 100644 --- a/nerfstudio/data/dataparsers/record3d_dataparser.py +++ b/nerfstudio/data/dataparsers/record3d_dataparser.py @@ -21,6 +21,7 @@ from typing import Type import numpy as np import torch +from rich.console import Console from scipy.spatial.transform import Rotation from typing_extensions import Literal @@ -35,6 +36,8 @@ from nerfstudio.data.scene_box import SceneBox from nerfstudio.utils import poses as pose_utils from nerfstudio.utils.io import load_from_json +CONSOLE = Console(width=120) + @dataclass class Record3DDataParserConfig(DataParserConfig): @@ -62,6 +65,12 @@ class Record3D(DataParser): config: Record3DDataParserConfig def _generate_dataparser_outputs(self, split: str = "train") -> DataparserOutputs: + + CONSOLE.print( + "[bold red]DEPRECATION WARNING: The Record3D dataparser will be deprecated in future versions. " + "Use `ns-data-process record3d` to convert the data into the nerfstudio format instead." + ) + image_dir = self.config.data / "rgb" if not image_dir.exists(): diff --git a/scripts/process_data.py b/scripts/process_data.py index d83d1d762..6f65165af 100755 --- a/scripts/process_data.py +++ b/scripts/process_data.py @@ -17,9 +17,10 @@ import requests import tyro from rich.console import Console from rich.progress import track +from scipy.spatial.transform import Rotation from typing_extensions import Annotated, Literal -from nerfstudio.utils import colmap_utils, install_checks +from nerfstudio.utils import colmap_utils, install_checks, io CONSOLE = Console(width=120) @@ -250,6 +251,41 @@ def convert_insta360_to_images( return summary_log, num_final_frames +def copy_images_list(image_paths: List[Path], image_dir: Path, verbose) -> List[Path]: + """Copy all images in a list of Paths. Useful for filtering from a directory. + Args: + image_paths: List of Paths of images to copy to a new directory. + image_dir: Path to the output directory. + verbose: If True, print extra logging. + Returns: + A list of the copied image Paths. + """ + + # Remove original directory only if we provide a proper image folder path + if image_dir.is_dir() and len(image_paths): + shutil.rmtree(image_dir, ignore_errors=True) + image_dir.mkdir(exist_ok=True, parents=True) + + copied_image_paths = [] + + # Images should be 1-indexed for the rest of the pipeline. + for idx, image_path in enumerate(image_paths): + if verbose: + CONSOLE.log(f"Copying image {idx + 1} of {len(image_paths)}...") + copied_image_path = image_dir / f"frame_{idx + 1:05d}{image_path.suffix}" + shutil.copy(image_path, copied_image_path) + copied_image_paths.append(copied_image_path) + + num_frames = len(image_paths) + + if num_frames == 0: + CONSOLE.log("[bold red]:skull: No usable images in the data folder.") + else: + CONSOLE.log("[bold green]:tada: Done copying images.") + + return copied_image_paths + + def copy_images(data: Path, image_dir: Path, verbose) -> int: """Copy images from a directory to a new directory. @@ -264,23 +300,7 @@ def copy_images(data: Path, image_dir: Path, verbose) -> int: allowed_exts = [".jpg", ".jpeg", ".png", ".tif", ".tiff"] image_paths = sorted([p for p in data.glob("[!.]*") if p.suffix.lower() in allowed_exts]) - # Remove original directory only if we provide a proper image folder path - if image_dir.is_dir() and len(image_paths): - shutil.rmtree(image_dir, ignore_errors=True) - image_dir.mkdir(exist_ok=True, parents=True) - - # Images should be 1-indexed for the rest of the pipeline. - for idx, image_path in enumerate(image_paths): - if verbose: - CONSOLE.log(f"Copying image {idx + 1} of {len(image_paths)}...") - shutil.copy(image_path, image_dir / f"frame_{idx + 1:05d}{image_path.suffix}") - - num_frames = len(image_paths) - - if num_frames == 0: - CONSOLE.log("[bold red]:skull: No usable images in the data folder.") - else: - CONSOLE.log("[bold green]:tada: Done copying images.") + num_frames = len(copy_images_list(image_paths, image_dir, verbose)) return num_frames @@ -487,6 +507,72 @@ def colmap_to_json(cameras_path: Path, images_path: Path, output_dir: Path, came return len(frames) +def record3d_to_json(images_paths: List[Path], metadata_path: Path, output_dir: Path, indices: np.ndarray) -> int: + """Converts Record3D's metadata and image paths to a JSON file. + + Args: + images_paths: list if image paths. + metadata_path: Path to the Record3D metadata JSON file. + output_dir: Path to the output directory. + indices: Indices to sample the metadata_path. Should be the same length as images_paths. + + Returns: + The number of registered images. + """ + + assert len(images_paths) == len(indices) + + metadata_dict = io.load_from_json(metadata_path) + + poses_data = np.array(metadata_dict["poses"]) # (N, 3, 4) + camera_to_worlds = np.concatenate( + [Rotation.from_quat(poses_data[:, :4]).as_matrix(), poses_data[:, 4:, None]], + axis=-1, + ).astype(np.float32) + camera_to_worlds = camera_to_worlds[indices] + + homogeneous_coord = np.zeros_like(camera_to_worlds[..., :1, :]) + homogeneous_coord[..., :, 3] = 1 + camera_to_worlds = np.concatenate([camera_to_worlds, homogeneous_coord], -2) + + frames = [] + for i, im_path in enumerate(images_paths): + c2w = camera_to_worlds[i] + frame = { + "file_path": im_path.as_posix(), + "transform_matrix": c2w.tolist(), + } + frames.append(frame) + + # Camera intrinsics + K = np.array(metadata_dict["K"]).reshape((3, 3)).T + focal_length = K[0, 0] + + H = metadata_dict["h"] + W = metadata_dict["w"] + + # TODO(akristoffersen): The metadata dict comes with principle points, + # but caused errors in image coord indexing. Should update once that is fixed. + cx, cy = W / 2, H / 2 + + out = { + "fl_x": focal_length, + "fl_y": focal_length, + "cx": cx, + "cy": cy, + "w": W, + "h": H, + "camera_model": CAMERA_MODELS["perspective"].name, + } + + out["frames"] = frames + + with open(output_dir / "transforms.json", "w", encoding="utf-8") as f: + json.dump(out, f, indent=4) + + return len(frames) + + def get_insta360_filenames(data: Path) -> Tuple[Path, Path]: """Returns the filenames of the Insta360 videos from a single video file. @@ -801,10 +887,85 @@ class ProcessInsta360: CONSOLE.rule() +@dataclass +class ProcessRecord3D: + """Process Record3D data into a nerfstudio dataset. + + This script does the following: + + 1. Scales images to a specified size. + 2. Converts Record3D poses into the nerfacto format. + """ + + data: Path + """Path the data, either a video file or a directory of images.""" + output_dir: Path + """Path to the output directory.""" + num_downscales: int = 3 + """Number of times to downscale the images. Downscales by 2 each time. For example a value of 3 + will downscale the images by 2x, 4x, and 8x.""" + max_dataset_size: int = 300 + """Max number of images to train on. If the dataset has more, images will be sampled approximately evenly. If -1, + use all images.""" + + verbose: bool = False + """If True, print extra logging.""" + + def main(self) -> None: + """Process images into a nerfstudio dataset.""" + + self.output_dir.mkdir(parents=True, exist_ok=True) + image_dir = self.output_dir / "images" + image_dir.mkdir(parents=True, exist_ok=True) + + summary_log = [] + + record3d_image_dir = self.data / "rgb" + + if not record3d_image_dir.exists(): + raise ValueError(f"Image directory {image_dir} doesn't exist") + + record3d_image_filenames = [] + for f in record3d_image_dir.iterdir(): + if f.stem.isdigit(): # removes possible duplicate images (for example, 123(3).jpg) + record3d_image_filenames.append(f) + + record3d_image_filenames = sorted(record3d_image_filenames, key=lambda fn: int(fn.stem)) + num_images = len(record3d_image_filenames) + idx = np.arange(num_images) + if self.max_dataset_size != -1 and num_images > self.max_dataset_size: + idx = np.round(np.linspace(0, num_images - 1, self.max_dataset_size)).astype(int) + + record3d_image_filenames = list(np.array(record3d_image_filenames)[idx]) + # Copy images to output directory + copied_image_paths = copy_images_list(record3d_image_filenames, image_dir=image_dir, verbose=self.verbose) + num_frames = len(copied_image_paths) + + copied_image_paths = [Path("images/" + copied_image_path.name) for copied_image_path in copied_image_paths] + summary_log.append(f"Used {num_frames} images out of {num_images} total") + if self.max_dataset_size > 0: + summary_log.append( + "To change the size of the dataset add the argument --max_dataset_size to larger than the " + f"current value ({self.max_dataset_size}), or -1 to use all images." + ) + + # Downscale images + summary_log.append(downscale_images(image_dir, self.num_downscales, verbose=self.verbose)) + + metadata_path = self.data / "metadata.json" + record3d_to_json(copied_image_paths, metadata_path, self.output_dir, indices=idx) + CONSOLE.rule("[bold green]:tada: :tada: :tada: All DONE :tada: :tada: :tada:") + + for summary in summary_log: + CONSOLE.print(summary, justify="center") + CONSOLE.rule() + + Commands = Union[ Annotated[ProcessImages, tyro.conf.subcommand(name="images")], Annotated[ProcessVideo, tyro.conf.subcommand(name="video")], Annotated[ProcessInsta360, tyro.conf.subcommand(name="insta360")], + Annotated[ProcessRecord3D, tyro.conf.subcommand(name="record3d")], ] From cda22ce606146a84a6446facd9111ba8645ed4e0 Mon Sep 17 00:00:00 2001 From: Matthew Tancik Date: Thu, 3 Nov 2022 12:24:28 -0700 Subject: [PATCH 25/68] v0.1.8 (#890) --- pyproject.toml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pyproject.toml b/pyproject.toml index 85de64ec9..c08d82dbe 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta" [project] name = "nerfstudio" -version = "0.1.7" +version = "0.1.8" description = "All-in-one repository for state-of-the-art NeRFs" readme = "README.md" license = { text="Apache 2.0"} From afd6fec6e73557e662978af742fd1c464e92f556 Mon Sep 17 00:00:00 2001 From: Matthew Tancik Date: Thu, 3 Nov 2022 16:45:00 -0700 Subject: [PATCH 26/68] Add docs for nerfacto (#891) --- .../nerfacto/models_nerfacto_field-dark.png | Bin 0 -> 33216 bytes .../nerfacto/models_nerfacto_field-light.png | Bin 0 -> 36289 bytes .../models_nerfacto_pipeline-dark.png | Bin 0 -> 41784 bytes .../models_nerfacto_pipeline-light.png | Bin 0 -> 44934 bytes docs/nerfology/methods/nerfacto.md | 73 +++++++++++++++--- 5 files changed, 63 insertions(+), 10 deletions(-) create mode 100644 docs/nerfology/methods/imgs/nerfacto/models_nerfacto_field-dark.png create mode 100644 docs/nerfology/methods/imgs/nerfacto/models_nerfacto_field-light.png create mode 100644 docs/nerfology/methods/imgs/nerfacto/models_nerfacto_pipeline-dark.png create mode 100644 docs/nerfology/methods/imgs/nerfacto/models_nerfacto_pipeline-light.png diff --git a/docs/nerfology/methods/imgs/nerfacto/models_nerfacto_field-dark.png b/docs/nerfology/methods/imgs/nerfacto/models_nerfacto_field-dark.png new file mode 100644 index 0000000000000000000000000000000000000000..8e37c83263f9643a7f1582e04321df2a167123c9 GIT binary patch literal 33216 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 JS?83{1OQr<2`>Nu literal 0 HcmV?d00001 diff --git a/docs/nerfology/methods/imgs/nerfacto/models_nerfacto_pipeline-dark.png b/docs/nerfology/methods/imgs/nerfacto/models_nerfacto_pipeline-dark.png new file mode 100644 index 0000000000000000000000000000000000000000..c80fbd7ede6bcdce557d07c6668ad7b5853a08d9 GIT binary patch literal 41784 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 literal 0 HcmV?d00001 diff --git a/docs/nerfology/methods/imgs/nerfacto/models_nerfacto_pipeline-light.png b/docs/nerfology/methods/imgs/nerfacto/models_nerfacto_pipeline-light.png new file mode 100644 index 0000000000000000000000000000000000000000..e62869cab770b5b063ae8ad9819a52f93460abb7 GIT binary patch literal 44934 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 w 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 *defacto* method. - + ### Running the Method - + ```bash ns-train nerfacto --help ``` - + ## Method - + ### Overview - -```{admonition} Coming Soon -This guide is coming soon. This is our flagship method that we encourage creators to use when making videos. It uses techniques from [Mip-NeRF 360](https://jonbarron.info/mipnerf360/) and [Instant-NGP](https://nvlabs.github.io/instant-ngp/). + +We created the nerfacto model to act as our default for real data captures of static scenes. The model is not existing published work, but rather a combination of many published methods that we have found work well for real data. This guide discusses the details of the model, understanding the [NeRF model](./nerf.md) is a prerequisite. + +```{admonition} TLDR +We combine the following techniques in this model: +* Camera pose refinement +* Per image appearance conditioning +* Proposal sampling +* Scene contraction +* Hash encoding ``` - -Most of the code for this method takes place in the `NerfactoModel` class. - + +```{warning} +🏗️ This guide is under construction 🏗️ +``` + +## Pipeline + +```{image} imgs/nerfacto/models_nerfacto_pipeline-light.png +:align: center +:class: only-light +``` + +```{image} imgs/nerfacto/models_nerfacto_pipeline-dark.png +:align: center +:class: only-dark +``` + +Here is an overview pipeline for nerfacto, we will walk through each component in this guide. + +### Pose Refinement + +It is not uncommon to have errors in the predicted camera poses. This is even more of a factor when using poses acquired from devices such as phones (ie. if you use the Record3D IOS app to capture data). Misaligned poses result in both cloudy artifacts in the scene and a reduction of sharpness and details. The NeRF framework allows us to backpropagate loss gradients to the input pose calculations. We can use this information to optimize and refine the poses. + +### Piecewise Sampler + +We use a Piecewise sampler to produce the initial set of samples of the scene. This sampler allocates half of the samples uniformly up to a distance of 1 from the camera. The remaining samples are distributed such that the step size increases with each sample. The step size is chosen such that the [frustums](../model_components/visualize_samples.ipynb) are scaled versions of themselves. By increasing the step sizes, we are able to sample distant objects will still having a dense set of samples for nearby objects. + +### Proposal Sampler + +The proposal sampler consolidates the sample locations to the regions of the scene that contribute most to the final render (typically the first surface intersection). This greatly improves reconstruction quality. The proposal network sampler requires a density function for the scene. The density function can be implemented in a variety of ways, we find that using a small fused-mlp with a hash encoding has sufficient accuracy and is fast. The proposal network sampler can be chained together with multiple density functions to further consolidate the sampling. We have found that two density functions are better than one. Larger than 2 leads to diminishing returns. + +#### Density Field + +The density field only needs to represent a coarse density representation of the scene to guide sampling. Combining a hash encoding with a small fused MLP (from [tiny-cuda-nn](https://github.com/NVlabs/tiny-cuda-nn)) provides a fast way to query the scene. We can make it more efficient by decreasing the encoding dictionary size and number of feature levels. These simplifications have little impact on the reconstruction quality because the density function does not need to learn high frequency details during the initial passes. + +### Nerfacto Field + +```{image} imgs/nerfacto/models_nerfacto_field-light.png +:align: center +:class: only-light +:width: 600 +``` + +```{image} imgs/nerfacto/models_nerfacto_field-dark.png +:align: center +:class: only-dark +:width: 600 +``` + ```{button-link} https://github.com/nerfstudio-project/nerfstudio/blob/main/nerfstudio/models/nerfacto.py :color: primary :outline: From 93839ca3f0dea0ba57e59a049b82a5e26b37e362 Mon Sep 17 00:00:00 2001 From: Ethan Weber Date: Fri, 4 Nov 2022 17:18:14 -0700 Subject: [PATCH 27/68] Camera and world coordinate conventions (#889) * documented coordinate conventions without a figure for now * another sentence * update frames docs * explain intrinsics and extrinsics * more comments * fix build --- docs/index.md | 1 + docs/quickstart/data_conventions.md | 69 +++++++++++++++++++++++++++++ 2 files changed, 70 insertions(+) create mode 100644 docs/quickstart/data_conventions.md diff --git a/docs/index.md b/docs/index.md index c5c75a64a..db68182d2 100644 --- a/docs/index.md +++ b/docs/index.md @@ -50,6 +50,7 @@ quickstart/installation quickstart/first_nerf quickstart/custom_dataset quickstart/viewer_quickstart +quickstart/data_conventions Contributing ``` diff --git a/docs/quickstart/data_conventions.md b/docs/quickstart/data_conventions.md new file mode 100644 index 000000000..98095af95 --- /dev/null +++ b/docs/quickstart/data_conventions.md @@ -0,0 +1,69 @@ +# Data conventions + +## Coordinate conventions + +Here we explain the coordinate conventions for using our repo. + +### Camera/view space + +We use the OpenGL/Blender (and original NeRF) coordinate convention for cameras. +X is right, +Y is up, and +Z is pointing back and away from the camera. -Z is the look-at direction. Other codebases may use the COLMAP/OpenCV convention, where the Y and Z axes are flipped from ours but the +X axis remains the same. + +### World space + +Our world space is oriented such that the up vector is +Z. The XY plane is parallel to the ground plane. In the viewer, you'll notice that red, green, and blue vectors correspond to X, Y, and Z respectively. + +
+ +## Dataset format + +Our explanation here is for the nerfstudio data format. The `transforms.json` has a similar format to [Instant NGP](https://github.com/NVlabs/instant-ngp). + +**Camera intrinsics** + +At the top of the file, we specify the camera intrinsics. We assume that all the intrinsics parameters are the same for every camera in the dataset. The following is an example + +```json +{ + "fl_x": 1072.281897246229, // focal length x + "fl_y": 1068.6906965388932, // focal length y + "cx": 1504.0, // principal point x + "cy": 1000.0, // principal point y + "w": 3008, // image width + "h": 2000, // image height + "camera_model": "OPENCV_FISHEYE", // camera model type + "k1": 0.03126218448029553, // first radial distorial parameter + "k2": 0.005177020067511987, // second radial distorial parameter + "k3": 0.0006640977794272005, // third radial distorial parameter + "k4": 0.00010067035656515042, // fourth radial distorial parameter + "p1": -6.472477652140879e-5, // first tangential distortion parameter + "p2": -1.374647851912992e-7, // second tangential distortion parameter + "frames": // ... extrinsics parameters explained below +} +``` + +The valid `camera_model` strings are currently "OPENCV" and "OPENCV_FISHEYE". "OPENCV" (i.e., perspective) uses k1-2 and p1-2. "OPENCV_FISHEYE" uses k1-4. + +**Camera extrinsics** + +For a transform matrix, the first 3 columns are the +X, +Y, and +Z defining the camera orientation, and the X, Y, Z values define the origin. The last row is to be compatible with homogeneous coordinates. + +```json +{ + // ... intrinsics parameters + "frames": [ + { + "file_path": "images/frame_00001.jpeg", + "transform_matrix": [ + // [+X0 +Y0 +Z0 X] + // [+X1 +Y1 +Z1 Y] + // [+X2 +Y2 +Z2 Z] + // [0.0 0.0 0.0 1] + [1.0, 0.0, 0.0, 0.0], + [0.0, 1.0, 0.0, 0.0], + [0.0, 0.0, 1.0, 0.0], + [0.0, 0.0, 0.0, 1.0] + ] + } + ] +} +``` From 71601f304f3e194a2c359d476385d84c73123a46 Mon Sep 17 00:00:00 2001 From: Matthew Tancik Date: Fri, 4 Nov 2022 17:30:29 -0700 Subject: [PATCH 28/68] Start viewer with more accurate speed calculation (#899) Start viewer with more accurate speed calc --- nerfstudio/engine/trainer.py | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/nerfstudio/engine/trainer.py b/nerfstudio/engine/trainer.py index 8959b27c7..74e3d25bf 100644 --- a/nerfstudio/engine/trainer.py +++ b/nerfstudio/engine/trainer.py @@ -149,12 +149,14 @@ class Trainer: for callback in self.callbacks: callback.run_callback_at_location(step, location=TrainingCallbackLocation.AFTER_TRAIN_ITERATION) - writer.put_time( - name=EventName.TRAIN_RAYS_PER_SEC, - duration=self.config.pipeline.datamanager.train_num_rays_per_batch / train_t.duration, - step=step, - avg_over_steps=True, - ) + # Skip the first two steps to avoid skewed timings that break the viewer rendering speed estimate. + if step > 1: + writer.put_time( + name=EventName.TRAIN_RAYS_PER_SEC, + duration=self.config.pipeline.datamanager.train_num_rays_per_batch / train_t.duration, + step=step, + avg_over_steps=True, + ) self._update_viewer_state(step) From 761645de05270264ad8103745ff6a252d00e8fa3 Mon Sep 17 00:00:00 2001 From: Matthew Tancik Date: Sat, 5 Nov 2022 22:00:28 -0700 Subject: [PATCH 29/68] Minor doc updates (#903) --- README.md | 6 +++--- docs/quickstart/custom_dataset.md | 2 +- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 19a0dc839..5f166ae41 100644 --- a/README.md +++ b/README.md @@ -110,7 +110,7 @@ Easy option: pip install nerfstudio ``` -If you would want the latest and greatest: +If you want the latest and greatest: ```bash git clone https://github.com/nerfstudio-project/nerfstudio.git @@ -135,9 +135,9 @@ If you have custom data in the form of a video or folder of images, we've provid After installing both software, you can process your data via: ```bash -ns-process-data {video,images,insta360} --data {DATA_PATH} --output-dir {PROCESSED_DATA_DIR} +ns-process-data {video,images,insta360,record3d} --data {DATA_PATH} --output-dir {PROCESSED_DATA_DIR} # Or if you're on a system without an attached display (i.e. colab): -ns-process-data {video,images,insta360} --data {DATA_PATH} --output-dir {PROCESSED_DATA_DIR} --no-gpu +ns-process-data {video,images,insta360,record3d} --data {DATA_PATH} --output-dir {PROCESSED_DATA_DIR} --no-gpu ``` ## 3. Training a model diff --git a/docs/quickstart/custom_dataset.md b/docs/quickstart/custom_dataset.md index f0a170280..960a38422 100644 --- a/docs/quickstart/custom_dataset.md +++ b/docs/quickstart/custom_dataset.md @@ -9,7 +9,7 @@ To assist running on custom data we have a script that will process a video or f To process your data run: ```bash -ns-process-data {video,images,insta360} --data {DATA_PATH} --output-dir {PROCESSED_DATA_DIR} +ns-process-data {video,images,insta360,record3d} --data {DATA_PATH} --output-dir {PROCESSED_DATA_DIR} ``` A full set of arguments can be found {doc}`here
`. From 1a24f3e58c544bc0211563e770d425426284256c Mon Sep 17 00:00:00 2001 From: Nikhil Mohan <47728081+nikmo33@users.noreply.github.com> Date: Sun, 6 Nov 2022 15:40:43 +0000 Subject: [PATCH 30/68] Refactor Data Pipeline (#896) * add none check * black formatting * cleanup * cleanup * fix tests * remove new line * init * toy example working * semantic nerf working * simplify pixel samplers * cleanup + fix tests * comments * fix tests * fix tests --- docs/developer_guides/pipelines/fields.md | 2 - docs/reference/api/data.rst | 2 +- nerfstudio/configs/method_configs.py | 5 +- .../base_datamanager.py} | 19 +++++-- .../data/datamanagers/semantic_datamanager.py | 45 +++++++++++++++ .../data/dataparsers/base_dataparser.py | 35 +++++------- .../data/dataparsers/friends_dataparser.py | 56 ++----------------- .../datasets.py => datasets/base_dataset.py} | 26 ++++++--- nerfstudio/data/datasets/semantic_dataset.py | 49 ++++++++++++++++ nerfstudio/data/pixel_samplers.py | 25 ++------- nerfstudio/data/utils/data_utils.py | 45 +++++++++++++++ nerfstudio/data/utils/dataloaders.py | 2 +- nerfstudio/field_components/field_heads.py | 30 ---------- nerfstudio/fields/nerfacto_field.py | 16 ++---- nerfstudio/models/semantic_nerfw.py | 40 ++++--------- nerfstudio/pipelines/base_pipeline.py | 5 +- nerfstudio/pipelines/dynamic_batch.py | 2 +- nerfstudio/viewer/server/viewer_utils.py | 20 +++---- scripts/viewer/view_dataset.py | 2 +- 19 files changed, 229 insertions(+), 197 deletions(-) rename nerfstudio/data/{datamanagers.py => datamanagers/base_datamanager.py} (96%) create mode 100644 nerfstudio/data/datamanagers/semantic_datamanager.py rename nerfstudio/data/{utils/datasets.py => datasets/base_dataset.py} (77%) create mode 100644 nerfstudio/data/datasets/semantic_dataset.py create mode 100644 nerfstudio/data/utils/data_utils.py diff --git a/docs/developer_guides/pipelines/fields.md b/docs/developer_guides/pipelines/fields.md index 8c6c6005f..f4c9c6d2e 100644 --- a/docs/developer_guides/pipelines/fields.md +++ b/docs/developer_guides/pipelines/fields.md @@ -69,8 +69,6 @@ class FieldHeadNames(Enum): TRANSIENT_RGB = "transient_rgb" TRANSIENT_DENSITY = "transient_density" SEMANTICS = "semantics" - SEMANTICS_STUFF = "semantics_stuff" - SEMANTICS_THING = "semantics_thing" ``` ```{button-link} https://github.com/nerfstudio-project/nerfstudio/blob/master/nerfstudio/field_components/field_heads.py diff --git a/docs/reference/api/data.rst b/docs/reference/api/data.rst index a0ac5a2b2..de7b57abe 100644 --- a/docs/reference/api/data.rst +++ b/docs/reference/api/data.rst @@ -13,7 +13,7 @@ Data Parsers Datasets ---------------- -.. automodule:: nerfstudio.data.utils.datasets +.. automodule:: nerfstudio.data.datasets :members: :show-inheritance: diff --git a/nerfstudio/configs/method_configs.py b/nerfstudio/configs/method_configs.py index f99110569..377c782aa 100644 --- a/nerfstudio/configs/method_configs.py +++ b/nerfstudio/configs/method_configs.py @@ -29,7 +29,8 @@ from nerfstudio.configs.base_config import ( TrainerConfig, ViewerConfig, ) -from nerfstudio.data.datamanagers import VanillaDataManagerConfig +from nerfstudio.data.datamanagers.base_datamanager import VanillaDataManagerConfig +from nerfstudio.data.datamanagers.semantic_datamanager import SemanticDataManagerConfig from nerfstudio.data.dataparsers.blender_dataparser import BlenderDataParserConfig from nerfstudio.data.dataparsers.friends_dataparser import FriendsDataParserConfig from nerfstudio.data.dataparsers.nerfstudio_dataparser import NerfstudioDataParserConfig @@ -127,7 +128,7 @@ method_configs["semantic-nerfw"] = Config( method_name="semantic-nerfw", trainer=TrainerConfig(steps_per_eval_batch=500, steps_per_save=2000, mixed_precision=True), pipeline=VanillaPipelineConfig( - datamanager=VanillaDataManagerConfig( + datamanager=SemanticDataManagerConfig( dataparser=FriendsDataParserConfig(), train_num_rays_per_batch=4096, eval_num_rays_per_batch=8192 ), model=SemanticNerfWModelConfig(eval_num_rays_per_chunk=1 << 16), diff --git a/nerfstudio/data/datamanagers.py b/nerfstudio/data/datamanagers/base_datamanager.py similarity index 96% rename from nerfstudio/data/datamanagers.py rename to nerfstudio/data/datamanagers/base_datamanager.py index 2e908ad35..82cf4a0d5 100644 --- a/nerfstudio/data/datamanagers.py +++ b/nerfstudio/data/datamanagers/base_datamanager.py @@ -41,13 +41,13 @@ from nerfstudio.data.dataparsers.instant_ngp_dataparser import ( ) from nerfstudio.data.dataparsers.nerfstudio_dataparser import NerfstudioDataParserConfig from nerfstudio.data.dataparsers.record3d_dataparser import Record3DDataParserConfig +from nerfstudio.data.datasets.base_dataset import InputDataset from nerfstudio.data.pixel_samplers import PixelSampler from nerfstudio.data.utils.dataloaders import ( CacheDataloader, FixedIndicesEvalDataloader, RandIndicesEvalDataloader, ) -from nerfstudio.data.utils.datasets import InputDataset from nerfstudio.engine.callbacks import TrainingCallback, TrainingCallbackAttributes from nerfstudio.model_components.ray_generators import RayGenerator from nerfstudio.utils.misc import IterableWrapper @@ -296,13 +296,22 @@ class VanillaDataManager(DataManager): # pylint: disable=abstract-method self.world_size = world_size self.local_rank = local_rank self.sampler = None + self.test_mode = test_mode - self.train_dataset = InputDataset(config.dataparser.setup().get_dataparser_outputs(split="train")) - self.eval_dataset = InputDataset( - config.dataparser.setup().get_dataparser_outputs(split="val" if not test_mode else "test") - ) + self.train_dataset = self.create_train_dataset() + self.eval_dataset = self.create_eval_dataset() super().__init__() + def create_train_dataset(self) -> InputDataset: + """Sets up the data loaders for training""" + return InputDataset(self.config.dataparser.setup().get_dataparser_outputs(split="train")) + + def create_eval_dataset(self) -> InputDataset: + """Sets up the data loaders for evaluation""" + return InputDataset( + self.config.dataparser.setup().get_dataparser_outputs(split="val" if not self.test_mode else "test") + ) + def setup_train(self): """Sets up the data loaders for training""" assert self.train_dataset is not None diff --git a/nerfstudio/data/datamanagers/semantic_datamanager.py b/nerfstudio/data/datamanagers/semantic_datamanager.py new file mode 100644 index 000000000..a66e4f365 --- /dev/null +++ b/nerfstudio/data/datamanagers/semantic_datamanager.py @@ -0,0 +1,45 @@ +# Copyright 2022 The Nerfstudio Team. All rights reserved. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +from dataclasses import dataclass, field +from typing import Type + +from nerfstudio.data.datamanagers.base_datamanager import ( + VanillaDataManager, + VanillaDataManagerConfig, +) +from nerfstudio.data.datasets.semantic_dataset import SemanticDataset + + +@dataclass +class SemanticDataManagerConfig(VanillaDataManagerConfig): + """A semantic datamanager - required to use with .setup()""" + + _target: Type = field(default_factory=lambda: SemanticDataManager) + + +class SemanticDataManager(VanillaDataManager): # pylint: disable=abstract-method + """Data manager implementation for data that also requires processing semantic data. + + Args: + config: the DataManagerConfig used to instantiate class + """ + + def create_train_dataset(self) -> SemanticDataset: + return SemanticDataset(self.config.dataparser.setup().get_dataparser_outputs(split="train")) + + def create_eval_dataset(self) -> SemanticDataset: + return SemanticDataset( + self.config.dataparser.setup().get_dataparser_outputs(split="val" if not self.test_mode else "test") + ) diff --git a/nerfstudio/data/dataparsers/base_dataparser.py b/nerfstudio/data/dataparsers/base_dataparser.py index 5f19f126c..3b99f274e 100644 --- a/nerfstudio/data/dataparsers/base_dataparser.py +++ b/nerfstudio/data/dataparsers/base_dataparser.py @@ -34,18 +34,14 @@ from nerfstudio.data.scene_box import SceneBox class Semantics: """Dataclass for semantic labels.""" - stuff_filenames: List[Path] - """filenames to load "stuff"/background data""" - stuff_classes: List[str] - """class labels for "stuff" data""" - stuff_colors: torch.Tensor - """color mapping for "stuff" classes""" - thing_filenames: List[Path] - """filenames to load "thing"/foreground data""" - thing_classes: List[str] - """class labels for "thing" data""" - thing_colors: torch.Tensor - """color mapping for "thing" classes""" + filenames: List[Path] + """filenames to load semantic data""" + classes: List[str] + """class labels for data""" + colors: torch.Tensor + """color mapping for classes""" + mask_classes: List[str] = field(default_factory=lambda: []) + """classes to mask out from training for all modalities""" @dataclass @@ -61,16 +57,11 @@ class DataparserOutputs: """Color of dataset background.""" scene_box: SceneBox = SceneBox() """Scene box of dataset. Used to bound the scene or provide the scene scale depending on model.""" - semantics: Optional[Semantics] = None - """Semantics information.""" - times: Optional[TensorType[1]] = None - """Time in range [0,1] for when each image was taken.""" - additional_inputs: Dict[str, Any] = to_immutable_dict({}) - """Dictionary of additional dataset information (e.g. semantics/point clouds/masks). - {input_name: - ... {"func": function to process additional dataparser outputs, - ... "kwargs": dictionary of data to pass into "func"} - } + mask_filenames: Optional[List[Path]] = None + """Filenames for any masks that are required""" + metadata: Dict[str, Any] = to_immutable_dict({}) + """Dictionary of any metadata that be required for the given experiment. + Will be processed by the InputDataset to create any additional tensors that may be required. """ def as_dict(self) -> dict: diff --git a/nerfstudio/data/dataparsers/friends_dataparser.py b/nerfstudio/data/dataparsers/friends_dataparser.py index 7a1afa69e..cd60e9951 100644 --- a/nerfstudio/data/dataparsers/friends_dataparser.py +++ b/nerfstudio/data/dataparsers/friends_dataparser.py @@ -19,9 +19,7 @@ from dataclasses import dataclass, field from pathlib import Path from typing import Type -import numpy as np import torch -from PIL import Image from rich.console import Console from nerfstudio.cameras.cameras import Cameras, CameraType @@ -37,31 +35,6 @@ from nerfstudio.utils.io import load_from_json CONSOLE = Console() -def get_semantics_and_masks(image_idx: int, semantics: Semantics): - """function to process additional semantics and mask information - - Args: - image_idx: specific image index to work with - semantics: semantics data - """ - # handle mask - person_index = semantics.thing_classes.index("person") - thing_image_filename = semantics.thing_filenames[image_idx] - pil_image = Image.open(thing_image_filename) - thing_semantics = torch.from_numpy(np.array(pil_image, dtype="int32"))[..., None] - mask = (thing_semantics != person_index).to(torch.float32) # 1 where valid - # handle semantics - # stuff - stuff_image_filename = semantics.stuff_filenames[image_idx] - pil_image = Image.open(stuff_image_filename) - stuff_semantics = torch.from_numpy(np.array(pil_image, dtype="int32"))[..., None] - # thing - thing_image_filename = semantics.thing_filenames[image_idx] - pil_image = Image.open(thing_image_filename) - thing_semantics = torch.from_numpy(np.array(pil_image, dtype="int32"))[..., None] - return {"mask": mask, "semantics_stuff": stuff_semantics, "semantics_thing": thing_semantics} - - @dataclass class FriendsDataParserConfig(DataParserConfig): """Friends dataset parser config""" @@ -142,9 +115,8 @@ class Friends(DataParser): camera_to_worlds[..., 3] *= scale # cameras # --- semantics --- - semantics = None if self.config.include_semantics: - thing_filenames = [ + filenames = [ Path( str(image_filename) .replace(f"/{images_folder}/", f"/{segmentations_folder}/thing/") @@ -152,27 +124,10 @@ class Friends(DataParser): ) for image_filename in image_filenames ] - stuff_filenames = [ - Path( - str(image_filename) - .replace(f"/{images_folder}/", f"/{segmentations_folder}/stuff/") - .replace(".jpg", ".png") - ) - for image_filename in image_filenames - ] panoptic_classes = load_from_json(self.config.data / "panoptic_classes.json") - stuff_classes = panoptic_classes["stuff"] - stuff_colors = torch.tensor(panoptic_classes["stuff_colors"], dtype=torch.float32) / 255.0 - thing_classes = panoptic_classes["thing"] - thing_colors = torch.tensor(panoptic_classes["thing_colors"], dtype=torch.float32) / 255.0 - semantics = Semantics( - stuff_classes=stuff_classes, - stuff_colors=stuff_colors, - stuff_filenames=stuff_filenames, - thing_classes=thing_classes, - thing_colors=thing_colors, - thing_filenames=thing_filenames, - ) + classes = panoptic_classes["thing"] + colors = torch.tensor(panoptic_classes["thing_colors"], dtype=torch.float32) / 255.0 + semantics = Semantics(filenames=filenames, classes=classes, colors=colors, mask_classes=["person"]) assert torch.all(cx[0] == cx), "Not all cameras have the same cx. Our Cameras class does not support this." assert torch.all(cy[0] == cy), "Not all cameras have the same cy. Our Cameras class does not support this." @@ -191,7 +146,6 @@ class Friends(DataParser): image_filenames=image_filenames, cameras=cameras, scene_box=scene_box, - additional_inputs={"semantics": {"func": get_semantics_and_masks, "kwargs": {"semantics": semantics}}}, - semantics=semantics, + metadata={"semantics": semantics} if self.config.include_semantics else {}, ) return dataparser_outputs diff --git a/nerfstudio/data/utils/datasets.py b/nerfstudio/data/datasets/base_dataset.py similarity index 77% rename from nerfstudio/data/utils/datasets.py rename to nerfstudio/data/datasets/base_dataset.py index b192a39c7..0c6c9fe15 100644 --- a/nerfstudio/data/utils/datasets.py +++ b/nerfstudio/data/datasets/base_dataset.py @@ -27,6 +27,7 @@ from torch.utils.data import Dataset from torchtyping import TensorType from nerfstudio.data.dataparsers.base_dataparser import DataparserOutputs +from nerfstudio.data.utils.data_utils import get_image_mask_tensor_from_path class InputDataset(Dataset): @@ -39,6 +40,7 @@ class InputDataset(Dataset): def __init__(self, dataparser_outputs: DataparserOutputs): super().__init__() self.dataparser_outputs = dataparser_outputs + self.has_masks = self.dataparser_outputs.mask_filenames is not None def __len__(self): return len(self.dataparser_outputs.image_filenames) @@ -71,7 +73,7 @@ class InputDataset(Dataset): image = image[:, :, :3] return image - def get_data(self, image_idx) -> Dict: + def get_data(self, image_idx: int) -> Dict: """Returns the ImageDataset data as a dictionary. Args: @@ -80,13 +82,23 @@ class InputDataset(Dataset): image = self.get_image(image_idx) data = {"image_idx": image_idx} data["image"] = image - for _, data_func_dict in self.dataparser_outputs.additional_inputs.items(): - assert "func" in data_func_dict, "Missing function to process data: specify `func` in `additional_inputs`" - func = data_func_dict["func"] - assert "kwargs" in data_func_dict, "No data to process: specify `kwargs` in `additional_inputs`" - data.update(func(image_idx, **data_func_dict["kwargs"])) + if self.has_masks: + mask_filepath = self.dataparser_outputs.mask_filenames[image_idx] + data["mask"] = get_image_mask_tensor_from_path(filepath=mask_filepath) + metadata = self.get_metadata(data) + data.update(metadata) return data - def __getitem__(self, image_idx): + # pylint: disable=no-self-use + def get_metadata(self, data: Dict) -> Dict: + """Method that can be used to process any additional metadata that may be part of the model inputs. + + Args: + image_idx: The image index in the dataset. + """ + del data + return {} + + def __getitem__(self, image_idx: int) -> Dict: data = self.get_data(image_idx) return data diff --git a/nerfstudio/data/datasets/semantic_dataset.py b/nerfstudio/data/datasets/semantic_dataset.py new file mode 100644 index 000000000..2fc551488 --- /dev/null +++ b/nerfstudio/data/datasets/semantic_dataset.py @@ -0,0 +1,49 @@ +# Copyright 2022 The Nerfstudio Team. All rights reserved. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +from typing import Dict + +import torch + +from nerfstudio.data.dataparsers.base_dataparser import DataparserOutputs, Semantics +from nerfstudio.data.datasets.base_dataset import InputDataset +from nerfstudio.data.utils.data_utils import get_semantics_and_mask_tensors_from_path + + +class SemanticDataset(InputDataset): + """Dataset that returns images and semantics and masks. + + Args: + dataparser_outputs: description of where and how to read input images. + """ + + def __init__(self, dataparser_outputs: DataparserOutputs): + super().__init__(dataparser_outputs) + assert "semantics" in dataparser_outputs.metadata.keys() and isinstance( + dataparser_outputs.metadata["semantics"], Semantics + ) + self.semantics = dataparser_outputs.metadata["semantics"] + self.mask_indices = torch.tensor( + [self.semantics.classes.index(mask_class) for mask_class in self.semantics.mask_classes] + ).view(1, 1, -1) + + def get_metadata(self, data: Dict) -> Dict: + # handle mask + filepath = self.semantics.filenames[data["image_idx"]] + semantic_label, mask = get_semantics_and_mask_tensors_from_path( + filepath=filepath, mask_indices=self.mask_indices + ) + if "mask" in data.keys(): + mask = mask & data["mask"] + return {"mask": mask, "semantics": semantic_label} diff --git a/nerfstudio/data/pixel_samplers.py b/nerfstudio/data/pixel_samplers.py index 8ba19ba63..6da0dff33 100644 --- a/nerfstudio/data/pixel_samplers.py +++ b/nerfstudio/data/pixel_samplers.py @@ -48,30 +48,13 @@ def collate_image_dataset_batch(batch: Dict, num_rays_per_batch: int, keep_full_ ).long() c, y, x = (i.flatten() for i in torch.split(indices, 1, dim=-1)) - image = batch["image"][c, y, x] - mask, semantics_stuff, semantics_thing = None, None, None - if "mask" in batch: - mask = batch["mask"][c, y, x] - if "semantics_stuff" in batch: - semantics_stuff = batch["semantics_stuff"][c, y, x] - if "semantics_thing" in batch: - semantics_thing = batch["semantics_thing"][c, y, x] - assert image.shape == (num_rays_per_batch, 3), image.shape + collated_batch = {key: value[c, y, x] for key, value in batch.items() if key != "image_idx" and value is not None} + + assert collated_batch["image"].shape == (num_rays_per_batch, 3), collated_batch["image"].shape # Needed to correct the random indices to their actual camera idx locations. - local_indices = indices.clone() indices[:, 0] = batch["image_idx"][c] - collated_batch = { - "local_indices": local_indices, # local to the batch returned - "indices": indices, # with the abs camera indices - "image": image, - } - if mask is not None: - collated_batch["mask"] = mask - if semantics_stuff is not None: - collated_batch["semantics_stuff"] = semantics_stuff - if semantics_thing is not None: - collated_batch["semantics_thing"] = semantics_thing + collated_batch["indices"] = indices # with the abs camera indices if keep_full_image: collated_batch["full_image"] = batch["image"] diff --git a/nerfstudio/data/utils/data_utils.py b/nerfstudio/data/utils/data_utils.py new file mode 100644 index 000000000..953e7951b --- /dev/null +++ b/nerfstudio/data/utils/data_utils.py @@ -0,0 +1,45 @@ +# Copyright 2022 The Nerfstudio Team. All rights reserved. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +"""Utility functions to allow easy re-use of common operations across dataloaders""" +from pathlib import Path +from typing import List, Tuple, Union + +import numpy as np +import torch +from PIL import Image + + +def get_image_mask_tensor_from_path(filepath: Path) -> torch.Tensor: + """ + Utility function to read a mask image from the given path and return a boolean tensor + """ + pil_mask = Image.open(filepath) + mask_tensor = torch.from_numpy(np.array(pil_mask)).unsqueeze(-1).bool() + return mask_tensor + + +def get_semantics_and_mask_tensors_from_path( + filepath: Path, mask_indices: Union[List, torch.Tensor] +) -> Tuple[torch.Tensor, torch.Tensor]: + """ + Utility function to read segmentation from the given filepath + If no mask is required - use mask_indices = [] + """ + if isinstance(mask_indices, List): + mask_indices = torch.tensor(mask_indices, dtype="int64").view(1, 1, -1) + pil_image = Image.open(filepath) + semantics = torch.from_numpy(np.array(pil_image, dtype="int64"))[..., None] + mask = torch.sum(semantics == mask_indices, dim=-1, keepdim=True) == 0 + return semantics, mask diff --git a/nerfstudio/data/utils/dataloaders.py b/nerfstudio/data/utils/dataloaders.py index 825cb65a1..8f8873d65 100644 --- a/nerfstudio/data/utils/dataloaders.py +++ b/nerfstudio/data/utils/dataloaders.py @@ -27,7 +27,7 @@ from torch.utils.data.dataloader import DataLoader from nerfstudio.cameras.cameras import Cameras from nerfstudio.cameras.rays import RayBundle -from nerfstudio.data.utils.datasets import InputDataset +from nerfstudio.data.datasets.base_dataset import InputDataset from nerfstudio.utils.misc import get_dict_to_torch CONSOLE = Console(width=120) diff --git a/nerfstudio/field_components/field_heads.py b/nerfstudio/field_components/field_heads.py index c11a827d1..702cafd81 100644 --- a/nerfstudio/field_components/field_heads.py +++ b/nerfstudio/field_components/field_heads.py @@ -181,33 +181,3 @@ class SemanticFieldHead(FieldHead): def __init__(self, num_classes: int, in_dim: Optional[int] = None) -> None: super().__init__(in_dim=in_dim, out_dim=num_classes, field_head_name=FieldHeadNames.SEMANTICS, activation=None) - - -class SemanticStuffFieldHead(FieldHead): - """Semantic stuff output - - Args: - num_classes: Number of semantic classes - in_dim: input dimension. If not defined in constructor, it must be set later. - activation: output head activation - """ - - def __init__(self, num_classes: int, in_dim: Optional[int] = None) -> None: - super().__init__( - in_dim=in_dim, out_dim=num_classes, field_head_name=FieldHeadNames.SEMANTICS_STUFF, activation=None - ) - - -class SemanticThingFieldHead(FieldHead): - """Semantic thing output - - Args: - num_classes: Number of semantic classes - in_dim: input dimension. If not defined in constructor, it must be set later. - activation: output head activation - """ - - def __init__(self, num_classes: int, in_dim: Optional[int] = None) -> None: - super().__init__( - in_dim=in_dim, out_dim=num_classes, field_head_name=FieldHeadNames.SEMANTICS_THING, activation=None - ) diff --git a/nerfstudio/fields/nerfacto_field.py b/nerfstudio/fields/nerfacto_field.py index 86e479e48..b70b6b4c3 100644 --- a/nerfstudio/fields/nerfacto_field.py +++ b/nerfstudio/fields/nerfacto_field.py @@ -35,8 +35,7 @@ from nerfstudio.field_components.field_heads import ( FieldHead, FieldHeadNames, RGBFieldHead, - SemanticStuffFieldHead, - SemanticThingFieldHead, + SemanticFieldHead, TransientDensityFieldHead, TransientRGBFieldHead, UncertaintyFieldHead, @@ -95,8 +94,7 @@ class TCNNNerfactoField(Field): transient_embedding_dim: int = 16, use_transient_embedding: bool = False, use_semantics: bool = False, - num_semantics_thing_classes: int = 100, - num_semantics_stuff_classes: int = 100, + num_semantic_classes: int = 100, use_average_appearance_embedding: bool = False, spatial_distortion: Optional[SpatialDistortion] = None, ) -> None: @@ -180,11 +178,8 @@ class TCNNNerfactoField(Field): "n_hidden_layers": 1, }, ) - self.field_head_semantics_stuff = SemanticStuffFieldHead( - in_dim=self.mlp_semantics.n_output_dims, num_classes=num_semantics_stuff_classes - ) - self.field_head_semantics_thing = SemanticThingFieldHead( - in_dim=self.mlp_semantics.n_output_dims, num_classes=num_semantics_thing_classes + self.field_head_semantics = SemanticFieldHead( + in_dim=self.mlp_semantics.n_output_dims, num_classes=num_semantic_classes ) self.mlp_head = tcnn.Network( @@ -266,8 +261,7 @@ class TCNNNerfactoField(Field): ) # print(semantics_input) x = self.mlp_semantics(semantics_input).view(*ray_samples.frustums.directions.shape[:-1], -1).to(directions) - outputs[FieldHeadNames.SEMANTICS_STUFF] = self.field_head_semantics_stuff(x) - outputs[FieldHeadNames.SEMANTICS_THING] = self.field_head_semantics_thing(x) + outputs[FieldHeadNames.SEMANTICS] = self.field_head_semantics(x) h = torch.cat( [ diff --git a/nerfstudio/models/semantic_nerfw.py b/nerfstudio/models/semantic_nerfw.py index c30804439..3f9dcad86 100644 --- a/nerfstudio/models/semantic_nerfw.py +++ b/nerfstudio/models/semantic_nerfw.py @@ -72,8 +72,9 @@ class SemanticNerfWModel(Model): config: SemanticNerfWModelConfig - def __init__(self, config: SemanticNerfWModelConfig, semantics: Semantics, **kwargs) -> None: - self.semantics = semantics + def __init__(self, config: SemanticNerfWModelConfig, metadata: Dict, **kwargs) -> None: + assert "semantics" in metadata.keys() and isinstance(metadata["semantics"], Semantics) + self.semantics = metadata["semantics"] super().__init__(config=config, **kwargs) def populate_modules(self): @@ -93,8 +94,7 @@ class SemanticNerfWModel(Model): use_average_appearance_embedding=self.config.use_average_appearance_embedding, use_transient_embedding=self.config.use_transient_embedding, use_semantics=True, - num_semantics_stuff_classes=len(self.semantics.stuff_classes), - num_semantics_thing_classes=len(self.semantics.thing_classes), + num_semantic_classes=len(self.semantics.classes), ) # Build the proposal network(s) @@ -204,20 +204,13 @@ class SemanticNerfWModel(Model): outputs["density_transient"] = field_outputs[FieldHeadNames.TRANSIENT_DENSITY] # semantics - outputs["semantics_thing"] = self.renderer_semantics( - field_outputs[FieldHeadNames.SEMANTICS_THING], weights=weights_static.detach() - ) - outputs["semantics_stuff"] = self.renderer_semantics( - field_outputs[FieldHeadNames.SEMANTICS_STUFF], weights=weights_static.detach() + outputs["semantics"] = self.renderer_semantics( + field_outputs[FieldHeadNames.SEMANTICS], weights=weights_static.detach() ) # semantics colormaps - semantic_labels = torch.argmax(torch.nn.functional.softmax(outputs["semantics_stuff"], dim=-1), dim=-1) - outputs["semantics_colormap_stuff"] = self.semantics.stuff_colors[semantic_labels] - semantic_labels = torch.argmax(torch.nn.functional.softmax(outputs["semantics_thing"], dim=-1), dim=-1) - outputs["semantics_colormap_thing"] = self.semantics.thing_colors[semantic_labels] - # TODO: adding these together is incorrect and produces weird results - outputs["semantics_colormap"] = outputs["semantics_colormap_stuff"] + outputs["semantics_colormap_thing"] + semantic_labels = torch.argmax(torch.nn.functional.softmax(outputs["semantics"], dim=-1), dim=-1) + outputs["semantics_colormap"] = self.semantics.colors[semantic_labels] return outputs @@ -247,12 +240,7 @@ class SemanticNerfWModel(Model): loss_dict["rgb_loss"] = self.rgb_loss(image, outputs["rgb"]) # semantic loss - loss_dict["semantics_stuff_loss"] = self.cross_entropy_loss( - outputs["semantics_stuff"], batch["semantics_stuff"][..., 0].long() - ) - loss_dict["semantics_thing_loss"] = self.cross_entropy_loss( - outputs["semantics_thing"], batch["semantics_thing"][..., 0].long() - ) + loss_dict["semantics_loss"] = self.cross_entropy_loss(outputs["semantics"], batch["semantics"][..., 0].long()) return loss_dict def get_image_metrics_and_images( @@ -295,14 +283,8 @@ class SemanticNerfWModel(Model): images_dict[key] = prop_depth_i # semantics - semantic_labels = torch.argmax(torch.nn.functional.softmax(outputs["semantics_stuff"], dim=-1), dim=-1) - images_dict["semantics_colormap_stuff"] = self.semantics.stuff_colors[semantic_labels] - semantic_labels = torch.argmax(torch.nn.functional.softmax(outputs["semantics_thing"], dim=-1), dim=-1) - images_dict["semantics_colormap_thing"] = self.semantics.thing_colors[semantic_labels] - # TODO: adding these together is incorrect and produces weird results - images_dict["semantics_colormap"] = ( - images_dict["semantics_colormap_stuff"] + images_dict["semantics_colormap_thing"] - ) + semantic_labels = torch.argmax(torch.nn.functional.softmax(outputs["semantics"], dim=-1), dim=-1) + images_dict["semantics_colormap"] = self.semantics.colors[semantic_labels] # valid mask images_dict["mask"] = batch["mask"].repeat(1, 1, 3) diff --git a/nerfstudio/pipelines/base_pipeline.py b/nerfstudio/pipelines/base_pipeline.py index 7c64e268f..978ae41b0 100644 --- a/nerfstudio/pipelines/base_pipeline.py +++ b/nerfstudio/pipelines/base_pipeline.py @@ -37,7 +37,7 @@ from torch.nn import Parameter from torch.nn.parallel import DistributedDataParallel as DDP from nerfstudio.configs import base_config as cfg -from nerfstudio.data.datamanagers import ( +from nerfstudio.data.datamanagers.base_datamanager import ( DataManager, VanillaDataManager, VanillaDataManagerConfig, @@ -220,8 +220,7 @@ class VanillaPipeline(Pipeline): self._model = config.model.setup( scene_box=self.datamanager.train_dataset.dataparser_outputs.scene_box, num_train_data=len(self.datamanager.train_dataset), - semantics=self.datamanager.train_dataset.dataparser_outputs.semantics, - device=device, + metadata=self.datamanager.train_dataset.dataparser_outputs.metadata, ) self.model.to(device) diff --git a/nerfstudio/pipelines/dynamic_batch.py b/nerfstudio/pipelines/dynamic_batch.py index b2e18ef62..d7d9e7f97 100644 --- a/nerfstudio/pipelines/dynamic_batch.py +++ b/nerfstudio/pipelines/dynamic_batch.py @@ -21,7 +21,7 @@ from typing import Type import torch -from nerfstudio.data.datamanagers import VanillaDataManager +from nerfstudio.data.datamanagers.base_datamanager import VanillaDataManager from nerfstudio.pipelines.base_pipeline import VanillaPipeline, VanillaPipelineConfig diff --git a/nerfstudio/viewer/server/viewer_utils.py b/nerfstudio/viewer/server/viewer_utils.py index 4824262b7..e0ea6e36e 100644 --- a/nerfstudio/viewer/server/viewer_utils.py +++ b/nerfstudio/viewer/server/viewer_utils.py @@ -35,7 +35,7 @@ from rich.console import Console from nerfstudio.cameras.cameras import Cameras from nerfstudio.cameras.rays import RayBundle from nerfstudio.configs import base_config as cfg -from nerfstudio.data.utils.datasets import InputDataset +from nerfstudio.data.datasets.base_dataset import InputDataset from nerfstudio.models.base_model import Model from nerfstudio.utils import colormaps, profiler, writer from nerfstudio.utils.decorators import check_main_thread, decorate_all @@ -446,12 +446,12 @@ class ViewerState: self.camera_moving = True return camera_object - def _apply_colormap(self, outputs: Dict[str, Any], stuff_colors: torch.Tensor = None, eps=1e-6): + def _apply_colormap(self, outputs: Dict[str, Any], colors: torch.Tensor = None, eps=1e-6): """Determines which colormap to use based on set colormap type Args: outputs: the output tensors for which to apply colormaps on - stuff_colors: is only set if colormap is for semantics. Defaults to None. + colors: is only set if colormap is for semantics. Defaults to None. eps: epsilon to handle floating point comparisons """ if self.output_list: @@ -486,8 +486,8 @@ class ViewerState: ): logits = outputs[reformatted_output] labels = torch.argmax(torch.nn.functional.softmax(logits, dim=-1), dim=-1) # type: ignore - assert stuff_colors is not None - return stuff_colors[labels] + assert colors is not None + return colors[labels] # rendering boolean outputs if self.prev_colormap_type == ColormapTypes.BOOLEAN or ( @@ -532,12 +532,12 @@ class ViewerState: for video_track in self.video_tracks: video_track.put_frame(image) - def _send_output_to_viewer(self, outputs: Dict[str, Any], stuff_colors: torch.Tensor = None, eps=1e-6): + def _send_output_to_viewer(self, outputs: Dict[str, Any], colors: torch.Tensor = None, eps=1e-6): """Chooses the correct output and sends it to the viewer Args: outputs: the dictionary of outputs to choose from, from the graph - stuff_colors: is only set if colormap is for semantics. Defaults to None. + colors: is only set if colormap is for semantics. Defaults to None. eps: epsilon to handle floating point comparisons """ if self.output_list is None: @@ -564,7 +564,7 @@ class ViewerState: self.output_type_changed = False self.vis["renderingState/colormap_choice"].write(self.prev_colormap_type) self.vis["renderingState/colormap_options"].write(colormap_options) - selected_output = (self._apply_colormap(outputs, stuff_colors) * 255).type(torch.uint8) + selected_output = (self._apply_colormap(outputs, colors) * 255).type(torch.uint8) image = selected_output.cpu().numpy() self.set_image(image) @@ -764,8 +764,8 @@ class ViewerState: graph.train() outputs = render_thread.vis_outputs if outputs is not None: - stuff_colors = graph.stuff_colors if hasattr(graph, "stuff_colors") else None - self._send_output_to_viewer(outputs, stuff_colors=stuff_colors) + colors = graph.colors if hasattr(graph, "colors") else None + self._send_output_to_viewer(outputs, colors=colors) self._update_viewer_stats( vis_t.duration, num_rays=len(camera_ray_bundle), image_height=image_height, image_width=image_width ) diff --git a/scripts/viewer/view_dataset.py b/scripts/viewer/view_dataset.py index 29317515f..68b54e42d 100644 --- a/scripts/viewer/view_dataset.py +++ b/scripts/viewer/view_dataset.py @@ -15,7 +15,7 @@ import tyro from nerfstudio.configs import method_configs as cfg from nerfstudio.data.datamanagers import AnnotatedDataParserUnion -from nerfstudio.data.utils.datasets import InputDataset +from nerfstudio.data.datasets.base_dataset import InputDataset from nerfstudio.viewer.server import viewer_utils DEFAULT_TIMEOUT = timedelta(minutes=30) From a13c10ba61568aed3ca53a90de2eb66cc34e46ef Mon Sep 17 00:00:00 2001 From: Matthew Tancik Date: Sun, 6 Nov 2022 12:42:30 -0800 Subject: [PATCH 31/68] Use tan instead of tanh (#913) --- nerfstudio/data/dataparsers/instant_ngp_dataparser.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/nerfstudio/data/dataparsers/instant_ngp_dataparser.py b/nerfstudio/data/dataparsers/instant_ngp_dataparser.py index 1641ad43d..1e5a69b99 100644 --- a/nerfstudio/data/dataparsers/instant_ngp_dataparser.py +++ b/nerfstudio/data/dataparsers/instant_ngp_dataparser.py @@ -130,7 +130,7 @@ class InstantNGP(DataParser): fl_x, fl_y = 0, 0 def fov_to_focal_length(rad, res): - return 0.5 * res / np.tanh(0.5 * rad) + return 0.5 * res / np.tan(0.5 * rad) if "fl_x" in meta: fl_x = meta["fl_x"] From b86a21caf2285e7e51c47a45c0a6f0da35eeb288 Mon Sep 17 00:00:00 2001 From: Terrance Wang Date: Sun, 6 Nov 2022 14:38:52 -0800 Subject: [PATCH 32/68] Terrance/camera controls (#748) * adding keyboard camera control instructions to viewer * adding orbit / fps controls * adding button to toggle first person cams and orbit cam, spacebar resets view dir and position now * renaming button * getting started element now scrolls, adding instructions for camera controls * fixed first person bug, removed orbit controls * fixing style * fixed mouse controls w viewer * adjust rotate speed Co-authored-by: Matthew Tancik --- nerfstudio/viewer/app/src/index.scss | 2 + .../src/modules/LandingModal/LandingModal.jsx | 18 ++---- .../viewer/app/src/modules/Scene/Scene.jsx | 64 +++++++++++++------ 3 files changed, 51 insertions(+), 33 deletions(-) diff --git a/nerfstudio/viewer/app/src/index.scss b/nerfstudio/viewer/app/src/index.scss index a27610a81..4aeaa6f1b 100644 --- a/nerfstudio/viewer/app/src/index.scss +++ b/nerfstudio/viewer/app/src/index.scss @@ -174,6 +174,8 @@ $sidebar-width: 100% !default; border: 2px solid #000; // box-shadow: 24px 24px; padding: 32px; + overflow-y: scroll; + height: 90%; } .LandingModal-box .WebSocketUrlField { diff --git a/nerfstudio/viewer/app/src/modules/LandingModal/LandingModal.jsx b/nerfstudio/viewer/app/src/modules/LandingModal/LandingModal.jsx index 645445680..a107b29b5 100644 --- a/nerfstudio/viewer/app/src/modules/LandingModal/LandingModal.jsx +++ b/nerfstudio/viewer/app/src/modules/LandingModal/LandingModal.jsx @@ -175,21 +175,15 @@ export default function LandingModel(props: LandingModalProps) {

Camera Keyboard Controls

-

-

- WASD - horizontal camera translation, QE - vertical camera - translation -
-
Arrow Keys - camera rotation
-
- Spacebar - reset camera orbit point and view direction to - origin -
-

+
+ Spacebar - reset camera to starting position
+ WS - forward camera translation, AD - side to side camera translation
+ QE - up and down camera translation, Arrow Keys - camera rotation +
- + ); } diff --git a/nerfstudio/viewer/app/src/modules/Scene/Scene.jsx b/nerfstudio/viewer/app/src/modules/Scene/Scene.jsx index dd0d36fc6..16848f937 100644 --- a/nerfstudio/viewer/app/src/modules/Scene/Scene.jsx +++ b/nerfstudio/viewer/app/src/modules/Scene/Scene.jsx @@ -29,9 +29,8 @@ export function get_scene_tree() { // Main camera const main_camera = new THREE.PerspectiveCamera(75, 1, 0.1, 1000); - main_camera.position.x = 0.7; - main_camera.position.y = -0.7; - main_camera.position.z = 0.3; + const start_position = new THREE.Vector3(0.7, -0.7, 0.3); + main_camera.position.set(start_position.x, start_position.y, start_position.z); main_camera.up = new THREE.Vector3(0, 0, 1); sceneTree.set_object_from_path(['Cameras', 'Main Camera'], main_camera); @@ -68,28 +67,38 @@ export function get_scene_tree() { const camera_controls = new CameraControls(main_camera, renderer.domElement); camera_controls.azimuthRotateSpeed = 0.3; camera_controls.polarRotateSpeed = 0.3; - camera_controls.minDistance = 0.3; - camera_controls.maxDistance = 20; - - camera_controls.dollySpeed = 0.1; + camera_controls.dollySpeed = 1.8; + camera_controls.infinityDolly = true; camera_controls.saveState(); const keyMap = []; const moveSpeed = 0.02; + const rotSpeed = .015; + const EPS = .01; - function moveCamera() { - if (keyMap.ArrowLeft === true) { - camera_controls.rotate(-0.02, 0, true); - } - if (keyMap.ArrowRight === true) { - camera_controls.rotate(0.02, 0, true); - } - if (keyMap.ArrowUp === true) { - camera_controls.rotate(0, -0.01, true); - } - if (keyMap.ArrowDown === true) { - camera_controls.rotate(0, 0.01, true); + function rotate() { + if (keyMap.ArrowLeft || keyMap.ArrowRight || keyMap.ArrowUp || keyMap.ArrowDown){ + const curTar = camera_controls.getTarget(); + const curPos = camera_controls.getPosition(); + const diff = curTar.sub(curPos).clampLength(0, EPS); + camera_controls.setTarget(curPos.x + diff.x, curPos.y + diff.y, curPos.z + diff.z); + + if (keyMap.ArrowLeft === true) { + camera_controls.rotate(rotSpeed, 0, true); + } + if (keyMap.ArrowRight === true) { + camera_controls.rotate(-rotSpeed, 0, true); + } + if (keyMap.ArrowUp === true) { + camera_controls.rotate(0, rotSpeed / 1.5, true); + } + if (keyMap.ArrowDown === true) { + camera_controls.rotate(0, -rotSpeed / 1.5, true); + } } + } + + function translate() { if (keyMap.KeyD === true) { camera_controls.truck(moveSpeed, 0, true); } @@ -97,10 +106,14 @@ export function get_scene_tree() { camera_controls.truck(-moveSpeed, 0, true); } if (keyMap.KeyW === true) { - camera_controls.forward(moveSpeed, true); + const curPos = camera_controls.getPosition(); + const newTar = camera_controls.getTarget(); + const newDiff = newTar.sub(curPos).normalize().multiplyScalar(curPos.length()); + camera_controls.setTarget(curPos.x + newDiff.x, curPos.y + newDiff.y, curPos.z + newDiff.z); + camera_controls.dolly(moveSpeed, true); } if (keyMap.KeyS === true) { - camera_controls.forward(-moveSpeed, true); + camera_controls.dolly(-moveSpeed, true); } if (keyMap.KeyQ === true) { camera_controls.truck(0, moveSpeed, true); @@ -110,6 +123,11 @@ export function get_scene_tree() { } } + function moveCamera() { + translate() + rotate() + } + function onKeyUp(event) { const keyCode = event.code; keyMap[keyCode] = false; @@ -240,6 +258,10 @@ export function get_scene_tree() { let drag = false; const onMouseDown = () => { drag = false; + const curPos = camera_controls.getPosition(); + const newTar = camera_controls.getTarget(); + const newDiff = newTar.sub(curPos).normalize().multiplyScalar(curPos.length()); + camera_controls.setTarget(curPos.x + newDiff.x, curPos.y + newDiff.y, curPos.z + newDiff.z); }; const onMouseMove = (e) => { From 39462e78b5e25337769ac2178595be2fb7d8e402 Mon Sep 17 00:00:00 2001 From: Abhik Ahuja Date: Sun, 6 Nov 2022 19:38:49 -0800 Subject: [PATCH 33/68] Camera Controls Overhaul (FOV + Keyframing) (#792) * Fov interpolation, FOV/focal length switch, better bounds detection * Camera reordering * Progress on expandable camera panels * Fixed console errors from clickable cameras * Enumerations for FOV options * Updated render camera controls * Removed console logs * Minor ui changes, fov changes again * Linting * Cleaned up code, bug fixes * Use Three.js functions for fov/focal length * Temp fix for ui field of view * Some duplicate imports removed * Fixed merge * Added explicit edit button * Added tooltip for fov/focal length * Cleaned up console * Keyframe interface, won't render * Keyframe interpolation works * Better default keyframes * lint * Style * Keyframe timing outputs to camera path * Focal length label bug fix, visual updates * Fixed looping with keyframes * Replace linear toggle with reset keyframes button * UI updates * remove comment * Save and load properties from json * Added VanillaJS-React state sharing * Lint * Lint 2 * Animate button functionally working * Interface improvements * Animation Button Styling Fixed * Better animation button styling * Updated disabled color * Changed animate color to blue * Viewport fov does not change * Fixed merge conflict regression * Disabled text is now blue * Fixed FOV interpolation Co-authored-by: mcallisterdavid Co-authored-by: Matt Tancik Co-authored-by: Ethan Weber --- nerfstudio/viewer/app/src/SceneNode.js | 7 +- nerfstudio/viewer/app/src/index.jsx | 2 +- nerfstudio/viewer/app/src/index.scss | 9 +- .../viewer/app/src/modules/Scene/Scene.jsx | 42 +- .../SidePanel/CameraPanel/CameraPanel.jsx | 701 ++++++++++++++---- .../modules/SidePanel/CameraPanel/curve.js | 33 +- .../SidePanel/ScenePanel/ScenePanel.jsx | 1 + nerfstudio/viewer/app/src/themes/theme.ts | 35 + 8 files changed, 684 insertions(+), 146 deletions(-) diff --git a/nerfstudio/viewer/app/src/SceneNode.js b/nerfstudio/viewer/app/src/SceneNode.js index a35d23065..6cd10721c 100644 --- a/nerfstudio/viewer/app/src/SceneNode.js +++ b/nerfstudio/viewer/app/src/SceneNode.js @@ -27,15 +27,20 @@ function dispose(object) { } export default class SceneNode { - constructor(object) { + constructor(object, scene_state) { this.metadata = {}; // relevant metadata for the object this.object = object; // three.js objects this.children = {}; + this.scene_state = scene_state; for (const c of this.object.children) { this.add_child(c); } } + get_scene_state() { + return this.scene_state; + } + add_child(object) { const node = new SceneNode(object); this.children[object.name] = node; diff --git a/nerfstudio/viewer/app/src/index.jsx b/nerfstudio/viewer/app/src/index.jsx index 855be0964..966e50e43 100644 --- a/nerfstudio/viewer/app/src/index.jsx +++ b/nerfstudio/viewer/app/src/index.jsx @@ -1,6 +1,6 @@ import './index.scss'; import React from 'react'; -import ReactDOM from 'react-dom/client'; +import ReactDOM from 'react-dom'; import { Provider } from 'react-redux'; import App from './App'; import WebSocketProvider from './modules/WebSocket/WebSocket'; diff --git a/nerfstudio/viewer/app/src/index.scss b/nerfstudio/viewer/app/src/index.scss index 4aeaa6f1b..81d059e53 100644 --- a/nerfstudio/viewer/app/src/index.scss +++ b/nerfstudio/viewer/app/src/index.scss @@ -241,7 +241,6 @@ $sidebar-width: 100% !default; } .CameraPanel-slider-container { - margin-top: 40px; margin-left: auto; margin-right: auto; width: 70%; @@ -261,6 +260,7 @@ $sidebar-width: 100% !default; } .CameraList-row { + background: $base-color1; padding: 4px; border: solid 1px $highlight-color1; text-align: left; @@ -278,6 +278,13 @@ $sidebar-width: 100% !default; width: 100px; } +.CameraList-row-animation-properties > div { + display: inline-block; + text-align: center; + margin: 10px; + width: 100px; +} + // ------------------------------------ // Viewer Window diff --git a/nerfstudio/viewer/app/src/modules/Scene/Scene.jsx b/nerfstudio/viewer/app/src/modules/Scene/Scene.jsx index 16848f937..8c6e93e29 100644 --- a/nerfstudio/viewer/app/src/modules/Scene/Scene.jsx +++ b/nerfstudio/viewer/app/src/modules/Scene/Scene.jsx @@ -22,7 +22,24 @@ const CAMERAS_NAME = 'Training Cameras'; export function get_scene_tree() { const scene = new THREE.Scene(); - const sceneTree = new SceneNode(scene); + + const scene_state = { + value: new Map(), + callbacks: [], + addCallback (callback, key) { this.callbacks.push([callback, key]); }, + setValue (key, value) { + this.value.set(key, value); + this.callbacks.forEach( + (cbk) => { + const i = cbk[1]; + const callback = cbk[0]; + return callback(this.value.get(i)) + } + ); + } + }; + + const sceneTree = new SceneNode(scene, scene_state); const dispatch = useDispatch(); const BANNER_HEIGHT = 50; @@ -124,6 +141,9 @@ export function get_scene_tree() { } function moveCamera() { + if (!scene_state.value.get('mouse_in_scene')) { + return; + } translate() rotate() } @@ -267,14 +287,24 @@ export function get_scene_tree() { const onMouseMove = (e) => { drag = true; - const cameras = Object.values( - sceneTree.find_no_create([CAMERAS_NAME]).children, - ).map((obj) => obj.object.children[0].children[1]); - sceneTree.metadata.renderer.getSize(size); mouseVector.x = 2 * (e.clientX / size.x) - 1; mouseVector.y = 1 - 2 * ((e.clientY - BANNER_HEIGHT) / size.y); + const mouse_in_scene = !(mouseVector.x > 1 || mouseVector.x < -1 || mouseVector.y > 1 || mouseVector.y < -1) + + scene_state.setValue('mouse_x', mouseVector.x); + scene_state.setValue('mouse_y', mouseVector.y); + scene_state.setValue('mouse_in_scene', mouse_in_scene); + + const camerasParent = sceneTree.find_no_create([CAMERAS_NAME]); + if (camerasParent === null) { + return; + } + const cameras = Object.values(camerasParent.children).map( + (obj) => obj.object.children[0].children[1], + ); + if ( mouseVector.x > 1 || mouseVector.x < -1 || @@ -305,7 +335,7 @@ export function get_scene_tree() { }; const onMouseUp = () => { - if (drag === true) { + if (drag === true || !scene_state.value.get('mouse_in_scene')) { return; } if (selectedCam !== null) { diff --git a/nerfstudio/viewer/app/src/modules/SidePanel/CameraPanel/CameraPanel.jsx b/nerfstudio/viewer/app/src/modules/SidePanel/CameraPanel/CameraPanel.jsx index d55915ab0..585d5557f 100644 --- a/nerfstudio/viewer/app/src/modules/SidePanel/CameraPanel/CameraPanel.jsx +++ b/nerfstudio/viewer/app/src/modules/SidePanel/CameraPanel/CameraPanel.jsx @@ -2,34 +2,45 @@ import * as React from 'react'; import * as THREE from 'three'; import { + ArrowBackIosNew, + ArrowForwardIos, AllInclusiveOutlined, ChangeHistory, + ClearAll, + Delete, + ExpandMore, + FirstPage, GestureOutlined, - LinearScaleOutlined, + KeyboardArrowUp, + KeyboardArrowDown, + LastPage, + Pause, + PlayArrow, RadioButtonUnchecked, Replay, - Timeline, + Visibility, + Edit, + Animation, } from '@mui/icons-material'; -import { Button, Slider } from '@mui/material'; +import { + Accordion, + AccordionDetails, + AccordionSummary, + Button, + InputAdornment, + Slider, +} from '@mui/material'; import { MeshLine, MeshLineMaterial } from 'meshline'; import { useContext, useEffect } from 'react'; import { useDispatch, useSelector } from 'react-redux'; -import AddAPhotoIcon from '@mui/icons-material/AddAPhoto'; -import ArrowBackIosNewIcon from '@mui/icons-material/ArrowBackIosNew'; -import ArrowForwardIosIcon from '@mui/icons-material/ArrowForwardIos'; import { CSS2DObject } from 'three/examples/jsm/renderers/CSS2DRenderer'; -import DeleteIcon from '@mui/icons-material/Delete'; -import FirstPageIcon from '@mui/icons-material/FirstPage'; +import AddAPhotoIcon from '@mui/icons-material/AddAPhoto'; import FileDownloadOutlinedIcon from '@mui/icons-material/FileDownloadOutlined'; import FileUploadOutlinedIcon from '@mui/icons-material/FileUploadOutlined'; -import LastPageIcon from '@mui/icons-material/LastPage'; -import PauseIcon from '@mui/icons-material/Pause'; -import PlayArrowIcon from '@mui/icons-material/PlayArrow'; import { Stack } from '@mui/system'; import TextField from '@mui/material/TextField'; import Tooltip from '@mui/material/Tooltip'; -import VisibilityIcon from '@mui/icons-material/Visibility'; import VideoCameraBackIcon from '@mui/icons-material/VideoCameraBack'; import { CameraHelper } from './CameraHelper'; import { get_curve_object_from_cameras, get_transform_matrix } from './curve'; @@ -38,20 +49,170 @@ import RenderModal from '../../RenderModal'; const msgpack = require('msgpack-lite'); +const FOV_LABELS = { + FOV: '°', + MM: 'mm', +}; + function set_camera_position(camera, matrix) { const mat = new THREE.Matrix4(); mat.fromArray(matrix.elements); mat.decompose(camera.position, camera.quaternion, camera.scale); } +function FovSelector(props) { + const fovLabel = props.fovLabel; + const setFovLabel = props.setFovLabel; + const camera = props.camera; + const dispatch = props.dispatch; + const changeMain = props.changeMain; + const disabled = props.disabled; + const applyAll = props.applyAll; + const setAllCameraFOV = props.setAllCameraFOV; + const isGlobal = props.isGlobal; + const globalFov = props.globalFov; + const setGlobalFov = props.setGlobalFov; + + const getFovLabel = () => { + if (!isGlobal) { + const label = Math.round( + fovLabel === FOV_LABELS.FOV + ? camera.getEffectiveFOV() + : camera.getFocalLength() * camera.aspect, + ); + return label; + } + const old_fov = camera.fov; + camera.fov = globalFov; + const new_focal_len = camera.getFocalLength(); + camera.fov = old_fov; + const label = Math.round( + fovLabel === FOV_LABELS.FOV + ? globalFov + : new_focal_len * camera.aspect, + ); + return label; + }; + + const [UIFieldOfView, setUIFieldOfView] = React.useState(isGlobal ? globalFov : getFovLabel()); + + useEffect(() => setUIFieldOfView(getFovLabel()), [camera, fovLabel, globalFov]); + + const setFOV = (val) => { + if (!isGlobal) { + if (fovLabel === FOV_LABELS.FOV) { + camera.fov = val; + } else { + camera.setFocalLength(val / camera.aspect); + } + } else if (fovLabel === FOV_LABELS.FOV) { + setGlobalFov(val); + } else { + const old_fov = camera.fov; + camera.setFocalLength(val / camera.aspect); + const new_fov = camera.getEffectiveFOV(); + camera.fov = old_fov; + setGlobalFov(new_fov); + } + + if (applyAll) { + setAllCameraFOV(val); + } + + if (changeMain) { + dispatch({ + type: 'write', + path: 'renderingState/field_of_view', + data: camera.getEffectiveFOV(), + }); + } + }; + + const toggleFovLabel = () => { + if (fovLabel === FOV_LABELS.FOV) { + setFovLabel(FOV_LABELS.MM); + } else { + setFovLabel(FOV_LABELS.FOV); + } + }; + + return ( + + + {fovLabel === FOV_LABELS.FOV ? '°' : 'mm'} + + + ), + }} + onChange={(e) => { + if (e.target.validity.valid) { + setUIFieldOfView(e.target.value); + } + }} + onBlur={(e) => { + if (e.target.validity.valid) { + if (e.target.value !== '') { + setFOV(parseInt(e.target.value, 10)); + } else { + setUIFieldOfView(getFovLabel()); + } + } + }} + sx={{ + input: { + "-webkit-text-fill-color": `${disabled ? "#24B6FF" : "#EBEBEB"} !important`, + color: `${disabled ? "#24B6FF" : "#EBEBEB"} !important`, + }, + }} + value={UIFieldOfView} + error={camera.fov <= 0} + helperText={camera.fov <= 0 ? 'Required' : ''} + variant="standard" + /> + ); +} + function CameraList(props) { const sceneTree = props.sceneTree; const cameras = props.cameras; const camera_main = props.camera_main; const transform_controls = props.transform_controls; const setCameras = props.setCameras; + const swapCameras = props.swapCameras; + const fovLabel = props.fovLabel; + const setFovLabel = props.setFovLabel; + const cameraProperties = props.cameraProperties; + const setCameraProperties = props.setCameraProperties; + const isAnimated = props.isAnimated; + const dispatch = props.dispatch; + // eslint-disable-next-line no-unused-vars const [slider_value, set_slider_value] = React.useState(0); + const [expanded, setExpanded] = React.useState(null); + + const handleChange = + (cameraUUID: string) => + (event: React.SyntheticEvent, isExpanded: boolean) => { + setExpanded(isExpanded ? cameraUUID : false); + }; const set_transform_controls = (index) => { // camera helper object so grab the camera inside @@ -77,7 +238,7 @@ function CameraList(props) { } }; - const reset_slider_render_on_delete = () => { + const reset_slider_render_on_change = () => { // set slider and render camera back to 0 const slider_min = 0; const camera_render = sceneTree.find_object_no_create([ @@ -106,6 +267,7 @@ function CameraList(props) { } set_camera_position(camera_render, first_camera.matrix); camera_render_helper.set_visibility(true); + camera_render.fov = first_camera.fov; } set_slider_value(slider_min); }; @@ -135,29 +297,117 @@ function CameraList(props) { if (cameras.length < 1) { camera_render_helper.set_visibility(false); } - reset_slider_render_on_delete(); + reset_slider_render_on_change(); }; + // TODO: Add pencil for editing? const cameraList = cameras.map((camera, index) => { return ( -
- -
+ + } + aria-controls="panel1bh-content" + id="panel1bh-header" + > + + + + + - -
-
+ + + + + + + {isAnimated('FOV') && + } + {!isAnimated('FOV') && +

+ Animated camera properties will show up here! +

+ } +
+ ); }); return
{cameraList}
; @@ -188,17 +438,33 @@ export default function CameraPanel(props) { (state) => state.renderingState.config_base_dir, ); const websocket = useContext(WebSocketContext).socket; + const DEFAULT_FOV = 50; // react state const [cameras, setCameras] = React.useState([]); + // Mapping of camera id to each camera's properties + const [cameraProperties, setCameraProperties] = React.useState(new Map()); const [slider_value, set_slider_value] = React.useState(0); const [smoothness_value, set_smoothness_value] = React.useState(0.5); const [is_playing, setIsPlaying] = React.useState(false); const [is_cycle, setIsCycle] = React.useState(false); - const [is_linear, setIsLinear] = React.useState(false); const [seconds, setSeconds] = React.useState(4); const [fps, setFps] = React.useState(24); const [render_modal_open, setRenderModalOpen] = React.useState(false); + const [animate, setAnimate] = React.useState(new Set()); + const [globalFov, setGlobalFov] = React.useState(DEFAULT_FOV); + + const scene_state = sceneTree.get_scene_state(); + + // Template for sharing state between Vanilla JS Three.js and React components + // eslint-disable-next-line no-unused-vars + const [mouseInScene, setMouseInScene] = React.useState(false); + React.useEffect(() => { + scene_state.addCallback( + (value) => setMouseInScene(value), + 'mouse_in_scene', + ); + }, []); const dispatch = useDispatch(); const render_height = useSelector( @@ -208,10 +474,6 @@ export default function CameraPanel(props) { (state) => state.renderingState.render_width, ); - const field_of_view = useSelector( - (state) => state.renderingState.field_of_view, - ); - const setRenderHeight = (value) => { dispatch({ type: 'write', @@ -230,13 +492,13 @@ export default function CameraPanel(props) { // ui state const [ui_render_height, setUIRenderHeight] = React.useState(render_height); const [ui_render_width, setUIRenderWidth] = React.useState(render_width); - const [ui_field_of_view, setUIFieldOfView] = React.useState(field_of_view); const [ui_seconds, setUISeconds] = React.useState(seconds); const [ui_fps, setUIfps] = React.useState(fps); + const [fovLabel, setFovLabel] = React.useState(FOV_LABELS.FOV); // nonlinear render option const slider_min = 0; - const slider_max = Math.max(0, cameras.length - 1); + const slider_max = 1; // animation constants const total_num_steps = seconds * fps; @@ -246,6 +508,7 @@ export default function CameraPanel(props) { // set slider and render camera back to 0 if (new_camera_list.length >= 1) { set_camera_position(camera_render, new_camera_list[0].matrix); + camera_render.fov = new_camera_list[0].fov; set_slider_value(slider_min); } }; @@ -253,11 +516,66 @@ export default function CameraPanel(props) { const add_camera = () => { const camera_main_copy = camera_main.clone(); camera_main_copy.aspect = 1.0; + camera_main_copy.fov = globalFov; + const new_camera_properties = new Map(); + camera_main_copy.properties = new_camera_properties; + new_camera_properties.set('FOV', globalFov); + new_camera_properties.set('NAME', `Camera ${cameras.length}`); + // TIME VALUES ARE 0-1 + if (cameras.length === 0) { + new_camera_properties.set('TIME', 0.0); + } else { + new_camera_properties.set('TIME', 1.0); + } + + const ratio = (cameras.length - 1) / cameras.length; + + const new_properties = new Map(cameraProperties); + new_properties.forEach((properties) => { + properties.set('TIME', properties.get('TIME') * ratio); + }); + new_properties.set(camera_main_copy.uuid, new_camera_properties); + setCameraProperties(new_properties); + const new_camera_list = cameras.concat(camera_main_copy); setCameras(new_camera_list); reset_slider_render_on_add(new_camera_list); }; + const setCameraProperty = (property, value, index) => { + const activeCamera = cameras[index]; + const activeProperties = new Map(activeCamera.properties); + activeProperties.set(property, value); + const newProperties = new Map(cameraProperties); + newProperties.set(activeCamera.uuid, activeProperties); + activeCamera.properties = activeProperties; + setCameraProperties(newProperties); + }; + + const swapCameras = (index, new_index) => { + if ( + Math.min(index, new_index) < 0 || + Math.max(index, new_index) >= cameras.length + ) + return; + + const swapCameraTime = cameras[index].properties.get('TIME'); + setCameraProperty('TIME', cameras[new_index].properties.get('TIME'), index); + setCameraProperty('TIME', swapCameraTime, new_index); + + const new_cameras = [ + ...cameras.slice(0, index), + ...cameras.slice(index + 1), + ]; + setCameras([ + ...new_cameras.slice(0, new_index), + cameras[index], + ...new_cameras.slice(new_index), + ]); + + // reset_slider_render_on_change(); + }; + // force a rerender if the cameras are dragged around let update_cameras_interval = null; // eslint-disable-next-line no-unused-vars @@ -327,6 +645,37 @@ export default function CameraPanel(props) { smoothness_value, ); + const getKeyframePoint = (progress: Number) => { + const times = []; + const ratio = (cameras.length - 1) / cameras.length; + cameras.forEach((camera) => { + const time = camera.properties.get('TIME'); + times.push(is_cycle ? time * ratio : time); + }); + + if (is_cycle) { + times.push(1.0); + } + + let new_point = 0.0; + if (progress <= times[0]) { + new_point = 0.0; + } else if (progress >= times[times.length - 1]) { + new_point = 1.0; + } else { + let i = 0; + while ( + i < times.length - 1 && + !(progress >= times[i] && progress < times[i + 1]) + ) { + i += 1; + } + const percentage = (progress - times[i]) / (times[i + 1] - times[i]); + new_point = (i + percentage) / (times.length - 1); + } + return new_point; + }; + if (cameras.length > 1) { const num_points = fps * seconds; const points = curve_object.curve_positions.getPoints(num_points); @@ -338,49 +687,71 @@ export default function CameraPanel(props) { sceneTree.set_object_from_path(['Camera Path', 'Curve'], spline_mesh); // set the camera - const point = Math.min(slider_value / (cameras.length - 1.0), 1); + + const point = getKeyframePoint(slider_value); let position = null; let lookat = null; let up = null; - if (!is_linear) { - position = curve_object.curve_positions.getPoint(point); - lookat = curve_object.curve_lookats.getPoint(point); - up = curve_object.curve_ups.getPoint(point); - } else { - position = curve_object.curve_positions.getPointAt(point); - lookat = curve_object.curve_lookats.getPointAt(point); - up = curve_object.curve_ups.getPointAt(point); - } + let fov = null; + position = curve_object.curve_positions.getPoint(point); + lookat = curve_object.curve_lookats.getPoint(point); + up = curve_object.curve_ups.getPoint(point); + fov = curve_object.curve_fovs.getPoint(point).z; + const mat = get_transform_matrix(position, lookat, up); set_camera_position(camera_render, mat); + camera_render.fov = fov; } else { sceneTree.delete(['Camera Path', 'Curve']); } const marks = []; - for (let i = 0; i < cameras.length; i += 1) { - marks.push({ value: i, label: i.toString() }); + for (let i = 0; i <= 1; i += 0.25) { + marks.push({ value: i, label: `${(seconds * i).toFixed(1).toString()}s` }); } + const values = []; + cameras.forEach((camera) => { + const time = camera.properties.get('TIME'); + const ratio = (cameras.length - 1) / cameras.length; + values.push(is_cycle ? time * ratio : time); + }); + + if (is_cycle) { + values.push(1.0); + } + + const handleKeyframeSlider = ( + event: Event, + newValue: number | number[], + activeThumb: number, + ) => { + if (activeThumb === cameras.length) return; + const ratio = (cameras.length - 1) / cameras.length; + const val = newValue[activeThumb]; + setCameraProperty( + 'TIME', + is_cycle ? Math.min(val / ratio, 1.0) : val, + activeThumb, + ); + }; + // when the slider changes, update the main camera position useEffect(() => { if (cameras.length > 1) { - const point = Math.min(slider_value / (cameras.length - 1.0), 1); + const point = getKeyframePoint(slider_value); let position = null; let lookat = null; let up = null; - if (!is_linear) { - // interpolate to get the points - position = curve_object.curve_positions.getPoint(point); - lookat = curve_object.curve_lookats.getPoint(point); - up = curve_object.curve_ups.getPoint(point); - } else { - position = curve_object.curve_positions.getPointAt(point); - lookat = curve_object.curve_lookats.getPointAt(point); - up = curve_object.curve_ups.getPointAt(point); - } + let fov = null; + position = curve_object.curve_positions.getPoint(point); + lookat = curve_object.curve_lookats.getPoint(point); + up = curve_object.curve_ups.getPoint(point); + fov = curve_object.curve_fovs.getPoint(point).z; const mat = get_transform_matrix(position, lookat, up); set_camera_position(camera_render, mat); + camera_render.fov = fov; + setGlobalFov(fov); } }, [slider_value, render_height, render_width]); @@ -406,23 +777,21 @@ export default function CameraPanel(props) { const get_camera_path = () => { // NOTE: currently assuming these are ints const num_points = fps * seconds; - - const positions = curve_object.curve_positions.getPoints(num_points); - const lookats = curve_object.curve_lookats.getPoints(num_points); - const ups = curve_object.curve_ups.getPoints(num_points); - const camera_path = []; for (let i = 0; i < num_points; i += 1) { - const position = positions[i]; - const lookat = lookats[i]; - const up = ups[i]; + const pt = getKeyframePoint(i / num_points); + + const position = curve_object.curve_positions.getPoint(pt); + const lookat = curve_object.curve_lookats.getPoint(pt); + const up = curve_object.curve_ups.getPoint(pt); + const fov = curve_object.curve_fovs.getPoint(pt).z; const mat = get_transform_matrix(position, lookat, up); camera_path.push({ camera_to_world: mat.transpose().elements, // convert from col-major to row-major matrix - fov: camera_render.fov, + fov, aspect: camera_render.aspect, }); } @@ -434,6 +803,7 @@ export default function CameraPanel(props) { matrix: JSON.stringify(camera.matrix.toArray()), fov: camera.fov, aspect: camera_render.aspect, + properties: JSON.stringify(Array.from(camera.properties.entries())), }); } @@ -447,7 +817,6 @@ export default function CameraPanel(props) { seconds, smoothness_value, is_cycle, - is_linear, }; return camera_path_object; }; @@ -479,9 +848,8 @@ export default function CameraPanel(props) { }; const load_camera_path = (camera_path_object) => { - // TODO UI for getting json - const new_camera_list = []; + const new_properties = new Map(cameraProperties); setRenderHeight(camera_path_object.render_height); setUIRenderHeight(camera_path_object.render_height); @@ -496,7 +864,6 @@ export default function CameraPanel(props) { set_smoothness_value(camera_path_object.smoothness_value); setIsCycle(camera_path_object.is_cycle); - setIsLinear(camera_path_object.is_linear); for (let i = 0; i < camera_path_object.keyframes.length; i += 1) { const keyframe = camera_path_object.keyframes[i]; @@ -507,13 +874,17 @@ export default function CameraPanel(props) { 1000, ); + // properties + camera.properties = new Map(JSON.parse(keyframe.properties)); + new_properties.set(camera.uuid, camera.properties); + const mat = new THREE.Matrix4(); mat.fromArray(JSON.parse(keyframe.matrix)); - // camera.matrix = mat; set_camera_position(camera, mat); new_camera_list.push(camera); } + setCameraProperties(new_properties); setCameras(new_camera_list); reset_slider_render_on_add(new_camera_list); }; @@ -553,12 +924,29 @@ export default function CameraPanel(props) { } }; - const setFOV = (fov) => { - dispatch({ - type: 'write', - path: 'renderingState/field_of_view', - data: fov, - }); + const isAnimated = (property) => animate.has(property); + + const toggleAnimate = (property) => { + const new_animate = new Set(animate); + if (animate.has(property)) { + new_animate.delete(property); + setAnimate(new_animate); + } else { + new_animate.add(property); + setAnimate(new_animate); + } + }; + + const setAllCameraFOV = (val) => { + if (fovLabel === FOV_LABELS.FOV) { + for (let i = 0; i < cameras.length; i += 1) { + cameras[i].fov = val; + } + } else { + for (let i = 0; i < cameras.length; i += 1) { + cameras[i].setFocalLength(val / cameras[i].aspect); + } + } }; return ( @@ -658,31 +1046,6 @@ export default function CameraPanel(props) { helperText={ui_render_width <= 0 ? 'Required' : ''} variant="standard" /> - { - if (e.target.validity.valid) { - setUIFieldOfView(e.target.value); - } - }} - onBlur={(e) => { - if (e.target.validity.valid) { - if (e.target.value !== '') { - setFOV(parseInt(e.target.value, 10)); - } else { - setUIFieldOfView(field_of_view); - } - } - }} - value={ui_field_of_view} - error={ui_field_of_view <= 0} - helperText={ui_field_of_view <= 0 ? 'Required' : ''} - variant="standard" - />
+
+ + + + +
- + {!is_cycle ? (
- - {!is_linear ? ( - - ) : ( - - )} + +
@@ -818,11 +1210,47 @@ export default function CameraPanel(props) {
+ + Camera Keyframes + + { + if (i === cameras.length && is_cycle) { + return `${cameras[0].properties.get('NAME')} @ ${parseFloat( + (value * seconds).toFixed(2), + )}s`; + } + return `${cameras[i].properties.get('NAME')} @ ${parseFloat( + (value * seconds).toFixed(2), + )}s`; + }} + marks={marks} + min={slider_min} + max={slider_max} + disabled={cameras.length < 2} + track={false} + onChange={handleKeyframeSlider} + sx={{ + '& .MuiSlider-thumb': { + borderRadius: '6px', + width: `${24.0 / Math.max(Math.sqrt(cameras.length), 2)}px`, + }, + }} + disableSwap + /> + + Playback + - + {/* eslint-disable-next-line no-nested-ternary */} {!is_playing && slider_max === slider_value ? ( @@ -873,7 +1301,7 @@ export default function CameraPanel(props) { } }} > - + ) : ( )}
@@ -910,6 +1338,13 @@ export default function CameraPanel(props) { camera_main={camera_render} cameras={cameras} setCameras={setCameras} + swapCameras={swapCameras} + cameraProperties={cameraProperties} + setCameraProperties={setCameraProperties} + fovLabel={fovLabel} + setFovLabel={setFovLabel} + isAnimated={isAnimated} + dispatch={dispatch} />
diff --git a/nerfstudio/viewer/app/src/modules/SidePanel/CameraPanel/curve.js b/nerfstudio/viewer/app/src/modules/SidePanel/CameraPanel/curve.js index c5cd68676..e877cbf4e 100644 --- a/nerfstudio/viewer/app/src/modules/SidePanel/CameraPanel/curve.js +++ b/nerfstudio/viewer/app/src/modules/SidePanel/CameraPanel/curve.js @@ -2,7 +2,7 @@ import * as THREE from 'three'; -function get_curve(list_of_3d_vectors, is_cycle, smoothness_value) { +function get_catmull_rom_curve(list_of_3d_vectors, is_cycle, smoothness_value) { // TODO: add some hyperparameters to this function const curve = new THREE.CatmullRomCurve3( list_of_3d_vectors, @@ -26,6 +26,7 @@ export function get_curve_object_from_cameras( const positions = []; const lookats = []; const ups = []; + const fovs = []; for (let i = 0; i < cameras.length; i += 1) { const camera = cameras[i]; @@ -39,20 +40,44 @@ export function get_curve_object_from_cameras( positions.push(camera.position); ups.push(up); lookats.push(lookat); + // Reuse catmullromcurve3 for 1d values. TODO fix this + fovs.push(new THREE.Vector3(0, 0, camera.fov)); + } + + if (is_cycle) { + const camera = cameras[0]; + + const up = new THREE.Vector3(0, 1, 0); + const lookat = new THREE.Vector3(0, 0, 1); + + up.applyQuaternion(camera.quaternion); + lookat.applyQuaternion(camera.quaternion); + + positions.push(camera.position); + ups.push(up); + lookats.push(lookat); + fovs.push(new THREE.Vector3(0, 0, camera.fov)); } let curve_positions = null; let curve_lookats = null; let curve_ups = null; + let curve_fovs = null; - curve_positions = get_curve(positions, is_cycle, smoothness_value); - curve_lookats = get_curve(lookats, is_cycle, smoothness_value); - curve_ups = get_curve(ups, is_cycle, smoothness_value); + curve_positions = get_catmull_rom_curve( + positions, + false, + smoothness_value, + ); + curve_lookats = get_catmull_rom_curve(lookats, false, smoothness_value); + curve_ups = get_catmull_rom_curve(ups, false, smoothness_value); + curve_fovs = get_catmull_rom_curve(fovs, false, 0.05); const curve_object = { curve_positions, curve_lookats, curve_ups, + curve_fovs, }; return curve_object; } diff --git a/nerfstudio/viewer/app/src/modules/SidePanel/ScenePanel/ScenePanel.jsx b/nerfstudio/viewer/app/src/modules/SidePanel/ScenePanel/ScenePanel.jsx index ff70042cb..69dc99416 100644 --- a/nerfstudio/viewer/app/src/modules/SidePanel/ScenePanel/ScenePanel.jsx +++ b/nerfstudio/viewer/app/src/modules/SidePanel/ScenePanel/ScenePanel.jsx @@ -161,6 +161,7 @@ function MenuItems(props: ListItemProps) { .map((key) => ( Date: Sun, 6 Nov 2022 22:55:50 -0800 Subject: [PATCH 34/68] Add training finished statement (#914) --- nerfstudio/engine/trainer.py | 3 +++ 1 file changed, 3 insertions(+) diff --git a/nerfstudio/engine/trainer.py b/nerfstudio/engine/trainer.py index 74e3d25bf..5b5bca84c 100644 --- a/nerfstudio/engine/trainer.py +++ b/nerfstudio/engine/trainer.py @@ -174,6 +174,9 @@ class Trainer: writer.write_out_storage() # save checkpoint at the end of training self.save_checkpoint(step) + CONSOLE.rule() + CONSOLE.print("[bold green]:tada: :tada: :tada: Training Finished :tada: :tada: :tada:", justify="center") + CONSOLE.print("Use ctrl+c to quit", justify="center") self._always_render(step) @check_main_thread From a6de0f5f605206eea80e90440fdc834349927060 Mon Sep 17 00:00:00 2001 From: Nail Ibrahimli Date: Mon, 7 Nov 2022 19:34:15 +0100 Subject: [PATCH 35/68] fixing typos (#915) --- docs/developer_guides/pipelines/index.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/developer_guides/pipelines/index.rst b/docs/developer_guides/pipelines/index.rst index b90954525..7255af29a 100644 --- a/docs/developer_guides/pipelines/index.rst +++ b/docs/developer_guides/pipelines/index.rst @@ -26,9 +26,9 @@ Why Pipelines? Our goal is for any NeRF paper to be implemented as a Pipeline. -The Pipeline is composed of two major components, namely the DataManager and the Model. The DataManager is responsible for loading data and generating RayBundle and RayGT objects. RayBundles are the input to the forward pass of the Model. These are needed for at both train and inference time. RayGT objects, however, are needed only during training to calculate the losses in the Loss Dict. +The Pipeline is composed of two major components, namely the DataManager and the Model. The DataManager is responsible for loading data and generating RayBundle and RayGT objects. RayBundles are the input to the forward pass of the Model. These are needed for both training and inference time. RayGT objects, however, are needed only during training to calculate the losses in the Loss Dict. -RayBundle objects describe origins and viewing directions. The model will take these rays and render them into quanties as RayOutputs. RayGT contains the necessary ground truth (GT) information needed to compute losses. For example, the GT pixel values can be used to supervise the rendered rays with an L2 loss. +RayBundle objects describe origins and viewing directions. The model will take these rays and render them into quantities as RayOutputs. RayGT contains the necessary ground truth (GT) information needed to compute losses. For example, the GT pixel values can be used to supervise the rendered rays with an L2 loss. In the following sections, we describe the Pipeline components and look at their code. @@ -44,6 +44,6 @@ In the following sections, we describe the Pipeline components and look at their Implementing NeRF Papers ========================== -Let's say you want to create a custom Pipeline that has a custom DataManager and a custom Model. Perhaps you care about dynmically adding cameras to the DataManager during training or you want to importance sample and generate rays from pixels where the loss is high. This can be accomplished by mixing and matching components into a Pipeline. The following guide will take you through an example of this. +Let's say you want to create a custom Pipeline that has a custom DataManager and a custom Model. Perhaps you care about dynamically adding cameras to the DataManager during training or you want to importance sample and generate rays from pixels where the loss is high. This can be accomplished by mixing and matching components into a Pipeline. The following guide will take you through an example of this. -This guide is coming soon! \ No newline at end of file +This guide is coming soon! From b978209858764a913b569a69a12957618996293b Mon Sep 17 00:00:00 2001 From: Nikhil Mohan <47728081+nikmo33@users.noreply.github.com> Date: Mon, 7 Nov 2022 18:53:30 +0000 Subject: [PATCH 36/68] [WIP] nan-training-debug (#910) * add repro * update eps * lint Co-authored-by: Matthew Tancik --- nerfstudio/cameras/camera_utils.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/nerfstudio/cameras/camera_utils.py b/nerfstudio/cameras/camera_utils.py index b0de30a9b..30d755596 100644 --- a/nerfstudio/cameras/camera_utils.py +++ b/nerfstudio/cameras/camera_utils.py @@ -342,7 +342,7 @@ def _compute_residual_and_jacobian( def radial_and_tangential_undistort( coords: torch.Tensor, distortion_params: torch.Tensor, - eps: float = 1e-9, + eps: float = 1e-3, max_iterations: int = 10, ) -> torch.Tensor: """Computes undistorted coords given opencv distortion parameters. From 28b86f8718f26bbbe77798b0457f6c427bbb8e4c Mon Sep 17 00:00:00 2001 From: Matthew Tancik Date: Mon, 7 Nov 2022 12:11:10 -0800 Subject: [PATCH 37/68] Allow specifying colmap path (#917) --- docs/quickstart/custom_dataset.md | 2 +- scripts/process_data.py | 24 +++++++++++++++++------- 2 files changed, 18 insertions(+), 8 deletions(-) diff --git a/docs/quickstart/custom_dataset.md b/docs/quickstart/custom_dataset.md index 960a38422..903c8df31 100644 --- a/docs/quickstart/custom_dataset.md +++ b/docs/quickstart/custom_dataset.md @@ -88,7 +88,7 @@ cd vcpkg ```bash git clone https://github.com/microsoft/vcpkg cd vcpkg -./bootstrap-vcpkg.sh +./bootstrap-vcpkg.bat ./vcpkg install colmap[cuda]:x64-windows ``` diff --git a/scripts/process_data.py b/scripts/process_data.py index 6f65165af..d6f7e0961 100755 --- a/scripts/process_data.py +++ b/scripts/process_data.py @@ -51,7 +51,7 @@ def status(msg: str, spinner: str = "bouncingBall", verbose: bool = False): return CONSOLE.status(msg, spinner=spinner) -def get_colmap_version(default_version=3.8) -> float: +def get_colmap_version(colmap_cmd: str, default_version=3.8) -> float: """Returns the version of COLMAP. This code assumes that colmap returns a version string of the form "COLMAP 3.8 ..." which may not be true for all versions of COLMAP. @@ -61,7 +61,7 @@ def get_colmap_version(default_version=3.8) -> float: Returns: The version of COLMAP. """ - output = run_command("colmap", verbose=False) + output = run_command(colmap_cmd, verbose=False) assert output is not None for line in output.split("\n"): if line.startswith("COLMAP"): @@ -352,6 +352,7 @@ def run_colmap( gpu: bool = True, verbose: bool = False, matching_method: Literal["vocab_tree", "exhaustive", "sequential"] = "vocab_tree", + colmap_cmd: str = "colmap", ) -> None: """Runs COLMAP on the images. @@ -363,7 +364,7 @@ def run_colmap( verbose: If True, logs the output of the command. """ - colmap_version = get_colmap_version() + colmap_version = get_colmap_version(colmap_cmd) colmap_database_path = colmap_dir / "database.db" if colmap_database_path.exists(): @@ -372,7 +373,7 @@ def run_colmap( # Feature extraction feature_extractor_cmd = [ - "colmap feature_extractor", + f"{colmap_cmd} feature_extractor", f"--database_path {colmap_dir / 'database.db'}", f"--image_path {image_dir}", "--ImageReader.single_camera 1", @@ -387,7 +388,7 @@ def run_colmap( # Feature matching feature_matcher_cmd = [ - f"colmap {matching_method}_matcher", + f"{colmap_cmd} {matching_method}_matcher", f"--database_path {colmap_dir / 'database.db'}", f"--SiftMatching.use_gpu {int(gpu)}", ] @@ -403,7 +404,7 @@ def run_colmap( sparse_dir = colmap_dir / "sparse" sparse_dir.mkdir(parents=True, exist_ok=True) mapper_cmd = [ - "colmap mapper", + f"{colmap_cmd} mapper", f"--database_path {colmap_dir / 'database.db'}", f"--image_path {image_dir}", f"--output_path {sparse_dir}", @@ -422,7 +423,7 @@ def run_colmap( CONSOLE.log("[bold green]:tada: Done COLMAP bundle adjustment.") with status(msg="[bold yellow]Refine intrinsics...", spinner="dqpb", verbose=verbose): bundle_adjuster_cmd = [ - "colmap bundle_adjuster", + f"{colmap_cmd} bundle_adjuster", f"--input_path {sparse_dir}/0", f"--output_path {sparse_dir}/0", "--BundleAdjustment.refine_principal_point 1", @@ -653,6 +654,8 @@ class ProcessImages: will downscale the images by 2x, 4x, and 8x.""" skip_colmap: bool = False """If True, skips COLMAP and generates transforms.json if possible.""" + colmap_cmd: str = "colmap" + """How to call the COLMAP executable.""" gpu: bool = True """If True, use GPU.""" verbose: bool = False @@ -688,6 +691,7 @@ class ProcessImages: gpu=self.gpu, verbose=self.verbose, matching_method=self.matching_method, + colmap_cmd=self.colmap_cmd, ) # Save transforms.json @@ -738,6 +742,8 @@ class ProcessVideo: will downscale the images by 2x, 4x, and 8x.""" skip_colmap: bool = False """If True, skips COLMAP and generates transforms.json if possible.""" + colmap_cmd: str = "colmap" + """How to call the COLMAP executable.""" gpu: bool = True """If True, use GPU.""" verbose: bool = False @@ -772,6 +778,7 @@ class ProcessVideo: gpu=self.gpu, verbose=self.verbose, matching_method=self.matching_method, + colmap_cmd=self.colmap_cmd, ) # Save transforms.json @@ -824,6 +831,8 @@ class ProcessInsta360: will downscale the images by 2x, 4x, and 8x.""" skip_colmap: bool = False """If True, skips COLMAP and generates transforms.json if possible.""" + colmap_cmd: str = "colmap" + """How to call the COLMAP executable.""" gpu: bool = True """If True, use GPU.""" verbose: bool = False @@ -864,6 +873,7 @@ class ProcessInsta360: gpu=self.gpu, verbose=self.verbose, matching_method=self.matching_method, + colmap_cmd=self.colmap_cmd, ) # Save transforms.json From c325e90a8ebbe96ed7ebe8c3935a4eafe41a92b5 Mon Sep 17 00:00:00 2001 From: David McAllister Date: Mon, 7 Nov 2022 22:36:53 -0800 Subject: [PATCH 38/68] 3D Viewer Displays cameras' Chosen Names (#920) 3D viewer displays cameras' chosen names --- .../app/src/modules/SidePanel/CameraPanel/CameraPanel.jsx | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/nerfstudio/viewer/app/src/modules/SidePanel/CameraPanel/CameraPanel.jsx b/nerfstudio/viewer/app/src/modules/SidePanel/CameraPanel/CameraPanel.jsx index 585d5557f..ec252234f 100644 --- a/nerfstudio/viewer/app/src/modules/SidePanel/CameraPanel/CameraPanel.jsx +++ b/nerfstudio/viewer/app/src/modules/SidePanel/CameraPanel/CameraPanel.jsx @@ -617,8 +617,12 @@ export default function CameraPanel(props) { const labelDiv = document.createElement('div'); labelDiv.className = 'label'; - labelDiv.textContent = i; + labelDiv.textContent = camera.properties.get('NAME'); labelDiv.style.color = 'black'; + labelDiv.style.backgroundColor = "rgba(255, 255, 255, 0.61)"; + labelDiv.style.backdropFilter = 'blur(5px)'; + labelDiv.style.padding = '6px'; + labelDiv.style.borderRadius = '6px'; labelDiv.style.visibility = 'visible'; const camera_label = new CSS2DObject(labelDiv); camera_label.position.set(0, -0.1, -0.1); @@ -636,7 +640,7 @@ export default function CameraPanel(props) { camera_helper, ); } - }, [cameras, render_width, render_height]); + }, [cameras, cameraProperties, render_width, render_height]); // update the camera curve const curve_object = get_curve_object_from_cameras( From 3a056ed622e7e302d32d7e28d5b9bb63bc8cace9 Mon Sep 17 00:00:00 2001 From: Abhik Ahuja Date: Mon, 7 Nov 2022 22:45:00 -0800 Subject: [PATCH 39/68] Fixed crash when camera looping is on, but no cameras (#922) Fixed camera cycle crash --- .../SidePanel/CameraPanel/CameraPanel.jsx | 78 ++++++++++++------- .../modules/SidePanel/CameraPanel/curve.js | 9 +-- 2 files changed, 55 insertions(+), 32 deletions(-) diff --git a/nerfstudio/viewer/app/src/modules/SidePanel/CameraPanel/CameraPanel.jsx b/nerfstudio/viewer/app/src/modules/SidePanel/CameraPanel/CameraPanel.jsx index ec252234f..dbabf0f3d 100644 --- a/nerfstudio/viewer/app/src/modules/SidePanel/CameraPanel/CameraPanel.jsx +++ b/nerfstudio/viewer/app/src/modules/SidePanel/CameraPanel/CameraPanel.jsx @@ -87,16 +87,19 @@ function FovSelector(props) { const new_focal_len = camera.getFocalLength(); camera.fov = old_fov; const label = Math.round( - fovLabel === FOV_LABELS.FOV - ? globalFov - : new_focal_len * camera.aspect, + fovLabel === FOV_LABELS.FOV ? globalFov : new_focal_len * camera.aspect, ); return label; }; - const [UIFieldOfView, setUIFieldOfView] = React.useState(isGlobal ? globalFov : getFovLabel()); + const [UIFieldOfView, setUIFieldOfView] = React.useState( + isGlobal ? globalFov : getFovLabel(), + ); - useEffect(() => setUIFieldOfView(getFovLabel()), [camera, fovLabel, globalFov]); + useEffect( + () => setUIFieldOfView(getFovLabel()), + [camera, fovLabel, globalFov], + ); const setFOV = (val) => { if (!isGlobal) { @@ -109,10 +112,10 @@ function FovSelector(props) { setGlobalFov(val); } else { const old_fov = camera.fov; - camera.setFocalLength(val / camera.aspect); - const new_fov = camera.getEffectiveFOV(); - camera.fov = old_fov; - setGlobalFov(new_fov); + camera.setFocalLength(val / camera.aspect); + const new_fov = camera.getEffectiveFOV(); + camera.fov = old_fov; + setGlobalFov(new_fov); } if (applyAll) { @@ -178,8 +181,10 @@ function FovSelector(props) { }} sx={{ input: { - "-webkit-text-fill-color": `${disabled ? "#24B6FF" : "#EBEBEB"} !important`, - color: `${disabled ? "#24B6FF" : "#EBEBEB"} !important`, + '-webkit-text-fill-color': `${ + disabled ? '#24B6FF' : '#EBEBEB' + } !important`, + color: `${disabled ? '#24B6FF' : '#EBEBEB'} !important`, }, }} value={UIFieldOfView} @@ -391,21 +396,22 @@ function CameraList(props) { - {isAnimated('FOV') && - } - {!isAnimated('FOV') && -

+ {isAnimated('FOV') && ( + + )} + {!isAnimated('FOV') && ( +

Animated camera properties will show up here!

- } + )}
); @@ -721,7 +727,7 @@ export default function CameraPanel(props) { values.push(is_cycle ? time * ratio : time); }); - if (is_cycle) { + if (is_cycle && cameras.length !== 0) { values.push(1.0); } @@ -1110,12 +1116,27 @@ export default function CameraPanel(props) { onClick={() => { toggleAnimate('FOV'); }} - style={{maxWidth: '20px', maxHeight: '20px', minWidth: '20px', minHeight: '20px', position: 'relative', top: '22px'}} + style={{ + maxWidth: '20px', + maxHeight: '20px', + minWidth: '20px', + minHeight: '20px', + position: 'relative', + top: '22px', + }} sx={{ mt: 1, }} > - + { + if (cameras.length === 0) { + return ''; + } if (i === cameras.length && is_cycle) { return `${cameras[0].properties.get('NAME')} @ ${parseFloat( (value * seconds).toFixed(2), diff --git a/nerfstudio/viewer/app/src/modules/SidePanel/CameraPanel/curve.js b/nerfstudio/viewer/app/src/modules/SidePanel/CameraPanel/curve.js index e877cbf4e..11a36f7cf 100644 --- a/nerfstudio/viewer/app/src/modules/SidePanel/CameraPanel/curve.js +++ b/nerfstudio/viewer/app/src/modules/SidePanel/CameraPanel/curve.js @@ -19,6 +19,9 @@ export function get_curve_object_from_cameras( is_cycle, smoothness_value, ) { + if (cameras.length === 0) { + return null; + } // interpolate positions, lookat directions, and ups // similar to // https://github.com/google-research/multinerf/blob/1c8b1c552133cdb2de1c1f3c871b2813f6662265/internal/camera_utils.py#L281 @@ -64,11 +67,7 @@ export function get_curve_object_from_cameras( let curve_ups = null; let curve_fovs = null; - curve_positions = get_catmull_rom_curve( - positions, - false, - smoothness_value, - ); + curve_positions = get_catmull_rom_curve(positions, false, smoothness_value); curve_lookats = get_catmull_rom_curve(lookats, false, smoothness_value); curve_ups = get_catmull_rom_curve(ups, false, smoothness_value); curve_fovs = get_catmull_rom_curve(fovs, false, 0.05); From 8d3640c6a1da89a623d91055308d8891e62e6671 Mon Sep 17 00:00:00 2001 From: Matthew Tancik Date: Tue, 8 Nov 2022 22:23:06 -0800 Subject: [PATCH 40/68] Support exporting point clouds (#924) * Support exporting point clouds * Fix typing * lint * Update requirements --- nerfstudio/model_components/exporters.py | 128 +++++++++++++++++++++++ pyproject.toml | 4 +- scripts/exporter.py | 127 ++++++++++++++++++++++ 3 files changed, 258 insertions(+), 1 deletion(-) create mode 100644 nerfstudio/model_components/exporters.py create mode 100644 scripts/exporter.py diff --git a/nerfstudio/model_components/exporters.py b/nerfstudio/model_components/exporters.py new file mode 100644 index 000000000..947254500 --- /dev/null +++ b/nerfstudio/model_components/exporters.py @@ -0,0 +1,128 @@ +# Copyright 2022 The Nerfstudio Team. All rights reserved. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + + +"""Algorithms for exporting data.""" + +from __future__ import annotations + +import sys +from typing import Tuple + +import open3d as o3d +import torch +from rich.console import Console +from rich.progress import ( + BarColumn, + Progress, + TaskProgressColumn, + TextColumn, + TimeRemainingColumn, +) + +from nerfstudio.configs.base_config import Config # pylint: disable=unused-import +from nerfstudio.pipelines.base_pipeline import Pipeline + +CONSOLE = Console(width=120) + + +def generate_point_cloud( + pipeline: Pipeline, + num_points: int = 1000000, + remove_outliers: bool = True, + estimate_normals: bool = False, + rgb_output_name: str = "rgb", + depth_output_name: str = "depth", + use_bounding_box: bool = True, + bounding_box_min: Tuple[float, float, float] = (-1.0, -1.0, -1.0), + bounding_box_max: Tuple[float, float, float] = (1.0, 1.0, 1.0), +) -> o3d.geometry.PointCloud: + """Generate a point cloud from a nerf. + + Args: + pipeline: Pipeline to evaluate with. + num_points: Number of points to generate. May result in less if outlier removal is used. + remove_outliers: Whether to remove outliers. + estimate_normals: Whether to estimate normals. + rgb_output_name: Name of the RGB output. + depth_output_name: Name of the depth output. + use_bounding_box: Whether to use a bounding box to sample points. + bounding_box_min: Minimum of the bounding box. + bounding_box_max: Maximum of the bounding box. + + Returns: + Point cloud. + """ + + progress = Progress( + TextColumn(":cloud: Computing Point Cloud :cloud:"), + BarColumn(), + TaskProgressColumn(show_speed=True), + TimeRemainingColumn(elapsed_when_finished=True, compact=True), + ) + points = [] + rgbs = [] + with progress as progress_bar: + task = progress_bar.add_task("Generating Point Cloud", total=num_points) + while not progress_bar.finished: + with torch.no_grad(): + ray_bundle, _ = pipeline.datamanager.next_train(0) + outputs = pipeline.model(ray_bundle) + if rgb_output_name not in outputs: + CONSOLE.rule("Error", style="red") + CONSOLE.print(f"Could not find {rgb_output_name} in the model outputs", justify="center") + CONSOLE.print(f"Please set --rgb_output_name to one of: {outputs.keys()}", justify="center") + sys.exit(1) + if depth_output_name not in outputs: + CONSOLE.rule("Error", style="red") + CONSOLE.print(f"Could not find {depth_output_name} in the model outputs", justify="center") + CONSOLE.print(f"Please set --depth_output_name to one of: {outputs.keys()}", justify="center") + sys.exit(1) + rgb = outputs[rgb_output_name] + depth = outputs[depth_output_name] + point = ray_bundle.origins + ray_bundle.directions * depth + + if use_bounding_box: + comp_l = torch.tensor(bounding_box_min, device=point.device) + comp_m = torch.tensor(bounding_box_max, device=point.device) + assert torch.all( + comp_l < comp_m + ), f"Bounding box min {bounding_box_min} must be smaller than max {bounding_box_max}" + mask = torch.all(torch.concat([point > comp_l, point < comp_m], dim=-1), dim=-1) + point = point[mask] + rgb = rgb[mask] + + points.append(point) + rgbs.append(rgb) + progress.advance(task, point.shape[0]) + points = torch.cat(points, dim=0) + rgbs = torch.cat(rgbs, dim=0) + + pcd = o3d.geometry.PointCloud() + pcd.points = o3d.utility.Vector3dVector(points.float().cpu().numpy()) + pcd.colors = o3d.utility.Vector3dVector(rgbs.float().cpu().numpy()) + + if remove_outliers: + CONSOLE.print("Cleaning Point Cloud") + pcd, _ = pcd.remove_statistical_outlier(nb_neighbors=20, std_ratio=1.0) + print("\033[A\033[A") + CONSOLE.print("[bold green]:white_check_mark: Cleaning Point Cloud") + + if estimate_normals: + CONSOLE.print("Estimating Point Cloud Normals") + pcd.estimate_normals() + print("\033[A\033[A") + CONSOLE.print("[bold green]:white_check_mark: Estimating Point Cloud Normals") + + return pcd diff --git a/pyproject.toml b/pyproject.toml index c08d82dbe..58955d64e 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -31,6 +31,7 @@ dependencies = [ "msgpack==1.0.4", "msgpack_numpy==0.4.8", "nerfacc==0.2.1", + "open3d>=0.16.0", "opencv-python==4.6.0.66", "plotly==5.7.0", "protobuf==3.20.0", @@ -66,7 +67,7 @@ docs = [ "furo==2022.4.7", "readthedocs-sphinx-search==0.1.2", "myst-nb==0.16.0", - "nbformat==5.4.0", + "nbformat==5.5.0", "sphinx==4.5.0", "sphinxemoji==0.2.0", "sphinx-argparse==0.3.1", @@ -83,6 +84,7 @@ ns-download-data = "scripts.downloads.download_data:entrypoint" ns-train = "scripts.train:entrypoint" ns-eval = "scripts.eval:entrypoint" ns-render = "scripts.render:entrypoint" +ns-export = "scripts.exporter:entrypoint" ns-dev-test = "scripts.github.run_actions:entrypoint" ns-bridge-server = "nerfstudio.viewer.server.server:entrypoint" diff --git a/scripts/exporter.py b/scripts/exporter.py new file mode 100644 index 000000000..55a8a1b28 --- /dev/null +++ b/scripts/exporter.py @@ -0,0 +1,127 @@ +""" +Script for exporting NeRF into other formats. +""" + +from __future__ import annotations + +from dataclasses import dataclass +from pathlib import Path +from typing import Tuple, Union + +import open3d as o3d +import tyro +from rich.console import Console +from typing_extensions import Annotated + +from nerfstudio.model_components.exporters import generate_point_cloud +from nerfstudio.utils.eval_utils import eval_setup + +CONSOLE = Console(width=120) + + +@dataclass +class Exporter: + """Export the mesh from a YML config to a folder.""" + + load_config: Path + """Path to the config YAML file.""" + output_dir: Path + """Path to the output directory.""" + + +@dataclass +class ExportPointCloud(Exporter): + """Class to export meshes with the poisson algorithm.""" + + num_points: int = 1000000 + """Number of points to generate. May result in less if outlier removal is used.""" + remove_outliers: bool = True + """Remove outliers from the point cloud.""" + estimate_normals: bool = False + """Estimate normals for the point cloud.""" + depth_output_name: str = "depth" + """Name of the depth output.""" + rgb_output_name: str = "rgb" + """Name of the RGB output.""" + use_bounding_box: bool = True + """Only query points within the bounding box""" + bounding_box_min: Tuple[float, float, float] = (-1, -1, -1) + """Minimum of the bounding box, used if use_bounding_box is True.""" + bounding_box_max: Tuple[float, float, float] = (1, 1, 1) + """Minimum of the bounding box, used if use_bounding_box is True.""" + num_rays_per_batch: int = 65536 + """Number of rays to evaluate per batch. Decrease if you run out of memory.""" + + def main(self) -> None: + """Export point cloud.""" + + if not self.output_dir.exists(): + self.output_dir.mkdir(parents=True) + + _, pipeline, _ = eval_setup(self.load_config) + + # Increase the batchsize to speed up the evaluation. + pipeline.datamanager.train_pixel_sampler.num_rays_per_batch = self.num_rays_per_batch + + pcd = generate_point_cloud( + pipeline=pipeline, + num_points=self.num_points, + remove_outliers=self.remove_outliers, + estimate_normals=self.estimate_normals, + rgb_output_name=self.rgb_output_name, + depth_output_name=self.depth_output_name, + use_bounding_box=self.use_bounding_box, + bounding_box_min=self.bounding_box_min, + bounding_box_max=self.bounding_box_max, + ) + + CONSOLE.print(f"[bold green]:white_check_mark: Generated {pcd}") + CONSOLE.print("Saving Point Cloud") + o3d.io.write_point_cloud(str(self.output_dir / "point_cloud.ply"), pcd) + print("\033[A\033[A") + CONSOLE.print("[bold green]:white_check_mark: Saving Point Cloud") + + +@dataclass +class ExportTSDFMesh(Exporter): + """Class to export meshes with the poisson algorithm.""" + + def main(self) -> None: + """Export mesh""" + raise NotImplementedError("TSDF mesh reconstruction not implemented yet.") + + +@dataclass +class ExportPoissonMesh(Exporter): + """Exports a mesh using poisson mesh reconstruction.""" + + def main(self) -> None: + """Export mesh""" + raise NotImplementedError("Poisson mesh reconstruction not implemented yet.") + + +@dataclass +class ExportMarchingCubesMesh(Exporter): + """Exports a mesh using marching cubes.""" + + def main(self) -> None: + """Export mesh""" + raise NotImplementedError("Marching cubes not implemented yet.") + + +Commands = Union[ + Annotated[ExportPointCloud, tyro.conf.subcommand(name="pointcloud")], + Annotated[ExportTSDFMesh, tyro.conf.subcommand(name="tsdf")], + Annotated[ExportPoissonMesh, tyro.conf.subcommand(name="poisson")], + Annotated[ExportMarchingCubesMesh, tyro.conf.subcommand(name="marching-cubes")], +] + + +def entrypoint(): + """Entrypoint for use with pyproject scripts.""" + tyro.extras.set_accent_color("bright_yellow") + tyro.cli(Commands).main() + + +if __name__ == "__main__": + entrypoint() From c5c980dd4dbf7e35bd94e54bf5d39709e0d40398 Mon Sep 17 00:00:00 2001 From: Matthew Tancik Date: Wed, 9 Nov 2022 11:45:53 -0800 Subject: [PATCH 41/68] Add viewport controls help modal (#927) --- nerfstudio/viewer/app/src/index.scss | 22 ++++++++- .../viewer/app/src/modules/Banner/Banner.jsx | 2 + .../src/modules/LandingModal/LandingModal.jsx | 8 +--- .../ViewportControlsModal.jsx | 46 +++++++++++++++++++ .../modules/ViewportControlsModal/index.jsx | 3 ++ 5 files changed, 72 insertions(+), 9 deletions(-) create mode 100644 nerfstudio/viewer/app/src/modules/ViewportControlsModal/ViewportControlsModal.jsx create mode 100644 nerfstudio/viewer/app/src/modules/ViewportControlsModal/index.jsx diff --git a/nerfstudio/viewer/app/src/index.scss b/nerfstudio/viewer/app/src/index.scss index 81d059e53..146947df4 100644 --- a/nerfstudio/viewer/app/src/index.scss +++ b/nerfstudio/viewer/app/src/index.scss @@ -174,8 +174,9 @@ $sidebar-width: 100% !default; border: 2px solid #000; // box-shadow: 24px 24px; padding: 32px; - overflow-y: scroll; - height: 90%; + overflow-y: auto; + height: auto; + max-height: 90%; } .LandingModal-box .WebSocketUrlField { @@ -186,6 +187,23 @@ $sidebar-width: 100% !default; margin: 3px; } +// ------------------------------------ +// Viewport Controls Modal styling + +.ViewportConstrolsModal-box { + position: absolute; + top: 50%; + left: 50%; + transform: translate(-50%, -50%); + width: 800px; // 400 + background-color: $base-color2; + border: 2px solid #000; + // box-shadow: 24px 24px; + padding: 32px; + overflow-y: auto; + height: auto; +} + // ------------------------------------ // Render Modal styling diff --git a/nerfstudio/viewer/app/src/modules/Banner/Banner.jsx b/nerfstudio/viewer/app/src/modules/Banner/Banner.jsx index 0ab082edd..baedf714d 100644 --- a/nerfstudio/viewer/app/src/modules/Banner/Banner.jsx +++ b/nerfstudio/viewer/app/src/modules/Banner/Banner.jsx @@ -5,6 +5,7 @@ import Button from '@mui/material/Button'; import GitHubIcon from '@mui/icons-material/GitHub'; import DescriptionRoundedIcon from '@mui/icons-material/DescriptionRounded'; import LandingModal from '../LandingModal'; +import ViewportControlsModal from '../ViewportControlsModal'; function getParam(param_name) { // https://stackoverflow.com/questions/831030/how-to-get-get-request-parameters-in-javascript @@ -56,6 +57,7 @@ export default function Banner() { > Documentation +
-

Camera Keyboard Controls

-
- Spacebar - reset camera to starting position
- WS - forward camera translation, AD - side to side camera translation
- QE - up and down camera translation, Arrow Keys - camera rotation -
- + ); } diff --git a/nerfstudio/viewer/app/src/modules/ViewportControlsModal/ViewportControlsModal.jsx b/nerfstudio/viewer/app/src/modules/ViewportControlsModal/ViewportControlsModal.jsx new file mode 100644 index 000000000..7a6d10380 --- /dev/null +++ b/nerfstudio/viewer/app/src/modules/ViewportControlsModal/ViewportControlsModal.jsx @@ -0,0 +1,46 @@ +/* eslint-disable react/jsx-props-no-spreading */ +import * as React from 'react'; + +import { Box, Button, Modal } from '@mui/material'; +import KeyboardIcon from '@mui/icons-material/Keyboard'; + +export default function ControlsModal() { + const [open, setOpen] = React.useState(false); + const handleOpen = () => setOpen(true); + const handleClose = () => setOpen(false); + + return ( +
+ + + +
+ The favicon. + Controls diagram +
+
+
+
+ ); +} diff --git a/nerfstudio/viewer/app/src/modules/ViewportControlsModal/index.jsx b/nerfstudio/viewer/app/src/modules/ViewportControlsModal/index.jsx new file mode 100644 index 000000000..befc5306e --- /dev/null +++ b/nerfstudio/viewer/app/src/modules/ViewportControlsModal/index.jsx @@ -0,0 +1,3 @@ +import ViewportControlsModal from './ViewportControlsModal'; + +export default ViewportControlsModal; From ee6b0071552ab3329e1b5fb23c0cd8f3cc353e41 Mon Sep 17 00:00:00 2001 From: Matthew Tancik Date: Wed, 9 Nov 2022 20:23:05 -0800 Subject: [PATCH 42/68] Avoid boolean flag auto conversion (#929) --- nerfstudio/configs/method_configs.py | 4 +++- pyproject.toml | 2 +- scripts/exporter.py | 2 +- 3 files changed, 5 insertions(+), 3 deletions(-) diff --git a/nerfstudio/configs/method_configs.py b/nerfstudio/configs/method_configs.py index 377c782aa..2423984c7 100644 --- a/nerfstudio/configs/method_configs.py +++ b/nerfstudio/configs/method_configs.py @@ -185,7 +185,9 @@ method_configs["tensorf"] = Config( ) AnnotatedBaseConfigUnion = tyro.conf.SuppressFixed[ # Don't show unparseable (fixed) arguments in helptext. - tyro.extras.subcommand_type_from_defaults(defaults=method_configs, descriptions=descriptions) + tyro.conf.FlagConversionOff[ + tyro.extras.subcommand_type_from_defaults(defaults=method_configs, descriptions=descriptions) + ] ] """Union[] type over config types, annotated with default instances for use with tyro.cli(). Allows the user to pick between one of several base configurations, and diff --git a/pyproject.toml b/pyproject.toml index 58955d64e..a7f601453 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -18,7 +18,7 @@ dependencies = [ "aiortc==1.3.2", "appdirs>=1.4", "av==9.2.0", - "tyro>=0.3.23", + "tyro>=0.3.31", "gdown==4.5.1", "ninja==1.10.2.3", "functorch==0.2.1", diff --git a/scripts/exporter.py b/scripts/exporter.py index 55a8a1b28..b251f50ae 100644 --- a/scripts/exporter.py +++ b/scripts/exporter.py @@ -120,7 +120,7 @@ Commands = Union[ def entrypoint(): """Entrypoint for use with pyproject scripts.""" tyro.extras.set_accent_color("bright_yellow") - tyro.cli(Commands).main() + tyro.cli(tyro.conf.FlagConversionOff[Commands]).main() if __name__ == "__main__": From 3833e4de56f8001da53c4e02b745a47c3e9380a7 Mon Sep 17 00:00:00 2001 From: Matthew Tancik Date: Wed, 9 Nov 2022 22:54:04 -0800 Subject: [PATCH 43/68] Missing mlp output activation (#930) --- nerfstudio/field_components/mlp.py | 2 ++ 1 file changed, 2 insertions(+) diff --git a/nerfstudio/field_components/mlp.py b/nerfstudio/field_components/mlp.py index 7774e043a..6f167056e 100644 --- a/nerfstudio/field_components/mlp.py +++ b/nerfstudio/field_components/mlp.py @@ -93,4 +93,6 @@ class MLP(FieldComponent): x = layer(x) if self.activation: x = self.activation(x) + if self.out_activation is not None: + x = self.out_activation(x) return x From 3e52aebd9a451188ece1af0b43a8ff4a2dd993c6 Mon Sep 17 00:00:00 2001 From: Kevin Chen <79341521+kevinddchen@users.noreply.github.com> Date: Thu, 10 Nov 2022 10:08:02 -0800 Subject: [PATCH 44/68] Do not apply activation for last MLP layer (#932) --- nerfstudio/field_components/mlp.py | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/nerfstudio/field_components/mlp.py b/nerfstudio/field_components/mlp.py index 6f167056e..312714a23 100644 --- a/nerfstudio/field_components/mlp.py +++ b/nerfstudio/field_components/mlp.py @@ -15,7 +15,7 @@ """ Multi Layer Perceptron """ -from typing import Optional, Tuple +from typing import Optional, Set, Tuple import torch from torch import nn @@ -54,6 +54,7 @@ class MLP(FieldComponent): self.num_layers = num_layers self.layer_width = layer_width self.skip_connections = skip_connections + self._skip_connections: Set[int] = set(skip_connections) if skip_connections else set() self.activation = activation self.out_activation = out_activation self.net = None @@ -67,10 +68,9 @@ class MLP(FieldComponent): else: for i in range(self.num_layers - 1): if i == 0: - if self.skip_connections is not None: - assert i not in list(self.skip_connections), "Skip connection at layer 0 doesn't make sense." + assert i not in self._skip_connections, "Skip connection at layer 0 doesn't make sense." layers.append(nn.Linear(self.in_dim, self.layer_width)) - elif self.skip_connections is not None and i in self.skip_connections: + elif i in self._skip_connections: layers.append(nn.Linear(self.layer_width + self.in_dim, self.layer_width)) else: layers.append(nn.Linear(self.layer_width, self.layer_width)) @@ -88,10 +88,11 @@ class MLP(FieldComponent): """ x = in_tensor for i, layer in enumerate(self.layers): - if self.skip_connections is not None and i in self.skip_connections: + # as checked in `build_nn_modules`, 0 should not be in `_skip_connections` + if i in self._skip_connections: x = torch.cat([in_tensor, x], -1) x = layer(x) - if self.activation: + if self.activation is not None and i < len(self.layers) - 1: x = self.activation(x) if self.out_activation is not None: x = self.out_activation(x) From 4b65180a5749a6bb9a378aa1fd0bf04135d578c9 Mon Sep 17 00:00:00 2001 From: Matthew Tancik Date: Thu, 10 Nov 2022 13:27:10 -0800 Subject: [PATCH 45/68] Add missing activation (#933) --- nerfstudio/fields/nerfacto_field.py | 2 ++ nerfstudio/fields/nerfw_field.py | 3 +++ nerfstudio/fields/semantic_nerf_field.py | 3 +++ nerfstudio/fields/tensorf_field.py | 1 + nerfstudio/fields/vanilla_nerf_field.py | 2 ++ 5 files changed, 11 insertions(+) diff --git a/nerfstudio/fields/nerfacto_field.py b/nerfstudio/fields/nerfacto_field.py index b70b6b4c3..79b81eb37 100644 --- a/nerfstudio/fields/nerfacto_field.py +++ b/nerfstudio/fields/nerfacto_field.py @@ -312,12 +312,14 @@ class TorchNerfactoField(Field): num_layers=base_mlp_num_layers, layer_width=base_mlp_layer_width, skip_connections=skip_connections, + out_activation=nn.ReLU(), ) self.mlp_head = MLP( in_dim=self.mlp_base.get_out_dim() + self.direction_encoding.get_out_dim() + self.appearance_embedding_dim, num_layers=head_mlp_num_layers, layer_width=head_mlp_layer_width, + out_activation=nn.ReLU(), ) self.field_output_density = DensityFieldHead(in_dim=self.mlp_base.get_out_dim()) diff --git a/nerfstudio/fields/nerfw_field.py b/nerfstudio/fields/nerfw_field.py index fb1a25242..b2916fef4 100644 --- a/nerfstudio/fields/nerfw_field.py +++ b/nerfstudio/fields/nerfw_field.py @@ -83,6 +83,7 @@ class VanillaNerfWField(Field): num_layers=base_mlp_num_layers, layer_width=base_mlp_layer_width, skip_connections=skip_connections, + out_activation=nn.ReLU(), ) self.mlp_transient = MLP( in_dim=self.mlp_base.get_out_dim() + self.embedding_transient.get_out_dim(), @@ -90,6 +91,7 @@ class VanillaNerfWField(Field): num_layers=4, layer_width=base_mlp_layer_width, activation=nn.ReLU(), + out_activation=nn.ReLU(), ) self.mlp_head = MLP( in_dim=self.mlp_base.get_out_dim() @@ -97,6 +99,7 @@ class VanillaNerfWField(Field): + self.embedding_appearance.get_out_dim(), num_layers=head_mlp_num_layers, layer_width=head_mlp_layer_width, + out_activation=nn.ReLU(), ) self.field_head_density = DensityFieldHead(in_dim=self.mlp_base.get_out_dim()) diff --git a/nerfstudio/fields/semantic_nerf_field.py b/nerfstudio/fields/semantic_nerf_field.py index dcf07ae6a..fa53a9313 100644 --- a/nerfstudio/fields/semantic_nerf_field.py +++ b/nerfstudio/fields/semantic_nerf_field.py @@ -67,17 +67,20 @@ class SemanticNerfField(Field): num_layers=base_mlp_num_layers, layer_width=base_mlp_layer_width, skip_connections=skip_connections, + out_activation=nn.ReLU(), ) self.mlp_head = MLP( in_dim=self.mlp_base.get_out_dim() + self.direction_encoding.get_out_dim(), num_layers=head_mlp_num_layers, layer_width=head_mlp_layer_width, + out_activation=nn.ReLU(), ) self.mlp_semantic = MLP( in_dim=self.mlp_head.get_out_dim(), layer_width=self.mlp_head.layer_width // 2, num_layers=1, activation=nn.ReLU(), + out_activation=nn.ReLU(), ) self.field_head_density = DensityFieldHead(in_dim=self.mlp_base.get_out_dim()) self.field_head_rgb = RGBFieldHead(in_dim=self.mlp_head.get_out_dim()) diff --git a/nerfstudio/fields/tensorf_field.py b/nerfstudio/fields/tensorf_field.py index d5cc9ba3b..4972fa1df 100644 --- a/nerfstudio/fields/tensorf_field.py +++ b/nerfstudio/fields/tensorf_field.py @@ -68,6 +68,7 @@ class TensoRFField(Field): num_layers=head_mlp_num_layers, layer_width=head_mlp_layer_width, activation=nn.ReLU(), + out_activation=nn.ReLU(), ) self.use_sh = use_sh diff --git a/nerfstudio/fields/vanilla_nerf_field.py b/nerfstudio/fields/vanilla_nerf_field.py index c7c40b850..a30582d14 100644 --- a/nerfstudio/fields/vanilla_nerf_field.py +++ b/nerfstudio/fields/vanilla_nerf_field.py @@ -73,12 +73,14 @@ class NeRFField(Field): num_layers=base_mlp_num_layers, layer_width=base_mlp_layer_width, skip_connections=skip_connections, + out_activation=nn.ReLU(), ) self.mlp_head = MLP( in_dim=self.mlp_base.get_out_dim() + self.direction_encoding.get_out_dim(), num_layers=head_mlp_num_layers, layer_width=head_mlp_layer_width, + out_activation=nn.ReLU(), ) self.field_output_density = DensityFieldHead(in_dim=self.mlp_base.get_out_dim()) From ad8599aad0238418ed9dabb29f0a5beae6f6bb69 Mon Sep 17 00:00:00 2001 From: Brent Yi Date: Thu, 10 Nov 2022 16:56:13 -0800 Subject: [PATCH 46/68] Add missing __init__.py files (#935) * Add missing __init__.py files * fixing lint Co-authored-by: Ethan Weber --- nerfstudio/data/datamanagers/__init__.py | 13 +++++++++++++ nerfstudio/data/datamanagers/base_datamanager.py | 2 +- .../data/datamanagers/semantic_datamanager.py | 4 ++++ nerfstudio/data/datasets/__init__.py | 13 +++++++++++++ nerfstudio/data/datasets/base_dataset.py | 2 +- nerfstudio/data/datasets/semantic_dataset.py | 4 ++++ 6 files changed, 36 insertions(+), 2 deletions(-) create mode 100644 nerfstudio/data/datamanagers/__init__.py create mode 100644 nerfstudio/data/datasets/__init__.py diff --git a/nerfstudio/data/datamanagers/__init__.py b/nerfstudio/data/datamanagers/__init__.py new file mode 100644 index 000000000..d926cf95c --- /dev/null +++ b/nerfstudio/data/datamanagers/__init__.py @@ -0,0 +1,13 @@ +# Copyright 2022 The Nerfstudio Team. All rights reserved. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. diff --git a/nerfstudio/data/datamanagers/base_datamanager.py b/nerfstudio/data/datamanagers/base_datamanager.py index 82cf4a0d5..1beb29963 100644 --- a/nerfstudio/data/datamanagers/base_datamanager.py +++ b/nerfstudio/data/datamanagers/base_datamanager.py @@ -13,7 +13,7 @@ # limitations under the License. """ -Data loader. +Datamanager. """ from __future__ import annotations diff --git a/nerfstudio/data/datamanagers/semantic_datamanager.py b/nerfstudio/data/datamanagers/semantic_datamanager.py index a66e4f365..011a68ce2 100644 --- a/nerfstudio/data/datamanagers/semantic_datamanager.py +++ b/nerfstudio/data/datamanagers/semantic_datamanager.py @@ -12,6 +12,10 @@ # See the License for the specific language governing permissions and # limitations under the License. +""" +Semantic datamanager. +""" + from dataclasses import dataclass, field from typing import Type diff --git a/nerfstudio/data/datasets/__init__.py b/nerfstudio/data/datasets/__init__.py new file mode 100644 index 000000000..d926cf95c --- /dev/null +++ b/nerfstudio/data/datasets/__init__.py @@ -0,0 +1,13 @@ +# Copyright 2022 The Nerfstudio Team. All rights reserved. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. diff --git a/nerfstudio/data/datasets/base_dataset.py b/nerfstudio/data/datasets/base_dataset.py index 0c6c9fe15..15d4296d0 100644 --- a/nerfstudio/data/datasets/base_dataset.py +++ b/nerfstudio/data/datasets/base_dataset.py @@ -13,7 +13,7 @@ # limitations under the License. """ -Some dataset code. +Dataset. """ from __future__ import annotations diff --git a/nerfstudio/data/datasets/semantic_dataset.py b/nerfstudio/data/datasets/semantic_dataset.py index 2fc551488..f2c2a0910 100644 --- a/nerfstudio/data/datasets/semantic_dataset.py +++ b/nerfstudio/data/datasets/semantic_dataset.py @@ -12,6 +12,10 @@ # See the License for the specific language governing permissions and # limitations under the License. +""" +Semantic dataset. +""" + from typing import Dict import torch From 4cf13857d08f465d08f2412ab126df8fe8993ccf Mon Sep 17 00:00:00 2001 From: Alexander Kristoffersen Date: Thu, 10 Nov 2022 17:32:42 -0800 Subject: [PATCH 47/68] Record3D added to Colab (#926) * record3d added to colab. * Created using Colaboratory * Created using Colaboratory --- colab/demo.ipynb | 52 +++++++++++++++++++++++++++++------------------- 1 file changed, 32 insertions(+), 20 deletions(-) diff --git a/colab/demo.ipynb b/colab/demo.ipynb index 1dceefaa6..6149ba4fe 100644 --- a/colab/demo.ipynb +++ b/colab/demo.ipynb @@ -3,11 +3,11 @@ { "cell_type": "markdown", "metadata": { - "colab_type": "text", - "id": "view-in-github" + "id": "view-in-github", + "colab_type": "text" }, "source": [ - "\"Open" + "\"Open" ] }, { @@ -59,24 +59,24 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 4, "metadata": { "colab": { "base_uri": "https://localhost:8080/" }, "id": "RGr33zHaHak0", - "outputId": "86df0e7f-35fe-4b79-8c0e-83692d42b124" + "outputId": "851bcce2-dce9-4cb4-8429-9ff0e27f73fe" }, "outputs": [ { - "name": "stdout", "output_type": "stream", + "name": "stdout", "text": [ "⏬ Downloading https://github.com/jaimergp/miniforge/releases/latest/download/Mambaforge-colab-Linux-x86_64.sh...\n", "📦 Installing...\n", "📌 Adjusting configuration...\n", "🩹 Patching environment...\n", - "⏲ Done in 0:00:23\n", + "⏲ Done in 0:00:19\n", "🔁 Restarting kernel...\n" ] } @@ -119,26 +119,25 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 20, "metadata": { - "cellView": "form", "colab": { "base_uri": "https://localhost:8080/" }, "id": "msVLprI4gRA4", - "outputId": "c5eb5997-37d9-4c9f-a3d2-7b67f4b6d346" + "outputId": "0be99061-71e1-4e33-98ab-5096db323841" }, "outputs": [ { - "name": "stdout", "output_type": "stream", + "name": "stdout", "text": [ "/content\n", "Downloading...\n", "From: https://drive.google.com/uc?id=1dmjWGXlJnUxwosN6MVooCDQe970PkD-1\n", "To: /content/data/nerfstudio/poster.zip\n", - "100% 750M/750M [00:03<00:00, 218MB/s]\n", - "\u001b[0m" + "100% 750M/750M [00:03<00:00, 199MB/s]\n", + "\u001b[0mData Processing Succeeded!\n" ] } ], @@ -149,12 +148,25 @@ "from google.colab import files\n", "from IPython.core.display import display, HTML\n", "\n", - "scene = '\\uD83D\\uDDBC poster' #@param ['🖼 poster', '🚜 dozer', '🌄 desolation', '📤 upload your images' , '🎥 upload your own video']\n", + "scene = '\\uD83D\\uDDBC poster' #@param ['🖼 poster', '🚜 dozer', '🌄 desolation', '📤 upload your images' , '🎥 upload your own video', '💽 upload your own Record3D data']\n", "scene = ' '.join(scene.split(' ')[1:])\n", "\n", - "if scene not in ['upload your images', 'upload your own video']:\n", + "if scene not in ['upload your images', 'upload your own video', 'upload your own Record3D data']:\n", " %cd /content/\n", " !ns-download-data --dataset=nerfstudio --capture=$scene\n", + "elif scene == 'upload your own Record3D data':\n", + " display(HTML('

Zip your Record3D folder, and upload.

'))\n", + " display(HTML('

More information on Record3D can be found here.

'))\n", + " %cd /content/\n", + " !mkdir -p /content/data/nerfstudio/custom_data\n", + " %cd /content/data/nerfstudio/custom_data/\n", + " uploaded = files.upload()\n", + " dir = os.getcwd()\n", + " preupload_datasets = [os.path.join(dir, f) for f in uploaded.keys()]\n", + " record_3d_zipfile = preupload_datasets[0]\n", + " !unzip $record_3d_zipfile -d /content/data/nerfstudio/custom_data\n", + " custom_data_directory = glob.glob('/content/data/nerfstudio/custom_data/*')[0]\n", + " !ns-process-data record3d --data $custom_data_directory --output-dir /content/data/nerfstudio/custom_data/\n", "else:\n", " display(HTML('

Select your custom data

'))\n", " display(HTML('

You can select multiple images by pressing ctrl, cmd or shift and click.

'))\n", @@ -179,7 +191,8 @@ " video_path = preupload_datasets[0]\n", " !ns-process-data video --data $video_path --output-dir /content/data/nerfstudio/custom_data/\n", "\n", - " scene = \"custom_data\"" + " scene = \"custom_data\"\n", + "print(\"Data Processing Succeeded!\")" ] }, { @@ -283,7 +296,6 @@ "cell_type": "code", "execution_count": null, "metadata": { - "cellView": "form", "id": "m_N8_cLfjoXD" }, "outputs": [], @@ -360,8 +372,8 @@ "accelerator": "GPU", "colab": { "collapsed_sections": [], - "include_colab_link": true, - "provenance": [] + "provenance": [], + "include_colab_link": true }, "gpuClass": "standard", "kernelspec": { @@ -381,4 +393,4 @@ }, "nbformat": 4, "nbformat_minor": 0 -} +} \ No newline at end of file From d4119d40865ea35417d777267b4b8b187d627b4d Mon Sep 17 00:00:00 2001 From: Matthew Tancik Date: Thu, 10 Nov 2022 22:01:21 -0800 Subject: [PATCH 48/68] Add exporting docs (#940) --- docs/reference/cli/index.md | 2 ++ docs/reference/cli/ns_export.md | 9 +++++++++ scripts/exporter.py | 20 ++++++++++++++++---- 3 files changed, 27 insertions(+), 4 deletions(-) create mode 100644 docs/reference/cli/ns_export.md diff --git a/docs/reference/cli/index.md b/docs/reference/cli/index.md index af333742a..797f0d9eb 100644 --- a/docs/reference/cli/index.md +++ b/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 ``` diff --git a/docs/reference/cli/ns_export.md b/docs/reference/cli/ns_export.md new file mode 100644 index 000000000..cdfc54f2f --- /dev/null +++ b/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: +``` diff --git a/scripts/exporter.py b/scripts/exporter.py index b251f50ae..730d604b9 100644 --- a/scripts/exporter.py +++ b/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 From 0a5331fc5cf267255ee4ff838a5c13dad2083360 Mon Sep 17 00:00:00 2001 From: Matthew Tancik Date: Thu, 10 Nov 2022 22:49:32 -0800 Subject: [PATCH 49/68] Add pointcloud export panel to UI (#938) Add export panel to UI --- nerfstudio/viewer/app/package.json | 2 +- nerfstudio/viewer/app/src/index.scss | 24 +++ .../SidePanel/ExportPanel/ExportPanel.jsx | 103 +++++++++++ .../ExportPanel/PointcloudSubPanel.jsx | 163 ++++++++++++++++++ .../modules/SidePanel/ExportPanel/index.jsx | 3 + .../SidePanel/ScenePanel/ScenePanel.jsx | 2 +- .../app/src/modules/SidePanel/SidePanel.jsx | 14 +- nerfstudio/viewer/app/src/reducer.js | 7 +- .../ConfigPanel => themes}/leva_theme.json | 0 9 files changed, 312 insertions(+), 6 deletions(-) create mode 100644 nerfstudio/viewer/app/src/modules/SidePanel/ExportPanel/ExportPanel.jsx create mode 100644 nerfstudio/viewer/app/src/modules/SidePanel/ExportPanel/PointcloudSubPanel.jsx create mode 100644 nerfstudio/viewer/app/src/modules/SidePanel/ExportPanel/index.jsx rename nerfstudio/viewer/app/src/{modules/ConfigPanel => themes}/leva_theme.json (100%) diff --git a/nerfstudio/viewer/app/package.json b/nerfstudio/viewer/app/package.json index b0768523b..6e2f1269f 100644 --- a/nerfstudio/viewer/app/package.json +++ b/nerfstudio/viewer/app/package.json @@ -1,7 +1,7 @@ { "name": "viewer", "homepage": ".", - "version": "22-10-13-0", + "version": "22-11-10-0", "private": true, "dependencies": { "@emotion/react": "^11.10.4", diff --git a/nerfstudio/viewer/app/src/index.scss b/nerfstudio/viewer/app/src/index.scss index 146947df4..194c5ac2e 100644 --- a/nerfstudio/viewer/app/src/index.scss +++ b/nerfstudio/viewer/app/src/index.scss @@ -369,3 +369,27 @@ $viewer_button_size: 50px; .ViewerWindow-iconbutton { margin-top: 5px; } + +// ------------------------------------ +// Export panel styling + +.ExportModal-code { + padding: 10px; + background-color: $base-color3; + overflow-x: scroll; + font-family: monospace; + white-space: pre; + margin-top: 16px; + font-size: 0.9em; +} + +.ExportModal-text { + text-align: left; + margin-top: 20px; + font-size: 0.9em; +} + +.ExportModal-button { + // margin: 15px; + padding: 20px; +} diff --git a/nerfstudio/viewer/app/src/modules/SidePanel/ExportPanel/ExportPanel.jsx b/nerfstudio/viewer/app/src/modules/SidePanel/ExportPanel/ExportPanel.jsx new file mode 100644 index 000000000..9703e2c14 --- /dev/null +++ b/nerfstudio/viewer/app/src/modules/SidePanel/ExportPanel/ExportPanel.jsx @@ -0,0 +1,103 @@ +/* eslint-disable react/jsx-props-no-spreading */ +import * as React from 'react'; + +import { Box, Typography, Tab, Tabs } from '@mui/material'; +import { LevaPanel, LevaStoreProvider, useCreateStore } from 'leva'; +import BlurOnIcon from '@mui/icons-material/BlurOn'; +import CategoryIcon from '@mui/icons-material/Category'; +import PointcloudSubPanel from './PointcloudSubPanel'; +import LevaTheme from '../../../themes/leva_theme.json'; + +interface TabPanelProps { + children: React.ReactNode; + index: number; + value: number; +} + +function TabPanel(props: TabPanelProps) { + const { children, value, index, ...other } = props; + + return ( +

+ ); +} + +function a11yProps(index: number) { + return { + id: `simple-tab-${index}`, + 'aria-controls': `simple-tabpanel-${index}`, + }; +} + +export default function ExportPanel(props) { + // unpack relevant information + const sceneTree = props.sceneTree; + const showExportBox = props.showExportBox; + + const [type_value, setTypeValue] = React.useState(0); + + const handleTypeChange = (event: React.SyntheticEvent, newValue: number) => { + setTypeValue(newValue); + }; + + const pointcloudStore = useCreateStore(); + + return ( +
+ + } + iconPosition="start" + label="Point Cloud" + disableRipple + {...a11yProps(0)} + /> + } + iconPosition="start" + label="Mesh" + disableRipple + {...a11yProps(1)} + /> + + + + + + + + + Coming Soon + +
+ ); +} diff --git a/nerfstudio/viewer/app/src/modules/SidePanel/ExportPanel/PointcloudSubPanel.jsx b/nerfstudio/viewer/app/src/modules/SidePanel/ExportPanel/PointcloudSubPanel.jsx new file mode 100644 index 000000000..8951c8051 --- /dev/null +++ b/nerfstudio/viewer/app/src/modules/SidePanel/ExportPanel/PointcloudSubPanel.jsx @@ -0,0 +1,163 @@ +import * as React from 'react'; +import * as THREE from 'three'; +import { useControls, useStoreContext } from 'leva'; +import { useEffect } from 'react'; +import { useDispatch, useSelector } from 'react-redux'; +import ContentCopyRoundedIcon from '@mui/icons-material/ContentCopyRounded'; + +import { Button } from '@mui/material'; + +const PCD_CLIPPING_BOX_NAME = 'PCD Clipping Box'; + +export default function PointcloudSubPanel(props) { + const sceneTree = props.sceneTree; + const showExportBox = props.showExportBox; + const store = useStoreContext(); + + const dispatch = useDispatch(); + + // redux store state + const config_base_dir = useSelector( + (state) => state.renderingState.config_base_dir, + ); + const clippingEnabled = useSelector( + (state) => state.renderingState.clipping_enabled, + ); + const clippingCenter = useSelector( + (state) => state.renderingState.clipping_center, + ); + const clippingScale = useSelector( + (state) => state.renderingState.clipping_box_scale, + ); + + const config_filename = `${config_base_dir}/config.yml`; + + const geometry = new THREE.BoxGeometry(1, 1, 1); + const material = new THREE.MeshBasicMaterial({ + color: 0xffd369, + transparent: true, + opacity: 0.7, + side: THREE.DoubleSide, + }); + const cube = new THREE.Mesh(geometry, material); + sceneTree.set_object_from_path([PCD_CLIPPING_BOX_NAME], cube); + cube.visible = showExportBox && clippingEnabled; + + const update_box_center = (value) => { + const box = sceneTree.find_object_no_create([PCD_CLIPPING_BOX_NAME]); + box.position.set(value[0], value[1], value[2]); + }; + + const update_box_scale = (value) => { + const box = sceneTree.find_object_no_create([PCD_CLIPPING_BOX_NAME]); + box.scale.set(value[0], value[1], value[2]); + }; + + const controlValues = useControls( + { + numPoints: { label: 'Number of Points', value: 1000000, min: 1 }, + removeOutliers: { label: 'Remove Outliers', value: true }, + estimateNormals: { label: 'Estimate Normals', value: false }, + useBoundingBox: { + label: 'Crop', + value: clippingEnabled, + onChange: (value) => { + const box = sceneTree.find_object_no_create([PCD_CLIPPING_BOX_NAME]); + box.visible = value; + dispatch({ + type: 'write', + path: 'renderingState/clipping_enabled', + data: value, + }); + }, + }, + center: { + label: '| Center', + value: clippingCenter, + render: (get) => get('useBoundingBox'), + onChange: (value) => { + update_box_center(value); + }, + onEditEnd: (value) => { + dispatch({ + type: 'write', + path: 'renderingState/clipping_center', + data: value, + }); + }, + }, + scale: { + label: '| Scale', + value: clippingScale, + min: 0.01, + render: (get) => get('useBoundingBox'), + onChange: (value) => { + update_box_scale(value); + }, + onEditEnd: (value) => { + dispatch({ + type: 'write', + path: 'renderingState/clipping_box_scale', + data: value, + }); + }, + }, + outputDir: { label: 'Output Directory', value: 'pcd/' }, + }, + { store }, + ); + + const getPythonBool = (boolean) => { + return boolean ? 'True' : 'False'; + }; + + const bbox_min = [ + clippingCenter[0] - clippingScale[0] / 2, + clippingCenter[1] - clippingScale[1] / 2, + clippingCenter[2] - clippingScale[2] / 2, + ]; + const bbox_max = [ + clippingCenter[0] + clippingScale[0] / 2, + clippingCenter[1] + clippingScale[1] / 2, + clippingCenter[2] + clippingScale[2] / 2, + ]; + + const cmd = + `ns-export pointcloud` + + ` --load-config ${config_filename}` + + ` --output-dir ${controlValues.outputDir}` + + ` --num-points ${controlValues.numPoints}` + + ` --remove-outliers ${getPythonBool(controlValues.removeOutliers)}` + + ` --estimate-normals ${getPythonBool(controlValues.estimateNormals)}` + + ` --use-bounding-box ${getPythonBool(clippingEnabled)}` + + ` --bounding-box-min ${bbox_min[0]} ${bbox_min[1]} ${bbox_min[2]}` + + ` --bounding-box-max ${bbox_max[0]} ${bbox_max[1]} ${bbox_max[2]}`; + + const handleCopy = () => { + navigator.clipboard.writeText(cmd); + }; + + useEffect(() => { + update_box_center(clippingCenter); + update_box_scale(clippingScale); + }); + + return ( +
+
+ Run the following command in a terminal to export the pointcloud: +
+
{cmd}
+
+ +
+
+ ); +} diff --git a/nerfstudio/viewer/app/src/modules/SidePanel/ExportPanel/index.jsx b/nerfstudio/viewer/app/src/modules/SidePanel/ExportPanel/index.jsx new file mode 100644 index 000000000..41d179916 --- /dev/null +++ b/nerfstudio/viewer/app/src/modules/SidePanel/ExportPanel/index.jsx @@ -0,0 +1,3 @@ +import ExportPanel from './ExportPanel'; + +export default ExportPanel; diff --git a/nerfstudio/viewer/app/src/modules/SidePanel/ScenePanel/ScenePanel.jsx b/nerfstudio/viewer/app/src/modules/SidePanel/ScenePanel/ScenePanel.jsx index 69dc99416..b65d4d420 100644 --- a/nerfstudio/viewer/app/src/modules/SidePanel/ScenePanel/ScenePanel.jsx +++ b/nerfstudio/viewer/app/src/modules/SidePanel/ScenePanel/ScenePanel.jsx @@ -17,7 +17,7 @@ import { VisibilityOff, } from '@mui/icons-material/'; import SceneNode from '../../../SceneNode'; -import LevaTheme from '../../ConfigPanel/leva_theme.json'; +import LevaTheme from '../../../themes/leva_theme.json'; export const snap_to_camera = (sceneTree, camera, matrix) => { const mat = new THREE.Matrix4(); diff --git a/nerfstudio/viewer/app/src/modules/SidePanel/SidePanel.jsx b/nerfstudio/viewer/app/src/modules/SidePanel/SidePanel.jsx index 5f1da13cc..dff6e70b9 100644 --- a/nerfstudio/viewer/app/src/modules/SidePanel/SidePanel.jsx +++ b/nerfstudio/viewer/app/src/modules/SidePanel/SidePanel.jsx @@ -13,13 +13,14 @@ import { CameraAltRounded, TuneRounded, WidgetsRounded, + ImportExportRounded, } from '@mui/icons-material/'; import StatusPanel from './StatusPanel'; -import LevaTheme from '../ConfigPanel/leva_theme.json'; +import LevaTheme from '../../themes/leva_theme.json'; import CameraPanel from './CameraPanel'; import ScenePanel from './ScenePanel'; import { RenderControls } from '../ConfigPanel/ConfigPanel'; -import { LogPanel } from '../LogPanel/LogPanel'; +import ExportPanel from './ExportPanel'; export const snap_to_camera = (sceneTree, camera, matrix) => { const mat = new THREE.Matrix4(); @@ -77,9 +78,11 @@ export function BasicTabs(props: BasicTabsProps) { const sceneTree = props.sceneTree; const [value, setValue] = React.useState(0); + const [showExportBox, setShowExportBox] = React.useState(false); const handleChange = (event: React.SyntheticEvent, newValue: number) => { setValue(newValue); + setShowExportBox(newValue === 3); }; return ( @@ -97,6 +100,11 @@ export function BasicTabs(props: BasicTabsProps) { } label="Controls" {...a11yProps(0)} /> } label="Render" {...a11yProps(1)} /> } label="Scene" {...a11yProps(2)} /> + } + label="Export" + {...a11yProps(3)} + /> @@ -124,7 +132,7 @@ export function BasicTabs(props: BasicTabsProps) { - TODO: Something maybe? + diff --git a/nerfstudio/viewer/app/src/reducer.js b/nerfstudio/viewer/app/src/reducer.js index ba1d8262b..401804bba 100644 --- a/nerfstudio/viewer/app/src/reducer.js +++ b/nerfstudio/viewer/app/src/reducer.js @@ -4,7 +4,7 @@ const initialState = { // the websocket connection state websocketState: { isConnected: false, - websocket_url: "ws://localhost:7007", + websocket_url: 'ws://localhost:7007', }, // the webrtc connection state webrtcState: { @@ -34,6 +34,11 @@ const initialState = { train_eta: 'Paused', vis_train_ratio: 'Paused', log_errors: '', + + // export options + clipping_enabled: true, + clipping_center: [0.0, 0.0, 0.0], + clipping_box_scale: [2.0, 2.0, 2.0], }, // the scene state sceneState: { diff --git a/nerfstudio/viewer/app/src/modules/ConfigPanel/leva_theme.json b/nerfstudio/viewer/app/src/themes/leva_theme.json similarity index 100% rename from nerfstudio/viewer/app/src/modules/ConfigPanel/leva_theme.json rename to nerfstudio/viewer/app/src/themes/leva_theme.json From f964e0dfe4c9e3ecff443cd399024961668ccb6f Mon Sep 17 00:00:00 2001 From: Matthew Tancik Date: Thu, 10 Nov 2022 22:50:44 -0800 Subject: [PATCH 50/68] v0.1.9 (#941) --- pyproject.toml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pyproject.toml b/pyproject.toml index a7f601453..146897261 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta" [project] name = "nerfstudio" -version = "0.1.8" +version = "0.1.9" description = "All-in-one repository for state-of-the-art NeRFs" readme = "README.md" license = { text="Apache 2.0"} From 0271c7ded8ac9c18d4629bbf4c5cc1b7f54e864a Mon Sep 17 00:00:00 2001 From: Matthew Tancik Date: Fri, 11 Nov 2022 08:58:53 -0800 Subject: [PATCH 51/68] Update docs (#944) --- docs/developer_guides/viewer/viewer_overview.md | 16 ++++++++-------- docs/index.md | 2 +- 2 files changed, 9 insertions(+), 9 deletions(-) diff --git a/docs/developer_guides/viewer/viewer_overview.md b/docs/developer_guides/viewer/viewer_overview.md index bd2d33e4d..2e47a67e2 100644 --- a/docs/developer_guides/viewer/viewer_overview.md +++ b/docs/developer_guides/viewer/viewer_overview.md @@ -22,14 +22,6 @@ The connection between the Bridge Server and the Client App works with WebSocket ## Installing and running locally -#### Running the Bridge Server - -The viewer bridge server runs on the same machine that you use for training. The training code will connect to this server with a lightweight TCP connection using ZMQ. The training job will launch the viewer bridge server is you specify `--viewer.launch-bridge-server` in the terminal. Otherwise, you can launch the bridge server manually with the following script. - -```python -python scripts/viewer/run_bridge_server.py --help -``` - #### Running the Client App ```shell @@ -58,6 +50,14 @@ yarn install yarn start ``` +#### Running the Bridge Server Manually + +The viewer bridge server runs on the same machine that you use for training. The training code will connect to this server with a lightweight TCP connection using ZMQ. The training job will launch the viewer bridge server is you specify `--viewer.launch-bridge-server` in the terminal. Otherwise, you can launch the bridge server manually with the following script. + +```python +python scripts/viewer/run_bridge_server.py --help +``` + ## Acknowledgements and references We thank the authors and contributors to the following repos, which we've started, used, and modified for our use-cases. diff --git a/docs/index.md b/docs/index.md index db68182d2..69b149711 100644 --- a/docs/index.md +++ b/docs/index.md @@ -105,7 +105,7 @@ We'll be constantly growing this list! So make sure to check back in to see our | | | | ---------------------------------------------------------- | ---------------------- | | [Github](https://github.com/nerfstudio-project/nerfstudio) | Official Github Repo | -| [Discord](https://discord.com/invite/NHGtYRAW) | Join Discord Community | +| [Discord](https://discord.gg/RyVk6w5WWP) | Join Discord Community | | [Viewer](https://viewer.nerf.studio/) | Web-based Nerf Viewer | ### How-to Videos From 36b514fc2074badc1af74fa5fc86a45c78492c6b Mon Sep 17 00:00:00 2001 From: Matthew Tancik Date: Fri, 11 Nov 2022 10:54:55 -0800 Subject: [PATCH 52/68] Update viewer zoom sensitivity (#945) --- .../viewer/app/src/modules/Scene/Scene.jsx | 80 +++++++++++++------ 1 file changed, 56 insertions(+), 24 deletions(-) diff --git a/nerfstudio/viewer/app/src/modules/Scene/Scene.jsx b/nerfstudio/viewer/app/src/modules/Scene/Scene.jsx index 8c6e93e29..f0d0c2523 100644 --- a/nerfstudio/viewer/app/src/modules/Scene/Scene.jsx +++ b/nerfstudio/viewer/app/src/modules/Scene/Scene.jsx @@ -26,17 +26,17 @@ export function get_scene_tree() { const scene_state = { value: new Map(), callbacks: [], - addCallback (callback, key) { this.callbacks.push([callback, key]); }, - setValue (key, value) { + addCallback(callback, key) { + this.callbacks.push([callback, key]); + }, + setValue(key, value) { this.value.set(key, value); - this.callbacks.forEach( - (cbk) => { - const i = cbk[1]; - const callback = cbk[0]; - return callback(this.value.get(i)) - } - ); - } + this.callbacks.forEach((cbk) => { + const i = cbk[1]; + const callback = cbk[0]; + return callback(this.value.get(i)); + }); + }, }; const sceneTree = new SceneNode(scene, scene_state); @@ -47,7 +47,11 @@ export function get_scene_tree() { // Main camera const main_camera = new THREE.PerspectiveCamera(75, 1, 0.1, 1000); const start_position = new THREE.Vector3(0.7, -0.7, 0.3); - main_camera.position.set(start_position.x, start_position.y, start_position.z); + main_camera.position.set( + start_position.x, + start_position.y, + start_position.z, + ); main_camera.up = new THREE.Vector3(0, 0, 1); sceneTree.set_object_from_path(['Cameras', 'Main Camera'], main_camera); @@ -84,22 +88,31 @@ export function get_scene_tree() { const camera_controls = new CameraControls(main_camera, renderer.domElement); camera_controls.azimuthRotateSpeed = 0.3; camera_controls.polarRotateSpeed = 0.3; - camera_controls.dollySpeed = 1.8; + camera_controls.dollySpeed = 0.1; camera_controls.infinityDolly = true; camera_controls.saveState(); const keyMap = []; const moveSpeed = 0.02; - const rotSpeed = .015; - const EPS = .01; + const rotSpeed = 0.015; + const EPS = 0.01; function rotate() { - if (keyMap.ArrowLeft || keyMap.ArrowRight || keyMap.ArrowUp || keyMap.ArrowDown){ + if ( + keyMap.ArrowLeft || + keyMap.ArrowRight || + keyMap.ArrowUp || + keyMap.ArrowDown + ) { const curTar = camera_controls.getTarget(); const curPos = camera_controls.getPosition(); const diff = curTar.sub(curPos).clampLength(0, EPS); - camera_controls.setTarget(curPos.x + diff.x, curPos.y + diff.y, curPos.z + diff.z); - + camera_controls.setTarget( + curPos.x + diff.x, + curPos.y + diff.y, + curPos.z + diff.z, + ); + if (keyMap.ArrowLeft === true) { camera_controls.rotate(rotSpeed, 0, true); } @@ -125,8 +138,15 @@ export function get_scene_tree() { if (keyMap.KeyW === true) { const curPos = camera_controls.getPosition(); const newTar = camera_controls.getTarget(); - const newDiff = newTar.sub(curPos).normalize().multiplyScalar(curPos.length()); - camera_controls.setTarget(curPos.x + newDiff.x, curPos.y + newDiff.y, curPos.z + newDiff.z); + const newDiff = newTar + .sub(curPos) + .normalize() + .multiplyScalar(curPos.length()); + camera_controls.setTarget( + curPos.x + newDiff.x, + curPos.y + newDiff.y, + curPos.z + newDiff.z, + ); camera_controls.dolly(moveSpeed, true); } if (keyMap.KeyS === true) { @@ -144,8 +164,8 @@ export function get_scene_tree() { if (!scene_state.value.get('mouse_in_scene')) { return; } - translate() - rotate() + translate(); + rotate(); } function onKeyUp(event) { @@ -280,8 +300,15 @@ export function get_scene_tree() { drag = false; const curPos = camera_controls.getPosition(); const newTar = camera_controls.getTarget(); - const newDiff = newTar.sub(curPos).normalize().multiplyScalar(curPos.length()); - camera_controls.setTarget(curPos.x + newDiff.x, curPos.y + newDiff.y, curPos.z + newDiff.z); + const newDiff = newTar + .sub(curPos) + .normalize() + .multiplyScalar(curPos.length()); + camera_controls.setTarget( + curPos.x + newDiff.x, + curPos.y + newDiff.y, + curPos.z + newDiff.z, + ); }; const onMouseMove = (e) => { @@ -291,7 +318,12 @@ export function get_scene_tree() { mouseVector.x = 2 * (e.clientX / size.x) - 1; mouseVector.y = 1 - 2 * ((e.clientY - BANNER_HEIGHT) / size.y); - const mouse_in_scene = !(mouseVector.x > 1 || mouseVector.x < -1 || mouseVector.y > 1 || mouseVector.y < -1) + const mouse_in_scene = !( + mouseVector.x > 1 || + mouseVector.x < -1 || + mouseVector.y > 1 || + mouseVector.y < -1 + ); scene_state.setValue('mouse_x', mouseVector.x); scene_state.setValue('mouse_y', mouseVector.y); From 50f9895f1af7ef662826dee521b55d3668d0349d Mon Sep 17 00:00:00 2001 From: Matthew Tancik Date: Fri, 11 Nov 2022 11:38:36 -0800 Subject: [PATCH 53/68] Add flag to kill training when complete (#948) --- nerfstudio/configs/base_config.py | 2 ++ nerfstudio/engine/trainer.py | 7 +++++-- 2 files changed, 7 insertions(+), 2 deletions(-) diff --git a/nerfstudio/configs/base_config.py b/nerfstudio/configs/base_config.py index 7b02e1a24..f5d2a31cf 100644 --- a/nerfstudio/configs/base_config.py +++ b/nerfstudio/configs/base_config.py @@ -178,6 +178,8 @@ class ViewerConfig(PrintableConfig): max_num_display_images: int = 512 """Maximum number of training images to display in the viewer, to avoid lag. This does not change which images are actually used in training/evaluation. If -1, display all.""" + quit_on_train_completion: bool = False + """Whether to kill the training job when it has completed. Note this will stop rendering in the viewer.""" from nerfstudio.engine.optimizers import OptimizerConfig diff --git a/nerfstudio/engine/trainer.py b/nerfstudio/engine/trainer.py index 5b5bca84c..90e93a7e0 100644 --- a/nerfstudio/engine/trainer.py +++ b/nerfstudio/engine/trainer.py @@ -131,6 +131,7 @@ class Trainer: self._init_viewer_state() with TimeWriter(writer, EventName.TOTAL_TRAIN_TIME): num_iterations = self.config.trainer.max_num_iterations + step = 0 for step in range(self._start_step, self._start_step + num_iterations): with TimeWriter(writer, EventName.ITER_TRAIN_TIME, step=step) as train_t: @@ -174,10 +175,12 @@ class Trainer: writer.write_out_storage() # save checkpoint at the end of training self.save_checkpoint(step) + CONSOLE.rule() CONSOLE.print("[bold green]:tada: :tada: :tada: Training Finished :tada: :tada: :tada:", justify="center") - CONSOLE.print("Use ctrl+c to quit", justify="center") - self._always_render(step) + if not self.config.viewer.quit_on_train_completion: + CONSOLE.print("Use ctrl+c to quit", justify="center") + self._always_render(step) @check_main_thread def _always_render(self, step): From 714d6c96b4484a362c25482873f8006b32858525 Mon Sep 17 00:00:00 2001 From: Matthew Tancik Date: Fri, 11 Nov 2022 15:11:36 -0800 Subject: [PATCH 54/68] Dont crash on invalid websocket (#949) --- .../viewer/app/src/modules/WebSocket/WebSocket.jsx | 10 ++++++++-- .../viewer/app/src/modules/WebSocketUrlField.jsx | 12 ++++++++++++ 2 files changed, 20 insertions(+), 2 deletions(-) diff --git a/nerfstudio/viewer/app/src/modules/WebSocket/WebSocket.jsx b/nerfstudio/viewer/app/src/modules/WebSocket/WebSocket.jsx index 0ac088ea9..0e265ef60 100644 --- a/nerfstudio/viewer/app/src/modules/WebSocket/WebSocket.jsx +++ b/nerfstudio/viewer/app/src/modules/WebSocket/WebSocket.jsx @@ -23,7 +23,11 @@ export default function WebSocketContextFunction({ children }) { const connect = () => { // of the form wss://ip_address:port console.log(websocket_url); - socket = new WebSocket(websocket_url); + try { + socket = new WebSocket(websocket_url); + } catch (error) { + socket = new WebSocket('ws://localhost:7007'); + } socket.binaryType = 'arraybuffer'; socket.onopen = () => { dispatch({ @@ -56,7 +60,9 @@ export default function WebSocketContextFunction({ children }) { useEffect(() => { // cleanup function to close the websocket on rerender return () => { - socket.close(); + if (socket !== null) { + socket.close(); + } }; }, [websocket_url]); diff --git a/nerfstudio/viewer/app/src/modules/WebSocketUrlField.jsx b/nerfstudio/viewer/app/src/modules/WebSocketUrlField.jsx index 4dcec3376..f93b528fc 100644 --- a/nerfstudio/viewer/app/src/modules/WebSocketUrlField.jsx +++ b/nerfstudio/viewer/app/src/modules/WebSocketUrlField.jsx @@ -19,6 +19,16 @@ export default function WebSocketUrlField() { }); }; + const testWebSocket = (url) => { + try { + // eslint-disable-next-line no-new + new WebSocket(url); + return false; + } catch (error) { + return true; + } + }; + return (
viewer.nerf.studio?websocket_url={websocket_url} From 2656e5653eac317fdf1a4dbf848ba9f04036a1b2 Mon Sep 17 00:00:00 2001 From: Matthew Tancik Date: Fri, 11 Nov 2022 15:17:52 -0800 Subject: [PATCH 55/68] Update viewer docs (#950) --- docs/developer_guides/viewer/viewer_overview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/developer_guides/viewer/viewer_overview.md b/docs/developer_guides/viewer/viewer_overview.md index 2e47a67e2..b80463e75 100644 --- a/docs/developer_guides/viewer/viewer_overview.md +++ b/docs/developer_guides/viewer/viewer_overview.md @@ -55,7 +55,7 @@ yarn start The viewer bridge server runs on the same machine that you use for training. The training code will connect to this server with a lightweight TCP connection using ZMQ. The training job will launch the viewer bridge server is you specify `--viewer.launch-bridge-server` in the terminal. Otherwise, you can launch the bridge server manually with the following script. ```python -python scripts/viewer/run_bridge_server.py --help +ns-bridge-server --help ``` ## Acknowledgements and references From fdbeb2ae3197c465860a8ff8638b9cf0facb4ef0 Mon Sep 17 00:00:00 2001 From: Alexander Kristoffersen Date: Fri, 11 Nov 2022 15:27:57 -0800 Subject: [PATCH 56/68] Streamline Viewer in Colab, added more checks before training (#947) Created using Colaboratory --- colab/demo.ipynb | 130 ++++++++++++++++++++++------------------------- 1 file changed, 61 insertions(+), 69 deletions(-) diff --git a/colab/demo.ipynb b/colab/demo.ipynb index 6149ba4fe..cd001aa85 100644 --- a/colab/demo.ipynb +++ b/colab/demo.ipynb @@ -7,7 +7,7 @@ "colab_type": "text" }, "source": [ - "\"Open" + "\"Open" ] }, { @@ -46,37 +46,42 @@ "## Frequently Asked Questions\n", "\n", "* **Downloading custom data is stalling (no output):**\n", - " * This is a bug in Colab. The data is processing, but may take a while to complete. You will know processing completed if `data/nerfstudio/custom_data/transforms.json` exists.\n", + " * This is a bug in Colab. The data is processing, but may take a while to complete. You will know processing completed if `data/nerfstudio/custom_data/transforms.json` exists. Terminating the cell early will result in not being able to train.\n", + "* **Processing custom data is taking a long time:**\n", + " * The time it takes to process data depends on the number of images and its resolution. If processing is taking too long, try lowering the resolution of your custom data.\n", + "* **Error: Data processing did not complete:**\n", + " * This means that the data processing script did not fully complete. This could be because there were not enough images, or that the images were of low quality. We recommend images with little to no motion blur and lots of visual overlap of the scene to increase the chances of successful processing.\n", "* **Training is not showing progress**:\n", " * The lack of output is a bug in Colab. You can see the training progress from the viewer.\n", - "\n", "* **Viewer Quality is bad / Low resolution**:\n", " * This may be because more GPU is being used on training that rendering the viewer. Try pausing training or decreasing training utilization.\n", - "\n", + "* **WARNING: Running pip as the 'root' user...:**:\n", + " * This and other pip warnings or errors can be safely ignored.\n", "* **Other problems?**\n", " * Feel free to create an issue on our [GitHub repo](https://github.com/nerfstudio-project/nerfstudio).\n" ] }, { "cell_type": "code", - "execution_count": 4, + "execution_count": 2, "metadata": { "colab": { "base_uri": "https://localhost:8080/" }, "id": "RGr33zHaHak0", - "outputId": "851bcce2-dce9-4cb4-8429-9ff0e27f73fe" + "outputId": "14f33da4-1e52-4784-e4e5-79e5d884fb8f" }, "outputs": [ { "output_type": "stream", "name": "stdout", "text": [ - "⏬ Downloading https://github.com/jaimergp/miniforge/releases/latest/download/Mambaforge-colab-Linux-x86_64.sh...\n", + "\u001b[33mWARNING: Running pip as the 'root' user can result in broken permissions and conflicting behaviour with the system package manager. It is recommended to use a virtual environment instead: https://pip.pypa.io/warnings/venv\u001b[0m\u001b[33m\n", + "\u001b[0m⏬ Downloading https://github.com/jaimergp/miniforge/releases/latest/download/Mambaforge-colab-Linux-x86_64.sh...\n", "📦 Installing...\n", "📌 Adjusting configuration...\n", "🩹 Patching environment...\n", - "⏲ Done in 0:00:19\n", + "⏲ Done in 0:00:18\n", "🔁 Restarting kernel...\n" ] } @@ -119,13 +124,14 @@ }, { "cell_type": "code", - "execution_count": 20, + "execution_count": null, "metadata": { "colab": { "base_uri": "https://localhost:8080/" }, "id": "msVLprI4gRA4", - "outputId": "0be99061-71e1-4e33-98ab-5096db323841" + "outputId": "e8074daa-afd5-4021-ae41-27ce0e2bf0d8", + "cellView": "form" }, "outputs": [ { @@ -136,13 +142,13 @@ "Downloading...\n", "From: https://drive.google.com/uc?id=1dmjWGXlJnUxwosN6MVooCDQe970PkD-1\n", "To: /content/data/nerfstudio/poster.zip\n", - "100% 750M/750M [00:03<00:00, 199MB/s]\n", + "100% 750M/750M [00:02<00:00, 295MB/s]\n", "\u001b[0mData Processing Succeeded!\n" ] } ], "source": [ - "#@markdown

Downloading Data

\n", + "#@markdown

Downloading and Processing Data

\n", "#@markdown

Pick the preset scene or upload your own images/video

\n", "import os\n", "from google.colab import files\n", @@ -199,27 +205,51 @@ "cell_type": "code", "execution_count": null, "metadata": { - "cellView": "form", "colab": { - "base_uri": "https://localhost:8080/" + "base_uri": "https://localhost:8080/", + "height": 928 }, - "id": "Eju-3p2hjcB2", - "outputId": "c9ff081c-2436-44c6-d292-f22dc3ef78b5" + "id": "VoKDxqEcjmfC", + "outputId": "d6c97ce9-f77a-4026-d6f3-328918435bb0", + "cellView": "form" }, "outputs": [ { - "name": "stdout", "output_type": "stream", + "name": "stdout", "text": [ "/content\n", "\u001b[K\u001b[?25h/tools/node/bin/lt -> /tools/node/lib/node_modules/localtunnel/bin/lt.js\n", "+ localtunnel@2.0.2\n", - "added 22 packages from 22 contributors in 1.536s\n" + "updated 1 package in 1.523s\n", + "https://viewer.nerf.studio/?websocket_url=wss://fifty-jars-return-34-124-199-158.loca.lt\n", + "You may need to click Refresh Page after you start training!\n" ] + }, + { + "output_type": "execute_result", + "data": { + "text/plain": [ + "" + ], + "text/html": [ + "\n", + " \n", + " " + ] + }, + "metadata": {}, + "execution_count": 1 } ], "source": [ - "#@title # Set Up Viewer\n", + "#@title # Set up and Start Viewer\n", "\n", "%cd /content\n", "\n", @@ -229,54 +259,11 @@ "\n", "# Tunnel port 7007, the default for\n", "!rm url.txt 2> /dev/null\n", - "get_ipython().system_raw('lt --port 7007 >> url.txt 2>&1 &')" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "cellView": "form", - "colab": { - "base_uri": "https://localhost:8080/", - "height": 857 - }, - "id": "VoKDxqEcjmfC", - "outputId": "b966821b-7d18-43ee-ceb3-724ac2d0c022" - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "https://viewer.nerf.studio/?websocket_url=wss://good-ways-ask-34-83-255-230.loca.lt\n", - "You may need to click Refresh Page after you start training!\n" - ] - }, - { - "data": { - "text/html": [ - "\n", - " \n", - " " - ], - "text/plain": [ - "" - ] - }, - "execution_count": 4, - "metadata": {}, - "output_type": "execute_result" - } - ], - "source": [ - "#@title # Start Viewer\n", + "get_ipython().system_raw('lt --port 7007 >> url.txt 2>&1 &')\n", + "\n", + "import time\n", + "time.sleep(3) # the previous command needs time to write to url.txt\n", + "\n", "\n", "with open('url.txt') as f:\n", " lines = f.readlines()\n", @@ -296,14 +283,19 @@ "cell_type": "code", "execution_count": null, "metadata": { - "id": "m_N8_cLfjoXD" + "id": "m_N8_cLfjoXD", + "cellView": "form" }, "outputs": [], "source": [ "#@title # Start Training { vertical-output: true }\n", "\n", "%cd /content\n", - "!ns-train nerfacto --viewer.websocket-port 7007 nerfstudio-data --data data/nerfstudio/$scene --downscale-factor 4" + "if os.path.exists(f\"data/nerfstudio/{scene}/transforms.json\"):\n", + " !ns-train nerfacto --viewer.websocket-port 7007 nerfstudio-data --data data/nerfstudio/$scene --downscale-factor 4\n", + "else:\n", + " display(HTML('

Error: Data processing did not complete

'))\n", + " display(HTML('

Please re-run `Downloading and Processing Data`, or view the FAQ for more info.

'))" ] }, { From 6ea7dbf934dd53f8403ceca4d0c5e2929550cdf5 Mon Sep 17 00:00:00 2001 From: Zak Murez <33580232+zmurez@users.noreply.github.com> Date: Fri, 11 Nov 2022 18:40:36 -0800 Subject: [PATCH 57/68] NuScenes dataparser (#939) * nuscenes dataparser * cleanup * style * cleanup * cleanup * cleanup Co-authored-by: zmurez --- .../data/datamanagers/base_datamanager.py | 2 + .../data/dataparsers/nuscenes_dataparser.py | 212 ++++++++++++++++++ pyproject.toml | 1 + scripts/datasets/process_nuscenes_masks.py | 131 +++++++++++ 4 files changed, 346 insertions(+) create mode 100644 nerfstudio/data/dataparsers/nuscenes_dataparser.py create mode 100644 scripts/datasets/process_nuscenes_masks.py diff --git a/nerfstudio/data/datamanagers/base_datamanager.py b/nerfstudio/data/datamanagers/base_datamanager.py index 1beb29963..5ea8c8329 100644 --- a/nerfstudio/data/datamanagers/base_datamanager.py +++ b/nerfstudio/data/datamanagers/base_datamanager.py @@ -40,6 +40,7 @@ from nerfstudio.data.dataparsers.instant_ngp_dataparser import ( InstantNGPDataParserConfig, ) from nerfstudio.data.dataparsers.nerfstudio_dataparser import NerfstudioDataParserConfig +from nerfstudio.data.dataparsers.nuscenes_dataparser import NuScenesDataParserConfig from nerfstudio.data.dataparsers.record3d_dataparser import Record3DDataParserConfig from nerfstudio.data.datasets.base_dataset import InputDataset from nerfstudio.data.pixel_samplers import PixelSampler @@ -61,6 +62,7 @@ AnnotatedDataParserUnion = tyro.conf.OmitSubcommandPrefixes[ # Omit prefixes of "blender-data": BlenderDataParserConfig(), "friends-data": FriendsDataParserConfig(), "instant-ngp-data": InstantNGPDataParserConfig(), + "nuscenes-data": NuScenesDataParserConfig(), "record3d-data": Record3DDataParserConfig(), "dnerf-data": DNeRFDataParserConfig(), }, diff --git a/nerfstudio/data/dataparsers/nuscenes_dataparser.py b/nerfstudio/data/dataparsers/nuscenes_dataparser.py new file mode 100644 index 000000000..88e215611 --- /dev/null +++ b/nerfstudio/data/dataparsers/nuscenes_dataparser.py @@ -0,0 +1,212 @@ +# Copyright 2022 The Nerfstudio Team. All rights reserved. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +"""Data parser for NuScenes dataset""" +import math +import os +from dataclasses import dataclass, field +from pathlib import Path +from typing import Optional, Tuple, Type + +import numpy as np +import torch +from nuscenes.nuscenes import NuScenes as NuScenesDatabase +from typing_extensions import Literal + +from nerfstudio.cameras.cameras import Cameras, CameraType +from nerfstudio.data.dataparsers.base_dataparser import ( + DataParser, + DataParserConfig, + DataparserOutputs, +) +from nerfstudio.data.scene_box import SceneBox +from nerfstudio.utils.colmap_utils import qvec2rotmat + + +def rotation_translation_to_pose(r_vec, t_vec): + """Convert quaternion rotation and translation vectors to 4x4 matrix""" + + pose = np.eye(4) + pose[:3, :3] = qvec2rotmat(r_vec) + pose[:3, 3] = t_vec + return pose + + +@dataclass +class NuScenesDataParserConfig(DataParserConfig): + """NuScenes dataset config. + NuScenes (https://www.nuscenes.org/nuscenes) is an autonomous driving dataset containing 1000 20s clips. + Each clip was recorded with a suite of sensors including 6 souround cameras. + It also includes 3D cuboid annotations around obects. + We optionally use these cuboids to mask dynamic objects by specifying the mask_dir flag. + To create these masks use scripts/datasets/process_nuscenes_masks.py. + """ + + _target: Type = field(default_factory=lambda: NuScenes) + """target class to instantiate""" + data: Path = Path("scene-0103") # TODO: rename to scene but keep checkpoint saving name? + """Name of the scene.""" + data_dir: Path = Path("/mnt/local/NuScenes") + """Path to NuScenes dataset.""" + version: Literal["v1.0-mini", "v1.0-trainval"] = "v1.0-mini" + """Dataset version.""" + cameras: Tuple[Literal["FRONT", "FRONT_LEFT", "FRONT_RIGHT", "BACK", "BACK_LEFT", "BACK_RIGHT"], ...] = ("FRONT",) + """Which cameras to use.""" + mask_dir: Optional[Path] = None + """Path to masks of dynamic objects.""" + + train_split_percentage: float = 0.9 + """The percent of images to use for training. The remaining images are for eval.""" + + verbose: bool = False + """Load dataset with verbose messaging""" + + +@dataclass +class NuScenes(DataParser): + """NuScenes DatasetParser""" + + config: NuScenesDataParserConfig + + def _generate_dataparser_outputs(self, split="train"): + # pylint: disable=too-many-statements + + nusc = NuScenesDatabase(version=self.config.version, dataroot=self.config.data_dir, verbose=self.config.verbose) + cameras = ["CAM_" + camera for camera in self.config.cameras] + + assert ( + len(cameras) == 1 + ), "waiting on multiple camera support" # TODO: remove once multiple cameras are supported + + # get samples for scene + samples = [ + samp for samp in nusc.sample if nusc.get("scene", samp["scene_token"])["name"] == str(self.config.data) + ] + + # sort by timestamp (only to make chronological viz easier) + samples.sort(key=lambda x: (x["scene_token"], x["timestamp"])) + + transform1 = np.array( + [ + [0, -1, 0, 0], + [0, 0, -1, 0], + [1, 0, 0, 0], + [0, 0, 0, 1], + ] + ) + transform2 = np.array( + [ + [0, 0, 1, 0], + [0, 1, 0, 0], + [-1, 0, 0, 0], + [0, 0, 0, 1], + ] + ) + + # get image filenames and camera data + image_filenames = [] + mask_filenames = [] + mask_dir = self.config.mask_dir if self.config.mask_dir is not None else Path("") + intrinsics = [] + poses = [] + for sample in samples: + for camera in cameras: + camera_data = nusc.get("sample_data", sample["data"][camera]) + calibrated_sensor_data = nusc.get("calibrated_sensor", camera_data["calibrated_sensor_token"]) + ego_pose_data = nusc.get("ego_pose", camera_data["ego_pose_token"]) + + ego_pose = rotation_translation_to_pose(ego_pose_data["rotation"], ego_pose_data["translation"]) + cam_pose = rotation_translation_to_pose( + calibrated_sensor_data["rotation"], calibrated_sensor_data["translation"] + ) + pose = ego_pose @ cam_pose + + # rotate to opencv frame + pose = transform1 @ pose + + # convert from opencv camera to nerfstudio camera + pose[0:3, 1:3] *= -1 + pose = pose[np.array([1, 0, 2, 3]), :] + pose[2, :] *= -1 + + # rotate to z-up in viewer + pose = transform2 @ pose + + image_filenames.append(self.config.data_dir / camera_data["filename"]) + mask_filenames.append( + mask_dir / "masks" / camera / os.path.split(camera_data["filename"])[1].replace("jpg", "png") + ) + intrinsics.append(calibrated_sensor_data["camera_intrinsic"]) + poses.append(pose) + poses = torch.from_numpy(np.stack(poses).astype(np.float32)) + intrinsics = torch.from_numpy(np.array(intrinsics).astype(np.float32)) + + # center poses + poses[:, :3, 3] -= poses[:, :3, 3].mean(dim=0) + + # scale poses + poses[:, :3, 3] /= poses[:, :3, 3].abs().max() + + # filter image_filenames and poses based on train/eval split percentage + num_snapshots = len(samples) + num_train_snapshots = math.ceil(num_snapshots * self.config.train_split_percentage) + num_eval_snapshots = num_snapshots - num_train_snapshots + i_all = np.arange(num_snapshots) + i_train = np.linspace( + 0, num_snapshots - 1, num_train_snapshots, dtype=int + ) # equally spaced training snapshots starting and ending at 0 and num_images-1 + i_eval = np.setdiff1d(i_all, i_train) # eval images are the remaining images + assert len(i_eval) == num_eval_snapshots + i_train = (i_train[None, :] * len(cameras) + np.arange(len(cameras))[:, None]).ravel() + i_eval = (i_eval[None, :] * len(cameras) + np.arange(len(cameras))[:, None]).ravel() + if split == "train": + indices = i_train + elif split in ["val", "test"]: + indices = i_eval + else: + raise ValueError(f"Unknown dataparser split {split}") + + # Choose image_filenames and poses based on split, but after auto orient and scaling the poses. + image_filenames = [image_filenames[i] for i in indices] + mask_filenames = [mask_filenames[i] for i in indices] + intrinsics = intrinsics[indices] + poses = poses[indices] + + # in x,y,z order + # assumes that the scene is centered at the origin + aabb_scale = 1.0 + scene_box = SceneBox( + aabb=torch.tensor( + [[-aabb_scale, -aabb_scale, -aabb_scale], [aabb_scale, aabb_scale, aabb_scale]], dtype=torch.float32 + ) + ) + + cameras = Cameras( + fx=intrinsics[:, 0, 0], + fy=intrinsics[:, 1, 1], + cx=intrinsics[:, 0, 2], + cy=intrinsics[:, 1, 2], + height=900, + width=1600, + camera_to_worlds=poses[:, :3, :4], + camera_type=CameraType.PERSPECTIVE, + ) + + dataparser_outputs = DataparserOutputs( + image_filenames=image_filenames, + cameras=cameras, + scene_box=scene_box, + mask_filenames=mask_filenames if self.config.mask_dir is not None else None, + ) + return dataparser_outputs diff --git a/pyproject.toml b/pyproject.toml index 146897261..59a74727e 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -45,6 +45,7 @@ dependencies = [ "torchtyping>=0.1.4", "torchvision>=0.13.0", "u-msgpack-python>=2.4.1", + "nuscenes-devkit>=1.1.1", "wandb>=0.13.3" ] diff --git a/scripts/datasets/process_nuscenes_masks.py b/scripts/datasets/process_nuscenes_masks.py new file mode 100644 index 000000000..cb9328f95 --- /dev/null +++ b/scripts/datasets/process_nuscenes_masks.py @@ -0,0 +1,131 @@ +import os +from dataclasses import dataclass +from pathlib import Path +from typing import Tuple + +import cv2 +import numpy as np +import tyro +from nuscenes.nuscenes import NuScenes as NuScenesDatabase +from nuscenes.utils.data_classes import Box +from nuscenes.utils.geometry_utils import BoxVisibility, view_points +from tqdm import tqdm +from typing_extensions import Literal + + +@dataclass +class ProcessNuScenesMasks: + """Use cuboid detections to render masks for dynamic objects.""" + + data_dir: Path + """Path to NuScenes dataset.""" + output_dir: Path + """Path to the output directory.""" + version: Literal["v1.0-mini", "v1.0-trainval"] = "v1.0-mini" + """Which version of the dataset to process.""" + velocity_thresh: float = 0.75 + """Minimum speed for object to be considered dynamic.""" + cameras: Tuple[Literal["FRONT", "FRONT_LEFT", "FRONT_RIGHT", "BACK", "BACK_LEFT", "BACK_RIGHT"], ...] = ( + "FRONT", + "FRONT_LEFT", + "FRONT_RIGHT", + "BACK", + "BACK_LEFT", + "BACK_RIGHT", + ) + """Which cameras to use.""" + + verbose: bool = False + """If True, print extra logging and visualize images on screen.""" + + def main(self) -> None: + """Generate NuScenes dynamic object masks.""" + + nusc = NuScenesDatabase(version=self.version, dataroot=self.data_dir, verbose=self.verbose) + cameras = ["CAM_" + camera for camera in self.cameras] + + for camera in cameras: + (self.output_dir / "masks" / camera).mkdir(parents=True, exist_ok=True) + + # get samples for scene + samples = [samp for samp in nusc.sample] + + # sort by timestamp (only to make chronological viz easier) + samples.sort(key=lambda x: (x["scene_token"], x["timestamp"])) + + # get which instances are moving in any frame (these are what we mask) + instances = nusc.instance + for instance in instances: + is_dynamic = False + ann_token = instance["first_annotation_token"] + while ann_token: + velocity = nusc.box_velocity(ann_token) + if not np.linalg.norm(velocity) < self.velocity_thresh: + is_dynamic = True + break + ann_token = nusc.get("sample_annotation", ann_token)["next"] + instance["is_dynamic"] = is_dynamic + instances_is_dynamic = {instance["token"]: instance["is_dynamic"] for instance in instances} + + for sample in tqdm(samples): + viz = [] + for camera in cameras: + camera_data = nusc.get("sample_data", sample["data"][camera]) + calibrated_sensor = nusc.get("calibrated_sensor", camera_data["calibrated_sensor_token"]) + intrinsics = np.array(calibrated_sensor["camera_intrinsic"]) + + _, boxes, _ = nusc.get_sample_data(sample["data"][camera], box_vis_level=BoxVisibility.ANY) + # TODO: BoxVisibility.ANY misses boxes that are partially behind the camera leading to missed masks + # Instead use BoxVisibility.NONE and make sure to rasterize box faces correctly + + mask = np.ones((900, 1600), dtype=np.uint8) + for box in boxes: + + # Dont mask out static objects (static in all frames) + instance_token = nusc.get("sample_annotation", box.token)["instance_token"] + if not instances_is_dynamic[instance_token]: + continue + + # project box to image plane and rasterize each face + corners_3d = box.corners() + corners = view_points(corners_3d, intrinsics, normalize=True)[:2, :] + corners = np.round(corners).astype(int).T + cv2.fillPoly(mask, [corners[[0, 1, 2, 3]]], 0) # front + cv2.fillPoly(mask, [corners[[4, 5, 6, 7]]], 0) # back + cv2.fillPoly(mask, [corners[[0, 1, 5, 4]]], 0) # top + cv2.fillPoly(mask, [corners[[2, 3, 7, 6]]], 0) # bottom + cv2.fillPoly(mask, [corners[[0, 3, 7, 4]]], 0) # left + cv2.fillPoly(mask, [corners[[1, 2, 6, 5]]], 0) # right + + maskname = os.path.split(camera_data["filename"])[1].replace("jpg", "png") + cv2.imwrite(str(self.output_dir / "masks" / camera / maskname), mask * 255) + + if self.verbose: + img = cv2.imread(str(self.data_dir / camera_data["filename"])) + mask = ~mask.astype(bool) + img[mask, :] -= np.minimum(img[mask, :], 100) + viz.append(img) + + if self.verbose: + if len(viz) == 6: + viz = np.vstack((np.hstack(viz[:3]), np.hstack(viz[3:]))) + viz = cv2.resize(viz, (int(1600 * 3 / 3), int(900 * 2 / 3))) + elif len(viz) == 3: + viz = np.hstack(viz[:3]) + viz = cv2.resize(viz, (int(1600 * 3 / 3), int(900 / 3))) + elif len(viz) == 1: + viz = viz[0] + else: + raise ValueError("Only support 1 or 3 or 6 cameras for viz") + cv2.imshow("", viz) + cv2.waitKey(1) + + +def entrypoint(): + """Entrypoint for use with pyproject scripts.""" + tyro.extras.set_accent_color("bright_yellow") + tyro.cli(ProcessNuScenesMasks).main() + + +if __name__ == "__main__": + entrypoint() From 57d56efb1e1e7d17e92306f2b2447df4fabbfc64 Mon Sep 17 00:00:00 2001 From: Alexander Kristoffersen Date: Sat, 12 Nov 2022 15:45:53 -0800 Subject: [PATCH 58/68] Colab hotfix: forgot glob import (#952) Created using Colaboratory --- colab/demo.ipynb | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/colab/demo.ipynb b/colab/demo.ipynb index cd001aa85..f6b5e1d50 100644 --- a/colab/demo.ipynb +++ b/colab/demo.ipynb @@ -7,7 +7,7 @@ "colab_type": "text" }, "source": [ - "\"Open" + "\"Open" ] }, { @@ -63,7 +63,7 @@ }, { "cell_type": "code", - "execution_count": 2, + "execution_count": null, "metadata": { "colab": { "base_uri": "https://localhost:8080/" @@ -151,6 +151,7 @@ "#@markdown

Downloading and Processing Data

\n", "#@markdown

Pick the preset scene or upload your own images/video

\n", "import os\n", + "import glob\n", "from google.colab import files\n", "from IPython.core.display import display, HTML\n", "\n", From 5b0f1ffacbde51a7f016fcebec461435fe0358f3 Mon Sep 17 00:00:00 2001 From: Matthew Tancik Date: Sat, 12 Nov 2022 17:18:11 -0800 Subject: [PATCH 59/68] Remove unimplemented interp render option (#953) --- scripts/render.py | 7 +------ 1 file changed, 1 insertion(+), 6 deletions(-) diff --git a/scripts/render.py b/scripts/render.py index b852a8cf2..f84c6c1e8 100644 --- a/scripts/render.py +++ b/scripts/render.py @@ -103,7 +103,7 @@ class RenderTrajectory: # Name of the renderer output to use. rgb, depth, etc. rendered_output_name: str = "rgb" # Trajectory to render. - traj: Literal["spiral", "interp", "filename"] = "spiral" + traj: Literal["spiral", "filename"] = "spiral" # Scaling factor to apply to the camera image resolution. downscale_factor: int = 1 # Filename of the camera path to render. @@ -133,11 +133,6 @@ class RenderTrajectory: camera_start = pipeline.datamanager.eval_dataloader.get_camera(image_idx=0) # TODO(ethan): pass in the up direction of the camera camera_path = get_spiral_path(camera_start, steps=30, radius=0.1) - elif self.traj == "interp": - # cameras_a = pipeline.datamanager.eval_dataloader.get_camera(image_idx=0) - # cameras_b = pipeline.datamanager.eval_dataloader.get_camera(image_idx=10) - # camera_path = get_interpolated_camera_path(cameras, steps=30) - raise NotImplementedError("Interpolated camera path not implemented.") elif self.traj == "filename": with open(self.camera_path_filename, "r", encoding="utf-8") as f: camera_path = json.load(f) From b67f96fc56df650eaf936835e34262b783326eda Mon Sep 17 00:00:00 2001 From: Matthew Tancik Date: Sat, 12 Nov 2022 18:23:24 -0800 Subject: [PATCH 60/68] Filter torchvision warnings (#954) --- nerfstudio/configs/base_config.py | 3 +++ 1 file changed, 3 insertions(+) diff --git a/nerfstudio/configs/base_config.py b/nerfstudio/configs/base_config.py index f5d2a31cf..2e67c64f0 100644 --- a/nerfstudio/configs/base_config.py +++ b/nerfstudio/configs/base_config.py @@ -18,6 +18,7 @@ from __future__ import annotations +import warnings from dataclasses import dataclass from datetime import datetime from pathlib import Path @@ -32,6 +33,8 @@ from nerfstudio.configs.config_utils import to_immutable_dict # model instances from nerfstudio.utils import writer +warnings.filterwarnings("ignore", module="torchvision") + CONSOLE = Console(width=120) # Pretty printing class From b5c34f0154a3358a8483120b63988a7176659a36 Mon Sep 17 00:00:00 2001 From: Nikhil Mohan <47728081+nikmo33@users.noreply.github.com> Date: Mon, 14 Nov 2022 16:56:36 +0000 Subject: [PATCH 61/68] Add 'inference' mode to pipeline (#956) * cleanup test mode * cleanup eval loading * change default * cleanup * cleanup * comment --- .../data/datamanagers/base_datamanager.py | 13 +++---- .../data/datamanagers/semantic_datamanager.py | 4 +- nerfstudio/engine/trainer.py | 9 +++-- nerfstudio/pipelines/base_pipeline.py | 18 +++++++-- nerfstudio/pipelines/dynamic_batch.py | 4 +- nerfstudio/utils/eval_utils.py | 16 ++++++-- scripts/render.py | 38 +++++++++++-------- 7 files changed, 64 insertions(+), 38 deletions(-) diff --git a/nerfstudio/data/datamanagers/base_datamanager.py b/nerfstudio/data/datamanagers/base_datamanager.py index 5ea8c8329..1e6b6669d 100644 --- a/nerfstudio/data/datamanagers/base_datamanager.py +++ b/nerfstudio/data/datamanagers/base_datamanager.py @@ -20,7 +20,7 @@ from __future__ import annotations from abc import abstractmethod from dataclasses import dataclass, field -from typing import Dict, List, Optional, Tuple, Type, Union +from typing import Dict, List, Literal, Optional, Tuple, Type, Union import torch import tyro @@ -136,9 +136,9 @@ class DataManager(nn.Module): super().__init__() self.train_count = 0 self.eval_count = 0 - if self.train_dataset: + if self.train_dataset and self.test_mode != "inference": self.setup_train() - if self.eval_dataset: + if self.eval_dataset and self.test_mode != "inference": self.setup_eval() def forward(self): @@ -288,7 +288,7 @@ class VanillaDataManager(DataManager): # pylint: disable=abstract-method self, config: VanillaDataManagerConfig, device: Union[torch.device, str] = "cpu", - test_mode: bool = False, + test_mode: Literal["test", "val", "inference"] = "val", world_size: int = 1, local_rank: int = 0, **kwargs, # pylint: disable=unused-argument @@ -299,6 +299,7 @@ class VanillaDataManager(DataManager): # pylint: disable=abstract-method self.local_rank = local_rank self.sampler = None self.test_mode = test_mode + self.test_split = "test" if test_mode in ["test", "inference"] else "val" self.train_dataset = self.create_train_dataset() self.eval_dataset = self.create_eval_dataset() @@ -310,9 +311,7 @@ class VanillaDataManager(DataManager): # pylint: disable=abstract-method def create_eval_dataset(self) -> InputDataset: """Sets up the data loaders for evaluation""" - return InputDataset( - self.config.dataparser.setup().get_dataparser_outputs(split="val" if not self.test_mode else "test") - ) + return InputDataset(self.config.dataparser.setup().get_dataparser_outputs(split=self.test_split)) def setup_train(self): """Sets up the data loaders for training""" diff --git a/nerfstudio/data/datamanagers/semantic_datamanager.py b/nerfstudio/data/datamanagers/semantic_datamanager.py index 011a68ce2..d19769308 100644 --- a/nerfstudio/data/datamanagers/semantic_datamanager.py +++ b/nerfstudio/data/datamanagers/semantic_datamanager.py @@ -44,6 +44,4 @@ class SemanticDataManager(VanillaDataManager): # pylint: disable=abstract-metho return SemanticDataset(self.config.dataparser.setup().get_dataparser_outputs(split="train")) def create_eval_dataset(self) -> SemanticDataset: - return SemanticDataset( - self.config.dataparser.setup().get_dataparser_outputs(split="val" if not self.test_mode else "test") - ) + return SemanticDataset(self.config.dataparser.setup().get_dataparser_outputs(split=self.test_split)) diff --git a/nerfstudio/engine/trainer.py b/nerfstudio/engine/trainer.py index 90e93a7e0..60f0a6dbe 100644 --- a/nerfstudio/engine/trainer.py +++ b/nerfstudio/engine/trainer.py @@ -21,7 +21,7 @@ import dataclasses import functools import os import time -from typing import Dict, List, Tuple +from typing import Dict, List, Literal, Tuple import torch from rich.console import Console @@ -102,11 +102,14 @@ class Trainer: writer.put_config(name="config", config_dict=dataclasses.asdict(config), step=0) profiler.setup_profiler(config.logging) - def setup(self, test_mode=False): + def setup(self, test_mode: Literal["test", "val", "inference"] = "val"): """Setup the Trainer by calling other setup functions. Args: - test_mode: Whether to setup for testing. Defaults to False. + test_mode: + 'val': loads train/val datasets into memory + 'test': loads train/test datset into memory + 'inference': does not load any dataset into memory """ self.pipeline = self.config.pipeline.setup( device=self.device, test_mode=test_mode, world_size=self.world_size, local_rank=self.local_rank diff --git a/nerfstudio/pipelines/base_pipeline.py b/nerfstudio/pipelines/base_pipeline.py index 978ae41b0..11930143b 100644 --- a/nerfstudio/pipelines/base_pipeline.py +++ b/nerfstudio/pipelines/base_pipeline.py @@ -21,7 +21,7 @@ import typing from abc import abstractmethod from dataclasses import dataclass, field from time import time -from typing import Any, Dict, List, Optional, Type, Union, cast +from typing import Any, Dict, List, Literal, Optional, Type, Union, cast import torch import torch.distributed as dist @@ -77,7 +77,10 @@ class Pipeline(nn.Module): Args: config: configuration to instantiate pipeline device: location to place model and data - test_mode: if True, loads test datset. if False, loads train/eval datasets + test_mode: + 'train': loads train/eval datasets into memory + 'test': loads train/test datset into memory + 'inference': does not load any dataset into memory world_size: total number of machines available local_rank: rank of current machine @@ -191,7 +194,10 @@ class VanillaPipeline(Pipeline): config: configuration to instantiate pipeline device: location to place model and data - test_mode: if True, loads test datset. if False, loads train/eval datasets + test_mode: + 'val': loads train/val datasets into memory + 'test': loads train/test datset into memory + 'inference': does not load any dataset into memory world_size: total number of machines available local_rank: rank of current machine @@ -204,12 +210,13 @@ class VanillaPipeline(Pipeline): self, config: VanillaPipelineConfig, device: str, - test_mode: bool = False, + test_mode: Literal["test", "val", "inference"] = "val", world_size: int = 1, local_rank: int = 0, ): super().__init__() self.config = config + self.test_mode = test_mode self.datamanager: VanillaDataManager = config.datamanager.setup( device=device, test_mode=test_mode, world_size=world_size, local_rank=local_rank ) @@ -351,6 +358,9 @@ class VanillaPipeline(Pipeline): loaded_state: pre-trained model state dict """ state = {key.replace("module.", ""): value for key, value in loaded_state.items()} + if self.test_mode == "inference": + state.pop("datamanager.train_ray_generator.image_coords", None) + state.pop("datamanager.eval_ray_generator.image_coords", None) self.load_state_dict(state) # type: ignore def get_training_callbacks( diff --git a/nerfstudio/pipelines/dynamic_batch.py b/nerfstudio/pipelines/dynamic_batch.py index d7d9e7f97..b169dfd55 100644 --- a/nerfstudio/pipelines/dynamic_batch.py +++ b/nerfstudio/pipelines/dynamic_batch.py @@ -17,7 +17,7 @@ A pipeline that dynamically chooses the number of rays to sample. """ from dataclasses import dataclass, field -from typing import Type +from typing import Literal, Type import torch @@ -49,7 +49,7 @@ class DynamicBatchPipeline(VanillaPipeline): self, config: DynamicBatchPipelineConfig, device: str, - test_mode: bool = False, + test_mode: Literal["test", "val", "inference"] = "val", world_size: int = 1, local_rank: int = 0, ): diff --git a/nerfstudio/utils/eval_utils.py b/nerfstudio/utils/eval_utils.py index 2f1ee4673..29a0dcada 100644 --- a/nerfstudio/utils/eval_utils.py +++ b/nerfstudio/utils/eval_utils.py @@ -20,7 +20,7 @@ from __future__ import annotations import os import sys from pathlib import Path -from typing import Optional, Tuple +from typing import Literal, Optional, Tuple import torch import yaml @@ -63,11 +63,21 @@ def eval_load_checkpoint(config: cfg.TrainerConfig, pipeline: Pipeline) -> Path: return load_path -def eval_setup(config_path: Path, eval_num_rays_per_chunk: Optional[int] = None) -> Tuple[cfg.Config, Pipeline, Path]: +def eval_setup( + config_path: Path, + eval_num_rays_per_chunk: Optional[int] = None, + test_mode: Literal["test", "val", "inference"] = "test", +) -> Tuple[cfg.Config, Pipeline, Path]: """Shared setup for loading a saved pipeline for evaluation. Args: config_path: Path to config YAML file. + eval_num_rays_per_chunk: Number of rays per forward pass + test_mode: + 'val': loads train/val datasets into memory + 'test': loads train/test datset into memory + 'inference': does not load any dataset into memory + Returns: Loaded config, pipeline module, and corresponding checkpoint. @@ -86,7 +96,7 @@ def eval_setup(config_path: Path, eval_num_rays_per_chunk: Optional[int] = None) # setup pipeline (which includes the DataManager) device = torch.device("cuda" if torch.cuda.is_available() else "cpu") - pipeline = config.pipeline.setup(device=device, test_mode=True) + pipeline = config.pipeline.setup(device=device, test_mode=test_mode) assert isinstance(pipeline, Pipeline) pipeline.eval() diff --git a/scripts/render.py b/scripts/render.py index f84c6c1e8..6cca7585f 100644 --- a/scripts/render.py +++ b/scripts/render.py @@ -4,13 +4,14 @@ render.py """ from __future__ import annotations -import dataclasses import json import sys +from dataclasses import dataclass, field from pathlib import Path -from typing import Optional +from typing import List, Optional import mediapy as media +import numpy as np import torch import tyro from rich.console import Console @@ -38,7 +39,7 @@ def _render_trajectory_video( pipeline: Pipeline, cameras: Cameras, output_filename: Path, - rendered_output_name: str, + rendered_output_names: List[str], rendered_resolution_scaling_factor: float = 1.0, seconds: float = 5.0, output_format: Literal["images", "video"] = "video", @@ -49,7 +50,7 @@ def _render_trajectory_video( pipeline: Pipeline to evaluate with. cameras: Cameras to render. output_filename: Name of the output file. - rendered_output_name: Name of the renderer output to use. + rendered_output_names: List of outputs to visualise. rendered_resolution_scaling_factor: Scaling factor to apply to the camera image resolution. seconds: Length of output video. output_format: How to save output data. @@ -73,16 +74,20 @@ def _render_trajectory_video( camera_ray_bundle = cameras.generate_rays(camera_indices=camera_idx).to(pipeline.device) with torch.no_grad(): outputs = pipeline.model.get_outputs_for_camera_ray_bundle(camera_ray_bundle) - if rendered_output_name not in outputs: - CONSOLE.rule("Error", style="red") - CONSOLE.print(f"Could not find {rendered_output_name} in the model outputs", justify="center") - CONSOLE.print(f"Please set --rendered_output_name to one of: {outputs.keys()}", justify="center") - sys.exit(1) - image = outputs[rendered_output_name].cpu().numpy() + render_image = [] + for rendered_output_name in rendered_output_names: + if rendered_output_name not in outputs: + CONSOLE.rule("Error", style="red") + CONSOLE.print(f"Could not find {rendered_output_name} in the model outputs", justify="center") + CONSOLE.print(f"Please set --rendered_output_name to one of: {outputs.keys()}", justify="center") + sys.exit(1) + output_image = outputs[rendered_output_name].cpu().numpy() + render_image.append(output_image) + render_image = np.concatenate(render_image, axis=1) if output_format == "images": - media.write_image(output_image_dir / f"{camera_idx:05d}.png", image) + media.write_image(output_image_dir / f"{camera_idx:05d}.png", render_image) else: - images.append(image) + images.append(render_image) if output_format == "video": fps = len(images) / seconds @@ -94,14 +99,14 @@ def _render_trajectory_video( CONSOLE.print(f"[green]Saved video to {output_filename}", justify="center") -@dataclasses.dataclass +@dataclass class RenderTrajectory: """Load a checkpoint, render a trajectory, and save to a video file.""" # Path to config YAML file. load_config: Path - # Name of the renderer output to use. rgb, depth, etc. - rendered_output_name: str = "rgb" + # Name of the renderer outputs to use. rgb, depth, etc. concatenates them along y axis + rendered_output_names: List[str] = field(default_factory=lambda: ["rgb"]) # Trajectory to render. traj: Literal["spiral", "filename"] = "spiral" # Scaling factor to apply to the camera image resolution. @@ -122,6 +127,7 @@ class RenderTrajectory: _, pipeline, _ = eval_setup( self.load_config, eval_num_rays_per_chunk=self.eval_num_rays_per_chunk, + test_mode="test" if self.traj == "spiral" else "inference", ) install_checks.check_ffmpeg_installed() @@ -145,7 +151,7 @@ class RenderTrajectory: pipeline, camera_path, output_filename=self.output_path, - rendered_output_name=self.rendered_output_name, + rendered_output_names=self.rendered_output_names, rendered_resolution_scaling_factor=1.0 / self.downscale_factor, seconds=seconds, output_format=self.output_format, From 6baf31dc9a9d81e6b44478bd31e0c0bc575493b2 Mon Sep 17 00:00:00 2001 From: Matthew Tancik Date: Tue, 15 Nov 2022 09:51:23 -0800 Subject: [PATCH 62/68] Fix python 3.7 support (#959) --- .github/workflows/core_code_checks.yml | 4 ++-- nerfstudio/data/datamanagers/base_datamanager.py | 3 ++- nerfstudio/engine/trainer.py | 3 ++- nerfstudio/pipelines/base_pipeline.py | 3 ++- nerfstudio/pipelines/dynamic_batch.py | 3 ++- nerfstudio/utils/eval_utils.py | 3 ++- pyproject.toml | 2 +- 7 files changed, 13 insertions(+), 8 deletions(-) diff --git a/.github/workflows/core_code_checks.yml b/.github/workflows/core_code_checks.yml index 3c9195f2a..86ff5ccca 100644 --- a/.github/workflows/core_code_checks.yml +++ b/.github/workflows/core_code_checks.yml @@ -15,10 +15,10 @@ jobs: steps: - uses: actions/checkout@v3 - - name: Set up Python 3.8.12 + - name: Set up Python 3.7.13 uses: actions/setup-python@v4 with: - python-version: '3.8.12' + python-version: '3.7.13' - uses: actions/cache@v2 with: path: ${{ env.pythonLocation }} diff --git a/nerfstudio/data/datamanagers/base_datamanager.py b/nerfstudio/data/datamanagers/base_datamanager.py index 1e6b6669d..a895fb7b8 100644 --- a/nerfstudio/data/datamanagers/base_datamanager.py +++ b/nerfstudio/data/datamanagers/base_datamanager.py @@ -20,7 +20,7 @@ from __future__ import annotations from abc import abstractmethod from dataclasses import dataclass, field -from typing import Dict, List, Literal, Optional, Tuple, Type, Union +from typing import Dict, List, Optional, Tuple, Type, Union import torch import tyro @@ -29,6 +29,7 @@ from torch import nn from torch.nn import Parameter from torch.utils.data import Dataset from torch.utils.data.distributed import DistributedSampler +from typing_extensions import Literal from nerfstudio.cameras.camera_optimizers import CameraOptimizerConfig from nerfstudio.cameras.rays import RayBundle diff --git a/nerfstudio/engine/trainer.py b/nerfstudio/engine/trainer.py index 60f0a6dbe..d35ebfeee 100644 --- a/nerfstudio/engine/trainer.py +++ b/nerfstudio/engine/trainer.py @@ -21,11 +21,12 @@ import dataclasses import functools import os import time -from typing import Dict, List, Literal, Tuple +from typing import Dict, List, Tuple import torch from rich.console import Console from torch.cuda.amp.grad_scaler import GradScaler +from typing_extensions import Literal from nerfstudio.configs import base_config as cfg from nerfstudio.engine.callbacks import ( diff --git a/nerfstudio/pipelines/base_pipeline.py b/nerfstudio/pipelines/base_pipeline.py index 11930143b..c0927c57a 100644 --- a/nerfstudio/pipelines/base_pipeline.py +++ b/nerfstudio/pipelines/base_pipeline.py @@ -21,7 +21,7 @@ import typing from abc import abstractmethod from dataclasses import dataclass, field from time import time -from typing import Any, Dict, List, Literal, Optional, Type, Union, cast +from typing import Any, Dict, List, Optional, Type, Union, cast import torch import torch.distributed as dist @@ -35,6 +35,7 @@ from rich.progress import ( from torch import nn from torch.nn import Parameter from torch.nn.parallel import DistributedDataParallel as DDP +from typing_extensions import Literal from nerfstudio.configs import base_config as cfg from nerfstudio.data.datamanagers.base_datamanager import ( diff --git a/nerfstudio/pipelines/dynamic_batch.py b/nerfstudio/pipelines/dynamic_batch.py index b169dfd55..788f68e82 100644 --- a/nerfstudio/pipelines/dynamic_batch.py +++ b/nerfstudio/pipelines/dynamic_batch.py @@ -17,9 +17,10 @@ A pipeline that dynamically chooses the number of rays to sample. """ from dataclasses import dataclass, field -from typing import Literal, Type +from typing import Type import torch +from typing_extensions import Literal from nerfstudio.data.datamanagers.base_datamanager import VanillaDataManager from nerfstudio.pipelines.base_pipeline import VanillaPipeline, VanillaPipelineConfig diff --git a/nerfstudio/utils/eval_utils.py b/nerfstudio/utils/eval_utils.py index 29a0dcada..7401a916c 100644 --- a/nerfstudio/utils/eval_utils.py +++ b/nerfstudio/utils/eval_utils.py @@ -20,11 +20,12 @@ from __future__ import annotations import os import sys from pathlib import Path -from typing import Literal, Optional, Tuple +from typing import Optional, Tuple import torch import yaml from rich.console import Console +from typing_extensions import Literal from nerfstudio.configs import base_config as cfg from nerfstudio.pipelines.base_pipeline import Pipeline diff --git a/pyproject.toml b/pyproject.toml index 59a74727e..52b5abfc5 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -146,5 +146,5 @@ reportMissingTypeStubs = false reportPrivateImportUsage = false reportUndefinedVariable = false -pythonVersion = "3.8" +pythonVersion = "3.7" pythonPlatform = "Linux" From 8678f4c2e652ba1a0ae3f44c0fcff78d7d9675c0 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Tue, 15 Nov 2022 14:11:51 -0800 Subject: [PATCH 63/68] Bump loader-utils from 2.0.2 to 2.0.4 in /nerfstudio/viewer/app (#962) Bumps [loader-utils](https://github.com/webpack/loader-utils) from 2.0.2 to 2.0.4. - [Release notes](https://github.com/webpack/loader-utils/releases) - [Changelog](https://github.com/webpack/loader-utils/blob/v2.0.4/CHANGELOG.md) - [Commits](https://github.com/webpack/loader-utils/compare/v2.0.2...v2.0.4) --- updated-dependencies: - dependency-name: loader-utils dependency-type: indirect ... Signed-off-by: dependabot[bot] Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> --- nerfstudio/viewer/app/yarn.lock | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/nerfstudio/viewer/app/yarn.lock b/nerfstudio/viewer/app/yarn.lock index b29328b9c..edccda676 100644 --- a/nerfstudio/viewer/app/yarn.lock +++ b/nerfstudio/viewer/app/yarn.lock @@ -3410,7 +3410,7 @@ bfj@^7.0.2: big.js@^5.2.2: version "5.2.2" - resolved "https://registry.npmjs.org/big.js/-/big.js-5.2.2.tgz" + resolved "https://registry.yarnpkg.com/big.js/-/big.js-5.2.2.tgz#65f0af382f578bcdc742bd9c281e9cb2d7768328" integrity sha512-vyL2OymJxmarO8gxMr0mhChsO9QGwhynfuu4+MHTAW6czfq9humCB7rKpUjDd9YUiDPU4mzpyupFSvOClAwbmQ== binary-extensions@^2.0.0: @@ -4474,7 +4474,7 @@ emoji-regex@^9.2.2: emojis-list@^3.0.0: version "3.0.0" - resolved "https://registry.npmjs.org/emojis-list/-/emojis-list-3.0.0.tgz" + resolved "https://registry.yarnpkg.com/emojis-list/-/emojis-list-3.0.0.tgz#5570662046ad29e2e916e71aae260abdff4f6a78" integrity sha512-/kyM18EfinwXZbno9FyUGeFh87KC8HRQBQGildHZbEuRyWFOmv1U10o9BBp8XVZDVNNuQKyIGIu5ZYAAXJ0V2Q== encodeurl@~1.0.2: @@ -6758,9 +6758,9 @@ loader-runner@^4.2.0: integrity sha512-3R/1M+yS3j5ou80Me59j7F9IMs4PXs3VqRrm0TU3AbKPxlmpoY1TNscJV/oGJXo8qCatFGTfDbY6W6ipGOYXfg== loader-utils@^2.0.0: - version "2.0.2" - resolved "https://registry.npmjs.org/loader-utils/-/loader-utils-2.0.2.tgz" - integrity sha512-TM57VeHptv569d/GKh6TAYdzKblwDNiumOdkFnejjD0XwTH87K90w3O7AiJRqdQoXygvi1VQTJTLGhJl7WqA7A== + version "2.0.4" + resolved "https://registry.yarnpkg.com/loader-utils/-/loader-utils-2.0.4.tgz#8b5cb38b5c34a9a018ee1fc0e6a066d1dfcc528c" + integrity sha512-xXqpXoINfFhgua9xiqD8fPFHgkoq1mmmpE92WlDbm9rNRd/EbRb+Gqf908T2DMfuHjjJlksiK2RbHVOdD/MqSw== dependencies: big.js "^5.2.2" emojis-list "^3.0.0" From 9ff167d7050c158b7ccf7359d58c0e10b583c9c7 Mon Sep 17 00:00:00 2001 From: Julian Knodt Date: Tue, 15 Nov 2022 14:29:29 -0800 Subject: [PATCH 64/68] Add temporal distortion and D-NeRF model (#825) * Add D-NeRF temporal distortion and D-NeRF model This allows for temporal distortion to be enabled on a variety of models through config parameters, without an explicit model. Temporal distortion and MIP-NeRF are not currently jointly runnable but can be changed in the future. * Simplifying changes * Simplifying changes Co-authored-by: Matthew Tancik --- .gitignore | 3 +- nerfstudio/cameras/cameras.py | 10 +- nerfstudio/cameras/rays.py | 19 +++- nerfstudio/configs/method_configs.py | 31 ++++++- nerfstudio/data/utils/dataloaders.py | 1 + .../field_components/temporal_distortions.py | 92 +++++++++++++++++++ nerfstudio/models/base_model.py | 7 ++ nerfstudio/models/vanilla_nerf.py | 25 ++++- .../test_temporal_distortions.py | 25 +++++ 9 files changed, 206 insertions(+), 7 deletions(-) create mode 100644 nerfstudio/field_components/temporal_distortions.py create mode 100644 tests/field_components/test_temporal_distortions.py diff --git a/.gitignore b/.gitignore index 84ed2e9ce..72951da16 100644 --- a/.gitignore +++ b/.gitignore @@ -174,6 +174,7 @@ data # Misc old/ temp* +!temporal* .nfs* external/ __MACOSX/ @@ -183,4 +184,4 @@ bash/ cache/ renders/ package-lock.json -camera_paths/ \ No newline at end of file +camera_paths/ diff --git a/nerfstudio/cameras/cameras.py b/nerfstudio/cameras/cameras.py index 7cf107f2f..5057509c9 100644 --- a/nerfstudio/cameras/cameras.py +++ b/nerfstudio/cameras/cameras.py @@ -337,8 +337,14 @@ class Cameras: else: ray_bundle_camera_indices = camera_indices.view(pixel_area.shape) + times = self.times[camera_indices, None] if self.times is not None else None + return RayBundle( - origins=origins, directions=directions, pixel_area=pixel_area, camera_indices=ray_bundle_camera_indices + origins=origins, + directions=directions, + pixel_area=pixel_area, + camera_indices=ray_bundle_camera_indices, + times=times, ) def to_json( @@ -362,7 +368,7 @@ class Cameras: "fy": self.fy[camera_idx].tolist(), "camera_to_world": self.camera_to_worlds[camera_idx].tolist(), "camera_index": camera_idx, - "times": self.times[camera_idx] if self.times is not None else None, + "times": self.times[camera_idx].item() if self.times is not None else None, } if image is not None: image_uint8 = (image * 255).detach().type(torch.uint8) diff --git a/nerfstudio/cameras/rays.py b/nerfstudio/cameras/rays.py index 16b28eae8..d9dbaba0b 100644 --- a/nerfstudio/cameras/rays.py +++ b/nerfstudio/cameras/rays.py @@ -40,6 +40,8 @@ class Frustums(TensorDataclass): """Where the frustum ends along a ray.""" pixel_area: TensorType["bs":..., 1] """Projected area of pixel a distance 1 away from origin.""" + offsets: Optional[TensorType["bs":..., 3]] = None + """Offsets for each sample position""" def get_positions(self) -> TensorType[..., 3]: """Calulates "center" position of frustum. Not weighted by mass. @@ -47,7 +49,14 @@ class Frustums(TensorDataclass): Returns: xyz positions. """ - return self.origins + self.directions * (self.starts + self.ends) / 2 + pos = self.origins + self.directions * (self.starts + self.ends) / 2 + if self.offsets is not None: + pos = pos + self.offsets + return pos + + def set_offsets(self, offsets): + """Sets offsets for this frustum for computing positions""" + self.offsets = offsets def get_gaussian_blob(self) -> Gaussians: """Calculates guassian approximation of conical frustum. @@ -57,6 +66,8 @@ class Frustums(TensorDataclass): """ # Cone radius is set such that the square pixel_area matches the cone area. cone_radius = torch.sqrt(self.pixel_area) / 1.7724538509055159 # r = sqrt(pixel_area / pi) + if self.offsets is not None: + raise NotImplementedError() return conical_frustum_to_gaussian( origins=self.origins, directions=self.directions, @@ -100,6 +111,9 @@ class RaySamples(TensorDataclass): metadata: Optional[Dict[str, TensorType["bs":..., "latent_dims"]]] = None """addtional information relevant to generating ray samples""" + times: Optional[TensorType[..., 1]] = None + """Times at which rays are sampled""" + def get_weights(self, densities: TensorType[..., "num_samples", 1]) -> TensorType[..., "num_samples", 1]: """Return weights based on predicted densities @@ -143,6 +157,8 @@ class RayBundle(TensorDataclass): """Rays Distance along ray to stop sampling""" metadata: Optional[Dict[str, TensorType["num_rays", "latent_dims"]]] = None """Additional metadata or data needed for interpolation, will mimic shape of rays""" + times: Optional[TensorType[..., 1]] = None + """Times at which rays are sampled""" def set_camera_indices(self, camera_index: int) -> None: """Sets all of the the camera indices to a specific camera index. @@ -223,6 +239,7 @@ class RayBundle(TensorDataclass): spacing_ends=spacing_ends, # [..., num_samples, 1] spacing_to_euclidean_fn=spacing_to_euclidean_fn, metadata=shaped_raybundle_fields.metadata, + times=None if self.times is None else self.times[..., None], # [..., 1, 1] ) return ray_samples diff --git a/nerfstudio/configs/method_configs.py b/nerfstudio/configs/method_configs.py index 2423984c7..a3649458a 100644 --- a/nerfstudio/configs/method_configs.py +++ b/nerfstudio/configs/method_configs.py @@ -32,9 +32,11 @@ from nerfstudio.configs.base_config import ( from nerfstudio.data.datamanagers.base_datamanager import VanillaDataManagerConfig from nerfstudio.data.datamanagers.semantic_datamanager import SemanticDataManagerConfig from nerfstudio.data.dataparsers.blender_dataparser import BlenderDataParserConfig +from nerfstudio.data.dataparsers.dnerf_dataparser import DNeRFDataParserConfig from nerfstudio.data.dataparsers.friends_dataparser import FriendsDataParserConfig from nerfstudio.data.dataparsers.nerfstudio_dataparser import NerfstudioDataParserConfig from nerfstudio.engine.optimizers import AdamOptimizerConfig, RAdamOptimizerConfig +from nerfstudio.field_components.temporal_distortions import TemporalDistortionKind from nerfstudio.models.base_model import VanillaModelConfig from nerfstudio.models.instant_ngp import InstantNGPModelConfig from nerfstudio.models.mipnerf import MipNerfModel @@ -53,6 +55,7 @@ descriptions = { "semantic-nerfw": "Predicts semantic segmentations and filters out transient objects.", "vanilla-nerf": "Original NeRF model. (slow)", "tensorf": "tensorf", + "dnerf": "Dynamic-NeRF model. (slow)", } method_configs["nerfacto"] = Config( @@ -159,7 +162,11 @@ method_configs["vanilla-nerf"] = Config( "fields": { "optimizer": RAdamOptimizerConfig(lr=5e-4, eps=1e-08), "scheduler": None, - } + }, + "temporal_distortion": { + "optimizer": RAdamOptimizerConfig(lr=5e-4, eps=1e-08), + "scheduler": None, + }, }, ) @@ -184,6 +191,28 @@ method_configs["tensorf"] = Config( }, ) +method_configs["dnerf"] = Config( + method_name="dnerf", + pipeline=VanillaPipelineConfig( + datamanager=VanillaDataManagerConfig(dataparser=DNeRFDataParserConfig()), + model=VanillaModelConfig( + _target=NeRFModel, + enable_temporal_distortion=True, + temporal_distortion_params={"kind": TemporalDistortionKind.DNERF}, + ), + ), + optimizers={ + "fields": { + "optimizer": RAdamOptimizerConfig(lr=5e-4, eps=1e-08), + "scheduler": None, + }, + "temporal_distortion": { + "optimizer": RAdamOptimizerConfig(lr=5e-4, eps=1e-08), + "scheduler": None, + }, + }, +) + AnnotatedBaseConfigUnion = tyro.conf.SuppressFixed[ # Don't show unparseable (fixed) arguments in helptext. tyro.conf.FlagConversionOff[ tyro.extras.subcommand_type_from_defaults(defaults=method_configs, descriptions=descriptions) diff --git a/nerfstudio/data/utils/dataloaders.py b/nerfstudio/data/utils/dataloaders.py index 8f8873d65..5eec5e530 100644 --- a/nerfstudio/data/utils/dataloaders.py +++ b/nerfstudio/data/utils/dataloaders.py @@ -166,6 +166,7 @@ class EvalDataloader(DataLoader): camera_to_worlds=self.cameras.camera_to_worlds[image_idx : image_idx + 1], distortion_params=distortion_params, camera_type=self.cameras.camera_type[image_idx : image_idx + 1], + times=self.cameras.times[image_idx : image_idx + 1] if self.cameras.time else None, ) return camera diff --git a/nerfstudio/field_components/temporal_distortions.py b/nerfstudio/field_components/temporal_distortions.py new file mode 100644 index 000000000..cd50893e4 --- /dev/null +++ b/nerfstudio/field_components/temporal_distortions.py @@ -0,0 +1,92 @@ +# Copyright 2022 The Nerfstudio Team. All rights reserved. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +"""Space distortions which occur as a function of time.""" + +from enum import Enum +from typing import Any, Dict, Optional, Tuple + +import torch +from torch import nn +from torchtyping import TensorType + +from nerfstudio.field_components.encodings import Encoding, NeRFEncoding +from nerfstudio.field_components.mlp import MLP + + +class TemporalDistortion(nn.Module): + """Apply spatial distortions as a function of time""" + + def forward(self, positions: TensorType["bs":..., 3], times: Optional[TensorType[1]]) -> TensorType["bs":..., 3]: + """ + Args: + positions: Samples to translate as a function of time + times: times for each sample + + Returns: + Translated positions. + """ + + +class TemporalDistortionKind(Enum): + """Possible temporal distortion names""" + + DNERF = "dnerf" + + def to_temporal_distortion(self, config: Dict[str, Any]) -> TemporalDistortion: + """Converts this kind to a temporal distortion""" + if self == TemporalDistortionKind.DNERF: + return DNeRFDistortion(**config) + raise NotImplementedError(f"Unknown temporal distortion kind {self}") + + +class DNeRFDistortion(TemporalDistortion): + """Optimizable temporal deformation using an MLP. + Args: + position_encoding: An encoding for the XYZ of distortion + temporal_encoding: An encoding for the time of distortion + mlp_num_layers: Number of layers in distortion MLP + mlp_layer_width: Size of hidden layer for the MLP + skip_connections: Number of layers for skip connections in the MLP + """ + + def __init__( + self, + position_encoding: Encoding = NeRFEncoding( + in_dim=3, num_frequencies=10, min_freq_exp=0.0, max_freq_exp=8.0, include_input=True + ), + temporal_encoding: Encoding = NeRFEncoding( + in_dim=1, num_frequencies=10, min_freq_exp=0.0, max_freq_exp=8.0, include_input=True + ), + mlp_num_layers: int = 4, + mlp_layer_width: int = 256, + skip_connections: Tuple[int] = (4,), + ) -> None: + super().__init__() + self.position_encoding = position_encoding + self.temporal_encoding = temporal_encoding + self.mlp_deform = MLP( + in_dim=self.position_encoding.get_out_dim() + self.temporal_encoding.get_out_dim(), + out_dim=3, + num_layers=mlp_num_layers, + layer_width=mlp_layer_width, + skip_connections=skip_connections, + ) + + def forward(self, positions, times=None): + if times is None: + return None + p = self.position_encoding(positions) + t = self.temporal_encoding(times) + return self.mlp_deform(torch.cat([p, t], dim=-1)) diff --git a/nerfstudio/models/base_model.py b/nerfstudio/models/base_model.py index ef36f53c8..57d0d3bea 100644 --- a/nerfstudio/models/base_model.py +++ b/nerfstudio/models/base_model.py @@ -32,6 +32,7 @@ from nerfstudio.configs.base_config import InstantiateConfig from nerfstudio.configs.config_utils import to_immutable_dict from nerfstudio.data.scene_box import SceneBox from nerfstudio.engine.callbacks import TrainingCallback, TrainingCallbackAttributes +from nerfstudio.field_components.temporal_distortions import TemporalDistortionKind from nerfstudio.model_components.scene_colliders import NearFarCollider @@ -77,6 +78,7 @@ class Model(nn.Module): self.num_train_data = num_train_data self.kwargs = kwargs self.collider = None + self.populate_modules() # populate the modules self.callbacks = None # to keep track of which device the nn.Module is on @@ -218,3 +220,8 @@ class VanillaModelConfig(ModelConfig): """Number of samples in coarse field evaluation""" num_importance_samples: int = 128 """Number of samples in fine field evaluation""" + + enable_temporal_distortion: bool = False + """Specifies whether or not to include ray warping based on time.""" + temporal_distortion_params: Dict[str, Any] = to_immutable_dict({"kind": TemporalDistortionKind.DNERF}) + """Parameters to instantiate temporal distortion with""" diff --git a/nerfstudio/models/vanilla_nerf.py b/nerfstudio/models/vanilla_nerf.py index 827bdfa26..2c5227ee4 100644 --- a/nerfstudio/models/vanilla_nerf.py +++ b/nerfstudio/models/vanilla_nerf.py @@ -55,6 +55,7 @@ class NeRFModel(Model): ) -> None: self.field_coarse = None self.field_fine = None + self.temporal_distortion = None super().__init__( config=config, @@ -73,8 +74,15 @@ class NeRFModel(Model): in_dim=3, num_frequencies=4, min_freq_exp=0.0, max_freq_exp=4.0, include_input=True ) - self.field_coarse = NeRFField(position_encoding=position_encoding, direction_encoding=direction_encoding) - self.field_fine = NeRFField(position_encoding=position_encoding, direction_encoding=direction_encoding) + self.field_coarse = NeRFField( + position_encoding=position_encoding, + direction_encoding=direction_encoding, + ) + + self.field_fine = NeRFField( + position_encoding=position_encoding, + direction_encoding=direction_encoding, + ) # samplers self.sampler_uniform = UniformSampler(num_samples=self.config.num_coarse_samples) @@ -93,11 +101,18 @@ class NeRFModel(Model): self.ssim = structural_similarity_index_measure self.lpips = LearnedPerceptualImagePatchSimilarity() + if getattr(self.config, "enable_temporal_distortion", False): + params = self.config.temporal_distortion_params + kind = params.pop("kind") + self.temporal_distortion = kind.to_temporal_distortion(params) + def get_param_groups(self) -> Dict[str, List[Parameter]]: param_groups = {} if self.field_coarse is None or self.field_fine is None: raise ValueError("populate_fields() must be called before get_param_groups") param_groups["fields"] = list(self.field_coarse.parameters()) + list(self.field_fine.parameters()) + if self.temporal_distortion is not None: + param_groups["temporal_distortion"] = list(self.temporal_distortion.parameters()) return param_groups def get_outputs(self, ray_bundle: RayBundle): @@ -107,6 +122,9 @@ class NeRFModel(Model): # uniform sampling ray_samples_uniform = self.sampler_uniform(ray_bundle) + if self.temporal_distortion is not None: + offsets = self.temporal_distortion(ray_samples_uniform.frustums.get_positions(), ray_samples_uniform.times) + ray_samples_uniform.frustums.set_offsets(offsets) # coarse field: field_outputs_coarse = self.field_coarse.forward(ray_samples_uniform) @@ -120,6 +138,9 @@ class NeRFModel(Model): # pdf sampling ray_samples_pdf = self.sampler_pdf(ray_bundle, ray_samples_uniform, weights_coarse) + if self.temporal_distortion is not None: + offsets = self.temporal_distortion(ray_samples_pdf.frustums.get_positions(), ray_samples_pdf.times) + ray_samples_pdf.frustums.set_offsets(offsets) # fine field: field_outputs_fine = self.field_fine.forward(ray_samples_pdf) diff --git a/tests/field_components/test_temporal_distortions.py b/tests/field_components/test_temporal_distortions.py new file mode 100644 index 000000000..61c240fd0 --- /dev/null +++ b/tests/field_components/test_temporal_distortions.py @@ -0,0 +1,25 @@ +""" +Test if temporal distortions run properly +""" +import torch + +from nerfstudio.field_components.temporal_distortions import DNeRFDistortion + + +def test_dnerf_distortion(): + """Test dnerf distortion""" + # pylint: disable=import-outside-toplevel + # pylint: disable=unused-import + device = torch.device("cuda" if torch.cuda.is_available() else "cpu") + distortion = DNeRFDistortion().to(device) + + num_rays = 1024 + num_samples = 256 + positions = torch.rand((num_rays, num_samples, 3), dtype=torch.float32, device=device) + assert distortion.forward(positions, None) is None + times = torch.rand_like(positions[..., :1]) + assert distortion.forward(positions, times).shape == positions.shape + + +if __name__ == "__main__": + test_dnerf_distortion() From 9ee6c31c0299a529deb5f4e16c441e78b14147cd Mon Sep 17 00:00:00 2001 From: Alexander Kristoffersen Date: Tue, 15 Nov 2022 14:59:31 -0800 Subject: [PATCH 65/68] Small Typos (#960) small typos. --- nerfstudio/model_components/scene_colliders.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/nerfstudio/model_components/scene_colliders.py b/nerfstudio/model_components/scene_colliders.py index b1f1eecf1..5cf178f99 100644 --- a/nerfstudio/model_components/scene_colliders.py +++ b/nerfstudio/model_components/scene_colliders.py @@ -13,7 +13,7 @@ # limitations under the License. """ -Ray generator. +Scene Colliders """ from __future__ import annotations From a7b2af185c9ce43bb4f8faefbc05c7eab99bf37c Mon Sep 17 00:00:00 2001 From: Matthew Tancik Date: Tue, 15 Nov 2022 16:56:56 -0800 Subject: [PATCH 66/68] Cleanup configs (#963) --- nerfstudio/configs/method_configs.py | 3 +-- nerfstudio/models/base_model.py | 16 ---------------- nerfstudio/models/tensorf.py | 4 ++-- nerfstudio/models/vanilla_nerf.py | 23 +++++++++++++++++++++-- 4 files changed, 24 insertions(+), 22 deletions(-) diff --git a/nerfstudio/configs/method_configs.py b/nerfstudio/configs/method_configs.py index a3649458a..2c829e092 100644 --- a/nerfstudio/configs/method_configs.py +++ b/nerfstudio/configs/method_configs.py @@ -37,13 +37,12 @@ from nerfstudio.data.dataparsers.friends_dataparser import FriendsDataParserConf from nerfstudio.data.dataparsers.nerfstudio_dataparser import NerfstudioDataParserConfig from nerfstudio.engine.optimizers import AdamOptimizerConfig, RAdamOptimizerConfig from nerfstudio.field_components.temporal_distortions import TemporalDistortionKind -from nerfstudio.models.base_model import VanillaModelConfig from nerfstudio.models.instant_ngp import InstantNGPModelConfig from nerfstudio.models.mipnerf import MipNerfModel from nerfstudio.models.nerfacto import NerfactoModelConfig from nerfstudio.models.semantic_nerfw import SemanticNerfWModelConfig from nerfstudio.models.tensorf import TensoRFModelConfig -from nerfstudio.models.vanilla_nerf import NeRFModel +from nerfstudio.models.vanilla_nerf import NeRFModel, VanillaModelConfig from nerfstudio.pipelines.base_pipeline import VanillaPipelineConfig from nerfstudio.pipelines.dynamic_batch import DynamicBatchPipelineConfig diff --git a/nerfstudio/models/base_model.py b/nerfstudio/models/base_model.py index 57d0d3bea..6be459343 100644 --- a/nerfstudio/models/base_model.py +++ b/nerfstudio/models/base_model.py @@ -32,7 +32,6 @@ from nerfstudio.configs.base_config import InstantiateConfig from nerfstudio.configs.config_utils import to_immutable_dict from nerfstudio.data.scene_box import SceneBox from nerfstudio.engine.callbacks import TrainingCallback, TrainingCallbackAttributes -from nerfstudio.field_components.temporal_distortions import TemporalDistortionKind from nerfstudio.model_components.scene_colliders import NearFarCollider @@ -210,18 +209,3 @@ class Model(nn.Module): """ state = {key.replace("module.", ""): value for key, value in loaded_state["model"].items()} self.load_state_dict(state) # type: ignore - - -@dataclass -class VanillaModelConfig(ModelConfig): - """Vanilla Model Config""" - - num_coarse_samples: int = 64 - """Number of samples in coarse field evaluation""" - num_importance_samples: int = 128 - """Number of samples in fine field evaluation""" - - enable_temporal_distortion: bool = False - """Specifies whether or not to include ray warping based on time.""" - temporal_distortion_params: Dict[str, Any] = to_immutable_dict({"kind": TemporalDistortionKind.DNERF}) - """Parameters to instantiate temporal distortion with""" diff --git a/nerfstudio/models/tensorf.py b/nerfstudio/models/tensorf.py index a0c771d2c..e3fa1ee65 100644 --- a/nerfstudio/models/tensorf.py +++ b/nerfstudio/models/tensorf.py @@ -46,12 +46,12 @@ from nerfstudio.model_components.renderers import ( RGBRenderer, ) from nerfstudio.model_components.scene_colliders import AABBBoxCollider -from nerfstudio.models.base_model import Model, VanillaModelConfig +from nerfstudio.models.base_model import Model, ModelConfig from nerfstudio.utils import colormaps, colors, misc @dataclass -class TensoRFModelConfig(VanillaModelConfig): +class TensoRFModelConfig(ModelConfig): """TensoRF model config""" _target: Type = field(default_factory=lambda: TensoRFModel) diff --git a/nerfstudio/models/vanilla_nerf.py b/nerfstudio/models/vanilla_nerf.py index 2c5227ee4..3e731524f 100644 --- a/nerfstudio/models/vanilla_nerf.py +++ b/nerfstudio/models/vanilla_nerf.py @@ -18,7 +18,8 @@ Implementation of vanilla nerf. from __future__ import annotations -from typing import Dict, List, Tuple +from dataclasses import dataclass, field +from typing import Any, Dict, List, Tuple, Type import torch from torch.nn import Parameter @@ -27,8 +28,10 @@ from torchmetrics.functional import structural_similarity_index_measure from torchmetrics.image.lpip import LearnedPerceptualImagePatchSimilarity from nerfstudio.cameras.rays import RayBundle +from nerfstudio.configs.config_utils import to_immutable_dict from nerfstudio.field_components.encodings import NeRFEncoding from nerfstudio.field_components.field_heads import FieldHeadNames +from nerfstudio.field_components.temporal_distortions import TemporalDistortionKind from nerfstudio.fields.vanilla_nerf_field import NeRFField from nerfstudio.model_components.losses import MSELoss from nerfstudio.model_components.ray_samplers import PDFSampler, UniformSampler @@ -41,6 +44,22 @@ from nerfstudio.models.base_model import Model, ModelConfig from nerfstudio.utils import colormaps, colors, misc +@dataclass +class VanillaModelConfig(ModelConfig): + """Vanilla Model Config""" + + _target: Type = field(default_factory=lambda: NeRFModel) + num_coarse_samples: int = 64 + """Number of samples in coarse field evaluation""" + num_importance_samples: int = 128 + """Number of samples in fine field evaluation""" + + enable_temporal_distortion: bool = False + """Specifies whether or not to include ray warping based on time.""" + temporal_distortion_params: Dict[str, Any] = to_immutable_dict({"kind": TemporalDistortionKind.DNERF}) + """Parameters to instantiate temporal distortion with""" + + class NeRFModel(Model): """Vanilla NeRF model @@ -50,7 +69,7 @@ class NeRFModel(Model): def __init__( self, - config: ModelConfig, + config: VanillaModelConfig, **kwargs, ) -> None: self.field_coarse = None From 95a27ecba5d04d4cc96d5fc7764f632ef31403ed Mon Sep 17 00:00:00 2001 From: Matthew Tancik Date: Tue, 15 Nov 2022 17:55:29 -0800 Subject: [PATCH 67/68] Add support for polycam (#958) * Add support for polycam * Modify blur score * Support processing zip and add undistort fallback * Created using Colaboratory * Update docs * Update demo.ipynb * Address comments * fix lint --- README.md | 6 +- colab/demo.ipynb | 81 ++++--- docs/quickstart/custom_dataset.md | 110 ++++++++-- docs/quickstart/imgs/polycam_export.png | Bin 0 -> 226266 bytes docs/quickstart/imgs/polycam_settings.png | Bin 0 -> 40697 bytes .../data/dataparsers/nerfstudio_dataparser.py | 10 +- scripts/process_data.py | 207 +++++++++++++++++- 7 files changed, 341 insertions(+), 73 deletions(-) create mode 100644 docs/quickstart/imgs/polycam_export.png create mode 100644 docs/quickstart/imgs/polycam_settings.png diff --git a/README.md b/README.md index 5f166ae41..d4239f042 100644 --- a/README.md +++ b/README.md @@ -135,9 +135,9 @@ If you have custom data in the form of a video or folder of images, we've provid After installing both software, you can process your data via: ```bash -ns-process-data {video,images,insta360,record3d} --data {DATA_PATH} --output-dir {PROCESSED_DATA_DIR} +ns-process-data {video,images,polycam,insta360,record3d} --data {DATA_PATH} --output-dir {PROCESSED_DATA_DIR} # Or if you're on a system without an attached display (i.e. colab): -ns-process-data {video,images,insta360,record3d} --data {DATA_PATH} --output-dir {PROCESSED_DATA_DIR} --no-gpu +ns-process-data {video,images,poylcam,insta360,record3d} --data {DATA_PATH} --output-dir {PROCESSED_DATA_DIR} --no-gpu ``` ## 3. Training a model @@ -228,7 +228,7 @@ We provide the following support structures to make life easier for getting star - 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. +- :iphone: Full pipeline support (w/ Colmap, Polycam, or Record3D) for going from a video on your phone to a full 3D render. # Built On diff --git a/colab/demo.ipynb b/colab/demo.ipynb index f6b5e1d50..ef1cb4dc2 100644 --- a/colab/demo.ipynb +++ b/colab/demo.ipynb @@ -7,7 +7,7 @@ "colab_type": "text" }, "source": [ - "\"Open" + "\"Open" ] }, { @@ -63,31 +63,31 @@ }, { "cell_type": "code", - "execution_count": null, + "execution_count": 1, "metadata": { "colab": { "base_uri": "https://localhost:8080/" }, "id": "RGr33zHaHak0", - "outputId": "14f33da4-1e52-4784-e4e5-79e5d884fb8f" + "outputId": "2641dce6-cd57-4d31-d8b1-860bc1adf17f", + "cellView": "form" }, "outputs": [ { "output_type": "stream", "name": "stdout", "text": [ - "\u001b[33mWARNING: Running pip as the 'root' user can result in broken permissions and conflicting behaviour with the system package manager. It is recommended to use a virtual environment instead: https://pip.pypa.io/warnings/venv\u001b[0m\u001b[33m\n", - "\u001b[0m⏬ Downloading https://github.com/jaimergp/miniforge/releases/latest/download/Mambaforge-colab-Linux-x86_64.sh...\n", + "⏬ Downloading https://github.com/jaimergp/miniforge/releases/latest/download/Mambaforge-colab-Linux-x86_64.sh...\n", "📦 Installing...\n", "📌 Adjusting configuration...\n", "🩹 Patching environment...\n", - "⏲ Done in 0:00:18\n", + "⏲ Done in 0:00:27\n", "🔁 Restarting kernel...\n" ] } ], "source": [ - "#@title # Install Conda (requires runtime restart) { vertical-output: true, display-mode: \"form\" }\n", + "#@markdown

Install Conda (requires runtime restart)

\n", "\n", "!pip install -q condacolab\n", "import condacolab\n", @@ -98,11 +98,12 @@ "cell_type": "code", "execution_count": null, "metadata": { - "id": "9oyLHl8QfYwP" + "id": "9oyLHl8QfYwP", + "cellView": "form" }, "outputs": [], "source": [ - "#@title # Install Nerfstudio and Dependencies (~10 min) { vertical-output: true, display-mode: \"form\" }\n", + "#@markdown

Install Nerfstudio and Dependencies (~10 min)

\n", "\n", "%cd /content/\n", "!pip install --upgrade pip\n", @@ -126,27 +127,10 @@ "cell_type": "code", "execution_count": null, "metadata": { - "colab": { - "base_uri": "https://localhost:8080/" - }, "id": "msVLprI4gRA4", - "outputId": "e8074daa-afd5-4021-ae41-27ce0e2bf0d8", "cellView": "form" }, - "outputs": [ - { - "output_type": "stream", - "name": "stdout", - "text": [ - "/content\n", - "Downloading...\n", - "From: https://drive.google.com/uc?id=1dmjWGXlJnUxwosN6MVooCDQe970PkD-1\n", - "To: /content/data/nerfstudio/poster.zip\n", - "100% 750M/750M [00:02<00:00, 295MB/s]\n", - "\u001b[0mData Processing Succeeded!\n" - ] - } - ], + "outputs": [], "source": [ "#@markdown

Downloading and Processing Data

\n", "#@markdown

Pick the preset scene or upload your own images/video

\n", @@ -155,12 +139,20 @@ "from google.colab import files\n", "from IPython.core.display import display, HTML\n", "\n", - "scene = '\\uD83D\\uDDBC poster' #@param ['🖼 poster', '🚜 dozer', '🌄 desolation', '📤 upload your images' , '🎥 upload your own video', '💽 upload your own Record3D data']\n", + "scene = '\\uD83D\\uDDBC poster' #@param ['🖼 poster', '🚜 dozer', '🌄 desolation', '📤 upload your images' , '🎥 upload your own video', '🔺 upload Polycam data', '💽 upload your own Record3D data']\n", "scene = ' '.join(scene.split(' ')[1:])\n", "\n", - "if scene not in ['upload your images', 'upload your own video', 'upload your own Record3D data']:\n", + "if scene == \"upload Polycam data\":\n", " %cd /content/\n", - " !ns-download-data --dataset=nerfstudio --capture=$scene\n", + " !mkdir -p /content/data/nerfstudio/custom_data\n", + " %cd /content/data/nerfstudio/custom_data/\n", + " uploaded = files.upload()\n", + " dir = os.getcwd()\n", + " if len(uploaded.keys()) > 1:\n", + " print(\"ERROR, upload a single .zip file when processing Polycam data\")\n", + " dataset_dir = [os.path.join(dir, f) for f in uploaded.keys()][0]\n", + " !ns-process-data polycam --data $dataset_dir --output-dir /content/data/nerfstudio/custom_data/\n", + " scene = \"custom_data\"\n", "elif scene == 'upload your own Record3D data':\n", " display(HTML('

Zip your Record3D folder, and upload.

'))\n", " display(HTML('

More information on Record3D can be found here.

'))\n", @@ -174,7 +166,8 @@ " !unzip $record_3d_zipfile -d /content/data/nerfstudio/custom_data\n", " custom_data_directory = glob.glob('/content/data/nerfstudio/custom_data/*')[0]\n", " !ns-process-data record3d --data $custom_data_directory --output-dir /content/data/nerfstudio/custom_data/\n", - "else:\n", + " scene = \"custom_data\"\n", + "elif scene in ['upload your images', 'upload your own video']:\n", " display(HTML('

Select your custom data

'))\n", " display(HTML('

You can select multiple images by pressing ctrl, cmd or shift and click.

'))\n", " display(HTML('

Note: This may take time, especially on hires inputs, so we recommend to download dataset after creation.

'))\n", @@ -199,19 +192,23 @@ " !ns-process-data video --data $video_path --output-dir /content/data/nerfstudio/custom_data/\n", "\n", " scene = \"custom_data\"\n", + "else:\n", + " %cd /content/\n", + " !ns-download-data --dataset=nerfstudio --capture=$scene\n", + "\n", "print(\"Data Processing Succeeded!\")" ] }, { "cell_type": "code", - "execution_count": null, + "execution_count": 2, "metadata": { "colab": { "base_uri": "https://localhost:8080/", "height": 928 }, "id": "VoKDxqEcjmfC", - "outputId": "d6c97ce9-f77a-4026-d6f3-328918435bb0", + "outputId": "d2919aa4-96dd-4e50-829f-289e4208882b", "cellView": "form" }, "outputs": [ @@ -221,9 +218,9 @@ "text": [ "/content\n", "\u001b[K\u001b[?25h/tools/node/bin/lt -> /tools/node/lib/node_modules/localtunnel/bin/lt.js\n", - "+ localtunnel@2.0.2\n", - "updated 1 package in 1.523s\n", - "https://viewer.nerf.studio/?websocket_url=wss://fifty-jars-return-34-124-199-158.loca.lt\n", + "\u001b[K\u001b[?25h+ localtunnel@2.0.2\n", + "added 22 packages from 22 contributors in 2.07s\n", + "https://viewer.nerf.studio/?websocket_url=wss://cyan-facts-matter-34-91-1-218.loca.lt\n", "You may need to click Refresh Page after you start training!\n" ] }, @@ -231,14 +228,14 @@ "output_type": "execute_result", "data": { "text/plain": [ - "" + "" ], "text/html": [ "\n", " \n", @@ -246,11 +243,11 @@ ] }, "metadata": {}, - "execution_count": 1 + "execution_count": 2 } ], "source": [ - "#@title # Set up and Start Viewer\n", + "#@markdown

Set up and Start Viewer

\n", "\n", "%cd /content\n", "\n", @@ -289,7 +286,7 @@ }, "outputs": [], "source": [ - "#@title # Start Training { vertical-output: true }\n", + "#@markdown

Start Training

\n", "\n", "%cd /content\n", "if os.path.exists(f\"data/nerfstudio/{scene}/transforms.json\"):\n", @@ -386,4 +383,4 @@ }, "nbformat": 4, "nbformat_minor": 0 -} \ No newline at end of file +} diff --git a/docs/quickstart/custom_dataset.md b/docs/quickstart/custom_dataset.md index 903c8df31..1c4f05722 100644 --- a/docs/quickstart/custom_dataset.md +++ b/docs/quickstart/custom_dataset.md @@ -1,31 +1,46 @@ # 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. +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 the nerfstudio format. Specifically we need to know the camera poses for each image. -## 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: +To process your own data run: ```bash -ns-process-data {video,images,insta360,record3d} --data {DATA_PATH} --output-dir {PROCESSED_DATA_DIR} +ns-process-data {video,images,polycam,insta360,record3d} --data {DATA_PATH} --output-dir {PROCESSED_DATA_DIR} ``` A full set of arguments can be found {doc}`here`. +We Currently support the following custom data types: +| Data | Requirements | Preprocessing Speed | +| -------- | ----------------------- | ------------------- | +| [Images](images_and_video) | COLMAP | 🐢 | +| [Video](images_and_video) | COLMAP | 🐢 | +| [Polycam](polycam) | LiDAR iOS Device | 🐇 | +| [Record3D](record3d) | LiDAR iOS Device | 🐇 | +| Insta360 | 2 Sensor camera, COLMAP | 🐢 | + +(images_and_video)= + +## Images or Video + +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) + :::{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. +### Processing Data ```bash -ns-train nerfacto --data {PROCESSED_DATA_DIR} nerfstudio-data +ns-process-data {images, video} --data {DATA_PATH} --output-dir {PROCESSED_DATA_DIR} +``` + +### Training on your data + +```bash +ns-train nerfacto --data {PROCESSED_DATA_DIR} ``` ### Installing COLMAP @@ -108,6 +123,59 @@ cd vcpkg ::::: :::::: +(polycam)= + +## Polycam Capture + +Nerfstudio can also be trained directly from captures from the [Polycam app](https://poly.cam//). This avoids the need to use COLMAP. Polycam's poses are globally optimized which make them more robust to drift (an issue with ARKit or SLAM methods). + +To get the best results, try to reduce motion blur as much as possible and try to view the target from as many viewpoinrts as possible. Polycam recommends having good lighting and moving the camera slowly if using auto mode. Or, even better, use the manual shutter mode to capture less blurry images. + +:::{admonition} Note +:class: info +A LiDAR enabled iPhone or iPad is necessary. +::: + +### Setting up Polycam + +```{image} imgs/polycam_settings.png +:width: 200 +:align: center +:alt: polycam settings +``` + +Devoloper settings must be enabled in Polycam. To do this, navigate to the settings screen and select `Developer mode`. Note that this will only apply for future captures, you will not be able to process existing captures with nerfstudio. + +### Process data + +```{image} imgs/polycam_export.png +:width: 400 +:align: center +:alt: polycam export options +``` + +0. Capture data in LiDAR or Room mode. + +1. Tap `Process` to process the data in the Polycam app. + +2. Navigate to the export app pane. + +3. Select `raw data` to export a `.zip` file. + +4. Convert the Polycam data into the nerfstudio format using the following command: + +```bash +ns-process-data polycam --data {OUTPUT_FILE.zip} --output-dir {output directory} +``` + +5. Train the model using the following command: + +```bash +ns-train nerfacto --data {output directory} +``` + +(record3d)= + ## Record3D Capture Nerfstudio can also be trained directly from >=iPhone 12 Pro captures from the [Record3D app](https://record3d.app/). This uses the iPhone's LiDAR sensors to calculate camera poses, so COLMAP is not needed. @@ -125,20 +193,14 @@ At a high level, you can follow these 3 steps: 2. Then, move the exported capture folder from your iPhone to your computer. +3. Convert the data to the nerfstudio format. + +```bash +ns-process-data record3d --data {data directory} --output-dir {output directory} +``` + 3. Train with nerfstudio! ``` -ns-train nerfacto --data {RECORD3D_CAPTURE_DIR/EXR_RGBD} record3d-data -``` - -We provide some example recordings for you to try out and to see the correct formatting. - -```shell -ns-download-data --dataset record3d -``` - -This will download data to `data/record3d/bear`. Then you can train, and don't forget to open up the viewer. - -```shell -ns-train nerfacto record3d-data --data data/record3d/bear +ns-train nerfacto --data {output directory} ``` diff --git a/docs/quickstart/imgs/polycam_export.png b/docs/quickstart/imgs/polycam_export.png new file mode 100644 index 0000000000000000000000000000000000000000..4d4997169ab24ce5023c3380e318f177c51bc0a4 GIT binary patch literal 226266 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 z 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%0Dk01Rl_HUItm; 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%0AEY8N4yiVBnp{xA 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�`4^X@`{|D79&U#f2j&E}SN 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

X)vFu=A+TpsKDG(OeDn7|~*kx(*Lck6siOXPD&F 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 z zf_=nkroAW(?6G^&prAZBMfr8kdi+#VmS}Y;0*TVyLJ)>zcK>fe&6@4IK4|sdUR0GX zoiL?;s2D%UsxMc+V#|#aHrox*aM#=%Ht2I?;1nrMjyW(i!1>Sq47N!+L{EhAucy&R zHx}y{@nTvs;Eh|!rQ-ONXs1>shurk@BTH&1bu2RpxHu#YOGRhSibTT4&{j8;^g`t zZQ?)(WcF=!yCASC8B2kg36hIw4*EZr@d<|oJmS5g>gLUW_OKX^>L+y0+(w;$z1YAU z$iPB-$^qfH?QTFa)2V=yi=zEt$1#sqiW(QN-!mMYO0w_=q#;G`ASTt-@1pJB?UGUJ z){uJNTABCT)$l5PQaVrW@us zo`LL&?e%+9=e+d1JJX(Wr#H53P2K0TN_p|ZI5B7Mqw#@?p z+*SSgqMDNN^nGPD+iKLIEjEg`tEgTP*x7S9l1`Dzphz+L11%gALj1w79?YSFd7bNC z|8bTLt?L6)t-1$Qv}f<*O&k*e5*9xIl3i30dJK@JZ7*Ni09Ef-ywUP@JZ8ob zWLQK=T;D|lNe0NHOp`jg9a}Iitz$5;O{TU;4Dq0H?zio!60_){aO>7=GfmC3#eUTz zf>J7@{MNjt8rLH0UgoUuUE$anuj*@`8zd(L&um-8ztjG&YPZ$PhV}ZSoIi~d%8aBd z{NjKgu~G_ALSTv@vt}=gw}{1jbr%e8s@Se3z}n>()26O7!iiOywPH`23FJ)~6xnPh zE&ZpK41cqNY6E;T!UB(&K3Y7@@ zl-GvgUD zu~lO2H0_79ize;($wlsJ4v{LNnG1f((%l|kvUff+Bb83$*EQ(XT42xF>`;6_15c6^ zSvT%A+ZWtqY(3wL(5@I6I4-pe^KR}4uM!~Dr;xO_qYFJjAv;NAe4us_n&{*^;*N~a z1|T2qGG~LNz_@<9fo(U83WVV$l3YTka7G>D5)Mkh?Ka41_K@}I1eH?tFZqOZiqX;LEH9Z3L*nKtJR~w4J zt&QE3lYX+5ILoNlJW+v)opqEq6qzbUtk%j4y%m4wGs59NPTw-KTecVENNpk^?B!k4 z{(A<~4xttNx@Xgc?`k}Dn3miePA(O?MXx2c$_%Lfmq`JpoD2SrYg!I)r|?4o{Qr4V4TBUFD`=MknBv z(0nh3yh|z;pqX!77ak88>jpb_uy}e~7ak+r5%!0MqFOBSAwDjQLn~>Qa4{skYXC*z z^OZc~Rx2XsgyqkqE@s=YmbSa$XqkmZa_8QLR*#z1X^$e3+0%r{xv7%b$EYLn+Ol_N z;+@=Zg@7takhchFhZaI0*Q zgGw`(b8XNWE|pni0})#EdUyR)gTF(S(vPqVNDFqRi=U-YbK{PFU0dzXYKbsJXr|~h zu5{2p)pcspkm9A*%`~f1g5*5>fSg)ijXUmp{HFszf6~sa{UH$9N&R(YnKNT(JAe>j zet26E5o7+&P@+G5u{Y&Ephd;QA6xRZb1LA--n&73b(SF6c&CJ%ft&=5(S=@&Us4np zcKYcUs9_s31(6b$34#|l7N->J2iK)y>YcW5wBD@4cnI{?5AZVaUj}l=<=kk?u@|Cy ze6=__9fyiRSDua+CldN%poM$x@5qx76zBxGK#pIIxwOYJ^&|`eEVppN%F|cH%`Yz& z6nK@&!U2szbg0MV$g9W`Yz6ojDC9fDMomq8{5Y`4qz*0aF@ExFXB-$lG4rZ zEx=^70*L^Tv|$Tm#&3z7?UB1sIh*RDEoNqx5PW{W)O`)dY_;gbgaXTBm_J`~< z(=MGWw=$V0mb_Q@x_*9_U)Gb1nrcB#qL<+mp)XHZaajh^ZiwwYJrCn7za z|05%lmkCt`m?Kp)5+3`wny#so4dWIs`4Nj7Gg>{!zoW+lQ6S6|K-Y|r>X`z?V}BdH zx*KbKzOi?Ij|WQ-s8vs7=n8T*27A~b({jVWl8@R0*mta@=naSSkv8fFFm(867Rf5c zfv|itBY-l)2*P=`fSE`}Mbg>??>^wu@$D;IB6ur%bpe7=@xiU)<*gMek6jRF$m?XA=mP=zmvO~lAkS8knK3jb9Os;gMu@mXUuHI`nXpr2^o+W zC$V7Om;SGSVP@e49;L_r7D(KnL~;QR{k^s}{{;~mJt?I%gk0Pz;#^p%YOd?k&4Adv z(p{qJF{vk>lJHbKKB5`xEaTBhd+x_&2z2TUB99WeObo+>RJg6Pf?h-ah_)2dp?YLL z!>%C~BiIrDc|}i~=(GxGVv_+n^lkI!j?-KNzUNw6=yKOtEDtA8&G2Eu{sHy(TSaCF zXF&17_alU!JL~n{^76A?hF>L>(x&*0qe^0t*Zx|Y$%gn*_SiiaQ);5LQzj7M-9sDh zV;I3n3^849s)yL{P2i&K26Zo2AYwj)Chp-kZa5>tJ}N8#FXPYZ9zRAy3Xej%83nmp z_F92rbAMW9VWRO#ifl_c%jN|xsy@iNt2Mzv!EA}V6)WThdk-H4$G}>j~rSN9bhjTlrbP|e_ zH{o+GGRe~_W2WC5GD-IbP3K{?Omckq=jOko_{_fBdJcDfwno5WFL?0b5K$#Okl(rPGoYiLfsH^ngk}QDAmnwePs5K=RL@_h4Se z)x{(3@yq`KhC5WPQK%;3Cogop`_7Df(-$1QuiUKU!My_3_~*Yb7B zm&ii1&w`w|a49T$7}Y(}Y$T*zk=BcuXe2AjBQp{z8ntOkFd&xRN04*?O`V+TKyy1% z{Ug)Erfw@ce94Z&I}p}?YWfj`8aiQ$$!VmvMbMydb zCcRgSOf@A6n7KLGrl}mif9_JpU`k1S@4tDjfvLc%wd|05saxepgk)#=X0H(S%&Wm+ zG5$&Z3v@e8=r&Cuz|KUh9tzn(t<0!@PJ8^+PEm9CAK&_=0{8lECj4n|HD{qKNPviQZmoRC9g)+G@!l!@LRyr?+yV2PnBSFlh z?QcIjW$KEuca+lO@VG+lw8SF6m?T7A31?95=+20`_^*af0x4=-#_8<3Gm233gd(pa z;Jv=`7Q`fb=f9WHTDWlIxI+;S^-z+-sjzyGRm!;d+b&QpSld8T5lELXqUOR=mNKA= zr=#K>xeyHF^kTC34?Z-$4{PFePj;|lH<)EY;V+w+nOH(LPQPMdKC?Bz+^qBzvi z;_f}J8J*|kMADy z{QH^S{}=%F8NlK;OWBYlsWr^3eeuFw9A=kzhAy+UsquLq2OXe;7|wb8(3Q-&XnsGl z6niT=lD(D=-vyAA7eI;82U!p;fEo^dU|DO~!{Rc52X+&pnF*4JTwa2!&O@uq*!ep zBmQCs+Vh9KxY76lK(u??_*z;3kY~J&xX-tCQa$f{a;;%2rGd;6vVM5feWy;!9Er=& zmbu=}&ZbGXouB)aPEmsjY~L9mlxwA-14oa5y}y?{v&e?VnngpA$dtn_9#6OX=R z$MdON2H8?|YU;-R?>MM`p<`nck23!*I>s@$byUB}{rmdAsN*Q3NEPrdfii+SET92g zdCYu^Ir?+b?~!UAMZ>h)slF*(dAqc7CFd>6?78gxN9odJ5t1JV2G0{GNk-g<%m&=o z8N*6N`KV11idNhZ&51fYy5gQFL(iS4=+{}$QIfp{r|H7*ow$#J5`mGq!+!Z(t=4>^Jc_QC2<|N z$bd0DpD%$&r_auDtPj?)5=l%$>NHX*6#k%Bc_sY2=m`y)Glj zsyIH0A=?L?VN>JtncV3tvgE?^;~RucojW+4dZ?Y!!A&_sCRBt26*^;%kmvEnI>`q- zCKgFQY99@n_%zb5D_4+n=o`(mhAkP+b0+`8EB^r&=2M>d_fA${_?VtZocdGKp*-laJemX z3qB3U4!T#{L}Tha{=lbBO+N=C`4S|qP66$BMHN#B0jR%f_s6M0i;i@_O=9f$awLmT zm=4_cBM-&1$qBNtdEHDG^wlnuEzf?R2Fg%+qdxxXnL&WitSY>RzsOwkIg0vV%E?nm zG<}eQ4a$>IZOf2x7ljO_F0Y+zrSA9E<|mHu9?u}0wn)4xnjv@B0t7p&-*lvM|BEQX zD_s(s;FMX@?4+RVLf7doai;$IFa!{4gt-`XuFM~~i2GmSYPjCYXneks zz=w5VFWtn4XSnOSj8VEPN8KS^Nmhn(XLct*^M?7*aGLpMG}*e0tA#nlgYmfEc!xCS z;$SyjY}D*?nENR3C{-Vw}Axuivl39v1 z9eW+z8hthV2FW#MTF-wnUO|@2KF*FmMxLA0>v@vOcOV*7SSWF~kKy|R+=kSJvvI5? z6z+_ICd!PobHIf%A|Sw4D$^Ca3j&Z&vbo4rj(ufY{>s0^jo_VZw=3tbwK z`BkM$vyCmb##2T;fnvrJot+<7hTHS6i=^UF3;v-Mkg7 z(SOxtjnsr!8hM~tIcP*p#Q%-jcQxPgq`jhkwX*#Wun1M z6HctGN>du?5`GaG_d<-s-kP~Y$0DVvs20j8*~d%i%0x$qC~%IBkf{6@v2wty4p=wu zQ9thGnq}oX=(p0UO5oo_AQj}*UNG&!wTN;U3LEiDH9D`87YkMP9-}1sbF>m3ZbX;jCWV=BCPb%iMrL=b=w2 zxsgKts_0Af1}M&P5;@uBju@3D8A@opCVA<6Tk_?bIHBItKwJm(PDWBHN2+hv_WA6K zZ_gIx(4);h#=O4K*53(D5bw5iE%VKD()3>!ldScX&eE6+{&x?U_PVagR=;RbFnHWp z;7j29$nfz?U83{aYN54f?e$FDYAtqwQHOs6lxFJ&I9z+{udKM^q0!7*%y+%khJ{Cl zk=0xbuPIwXH6;-SFtS?CjM$1i$pViVI0T|H*1wV$!$__0VNXIU!tmwr{H8Fb&zR7N zt-YslQDI2JntfI~E!OX^Ea{|8mc-|A(-lTE7X1z-7e*-+On`WsDs%BK&Iq&F65)m! z6*2L7KSvvHl7>fHGu3dPCQr*8NR+ViX-WaKpWd~0fE8eQnLT^TWwU<9l%d!2Wotm| zbng|4kL%Owg{{-{Z!7?RT4mX|-&zKM4~VzW*W2`~A^cMmdhTjx+hjmf0z)!q7WH9$2NMh)FlK4)f_zd&mZkx%%qr}=#D zgV4eXHFTjW3#+Q^-+sS!6W=+~HmqfOqAL>ql%s<#MUSNDKlMWguwR6_gix~gUjbio`>FTACpLob_HcV}K`qvbThpU6XPuQiA7XBM(u`q3N zbm#rZ0Jqtg^c@O+c%E%`5cm8WCzYnc?7w{5w5hL4)^9p@4g^~~ItRUbKVC(V4sYk@ z>Apque9)j0FGm#g2?v~L}*K|1dy=*;@<@$hq15OQ8{7#?Y{I4}g{dgl`t)%~a z@|sKHs^i(A9ilzS0c<8cD+Hq=n02nnt21GPGG^wy;s6guWZJS=8(aKZ4HUbb=02m& z#pbS~KihR!;bbG>~akQyikU+bw2`Q)QFaZMc!E+`LEpM8HZCUSdwKKgqilYktEw5W3eTamabQ z&&hE{C&(Nl%}(U)C##uTL#pmuf=qW5NIAQ2v0g6V0?CB+D`R^1rm}O^VNzEl(qZlP zXu?a%G=a|*@dqWx@sQl&e;+!Fz-rUueefa~(r_1yqJ6a+CU10R2EfaN{ef<1f#{`9 z)PfXxew0bcaIhV<E=7k{t%T(TFI!>S9;5YIM$X8F_k$IbM0RL_g^mAlBp?&Fb+Ncg9D z2R>`}?f>EFE5qXIdT8H5ad&rjic4{KiVp5NxI4w&Tio3pio3hJQ*>~5?)1CQz4QA# zXZFd?UP)H66MVrNRiVSq&(7g&F>Aq~xQ{(0E|-q%i>bEtEw4LPzZVJ=?;0px|Gyb= zSkvGO^JH~c!WI$W)+xRY#{<2{i%@iOx|j*JScI?Y80+CtjIf7!q87}tbKl+a)cBqv z%RM7vXquX6Y){HCQyW^w50HnIrP^$dtfUNp$q6xhE~c~I2Lo+cE4664T@xyhjHS|g zfF;NZA`v^a_AYJ9hnFQr;~1*0OeUOCEfF0qINg-}mD}mv-LUNoPQVY?t^1iyo{yVR zGnSpXWA#j4=UE*UGc?Qj#z@d$-^Sqd&+zDJ`Dssevwt?c8C{KGSQuPNnub}z}XY&&%*XO4spHS;hZbj$LJ`%k*cuNvAn?T- zq@qJ{QVwBb&r09d9?$ug(iP^p1Mb-pNC(rx zs$?Fy@gwYUGt@1+BVj>&nEB*cG6n7H%aSGYcsASLTFzuX&!+tlxVL?Jyx(_GJ~Q@S zY}eg)X8k|pCw+;%j&!bXKVROT;&Prax85&aHO~V7SCBp{yx0QzCP#H5ipL=*f@h>} z`=u^5Bq8_&D>cnQJ(`V(y&8F4eWpMgw*Ws|B%}C#ZRT?D*I@TT5RvCbCZ~hF9kKT& zqg%sw(Zz$Mth^@akj8}2* zVB|dU2tIPhRgUrg^AMLX=ojU%UMzzHqW|_Da@ID&XKMi3g{(b95_B%X>zFxs(}Y?~Z6hk8i75LD2rCOLyop)m5S2 zR9Y<3dBez=R*tX$O-7nwAkizw6V`BYFcS(-Kf^K!(W)u12=-kgrjRAd9J;(PAuY9v z3gtOy`*Zs$isbz(vu;bIroJa+r>|bi>qP+*iM^9Ga?V>#4#S6UfA6Npao!&d8|T;A z{@mc5Rq$7C+IP81oTvN?nxvH%FJx2n@*!kvki>CU3Xzk42=nQpLLEzMONSB>Dup>F z90#P03`Oo)rU!ltF|6IIPsM3cA;)a}2IH0tNd%lp#n(;>EC?*N#s!R!RnynPiiz9S zZx{=3tR5xBLua!StT-K57RSps446?Yqi89L&Xz8_c2d|B+8eSDnrbL$t5iW*gNMJw zwH#%yUoRx(3@;NuJkD{}`uCC5$q^T*!Hj=e?`&28KI*j81e zZIQR6tGm{UlFPC`MxIC5WYpK!6k-poR{!u`S!V#A|1`}bvUdXLCV1#nd}6Lu_PoN6 zrMON1I;)RQ<6e-qtd1oN*iJg#8NiPY*U{Js!@oy}(6c3?UZKLTaUR8QdrGA;P z_6V+mtPSE!fu1IqX})J_YhHUK=kbXt52+k_SS*#O9*D`0@L{1`V&=&Fm{AImanmsoQIwiys!sID5c!XU9W&Y}wT=Hrpq z=0`F#x7vylmE|*YM0s4qVu82|1`N{Yhhj*0wh>Q?i71x#Ny*c?^&j64y#}>qMY-e? zweNqH#(IyAk&%Fld%-^v`Ub2P%>rd)Mp7SD;=|Fxl0Tsq2nuh~&0|K^m~oR#)N$wH z?fjof%`yDyNSZ7s;g^lM*~@R@lPbck=nCNxs?B?@C3$Ml_MQ9xg@)0~J>h#I?1IA& z9`-*3N}WFFz7cenm!mGQ-|a8g*`nrw?kVGgOv?qzNd2ldU^80vZ4AM8HKHiXeFZRdVlcUzEkaW*}_t zN^ZwcfSZ`R(C>v4e=UsfaJW)g>L@e*dHU}zg0%F)3HR4t>_O9!Jl^2g!VXsp4_GB$ zqtwDy=3;I8%^5+a#B%M|O)op*vfvy_4_mHX+XHlHIoFhPrpqn%O&5Zp66~u#2L8~? z)aD>N=erTbw*@ixy`ESVBMaJzK6^WV~< z*kzEE{`M%=sAuLDI&bn(V`c>+=r;e8nWPAfNcJM;DT9He>8$d0 zh40uy{g0c$8Eqyj#XsVObMjT8`oRrclS4WmFt=tj6AXWWNL`R7T$0z?j5tJv)9di< zzGjHb)u}MLMt~&5xZ&URckMZ&@ zD$>Qh-hUFc5b%1F|5054Wb0(*fk5k!Sj}Gvq_$Q(pZ#cnYJ*s_#gi;pp=#r8g7hX4 zM67{=1;hi4X|4H7W~nwr-RxU4%K4L#$muk88=w7a%{u=ho{R2x(!Fb05|HmiXzzPC z-ydETu6}XyKoV+6R-)KF>~W<#wk2|O>WKPa@&1+4qL2SkC0x+Qj8)Nt;ebSAAF38;m_4w!C*&35+#Stsf_%*-ALU%kBZjwhrT$B`kSnqpO&@YJ-L{d3wj0wJk6S}P z#SQH=fF>oX3Dv+q=0hGxO8MtDKX** z8$+JlVt={{_+pCZDbw2G{U+APG{-De`%j@`G^YR+o2S}5UU*K zBO&UW_-t&A_FP`>GQ-%X)ut2P&X+l*Z-f3+`}{ z6G@3=(W-uC`zL(oybqEGA?cb%4mku{&CH;}hlu9EiY(x#kC+OTZJoj{@9Ir39)hqe z)&6rl$Hn|R5I~7!G~vjMFJhUmUZn-2M~=|cy1FZJk!vrhuY$ps_EaC?fkXUIa`?L` z=E-+aal)XEsJt4=aFH+0HYst>;rbXtm)#HbE?vX1#@dkx-AJL9vNYg*F>sjURrbVK zstj7ubGk+Wj-_q~0co^Q^524#`{doeOv|qBdu0uc990CNf;_z(rfkHlwwxprKp~63C!HN`@`r@mslddO7qZQCg z&9FqL>Ojeigx`dPog9#;?tNCFnmWr=jqkgzp68tS<(eMDYhYQlrm;`AAXo&2v0A>* z-Zi3B{RS}uMdYNKbLwoFNK>D6!6N6*i>X@BAFNMj%q=lo`cPe_UXls)npnfRZPH%5 zgf+EHTQA8e^E!5|w+zb0b;^c+$wUpM`XX|dA^xvGgue_Ta+e4>`Aw$(R?JUp3aO4a z4l}8!K(k=o^%&-`w83Lb zmG3KSlbe?UdOh&+`S18RUyj^{dOD^uEtC6dyH;tBvqM5akA~Ya)AaEdqmVMub-#^f zdg{X;+0bI!6-cdmepC0_2F5f{J7?!wVaXN~g{v;$XZ`tAorH(?r}CnAKuZn5V7s^H z;T*k+_-d)H-eB9-T$C344ULY3k+V7;;uC#rEbaN_8f_2q&F?d>uI(?Bb+qH zZR)=>UhT*tg2#gDGA#!k3P$N*bngYmHZ9!aj?@~GYy^x}i1hT{Q(v9=vfATS zSfguulINK3%~cA?Zv^|62PBUOq`EG7{^{NTF@5)UvHB0;TBgWJ_X1;%MD?;efJXHq zseX}oW*r^|3bB~yt0`q6ZSD95ec$UnEi_Oipzd^LysWXv0K9uv;Q%M>nNt9u5?W2;h4y(XFs1J@ z^XWJ~JNml+Ha43}NF_0z*1m z#EcemqPUsW+9T&!Y|)%wEKU)P3m)(R&SIU*|6uraBynJMo8)Q2O_C$yH;;a~n8nhV zrv}2kY~~CdVeuw_i3xk9PrDb~FeF_*d>&pije~=s?%ovQh^g`i+mn$d*GJ7Gnwri4 zk&^Vv-Ncl*-LlKw*a_*Voqyf1am|J!E&&SWZF8d0j~+C-eRB?zx}Mr=RJChs*3lc! z<;?^=wQ!eQ_|Ra$yF-tY*-H?M#b6B9@1=yVIV~2rOS_f1%CwlW>mt~W=a<^;xSEJP5R%1+JanWfeD%dJ)gjR9_M zF>S#ZjRkmU`Va_LXbN<3^8-@!hCNgAWX;Iit+gt<6!bV}slRz*=H)p{V^Yh=Wi20X zWKYifU(N)zsJrwMS#*ki9!PU8q@8=d;>8T~iAx%Iaee;)&6p#BEfn~V(@{~Edp~#Y z!sA@{O{Jnf%ZAdc81L{oBbAoJv6tPV74|y+P!?^i_TRp- z@xj8h2o@D1XM5p;P%-<;!7Q@mmOx*bv1}_mzX4@f@!k0(ESSpQkzB`l%hGZv8$nV+ zf-6KcLQp&c6hAePGFoI}hF7{kug1wi&LpD?jcPwI44f6JVSs)Zhij=aR9>D57UDja znuYsV@DZhL)MkxQXwGN9m#l@Rz>V1Qv;V68)bxD(m9K0T$0c}RzVR3()h~<0jX%7W z`-2B3d5&#B&sSpQ{NFZ|N#E!)h#tfw$`}q?sqtv(_cK&?PX4vGV-u?a5~X)_@)<3p z`9d_)r24eBpmIt+%F{rY92fIonnD`~!A0vsscK;~u5JxB=>|$1J9c*`JsQ(Z^mnp6 ze0v=BCW^q2JeYE40(sg8aobGtyY=6#2g24CV%?TESrW7UcN#eIaZvL)>IFR z|3deybFHduVSh8{XD=UzMqF95Q4Xy=-Lm|oN@NRJH>bpC5BL3t4hm0L(Um^{xuJwf z+de*4&`$-0YV`4|%rXPXZ}BUq6VYy8R#9b{iS&M!QM{5fkxl)fHMi{_N2;5JFiXPI zD8QOrRQNG(U>`n-iB7+X@%^&y(T#$4GLKxm`CA}~k1Zh~`T0qt=PNQGN{*rjT`62| zKoE@S5!B*QK&X_IHoUAk{Qs6B%{^62U#W%flX8==g?wIq+LEJOYd?aLh-T{gMRLv< zH`os35iiK{!xf_1s6PjFWG0%RlKHG8ybDn$4{{-|t6v!$LWZKQTbvCuKkWIl-?2`@ z(N^-tG-fsSADLbsBz|J`iMRdx;=Nc}aH~HXaXWJXL~PDx64|>EXCj}soYvyRR60ts zaqJwu_+_dA-(M*Rp^qYN=H85(joSsKh%Dk36?nA2qAQlUrAxFculCux21NT#b4>`Q zEeYu?0+=iao7n}A;2L*lD1o+mUlYO`(End80DufpM~9%S_@6t&A~<;e^P=f^t1i2u z(4&@;Il92|)9P==1eG98HNeXSLE-tvaIQp$x~-6A9|cWIe1Q?cEE666vBx0bH61Y4 zM`}f0IDmc}pr7KletaGh-D1#T`~6VJR0$gV_M#Y4+Un6ug_1_&SWK#R)o^{^iL1GUq|QBuHcWjH-O?5+Rn1r0 z2G$KAU2E8f`gum2j6sj$#u({>ylc&W2b~D^y=lMfQ&tzfm#=iT8vE~wVR7ZpmL?=6 zh4eyti;nLXJq*Ra*<}u|5qNGkN0? zgal_YO~f>B^-BT}CI>5%xj+k}0_B$5$FoM=8j+4OqH9Nej#j?;u zdm)zo`>N{ar-^vHtyf>#To8HNX`nxSJWal*XkO0ro=abmRluRFDuH!J#NJyPd+Y85^|wehf@*F9j_A1NdR?1o!0m;qvzgqN0fnY z^mOc;s}{y>D1?+N}8Iv$k!UV(^>?jufuS;6CCo(nQZ#F2FKk8c ze`fg#9`5W~-)buZ88WIhtQ>h1WA0_H(Kc%g;T{}HK9aVD)2m*h`O@s~mK6Z0)1nRFfhe4IeTs;m(7x;8`^&>*%zr?z9dAT8pKkKc?-J9Xck*@@`IEVV zFbhjnR068A`h+{<(>`=kLx&d))^+x!P)jS@sFxJOPy{U;&#j#Lo~Gyr(7dP{Z*|$N zXe1MIjE9tSyvRO=8HQzeL{aR1b&HQ>U~dc$?+8a*vi+eZRuS@$I64ze1S#3u^LmEu z$;y#-wGNiiL_*L^lWIkOFk=q)CyOqZEBP;asE-eCfw3`LB?gS7JtMaC+v1EvUZ>pCG`!C`Z}Nm5`^IHu&skZlNoa%pj+{-&B*xi=8W`kArx3S@zCNhhf7Hr z+#pO4BASp94v(@Vr;-86?m$H zLyKz@rCH!#kmssJgCK2};D10Oyj_g=roZ^5iT*O>mu}r8d_eg_USt-sTXc)^M$>CY zuyE({TnMK^2^y@eidqs$x?pEswjkDN^i1d?TEN?a>gDcPLeTZ~@HAht|K~eI$Lj_6 z)3O<@+7H;g+cJwBM!G7^6#NH1_-~RaDSfuLF%*cKXoN05Bt?H`Wu{wIVI?@(2&! zgutj&jS3Fd3N^zjJA$UnzQ74tUH2Ux$?R&!N)7RFWCSbU0$S1NTI^3KG_kL_{+*j6 zjp{~KGr+v=gQ0i?VB_2Qw%a<^(|t-vW^L2$f#$8lDAf_Kp#NQWNuAZcQtJESc*l7r zpL&F*fiH~vwkLlw(>uiY#|QeKjW>Vh^aZ+F8OFoi)5xQ#0P+l;9tX!tH_bYzGIAFjW zVJMS!_&!XLbQZsZ(o|F*6iy-9_{*msi@=>O?*i)C+NPo}U075Y7q6mQ_TUA?{AFDG zdLIR$RUnR-X{cBMRSDYC} z)Xr532 z5)q`c7FI&|TSzP;dXOJ&Ohl;feKSDbDV@C5F~J*J5L9G~mfrX%8&j zB>npJlfb?W-o8_SU|F9Z>#~cR0O}nY%r*$-$EmBR#I`(fP*TEMNUybj(nh*nik2`} z=L^t%Ll}-rAtmdA85@ryWBJ5Sx%a*C%I#>RWHb>2e~g&;fbM$3fANe&p5QRSU`7C< zGScsZabq1{^E^Ny1l9`8`wL#ke1RHJ0^`u)lr>&Tw}0i7#5NRbaI`lq7lTtDl-n!X z%a(ZC+diy6FB2^ij9i7VL`{Ln(ha?NFrRytM3T%}mBw!0BSqpH;R))^mk)8acS`egy6AMKiOr#<~XvRp1k4-dQhWjhtLQ~R+V~+@STs+7{ z%TbLs>G&~JSxDqUnh@h#PEq`I7*I7QuVk%@4}>0>*t5(hz`-a!lpi3|$}r zA(5Zq`!YD$aWvUJIBmg{@@+eWGB9{Nq$uV~;k?_Qhk)kxr2LKG__OnC8>ZM4{9f^MT)=U(OnGzPVV6j0^{h=6#K;^{!qoDl(j@-I9(9 zNZi{E4gOiVjM*HikE>tp0 z&Lq)otHtF|zL3WLSwl^q>#|;;Is-zT%LyB!?wzaja3EL!Daqt)H{R$z3OgqooEQSP zZKMShzJ%Dc;%b+IDxp~G$bF`DFDKM)lL6Ak`s!XpfUIIyIunR7L_k7$-<{L?GpELX zImE}d?SX`8g=}V*1%bOMV#ZE-!^D-U0F?Ec8uq?t#v<(Gyrn>R1fpt$SGE)_sF7JQp3a#@yIP7}pZXF3 zECIeBRWRT9$7>}S{7DOq6B2XY#oi{MrWWBB(dL1&NS^&VzbEvi;nzuPRcRP<;72i@ z-?<#vN8SC&%@|y`?~Jq348ii@4Hz*U{1CgDDT1jgr-gAvQh2(kVJfX;_h`gUb+2Cp zo$wqnmChyRUd|@yaJ1XAwb@qk3EwuG zDI#CcLqpd{T;|g*tq8e3+Rh)=2gf*Y7$R}48o-6)O(B@hV{r*BIzE*#hRTBg19e(e zj8^~iFZf~B=>P3bs1eqO*h*(vjVz1Ds~&|A95t9njUIN(DbECBe~{hgHkCR2qx`MJ zN(0gC6{O`Ag&(){W|}OdO8b9pb0p&}aT9(^DG#f`W!oM$yCUs(tUT;w7OG-J% z$%#UT)xwX<1U+9+EmM5q?O4vI;e-Y$2EzmY#bYw2kGd5L^ndTCMVRl^ zV6v)-R2=7jvA6mxWjthIy0!?5qXXFr%8pr6#Rb}iA+hj?Si3ZNRX8No&gJ_ce)}Y; znv{{smR^@bi4m-#VVfd>uEhXRt0DGNU$QJ^!TV76rKZI#4ot3%e$09cD_L5q55}|k zS=!&7BuC^V+lTd1E+hJ612nUsUqm`vAKmCaUwdPZlQ&=sw5@XJXu=yxSXUey@}e`a zvFy-AFPp~Olm}_TzO24r?-3xU(xABU38f00L2c!%U9(e{c+0bE*!ve|Mi; zcA*#W6v#Laq!kEbc4Melk_iH7Syyw|juUISiGKDZ?>S-4c`#K%>K1FW%#-`fA9#U1)6<rAnCO0Of z8=i#9VQSJd9e=;R;ychGuie!-HVMJnAmfx#0Vq_+M>Hw-<-r z)!=N&F*(EGWodQD40>@#(~z{{xX~XiAXGl#@dg{5x5dN9EGR#M2Tdh--WJ|`p2DBD-bwiR93S9&@5Dz9z4z#gmN~yhd@Elq`gv5suwFnNUj^&Fuk> z9*!-xP|WO17ibLU*2LV8Y%}%#X_swFDPxml1o3;jGmET^=#9}IrP$%e@#cK4u|DxP zkp=N?*auw%vam;O7chi`qc4&@=))k?WLuCdt5Ozksah}2ydNoYuxKOBm%9q<*&fG8 z%Lke-z?Ra)hN&nW-GjM|W+D#cmsfFb8~YA(s`*6T&HC=v_;3J8m7c3_4q zu593GC-%3pSs|ly?@#GKSY35R?w=k1(u3r1gFW9MOKa`=T|n`Xz$t?8w<)U)Qd-Jz zfqJ^pxb=zu%%Mp|sQ+#Y_hAJlpvgxkanKGUIr!TX1N?_lcePyz5dDAa|17%?^!$T4 zu>!R3A8gT+%3iMz%rWMa;{BK3k?3Rn9ffWcpSdy+Wt($GD`A+F>&uBy3eX{B?fnW3 z9V$Z6?*WT=RE#AuBdlVB0wW7I?1B@4#%;tBJ(BjQ%_w*&CZ77Y3P~Fx>mQOq(pS?V zkC+Zyfhkp)iU+yE#HfgH8v($v7PfY>1bct*cUwXUa&mQ|_xdZ*@$IPh2PqHf6QqB+ zrUAaY$HYAdIE+@SIpyfnq?oT&e7U`3`r72RMIOMQkeZozX(oSSHv1;ZKV_hyUPk17 zB;L+tW`kgrunh$O!tQtLi*=P6&VR2$R?}7ePHIGM0_`T{D_1V)&y3#6QfY_-38#5~ z6h7uo6avqpwo4W$*6-|Lkc3-ynf^Z*1~0xNld&dtEg+((1t|Czu>lSQka%Sj6q+dM z``;rZ{~jS^Ny+;eoFhvP&^L9zbZ_ZcyfQI1F%1oCM85+s5@YYebGFk)R!s08ZE1_< zL1ZH<&qhjvp>?jU%8{(e?O;ScJO*?qeQUJM``U|PSq+j7gLN%)Tz{aC`jK&|jqIZi zL`*4tNWNT)s>RlH8EtZ;@A_ZvCU-Br4iJ|193 z2}Hy1Yko>RC|qnGzuZC|@g_2Rf`>udZ;Is*u`Am`Fki0_ekWVKI;>vB3#(t^Z1jYx`mm#_-{hLlh_=de>BB16lhH z^%F^7K>d}owQ4k+fu-un$>THp?OjbuROEl;UjYhV3 z$~Qe$@sfL|uV5q|M-|!ZFhWY#tUkb+^8vS1uopT7$bJ3eb(f}$LV(ASr=WWM<89AF zf@#H2(+y2{s=uvpAEA%k%V2Gkm&%|8eoT7Ol_-`4sl682?M1xI_qN1Pz7P(GZZe7K zi>YRGK9QFXPuu*9tXc;hF)G&ZqVJuH-*0uA30TQ)d_W}Uu-2D9GZUPIQX{H6jhX3T z2}RQg_7Bzr!>#+}<~^n}wu57)Y71oew+C56I=mg=7MFpY;Wn-Lx{=uh>nSTr&60=+T{HAVFG+)Q)qaI|-4#Ji#H}qE79t%NURzh0job^w=^FHLp#-vGZIItE;7=8_W72G+0cPaB+Sru zSIBkApdlz-)X9asHUl9lH_K13QMDSjMF4zq5?7t;`|6_7V9z8G)Tnb;?E{#Qb$Fyf zzqm5EtP-Fg>c~Ijtz91Uy^l#snllA9`Yg_b%*kD_ z{M%Rg(}~RQ{fPF|fL{Cp%XjVNN}2Xs#K8{pg3yykPZHKa;EGX$MT!9vTTH0+%cLUO zB)Ck<==p*ocG5NhKN@s|t=1$7xTgnjHfQ2q?Bd1B7f2PX)i_(oEXLzUAL+$>kyQPfSJe7>}cl-Ki z#4F3kcWS@BNdjE<1apmwK}JyiWKG8!!AIF~Q~5U{mg6v;9N*pO9KpGsiKeR0GC;io zb7M_&rK}K<*zTZ?jO~ICQ%kh)5aQ3suXP=GACp0(vN$f>lpE$Bp&6?x0`tbfoZRbosb1hNY1b8X2)RW2erD@kJ2xS|O~w;4FywkerG`T%!-w{T%G}PJF=H81$v{KPGDbr9m}f()ce4 zuIk}%@B$+XLg&j}E0%ma1gp3jfnrOwIg=p)au8X~9+qL407@YW#Drw-Zm@EJZKT!w zXV6CW>eEgT&H9V7@)~L3jd9_S7J|qbl^f{NYvrgJ>;n*jy|f{F;A3ui*Q`}p!vZR* zLY+4KtWu#@_ir=+=@5ZaXju3)puvtC_rs&A6Aq~9P1$@TP74nw0Wbd=V8|X8r1e^x zRNIX56Lef#%*L9L4b6XplzWU(JJ~o!zMJs56pSRl4MybXM4XDsW)wdU9?M12FXP=qHGlX3hl= z59^4eNe6rvxk?tH!jv!*RbSgksZG{ql!SHKI%ko7bBbwZF>W4*>e*UlCI(8VpyXZ> z{bbv6_O92PwGdw0LDjJ?=;}hFQOe%iO35tmsXrj7{p@i}u}xRNw%Klm0WRA~hy?+^ zRqoSh)95ZPbN0-b{?$7|n7gPmq1vdhcw|0aA?r7bqb`WhS+-;~zCWGZcu-eg1T>hl zM^iV9H~+mI>LXg|@+Gn0Cn=l;^RU7)GQ1Yfj*e-=8iiS$72J82mt-QK(bOvKR46G@-&|nTbk11R!tfQu9HkWk9m$N-yH-u&u*0A0!r8<1 z$4hRizZrWL?+Ri2BEo+iKZ8d&NTdA?22*8~_J6-3`P;~tO z8!9qV{%r{9hj_G_02#OPQt4)UM(CskhDPXhlrM-k8{+e;F4@FoIhJP zEN|DtC4i16lke{X=Pj?*G(3(nxE!n~AoxGdmw#;O`U0WGTOSFy&IWS7Jm=fCoQ{oV zqSDkvU<||CJzh&q?^H}1h}znId;B=c*&2%2gIwu+{ZCeQ?COx;U@r+JXDDBS#OS^4 z(s8p1XZ@@Rd>=Jj+3$SuvDRbMrc&#ciOcp4E(oS=jn`tz-s5mpv)1qe<_UOm#8c}I z2fn#^HCB>l-@8}#mtZL)hwV*EJuOuNyDQPXi#b}Xn$JH=ripUM;tV^$N( z+?O8wlf(C(*_t`+)PwW;`+w=0OfEKJ-`Bzl@wJWe7M~14@o~;Ya)5}^&YV+(XI;CFWKD!-SZ6$uM%4kAW6EMr3NJK zGdRrttBJTO@DW~2_qKv;M~Y-7!N#odfd(knl%~vU*^`L zNH##nzLgNTZ0~H7v?Pd?Tnt^Qtp{5XBH`0PT%uUnhcLa(;GIKf8+7;^2zgO*5$Vsn zr4xmc_p$qG^k$Ye&UMHHGyC*1%=+<`W|C&U5mFyhSK~KR8_y-1lga2ZD&4D8;hx)~ z@)X9FnujSu_0z@2X{RDJnqQEHGn5wyYcLe=5EAMk2F~VEq=$6Oe}v8ttGG&rnnGNo z-R6gb5P`CSm7(agr^t;%P3*GkA7ph4NxvvR;DMCb&*?xCaK6G-8Mwwcg3D+)*0;suv?c!0C(i0Z>CpZ=6Jo=xGrQHpo1vr z^_P;*ed=ayXe&snuD}ujUDd0dQAyTjv&NuXcf#jMQJ3!=ns!m9#qWIhz{PZ)k$7b9Pn~iMDRh?4z|&WoeMui{Vi;l-*;ZtY!c#t8$Qm(6ppoI?6q86 z{W@eU%<$J&{4Dhr5!o*Vo?mQZd265-$vC}o~iqiaI!M9kN8=+Cm_))4Q&H0rc zoPyc+nd4kCqY;+YHy@^n1IbE)pQ4reg3AX@rggxP;eM2@pC(ev`{08r;i@1o#pez0 zm+|SY{301)%NX`Jz9h7l#`Siob75eQN~X}U-rJ+&U)oY^_;UP_%0r9eB@~6n6AXp6 zGPPygWgYgTTom);SgMt?ME+djd>)pCC%CD`R{Kf{0CVaY`qSBtgg z!dm8Oxby+Tb46!pn>F2QTLZLM7YZz`s2Ki$JD5a z0VeI-78V+lb85<66aqX(f8EylOj4Vgn;G`>_+0#6Zzs6Zjxouo=}M2H$@ajJk%3F) zb0ze9IU)M{$lRl8FomRGLH8}>{&+XuJ=7>f8f_f`pLgfH-;?xTQD$ z&3%%Yu%Z-hHFre4ES_6ODpgD@Fi_P)nz9flE_epDHMogirG~HzxGDgYwh0ac1l%YX zdcPsidUdul8*c3AP(&T9^~1BhN} znY3Mprj(N&5%)Xlx*KMmJ&BI=*U^q2%F3i=eS2fSL!NeFbj%Z63Eau`OZv0i1;>5; zE<1-Mn!cG@erX*08lB@nQLK~`-t=iRwC2C$3>t|M)zI*c#$!heg7-2RsXb}=Xe%qN zDjTLDnGWS*o}Hc2u@?;F{In72{!nGT4Zu?_Q-3mCBGhHwwFzUgh{F%`zVt<=Dj9QJ z(t@mWeig(#-wa4Y*&=P5#*8F#p6!Z{3;8InAi9*<0`ii*&%!rK2`pp6P|BOWl=^iT zk%QTTB`{YVZV1|`^_cX%8(pO|`)T{4gZ@4JnyRwO&m4M}!1&v;g$^&|L|uq*iSy6O zrDz<=6i%JCM1Poiy%OghLW7ZR!I8U($)UoCq#jrwxVM|z_7=mv)hE}BoYJzg{tc4t zqh=c3s&if6Nz4uRM?~6Rh>z)>mx#LFn}dmn+_>_zEH!)jV$k;@etz!57NX{o-WM&} zRoLhAYmS%ud-uAjFrGPUf+6dN)7|C;O8Usyj86oRFONg@X3j15p+ifE%-eq8oBkBctH$1Q!Pc>>d(lT2-=cikasw=M7JBk2zuTC3o<5(WIF`s<-@ zz{h?R|DJ?`!KeG9X;$C0f!a(dS(kpUU}h+qQN+Znu_Rr5!9cTZjX0UOfW0aq`GPz? zXcBZ)2(!)Vf+yg*ND3+h0)_6{+WR%{{GLV=e7JVS&yVEO7}w_ERp;{&*Yo1=vtcY} z!mf@*4WWkyZ|0C2Lw*))y|RSeG(%WPwYP>}XQUVFH!&Gi-&;ZO2BHSm^n%GpYZw%j z0&yU39sA^nHoFbM+sStf^tapU)V*#&3k5&l6dkVaufN{Ne1|K)33q?~=Pd-oGdr=( zK<$jV66hU}We-`RAuXgB2B(btpl6r52Tv!Ml%Bo^aGMrjF}&<505o2S@u~c(Rc61x z$tBY82Vu=*e)@NSq-6#Bha1e0;OdgzK#v{cRsh(L6g1z4g!wvw!|JVwdhL=H8CV1x zvNt9*asxH|-Q37+5<+}+(>2Y2_uojcFB*1OjI1AY3mR9DsByGlsEIh8&v8x#S0hi51s zz>oO-S!(1h^mkE?qGE7ZhAz~g3Oe5d6Qwne$}>jVGtI9O{At<%r6c$h4Ks~_faS+x zR%wdQv}x%T0`_ZYgu*`%z3xYQa)X9AURL3NJRdM#&IaW|yq z{XDGU(}YReURcIqP|Jc!sGRcFnZuLp% zVz7wuNXY}k+frAw*{m4@mzkV|WxW&nQfv?lL)^Ns!b_{;RmA%w7?RQ`(~PMm8H5TY zM13f=c?Po>gTJTUQ7bC&4STWVR%4#D{0q;sccZJM5SE*7G+|@1H>RFR+Ul#q^@ZB& zcf)eW;``jV%;PFN%UizZ$gRxsG5au%pI`!RP9Q^TrJX19DxbgTnsX5S%@kZ?^ zSjYK7Zh7T?@jnHCli%^B)5L}A1%7O|Fm~j^(M9=_MtSer?%m=0`Om! z+~lnL;t^Erm)E}Zu5V@nSEb^^Nu#HW{(%Q9jw~Bi^%F^8vhX@mlKCz;b^n_Xc?WyM zG^U%LFcR^DNF{volX9*KHKC@TW!ayV8d9+nkE)|-rAD`oyZ`bdoADgKk%9`}YNUQ1 z+lq0rOOw9rcDUJXR+(^xw>Mi0Z(P{6EB)9bSgc$X-n^7*t#*@<(+FGluE2Q9*Zq3L zO}z?X%2OjtyT!7=Nbmgn`kN3EI_5QMADAKR!+M@#Kmuu`@LjxxwTt&8PWlZJC7>P#{*K zkj?Ff9?e+$<-M)XGN|i=I8k=_&=Tj>&oJa|J%Y6?GYfGn4*z0fB1D!QeUka~9vr$P zDZYn{1U3)y?_Kd_U!|{6#w$nyVDK5%5r)plNw-0%)B|XI;5`DCq|fpp2zDHGnRRy} zam-Dsz(yjEcdIqqb*m`W?x-OQS#~<8;<~j1Cd%eFJlyA;T|xshKKIr18IsZoVVSeoSvVES3C|a#|sbHa> z)&@Xq#DKkg840!5)o_7~7MuB)`i@=#D_4rxL(V|s7ka)>8uE?wPmMxoEvIf3^fdat zLW>fTNh>bE(2h^#-k2Pq;7v*yq}w+P3jzr0NjBdnlXra60(BQw08)3G3i%n&x+W?5 z6Z_#BUQat_u*ncX&pO_m#SG@L)MO+Uw;-vQ(?|9d+M{hw-BM*@c6sk{ogpsA#WJx0UWn%=X9Aj0d+j*qU^*o>X9j@qYeQkl zD2$mWcS)GmsrhVrSEv>9S!MnrTEX@CJJU+>=&wpGF|A_2u3+HS{0G~~^<8xEv94lY z4KFKXCTcTa?l!%}xkz6!v#!o@J=T@n0d-#FaYyN40A>mi9H+#(3G4(a;?E z{8U#TDvFEVzj&6PXPtBqSYxyPLp}*1Xh>d5HKL7y`n*fR*Lg>`r~t@4SB_29+&$D3 zR-H4$76mSLQ{yqb_cq3M72n{(Iv$<>2v-I&6IuzD88j7W{~@iuYp5n=+0m`V9eF`a zh79|ta({w)^H1(u?Pa9f^HW~?;(xawsyA;J*zVb7wA;_cV!zhFZ8fM{@aN>Wsy1Ba zvSvGf36DT>d?d0h^=N&Bs(+<~fr^ZskEr+-Y^{{>`TGXR%pPrQ3O(Du!mgfnE1bWe z^N9aw;K-l3RO5z&+(z;8Z1W)~>DccCrt%d>LfKKhIj1Kag0V*0vc{-0R8z8N4KnGe z*@5bx;RsU z_XFEgE1a0POZYPWeJfL>k;A|6Z^5Qgt`y` z3Zvkdcok@a`syDd8y-u&)_P+HK3I!Bpd{;O3GLn2m=^TG)SMROi)evQX!5vI0NZm&}s*I{O@X-ox0DTt(65rQo9GHDs zU?=#upDx1nH~w<`vB(JA3V_@U7G3RNRs;oI|EmsMPb`{BcA00)J&DglwKfHkSI*B7u&%zgn?Q;@= zn;>_3JdiEnPK9B^8^i$EHrx+HS<~BBCvrq`r#nmx4%7~4zMw=5y}w4IsFckL-H8ud zuU|(Lp?m6KgVc~ao6ipUTqZ$bgnEzt4K%MX<=;tah~3Fp9Bp6E^>}>6K;}gMxi6p9 zs5W&5v+=`tF!)l3yq=%Pb;QHB>^)962?CUQkFWuca?Pwvm8;}tvpX1LP5I5Wllwye zOvm-YTxfOvN<(dMlG_-;Kdi>ZS_tI@Bjk^4!;XrxD>P|x3#1*De=LVsZT(F0#x)3vE)EjD13Q5OR zf}BKDy5=GFO7r0s@ng#eG^;E{o2(WW>;u|E7!@Uza$iSlU)5Dqs%Cj5{l|OLv#1?B z+^dxq%ws8I2)o~Joik4#{Q3x4PA5tUZGTYTv?0F8?{fu>Rn_~WQ`Oq__8JH)2f5m% z&k*-Q_}H74HoV=VF5(6#n^4`D&za`1JlMr)y*E&-YU$C0^?BXwT6ZkW2O)m1;hw6r zhd)aM-Oa+-7LLS?)5bkx$mEZ2py#1h>Xccd@FqsYz!L24>PNu-l~$Z27cU3kSJZR?QXWhmC$Pf0)5pn|r^(1dcZ=9vsQ9?)y1! zvT_GZ**39`1rdQTQqC-ddSpc)ZV+kFs42O5cv(qUsRx>#>cO>6^5&c=iGnR&^yLQ3 zSj2Gg{IC{5-{Z#H_aA<+=4wA-fsoo1y=YjyD~tv$X_nVglTIFha#@T%{dx==Nt~)J zI*GskKgHrR(oYKwI7z7bK^L~lf{qGb+VnHeKv>?7EBN!Zs7}}3IEM@*g?3kz_al}TII2Te0>*M3 z3PbBoSMuJKQ;)GKk*8o+2C5;9CbY>kg}B~!U(Y?lJ=mJ4C0U5&oPmW{gZOAj@CMOR zA1#T^SRbD2NZ|TVLD9QOt#=#L-%+Ga1>WhOz1f-?TGxJ?^lVa+bRJ)|36-3}sp zuqBxPOPG6devuDh&BaG$ z?L~SB!14vzDbcazq*aKar=hC4@5sI06-SB!GiRb+#*1hwSWgnSTh5cNwW(b|qk83o z9s4OsKJuM!Wa$je8osnR^&nxhL0(pJe`rAZ^UXnZqY#_`vw-nfYdxqn(>Ax)4$tT@ zWF9FGJ>7uBv^l^8Zq@l#Z!bcf^41Ylz1h#Tojz|R*eXd~ z-V4?Us+kt$yPB6@IX;KRkt{j;jO5#pQR3RjD&J0Xvy@wTGVH6K=!X9{7skV~|H4<3v4SpHklx zJc2&)#sWf=r5cze|8{?=k-65E{)DHu)@BZ=;|#`?gjl;4Ei*GoQ8UsH`8v3N=9_`M zB$BrH|M@LJ1h#BPCdG+Y+Q{o3f zfKcPbsI{)#(A$vP2*{J4_j@2p+jul-)%1EzQyXOR(m2dCw3#9Zfdnr6xAt?QyH_tK z2U{ETOzm7CE>d`}t}b>`05$oU16H}1DuZqEL5zP-yC0|M2USjMCHV`+;J={n%e8kN z_fH?vzdqwi>>m@e=(G#v)KKy(Dg$l;hOW_0o3^DKb;e`3A#RQ;FqS;BB_MJDGMI5; z9-+;^NVqV<=36sjzN}G#p-tW^3#~*T3nh7bm3}C^L|Q^in{t` z%|yl}K17RnEH_0Q0mk`}Q|(Y>x~>dh@43QC-L3iP44K_AUGsh!+ZWJtH{F5brz*R# zyq(MrCNM&N!;vV7FYneuiBe!A54-I0ovY#3`DO?Krq{aeT+uA~TJXEdDk^02d${pv zmt)K8n$9~XyX)dQL?28aVFdpT^ycN|h4SA4YLE-^IlI77irG(Db)gzw@0d^X8 zC(`R3>(uC`y7hoB^gL?)Ge>_Ogia#Mvo=Y9DGlJ@Zc55#dC_oiP>{k?3yo0ymYb{UgEgsadueg={A_l*Cg`uXfv zkZ6>p^{9|h+`sPxmvOkBn2CV<$(HIKII_HUc%w=DV@>1WP*Qe#!VHJXA1GvpVu{lD z-HF)JJXp2fZg8$|T6fF25w`bJFNY%WLLMO)ck{!=yas6d^(+7GjI7pXkU>y0)*}<0S$pyzr3-vO@Mt;9q|}8ZpDEh`OpSKceH~5(dVKepk@AR2VuD0~@34P&tp!^$3cJ z_1c(qM84@gVTSMzLLhUL=};8sN0W}6lG1knb^{2|kB4Dt!^$U5#^7eDD4xlBBI6 zn1Tc4vwj!%rBEX<$xu#FzI%vbnad|8TL4Cf=sb6^xW;OZZOwP8p&1-{oc6G)29Y=l zm;Zxb^VrQ_YviWr#CqzmW%THJ_F}_l(~aAPBUc1KxpeSQ3jDrU-5+3CfE z&!QhtCxhDEc>Z#=hvV+xpGYzOj1G9OM(l8^t1-T@Yro#{B?P>)=)2y*2>6x5ih8*X zY=|N_ZZ!Y)xX@X3^fPLPX79WL+#aV#!Fb1QLHH+w(L{5v#QehlnJ5A>Yl zvU68B#_Bc+*)KRRiLX^qE@ppp??=5T$HF)Kc<1n)fFkNmPWACqW{)o18^t}-5YX-4*y+$-`I8FQ!v$`fkWjG26BljcA_I-z* z6nc@LT=jT%VRe5W24b^i_%Lf#EeGCAisHC$ybJKzWQ1J^W(q>_Iv?coMos?mGKc4lUUbE>TFlz6&eVHAj$j>|B5i%=$S}02DhaG=9 z;JtXOo0{0k^1-AMcuDt^Q&1RKwO_9Np_J{%uT`}XT{lHOzN|9cM8Dy2gH;)K+0L&w zePQ4AM%J|M23NJ-;M$N8pNb6L*zh|wee`~6Vu1VvuQi{evJN7J?=8(U-fi!k@gD!S9(~Rimx7I3LcI>^i==staO# zboZos;DKO6Bx0I2d|+i`Gy3bM-Vw%92}}+reKVRD2du7crtF>H-gm}~t`5?Tgeqf3 z5{Gtj!|e7%E(}_u`@7h(gZ9DS<$(^k*h6}SlSeWq8Ffwkg`Qp`E0b7Bu)gfKfhfD?;h{zjhgM2jnC-k z$2JZj{{>4}b8Hl7c~F=N-77Pt4N0@K-FpfLd#A;J1T9F7YGZEFfgl(fHUC$`=fAt- z+c1uoqU<}}J*I1$R$5-CEptQ5Hgl&9ki!#|*AXV*_;wYwzirrP$@@awr04DDQh;AX1nNOrb()!bGj zvyCwq7ztecH@*2$KP18NI6}9grx+{fYLuCqZ0xKzD!ezO%Rf9%H0HuKJp`SHha#7dk#dh|y9o}O+4ktc# z5)>fKXAJDS?(i-fX${j~$#5n`tTFHLSO*U#ggLDj-5=i`_R|3VT3;Hckz#Ni`v-I26J~v;#5z< z=dv3AOEFZ^H1=nQAcTF>g_8+3oKrc}8t$r&d!ov&XKWDxXZT5gKW-@c>C|exl5nLU4Rw5HJRXFa1J-5MmuU``!L2Q^cXAyXRVNQrT^W_(KW>pT9IW zTuwdX6DYP4=~lq2vy%;Z8jX!Hk-a1c*j>X)una{h)VQ5%kqUW`LToQLTP9!D>dkc- z-ENybfy0J6*T`Mm=Q79bkV65R=9@~3=@tcq$x!$pTQ1h@^#Xedx9rN&yRi$mb2Sc! zX-bj%$MiL^t_gz!Aiw7*(B~2SppPnCvptmk@vEfePU!VG6`-oGA3D|f3a6uU99x8T z{HNsC@-Oo-eut8`;g%E<=Q^Sow7a#Z&CUu$BOgJ63H-WUhOv~2z8=Y;7Nn8Auaif0 zQ(Gx21XdD?kjSW%I+8&)q%w4d&I;*Q|u8#jl2NHq_ zLfFf#-GNONHJe|S6li<79}D?bCVshQC*b8kaWMIU0_W>o<26C&!(q)Qu@@h?u9s>xcyZGmSrteYZQlEZ2#g1X#4A!u7T&&e`G#0L} z+IK*M9fj5$hqyCRpAzG;2R;>%6k}{;2fdI#@_Ri@VlB{L&u<+Xy>G$Z?x!03ilU3# zPf5JF?oV{z*+wu5lPMeYz7)H-`h-KW;q{`R?|T=tW;XEQdzF;44uf!ySD&u9aWiDc z<#ywr9U@ENP2#@(CPHWAflim@4w_ZM+FRbmiy`bi;c%uqCnUz6XI;pn0%ju#r6A3gMaYFKf9 z><#yXM}cUB+hFRw(B_Hp@Y!E+**k8LfMs~vM$T9%EIPYO{M@2=AHI8Nz;YHy36Vi? z)60$W$8sNMb?m%h9G1G>;z?46YgW@KM#)*^V=(O5a-yzR zY)nCu9WP?s+lAyOsOQ^@2pZX`eAPGNr55WyvyFo>2H|K~=}*2jDdd%#Lcz6#>Ou4= z_8p$9e14mwvk`}06l?yd#>R#%l|HIV8A85zXe5hU`OR}hRsCbBxl6U?s+A9c$-d0n z^N9Ra=URJC{z}QEnO9ryxzOh=YxTnXe|bOPgd5qnX%_$f)4oJ1HfTeZiFs}GIVt`& z`k6fj<9x(Pkhq18$ymI&TTc7Djt3vNksTL^qsCM1Uu^VTq+8WVvJtG`Uj{O+ZmbE8 z1qO#?CpYVTfNTnfQrYasG&k=~X7DqG8>BSMTvA#}ZFtUC?$%#Tc=2&-e~$q`US=(< zT1qA>x7*=S5t0$ueDX%5T2)!GAt*ysOiaX$jf*}!PJPcUEkB(h@9a_xSrejHYiqnb zt$^3<>b0c~V>bX_d35d*FFWp{8^I4;eVk;Z%nC|R+-n0D!c_tZIrQPec!dS$Jasnp zDJis*ekNi8p#x=C90M}jqaV&#gkqT~+6}kqEq{=@%tH$6s`XTPU5bUD@6W@7gJH8| zS%%*{sV4j95dj}-RI;b~t!ZuS#wSVXZij=vC9QL+s{Um2-w&uUjCOJJ{rB;RwNgL+ z9$v_o!%qs7?P!dbDI0FnSTycXdJ&)S%g>10@Ni8{7o4wAgteg6)N8)FU*o`mq|8@% zPpM{ZuH0vgZHy49N)zb^B#2+ryrMBBIs@gwSjjb{=D7;n%0=H_zC0}kV@e>7pzt^; zIZ3Ux3Sx^T%QKZ1KyCl2eEdvHFO^J6H4TE4O(F%LNEj_5QUw>}ZvEX0Z}vo>B@;o{ zvBY&HWvrd86qRdv3NDhb`L5Sw4?r}~$VN`blo)=9n3a%=J$A8^&6JUYXIYBPb;p_}5iFd(t?O=XhOejghBj4K zvL&VpHj4(VCm}V006BH^d|m8KoFlgZGe8)Ld8avYgz?D3No!`zmbugw9rKgW<37%1;FGDlkW^g7ohyoxqSDZ=r-FC;8n?(lU&z|79(1gd= z&S+ZqOI(j3luUyp^14yF+G>J7DRXw~6kcyXB)^*^##M|(cXZhua$>eAGflf;O32A% ze~1zY{rG4~V6&v%jE-3$@=%m`rC{d$_s;twGXi~jc7k3+JLd3qLeu_{^K3ysM@EXS!eDE zH5@KtA6TameZfpZqI57LtX7W%3texsfl1P+7@TW-(YrHc@xdcjFMF2^ zx3fmznnG{!(v-2V`NJHVdp4UVIIa;#0`aLg8`95)#O=r0(bU57AQ6wqm-$fNVbs(L zrfDYXvko1S+Lvxw>A_ruAtGF0BFo6WQ-+W;QqT+Qge!t?R#*{|reyzlt3~IQ)4Ep7 zFcLjvV+Np49}91|(1=g!t*!==)R8MAR%%8`%m2Cf86Ks1ZSOQ!X~79Le{kjPiXG^+ z$!)tlpP9po_$QV%TI-})u8Gz8LuVT~FvfkAdQG^K19mWsk=j5`?P$Ujx%629(yLH% z^wP3pCV5cj5_gib(lu-ujLoeD>-+Y2*)l1ZvG~VaO`Q&nCf4(_D4D~xrVZ@NU75QB zqxs9a3%&x>jMZVEwSz_fHR5v2TOVdiN?`YwuAFpvL@GEL;%jW|?C)Zqz=DPh#=XH+ zd@+z4R|K3Mvtt?lCg!PC@wBwkFedJQZ6ow6xR~L5eDV;Aug{Mk<=G2K0&zyeDg?W} zoUC(20=e>QryNS{^6_EPDu@!?ieaVVk+O+e*W1a8jOv;s(;X6f?{bAWLM8Szhq3QD z*-+Z$AB?G%RMR8Ufwim2cCOIFJEDC?lKl+Dt=uQ*%x5FU$nzb~^U~VmYx+f{|2vYegg_$XsYyit(H5`qT}a0|Twqa)8t0c7ktP z*b<#+Bmu?*`_<_@-3YTepN45R)T*#0B1Lkor4bGEokfwz;6RX>^w&iEs7-f>fLw=3 z6-J2Bpn{mm`CysKn*e?EVRI)-Bxk_WUpf^37xYkgc#a%w!W@ZPK-6%`1nv~J$81lXd+-;a{+6{`y;w?WLQCpr_WEp-F>F4T~&pj`@5ks zXYPxHIQY2-!-jzw&kua>hD`+6I*}%S>g18v;8hOmr1j#+UX&8>+J`l{cd*SUg%f2u?cYY%jxw{F=3=)+W z^6wBq8!1;!99^nCre(|W?>^WJ&CC>}`*s>}!Ygljdo=$CdYS8kyd&Vvn;mR!V>7|w z0Tkx3(S;)uj#js++nma*wpl>5(e+22qpJwZ4IqEMwT^Js*6!}OVaaH7(5xvR8aIBl zwE-!Q+5O55VDq}S3ylJ4<+?TGBE})^k7<^wAsgFo6m`18Qve1T$j8(9p#hC$F<*Dz zgFoi99o!mwdd>T`PJYI1`soz_|6TrCyh=NWP#_@hp4=dv6M4>YT2MRMaK-lJ;`!p! zj(e)L(c4v&Ma?CqQ-KzFTo$tuQMFK8K@pkUJO5L3p_WwwQMHL0M}M>P9L~bRTR>2- z)Hc0xe>5*Cs&1!7in^!eCe>K4Hxz)5h9V7I(yO;yC#7b^sx)ki9qRNeR*P^ViKrcl zgLZs6Q5ta0wHN!oxxJhwYRxU?<1>_vg6flBKVFlciuri`seHl~3m*(`@|(>s`;Oa> ztey1b{-X$Z@j76gc5lNWa_}(J(pu8v+M;I8@zaMNmE=+OpZUiI2TW8dhU`ZtH{O*0 z`vy@&eLo>jz37^-_f~J==_?-JwWwn`>Z;pEEYdC-)z@!ZW6?x4#KP_r`(q*)Uhq}u zejZzOM6E)ha*C0K%F<9K0e8PT5wx zPt3eEfe~#2sbm3u{82@f&Ic(&ALq}Su(DFrDJ1j0O)tNOaK0cMnKD#in-RB9} zuTvTPti(WpG{wNl8F5*)sqWuDIB2d55E8=o^LzI=`4E}&tFaAf_dv3z00f6JY9o5w z(BXoSkRAz%20$2SQ~Kh+?wGw<%S^$ZZTlxeRr|3Q6kZr6LF(|FfCd#VGS&2G z#Kiuz(>gNhOAOhdbeH=4p+2;`=s!g>xZ@f>E^ zdbslq+}ksgQ!~S~@_+J1Ly@b}Z$bZ~fsDhgF5;L&{VN&bz|(*50gzWo&|+Q^eWN%`HI<+u>}Ocif1JFyBw9yTcoUDv=oh zz&LBxIo@j?^kf}|o*`WuOvf>U`%&HzH8e$YUC4WA==0^ZH7vfaD z@c@0#ewT_1Q?kunr@opQU2sp}`jQ**8-nD)617`z2{ZeO>=I(q`H^z)!@;?1ls#pB5uZvx0QR4zTF_F?p|}I9 zI`+Q)7&vP0Vyz`CCmypog*7Pr0V_NzPI^}c?XmHkn%ZIi#5RfLxc`OdRig{D;dK6& zoE`~uE@qWc=K&;0Nwt`Q-agTV-ycm9moR~bG&y@6a07VlrI(4Zme#}S9<3EZ_4bKT zQgTSmp#1nTSj|zl^RS#+TzL_5bzw^@VfZf#jgy~WMn%Q4vE%+-l4qPH`q9@E$2T~n zOiX^c(Ux^-h3UiYY{M1m;R3MtV4=AFE7@Ac_|Okyt@9$P%{^;tI$%tmK&IB5k|Mg$ zA61(FL8jU3iE}aw9N471XoM*D9v+vtb=39rAWZxw29=jU$8oL-k7a1@=-z~}a$f=~ zZicN$rzJZYM%!Q29CsxR;T!m(O2tv<0NT)ZK768Y?6fR@B)7HJ1!E={AxrBHpMs2i zAO&&mNXX^J%+;jYKZa$0^#mbvxBHPr{`&QaRv}Tf%h0yD+00)^lzGJjOMYoZB5f>^ zyi+;5cW{wz?)kEJWBYcw&Y_w;KwfaT0YAzGA|k4)qM+XBlI6@dv0TVQa&hhV*?aQ* z&f((Xiiv#<&2HEkT$#nT(WP8PjP?F5I-0^dR_Pm*lJd!Jp|p3Iu|XL~9NrNGgW*Sn z;_Un`y|++y8x_M+!J5OmcyPK3)T8F2<2|R{+4U}vQ}g&fVQAXZ{5xQqV0FFPI8*=5 zO11Ve&bZmF4+muLNqse7j7q$SZm=@7mEUV66MYd}Brg1Pe(>gcv{;Aa&PPBsZ*{bVrc4zR3ykfdgb1}s`wCjNx$A*Y>=Zv@ z=EL*68^%zmZ_UlE{+?L)qxzEwB-xh|N*$QCnfkAQVODeYD7*oZxO8>>umSI{X843 zL@|_p>J6`|%j*f>4LxP~{*(9lYzxAxpU0zY5}TgH{zj|g1c^21{Q1Nw7t6kS#u?D{ zwpK*5_|6M|IJGX`|8m>zn_|>qvDx*iwO+v#n*scFcN)jQDtSHChj3D|^&2OUfK%Xx zikR`xP`u37s`H-+9g&4$yX;w+2clhjfZk4x?mab@VVFf{Bg8r8QOZTE zM7wn{Ha87PnEazI1jKy0@P%bzt@v(j-3PNCm0ER8diHaHi8*CA-_6s-eEp{TkYjpI zmeX{9E?LN{)uEwjKY$m9AiH~xUxN{0nC**Vc%0-D^8RCtfq(}D3ax1fapa^q3U^ic zr}!19r)RF43fCz_O*M7%gTNrr=oLS1uK*YF*hwlYW2nv?6U5ipMMT5|1oeS}SZQcz zXg||~Z{y4FY0BJ;TAg6f@9&r4_h1FQS5U&xv)@gW+oQszJfwaOglrbQ2Kg(qOJuI_ zI_w^hy{~l**?phtS#JM1eE2j@_YdEp%n;sp&EjUr-R{x&Hnv@!>j&4B7(+dgZzW4a}E$n|>fX&YR1z9dH5-_>Nq`q1-TN%@5=}7u_sA3gx zm|{)}-b6I-&S zRbOA1<)x*xL$A$d&-8~sA2(m5d=#hFCra1PqCOo_(>9nu-QBYmaT-UqnbcvBiw?ed zzb|!qqi2xKDoANn=p%*2vUOkBT40jh1OS@cFLmT-YZb?|N>s4aEp7*|2fQ_q%ZcvI zZRhSwAnN;|*&E;IMj0C$==Khn9A@krb2`Pdv7iqg*1wBk6`62Gp}44?P)Rqx7iz^1 zQwpbNM-&|c@=_w$gccgY?slHT4c*x9qIKS|o1ZA}Q1;0#IfhSHW{V)sFBo}XxS^rp zGcjLrP|;Kt4ejIS=$NS7pUI<<-y5xV;YCz@UYAl49L>jCx@R^5=y?iCu7a4!MSNhZ zyfJdCst_Q>$T5FB+EL+0P~t~X;vSYOn3&{kS=tZXBmgYTts+Vnn7|P~fM{nFehfj_ zpEX_%Rm#(_ba|{%?KkNWk&y#BbD{q7+T|3R^|Fnd5y-*A!h^A_)Vb9)9F(%9t6nko zuUIHCJH`B_vBN!xy6gFBMUGQgNp9Fbvm14aJF4UG*sjR^X1B94k2M(_jI=#ICF!1A z{JUx4YuM#yAaV~5$)3Ui>gZiPm~iv_0A0Y}S&LKVc=??0xy}lSAgzVa#hfsmC}5m5 zeGFLw177fzyGsTzEz*f7y7$)Im_w4AYha@aim1>OL=KNo zjq};&&w_v4K)7n=)&ngpTj9B}O+g%ISLM!Fd?2_`VvxS<9iU?FCCUZ5GW7Cw` zXk()YZMS(VIjyjdB(yZlU-tX0d7-u^XBsbh-e`k{ zo(|=tZvnIN2P;4gmmn&jtgy2JjLKUd2?;K$hR3Jn!v6_5 zzn^I9rL1$YSO_wgw`Z1qzUXW`dkc%ZD%sf}=ETRp zhf}aLRH~89!SgR_5u}dbk!A-WLW$p>A|kNYI^L1(B~5?V(xWS_GzBZ@IF|!G;i@#t z)zqqfB9*_lk&#hK$mNRn@cuVJDJeRWi4|)(`6NmaF7m`5S!(5cu3BD3_S4pf64C1+5gf+#r-3Vg!dF@0XlWMd!>C#UN*jsnXj`|AGjJNE5}in ziv>FVgnyDW*T_YE)ELAtOccFF%TieKQzN??v|cy zg#Vho8Pz$0dyUKW+Uiw&G08>!0z15w{pR=-cLpVIJqNA`iW^Ek1S6RML9tSRi9ff@mVXMC_^A9h$EH>da!uLoSP+Iq(?4ZERr?#RuS1u{o3;W+oN#f+}0I3Gr^?vs@|X z8%<>&Fv792&UY@F&v?+|r`Q>dLHM)s!pVh?fSw)P6bA^!I7MpF58bq=?5(%@=quIi zx-kz$cbAorz9Ube%XJ2Y`lO7k#fO+@*{Y4LY_}a(#ZMF7p0^N0d}VCW^`FVR znO>L~ENd!F-d0cD`R69!YeG{$AmMVkLW~^&o0X1HLaJZ3Gydna*%w4Im6a9TnT2j7 zNsDcAy97rlQcdD-Ke#vuhwxApnxgXQ;lg&hEcH{mCQpufF^Vobey9X5p4i9dGGD<>O zyLa@;KLbyAD`vVbp&q*))97u-BO@YyQ#YIY+01=19c0ls_0AA*M8Yn??Yhm*^SJ06 zvZST=@4w0UFL)lw=H{5)4dA80{B-XBGg3N=&uqo8Lr9YwZc)(K#;h2zoCpO)y?;o$ z*fkr8N+*BoFD@}lIDRV-oFk;PlM*wXEs~B-&FBCDwrJnnrAvsYn@Ts=1B?^<_V~<0 zD~1-?Emx?qXc2J30n~3?M8=ej!;~FxVHJgk)hg z&yG45lPjXUdm}sk5=#?>DkKtu7g{b8GV=<~+;Cu2BQYY{^b1XzCd?Ay$$&cGU_&>x z1p(I1zT;VQ(7rDk+Mb!4L%f6kx`b|4Pj~?ktk#X;)aGx|`K!K4H9)IkIrggQ($ns? z_cO^fxac6V5IU=?yAQ$d>H%X1(!w6$211;wdfHVhB+Iq`9uo6$ChPI&E#mcvdqYsE z?UhOu)JA=_j-Z&?N=ij#@1Yr2v5Jvz)WsP8bq)p`|LY5>hzGo?YK?%~E3{VmO6hz` z)o=OzcH6W219QSXu81AZ)vkx?D;oq)E90QnxdTtKVt>$<3X%`z2t9i51hTl1ov3+GiZ!frZ!Unhe#Aj4wPNvG?;i4A|fJ=ys7-HQw+@Isx$!i-X1&a{Nr9}vI+z5J~QK!^0?4lc&)35kP8U7 z-nJ-}@h#OI`cE%lnQm4BraM3$q%3*_@S$43+V7;3MnYx4uzlC;*9ZICGf{Hu#kYy< zx;oa7^VJjvr*a~7ZWNoPYK%AdS9mDcqvMNMtUm9Oc6LWc$Kp+33!UrAF4C?{pXouB z;7NLo>C5(2E_bnh1Cjq)g|oKJ3J*Ybl`@zCXW0B}OIeAO9F)A6w+5pqElt30w%|!E z7Z16t=k`5A;`=A=t2EeLg{O?JjxQN6!DgOLmG3EWq+X<;i!LoI9Y{{>j1}Ti(DtMw zE-?AoY)pUtf3=-;R21R=?^Rm58$_i`q;nNv6%bHzrCGX5x{;DvQ0WE%>0P?Jk%lFu zVM*y+;*P)Xx%ZxX&$;)nd-t#TV`la_&zzb0%=`WNydQPPKef{jJwV#~s|{Y7N=9c( z`x-juHZy%ZN?(iu9qr+yTku17c!f~dhab0Jm*8;sSj9YeO-;~?H%3F&%Ah0Spy~Zd zQb$HcyQCzFn_0pd!*YYxKu8HbH@Bc)HY>~Xi+}GoMIPzkey%q2-0)c}nc#KSgo>Xa zKj4Dx%C`N6P-9>t=lQ`OYqD2LKAo>QqUVjWlU-&>6Ev@k2&@;^~ zdP|Er0fmPfmno^qJ`>lrm~%+vaq-|MU0oknTBy2&Wa?cG6n!IpXu0rwxETPsQeGpNX(w8IvAym{|~feIG-eE#S!ak>F)L!|U?gD_`Eg2M_skmv__{ zz@bn%dG^;_%8UpiFUk-PO756ng1kVzb&Qc05_|B7zFS3!GES;V9w&ZXJTQC3U0N}n zl8OY4nXmox5Kpo7Aa&*L`!aC^nmD6{w+@?J_T9s*e+8^H7@z&`!^?=oaQCkN`OD~#o!Zc6ZzEV-wOQxXqP;oZCUTJz^>-|{XGS-#!hXr*}A zwz?lVk@4s`GL8FO=MkSq1|%%Kr6{)zv^*fbbVonCYg!(4xl7Av!JTF|l&h1A5L}7F zHFRR`sV*U@S-?kiTwa7s6KuY#lE1fmelxjcRnx@~dhznr zJa{-Z17Ag7%`g=-J&6!okLOt?r-yY#%fM-OL-X0da3)k}u=1k(ts|-I<3QO&s;A%k zpCET zqg9OC+CGwey_fAhS042@q875#N#$o|IHn_K_cq#Iopp5PY0u==9}rNzIJvn>-5PV@ z2qmTsFp!>qDlU#iFUl;NXrD{6?2p~U298z8d%cW-)*}-NqrJCoH1mhIS|qPd#5G@SVwpop(CjUNbF%**ICT zK(4lfFiHAI6GM`Odk1_vk-w2BRn^zJJim{n$;j1XMNG?gT2#{N2vTeIRPEHGALDw` zhGL!E%MLY2JED3F#3bgpd=q?pGdoR&b9`=j1gQBIdPbW4zj%-EZB061n>ve2i82Lv z!(Kxg%>}N{x04!{$neyDe&eZa&!Eo#dGROd2>)_!+(<8G%iM5PGQ7|m!%i$re z?Q8|j@UYuVwM{AXO2(Hx$8``Jkkc^yZ7nU^{5RKUDn_Iv`F4@}vb)GL!D@l!D}23r zFH-YOBJ02H2h*K6=7M+D9Y{9vHQYluiOd zL@{%7H?H1sxaFN|5k0Q~e#$!JB}!-M6?LhuXy5r6z3AVy{duEP=Yy}M^D(B6%U}$W zIBzBCZ5OIu9qENU&Re{{3Z_c_3k3bo0o>|E|*DkM%DI;(f-xHrVEVA!H7S zTsT_Ai?FbnEWz||eZ_#jcyxWLLiiynir~j}jth#)a#rH8r2Bm_ZrLa6{(iyfL-gbk zr0&pPs=I6SgCSygY4>7T*%I^b(jOe0u*raOl|My5PN^`L)*YVr`E8hi^c+`$!)RMH zj`|g6u?VvG0Q zA-b0~o!EQx%^yj(rZ7gc^~om-r!m%g___kW6vxXbfithAK_Dd_taTI+z-9^o@#wu! zIr1q^ID29Bjj$&s1^6`e3(m;cxhmnoGM%r{pFx=L&Q)9e&UE3`CL{YwvBu7);nVYy z2_yRhLE?B!vY)$)m#zFG0Y1H!fbekG3sKQqTU~D!3QJT@VnkWEJL0P4AZQfQwcv~2 zNvCDGqLBt-PaN~?2ub1C6@g+>lWT_?oYGJPAYp~AcB@352)9w|%E=8cL z8y&Jdbb0xd0ym*&dCxKuVRGHx*2nNRCPQ1tWx8w)QeztQ6t2)2lv{0MF3ZDrX~fzn zLPxV@eEc&IQeitmeUjb{6~H8UrTf+wU18b}7W%a$Hi65vTTAFa6sUU^K^G_4>FH`r!u-gHl#|phqvzb;QaLZ>5NwSM+`nb zkP)iPKR&_2a|u`~t0$J_*13vbKE3GyA3XMdsK!zE1}}Bk8n!g1nUImY&%9=(`(`~0 zu2~&VUeoyB#<+7UXlJ-==@1+ zCcdMgx-lMkuz+ACh(0}f6XFJ``TZRgYCVVLQ@I%>XLQIt=`czz>Bg{;`?;uLcLQHn zSE+m4M$6%CugZ|8MAsszt}3VOA&@k&HfIKC(9Qnuwta_WrWoAkps4=JCN%fC% z!Nad2cb_rk0Um6a-mm=7>5f}n0tS`=}>%W?d`r9H{w(Ti_QM{_*79F zuuopS1DY8(P$48U&lAN2_O_WB$VQFp)}-i!i*Y&gVO&qsVYLVyeI9l+>48i~e}Bx< zQiZQ%YaXKFvuyd|epY;^k!YhYrA=hq^JsY|!S7PD7Or0REM)olMa+hp2*Ee3iV*1C zO)K1NUSw-W*XTI-HO<-l$n0jdKc8rC!uCuyR_LunDhks0!+F^P_fD^s{#n>XXhMQH zR%8la>)SF(P2PtZLpMH+PSq3_l2O0P>Xz;F;7+9X``iWU)u#kV6 zhENc=JDJ?x{iRhe#UypO0#iz;dZXrysgl+Ze7--!x8T1Vsaaf; ztyKFEQfp7^buk&Gh=D|!&%pio01`W}(xQCrp!Gb|6DX0y%0CPBx>g>4i@Z2Ov%+B*+* z`q_1=4mHq%1ShO^QjEm5-ZOxS&%`!eKS!7e1-RH(1 zcMZnAy!_}(Zn92!jK9zgwB}16@2#Y&jPf+XM(8D8(`p9I3AlWzgtYlx8w=`t8&7sh) zx9u?u;sCSb5yjLPy96|bJ@UoiE-|Q<9<)O|$kLf&hR?dNU=v?reJ|h{xwyTe(`OWz ztG0_W=|yILTAPE^I~PLC)(eA=P_j6c+_>xhXb#i0u zUJ??Dw;wAswr!P8)5Tq+)wjj9q}NXFMz+HpReTGhYwe{2vg3pq_Qp>HCwrC{M3^g$j^tt)ESgy+*vA*uLuwT*ViEt=S) zzHtO`93M$#-!`aS=vjJw?e*^Whw+!WTffA%%mu&Vpr4AF?HJvlm$cGkyvb_qWj@sV ziUY;vOf?QqZ_0+w!Hg$EvzJ>~d|vXvfs*s^7!tSf!ab}vDxbsHI3V4-!DJ#q#j#4L z>s zrqe=GcACl14!YrjA()!~&5Du3m&N9uH_wqh2}6-T5|qCEeDxNCZ_$L>Az4?Wz3=0j z7Z&FZisgClo{x^HI6Rw&l{i}+6@s8SZ=6o9S!XOb*xgThFsd%c7+X{^JSiiYr01av zU3r#^O=W6jZn97^(3y-kGF)nQB(1L|8czXI@tK@0X21L$x?klbcl8CH5+#{6o`9RJ z^&Ad<5C|NM;t)#}^LrrSjt)W5i`r;OHYuuuv+E6no;_MuD?)C61E{c zC=ho6bMaO>-WguHq_cyg74~tox=s5WiM!aJzcS>P9tzvYFckBrRZ3Jw!9FeewLWZJ zX}@)GbW%~Bey5_azm}#amNIWLUt+~bLm}9HpWx7Q_l14M6}4RJN^w<`RA-tddHd+0 z>N67R%%BsCptx8Lc|F-3-$FTHWmZ!?F-C&ycL7~;cz+H2Lu#`T?`Fxv*!Fch@=CXrdkXq+s`&JeeT*6^W1qHO0W~t{>Cdy zy&w=$HHyV3AreyaF4&}(54wwFOxh60do`CqI*4~LJaN!r)&o>EH32L0>n>e&i*&7pOd0-Lf-$-g z-3W9T4E+jK67CQNG?!>EDLW1+ennJx1O7(bwy?;~)Wq%EG-=;2IMdPe(``*x>dOLa z#J>%jqWGU7MS6a3fA^@DP=?#iYJ|IfezA7Zog^jf+9Sn?phcGHw(+~&(1}or?!xkv zq+jy(2e~7eQ{5Rl)9Ot;9=PoGFuhNyATR+B1eT z8d~TzI}`u$CRisQ3h&OJsql2lKTRm#-yNWAJy8fBpZm#5lI>Y(KGSF+uBSL_p;Ma$ z=YK>mooF(dgmr0QveR9r5@Uv#a^aP5wJx)y-0j7{nKoMHS0Am^w%(S};wm-nWP>z% zNkm1fk9>n`R|n`SbDwS_m{s2#vx~ME-gA0f9&$1*fPU=1v^Ae^ zG!UhLmFr6cDaH%8zU)bB*i`^qvj$nS~TM`a}ggA)re>zh_L@5ePi^ z3(;FBNr7UjjL#)5xrs^i4MU!B2n!Sn&Cbg^o6?ya8$$p(Ii8E)cUyJX%=y!&GEdkf zh!V8S#fu!$DP5W7Wfh(b-}0wRiEH~0z9o{5vANJ}T%H=sr`a5~!E5b3fIG?~r|EtA zCk3LHb;ceE=4XQ6Syn0T`q=1%bG4sUTCjx2M2BS_2of+0AVx8#=iM2)V;Fm#R$I^N z7kg4b?m0=>GC(KRFJukrP{*AXG0h9YdtI4$>d#L+cN-P)`#D8&ZaoKr^Np$3Im!}5HdsY+()6=##A_C&6U^pK(4}R* z+9(9;4)r-7kvd!ED`&O8)+r7%9{5m3mPH$g&b#gLn45z4-_9oQQzG;y(bWpwEt{($ z^YALJyPbqhAd@OG*hQ|4#w{jE zH=316L;)s{#eBcEvv~R9+SUTYhTc5%>X=tNMeO&1)f4L}H`KEQtC^cenV{a`U_vGd za-yjR^aFq*xJ2*#|@T$ z?&oAJ4&5?B5l^NMO?Q_Fki(mFuR_jB#yMhjhTXJN{C)u5`sdrfe~M*Vv0z4CarV5P z{`8J5uwB)0b)A(*U*ch@&Qw@$8Wxb(@^c_H3Z@ir@Es={rbMhlzN((76t2n~a$kR7 z>H+eJ5H8L)`MVbfX|N@~(@QjH=6do3^WJtYs?k6O(qt*MP*exK=}KHd`BWT>uQ6Ij>|J*oHkJa74XL1Oo}dWi=A`C?G?-!_y_wqT5VvsaD~gQT#a~vSZfe-_a$?>6Vd1z$xj|^h z{U`Xii>ePsg*2F;_-XgtV43@s#Vtd|+$>_^U3X$bKvtrd?1wZ=_4~DlwF( zm6t8l3PvD>Gs9Z~CkXEY|A>*v>|B(9>%hzIT|d=F0*;3S!A%}tx+B@L|*!yAi_*t+8pG<5vHacnxYYx-Tu#7f%H^S+$#MEXO>zb}ZMX zbf*Rm3zeMICDUXOai}Br|KVrNxBy@^HG+x8n5JM_^sO@F$>+Gak2VR>SLk++XKHSqe;fmJy!L0Z^bG#xoce{hJ(O8}hP=5F?TPvu$*iZpEa1%>^u?faZthW~d3k%=oiF^xU;T=Tdth16I8dx!joWArZFG z>}hb7B)$9lCPp2zQWA{!wSVi61DV4?Q+@80%l^Eud_D8r@?>Fg1paQSP*LD;y6*Da zl(&!UOSh%z3vr~~J8ADW8Fkz9c^mDRBVUu9$+DmZ*GA)`oUaih8YA|l2xzyE-+e)5 z%E=W25wpY~I#7AIJBFA3A+s2+<$R4o!Zv(ok6O098VoH+@$t=|Y;c3oP7nhc##lfC zU|2m$jdMCd^3{1u66CTmjvPt8&zQuVveC))U&1)_KN47qAx$;qS;MLT)mQ}xm{1j+ zNdw9%=2wjfpeY&l!|#$NdVL+{!9)6!jXTdMUuCh;-_v-3AI#nza=Q~q{DV&yr zcqY%@$QunoAW1++w`?goEjBhB4xh9G_ja9pts7_3{gjIG@Yd;={JtGj<^1MRAk^z_ zSCsjQgapywzuS41AfKpqJAUTwHGmUXZfpN8Rl3$a_@eLU%RZL38X8eg>zJf|(fi$9 zi7qs`F*8cm%GL7m3ixL@(}fpRNP;h#nn0jTE}fZ&ut-T+^y;MF%5u~p-%;}~bo@b! z;_Ejyx(#0S;jsL41h@kqyN>)lH~{-#MGx6MQTXWKr>N&c7LiKv=AU>uGF|lPD^A1g z7-eMKH?=yxpYJ=>m}a6sHM`*?@capH_CDDR0tX7w^0Ds6v!y_N?Q|9(M;^bEu4d{{ zpx-Itk0=KcgKBC-=Bjq{s?yK*QGecCsnpGTadXOhHhXKNTEsfRlbRZsLyUB`B=@I^lso110mblT$( zrOV$Ng0pc$YD&U%bP-n^ zGkeJvM_aRvZuuiNh+)#j25jrZYii8G-q-w0_$i&~+(4@V52h=>r~-4({O&Ja}d zFt&G9(J(M7WocNw-J*vWuYu4XYit#Q!{m+bWH;u<-(b6U7YWY;*=NoK^vExXKcpPD zD2CJP@kW&KDGQ&lJPd5I)vq*nb-Ws2EP+&0G6{lzH5HUlHC?Q+-`u4p8pjSk_qc3> zfof{1gX7JH6$`b>)QBYA8Q&U>avOLFate?FiWaI4MM!vRlp3i)q8WWzO`We|_|Sy> zS(Wui=8qr84wIU(l~X5I%`ja*f6nF==}w-Q9xZb9&9G>;|HGF-^(`&UFS>2-lg*0S zz(W^QR4@VvTaoKM%&NRBsEVWF-8JsaSH5{Vks{2!y1D<>N2oR-b?4b|j0)@MJu1`F zn~}kG3?4@>YY+@wTyRa2bgvrNaGkZVUd#8TkyyaM--NAY78XzcHAcmlC}whM9##}4 z#LP5p;DT?Eks~H;;HlY=grfgh49EfWqhkC}+_w@hMR_Z2!4?%TPv5XACAUUTHMc>M zj4xlNOOjJE&$FL)+Ri==B?$J>P%;S|!jF;QqjGvg#76F>@SPS?gC}1$k52qm~o}t=EnQD z*4sIH00?M}Ieg`;NRcUD=TZ>UWc~P(fl!t~x(?g-T6qPXQ*0J6wuXI_9L)^!%YRo2 z*hD0^Xw?v#s~)LC5uu8nxv9vH<$l)j6bZ!ARvk2_d%^%@fGPZEXEiZX^01Ooyxsi3 zm2*FQu^IgI6BTjXtEjQu&`rz5$LGlnZm#TJXH2li@#=43uCBZYil<)ypPMsjsv<7B0@(-f93K9HRrLcet+&ko~_dj8=`Lj zydm_t#DfD=k-pgd6KXlJ@Z2z#@C>zz<#KZ~v&SnM+u7y)C?ELm z49P7nu|F|Dk#vW+VSU}7E}nLHLbZFW(1l5t1|2ll^1GFwFgMSCAvB=Z9h4Uo9NH3+ z?CF$;F9GT`2gO811y;v@F8l2ZXH$&lY>IHFHDv;3 zt;A`B!NoKou!Whwmn_1|nZ;lz5`SN7lp8|J|6!1boAE+8MTnelo*yTS z3`jC4H=*vXsEXW!2YiS(=`sf)D~B2M@;^@RHS+{$_VNrC`Q&R@!^&t__4is2uM^QB zze3sKfXXQ68#EMJWsizVIomVN;s@`F3|r0)kYam5tE_d&c;|iuX9p(To5IdM%a7i5 z;5vNFEiaFRT9+Na!X1+W_*7h$6xshPi4ukC!fuY)yr{-}gxM4oRIKDgLmNR#nT}Z~ zSt6D*T=g%tg808qD96h4Zr3yijJQ%?Bp?oiV^e0yd-ZCRK`lv+VzZ zmkekMHMSt~YXP!E=Iwv>;?`HxT$xt}fMTP?s|Jf^23dlF0%w355<S@cbCQ+cW3*X+1c8fm8q$n z+8f=Ya&yXc4ZjNBcAH0*4 z_75m1n23LVAMCAio}i$9DMwI!Knd@5UR4KlP~2QwsXd0_5g@w zHZvUwtS@+u+g3FqIAiE&-g(~h zDbxU`02Up+gqIxk19}1EmjGEZ7ZzFw(-}eD6CaXzk z;e_~tP6J=NaZjxCjtCtS^F_nl_hpxvLM}V{B{VYMX*zMK<2J8#LxHr=Bjq@V&+(1# zZ{{&Y5SD1wjaPV)P< z_3t0dYpb1}GWG)K%84c3U(Z*%aqeu8TkLdD6(>o{HEU7!C!b+>4(t8bKQoUv?9tX8 z{1!f0Zrn84piQeadWzP@<@5Zyw$`8v>@qAg^1%F8lb|&8A2yp^v%)H9R~~Bxl8knu-gTfq}v4Px2o& zy3VYu2cNq&uS<`)@`RBLS{xqN6QfLtTG-G2Z!jlp_(*s!FmI2RVS_G2r$lv@aeH-H zoQ~T^jZily%j*`}#epQxryffk_F-J#mac9u7*!oW5#bvmzZT<5N+WTE8JX>$kep2! znV8UKE&gJHprN4$HiKahx1KLSTZcxDnT~^_>Ri4jpWgH?VDq(ggJ=BDOs4yBxKp*YgDm}h{TF+6+i>2u2;MowGr<0^ zxXhIpa!M2uk@hQd)gK;c$_Q{?M8T4Z#QhTrF?{V;!lr4*IM3Fk^8Wb(REOl)jM{)_ zRN{Q^c^j*lCV0KZjw1OiY^`RKj6;N0$U@({Whko?HmxpCc<=jn!bVHEkj~D6Q_s1> z`Zk~UZ~htlL~h3m!pe+{S>Rv#WdaI00#TNVB)|VmGxxf<9nQfJa5`d5j-@h0BvHne z_AOv2`xX|tdR|OT&9gb?`YPG(0Ikxz)#dZJ32YZ@hCyYMa{cNE@g_hL?+MHrwTxlrI%-CXW`+IeMyvxN^MF7pT;bD$ap=@l2x+g#H2CtpYRzCy3jBz z-Q2{n3C5FDG#8nRhK)CZf#?-6v8)Ci)B(Fo@Rzv!7KHvU#t0p5V3S6u$y}JNwa{y; zjVe4n7IT0~g=eMEJQ!;V>{=-Ie0MG>ro~00S)FYX#ykJ<@%YxZutm4Fg;C($7m8TW z`{yNy@>^pgVu$;)mfW>;Eiow(!5nAPrp!39y>4rRmO^J7&(1_Q?8Ry;>|l44NVP`P z2Bs(gWq39aYIhxde`ZPsF~R(Vm^N)V2Hm~y$e0G!Ka<1 zo{x2woBl7{0mN!FV@JP``z13=?Pl@?H0TTo4}_KqW34^#uLciB638SAXECNb+uyf(%F$`_g&q<1zUXUQ zfQ|SNJyCEdC138qgs#U{ZHe9Pr}z#VUGS8Ylx#LjX!<-JLrvC#CTmO1507y$ZCDk;w?e55u*E%nAz>(e8MBrN z{G9}m*z|V`rwj*^IgzY#zpzMnT%kP9H?Uy2J#zI%_7Z6Sj1gYWGhs5QL6J!g*yDdI zOfH)zuql4>^ybmFU8?)0L8l!)V=fc*ETIx}Gqz23u{CWvn=C^$)gmwZH<$k-tL3;* z^-52y@pj@-op08Xv-Mu<|xK!{_CY9z} z2arh6`HSGo1z8ghQG?ld=7oq#fntW5^h6S;VG#FcfiLQcUdA$?1t0McDu{KSVB26;W$c;d zd47ndk(#H7GL?)ozU{bma(5A%B<3GLohwTvDScDayFwzmg4xs+Oa4aQ383>+cRHBR zKimLeusNc)lHCQv1Qe>E^NiQib60W@ zLEY&vKhHX+w^js_Jw=nL)UkD296(uN;Vj9mHVyIql1+-6{*ZKRRygYpd96+bkE1W@ zn3}AnF~_qwLn5RFnO5!3Nt z_ZzAU!9NBW%xSVWT5@rBH#`kmCWNy@xBmJj*!B)(IcXp@(`e=k)0_Y^3>owI-|^cp)fEQo(M$ zhlr%vk5yWZ^DT=`lO4eR-3|wM`t6k`Da{hy6YI7w-BH5$VoMkz4UudX ztK;H13#jzUnNI%t)6Q@7_TK1~s0f!uomSlQZB-n#Clwj<9JMBX>sc8Qq9}|8Rj)(32Uz+}|GOrg;fP9P1f zyUioo0cvFm_)*m8^+e+YO%}`^D=`HK@cCXq1u;U~*8n9K86K|Bf%R@+4!JyL#C31q z(N+TVZXC7E7?OK^7Y?zf7P;v{gTwV_RoAmQbQFtbt$~+V>)(w~FHfr^Tz>m>Pxs&u z1Ad=KlGrr=&YR!Df_AGdMD{wZV&{rJMM?#IaQ;})>Xi$m0lm-{49bMa$MabBQ#2)C zQfSmM$8Ik!geJ1j9zgexaPY{3ih{3-z66Kcpy81$O2*Mt`jGNNtF<0C0wMt$#EN##_rIwn{u5=#fAy*nuE@LPQuLd!Vq(lQ^zkK34pWC1Yd64QQ(-X@ zzGBUu|qLMChjb96HgJ%s}PkOz`B91>En z=JZgT%Wdj7QKRd!1)I$bZ*NZOI6dOY$!VJ@b-!|%c~Bk@PNdV_FkfQ6fi!v^e?!%m zB(w`nzp8FfBbUbyK8^8_EXme_&G7^=CPxNI(D#AOVbd#|a`Mb* zGPkJB?V6a6&m~_ZG;yc<$IFuTi_Zhngke{Z{VGbh*Qh2{s2=h1<;$Zip`gD4Ql)kg zA0g2R{eoBjJFx)_P$HJFhRf;jdqanXaFRqlI8}-=$aHvu)R7oy5#x#RjDgAn2&~3k1vflj+h?{biU^EbMs9LQn~r~hOV}fXq{}i*}50%-lHFG z{J>No28Q>FmKu$uCCP&nbGrgFd-R=*-ktyE0rBVk1c!FS3FJYN(b<4WfxJLj90!w= zw&ik7ASFailRRygVwO&UNpGy{Rbi1HP!gu6A8dQS6ZhXQ?N$UBU6=ZC`P-!|jigk* z_0EsAUaa4TpkdzNmy9+IJ+gum=(8%z-BPJH@yF8Me$JFcMIL>GHYlvqR3{W@gBLK5 z99~uyeD5IqVZqpYYr6_sk0=>y8j3U*EKs9noUJ1%ofwYhmUUVUpv=x8as~|%vDwYR zdN`b;gR;%m%Xsnv&s-i&}hjhe7*0cR1t{^k*vez39s^;vm&DXa?KhMNl76O1YhtiehhQ* za&O&caZ-28s@af7VqOkCHfk!@`${v@k@9`P$LSvyMc80AwJ;fqRz6&5Z*L>n*;YoU z*PR!wOm!0sERwM%m;Z>z%)a;PgA=KAHCMnUkJh)uw^;_x~zig%)x zNL;*jh2qYtJ@+K6WB;Wo_0mBIX+8Z{=YW50X#M}&>L6TPxXhydKg~4g3ko{uX1`8S zszddT(^yC{3JgqpINyc&1k@qXN{{-yKcNf?#=J?w#I(BNOibp z>npgedHGQVtUdxsZ{BXn$7J)uFpZe4(+u(YG1BgiD)sQ7yhM0$7FWj zPdd}_{*3H`_r~y7+PUa#O}~+6o8@qyxM05Wt4(P&Dr%h2bFApa&Yc$4{4zPYsX^vDKSY=YDHPrz=1Nd(YTcEDh9_ z!@$S?T+Pv^F0^*cZjly!Sr;Z4e9z|h9_4LwWa*SkYwhNH_!DR z*?t2hsY+Hc%Wu036>efduUM)|uj-7n=lRNb&sI)S7JNv6ucOMU_A0)dR_0l2^M~j6 zX$k5cLebW1Oiwj;v<$ONYwaJWue2tXl=NY9P{V*ktmxM4h2c1=qH_ICmWArv2x5N8 zGOug#j`?`3DY6&&bkDOrb*LW)(dd)S(>%T$PSB$%j$wQ-HlRu1LgaR`z%0yyAZwb_>nO)30buxO%GlTMyU3-l4{5mWdsiIE zR}8`L@>z_fr_)8q6FJM@b4dhSWKJ}#4P{Y?^db)?6@&_u$gO$f|2c81r@PZ|K4R{v z=GE};`od*DT`RvWR_o%0z3T^|5M>%oREa}sG*pv^A$cFCodFnS)6*$`I1v$1=f|sR zHEL0Y`x7S@SIkKQ_Nt&F$%*e=-8w}BlBWdQ2Zm`;W0%%~uc3;9_LM`X%iCc9c^jbu zCOOFFX|wsfn5Flulz==gyCXI_k}6}>^{NHyk};suo-s(f(`sqedLX01f1RfE=*Pi$#);dJx_kJX1SL<7>-FfLKg`od#TZiS zPkH$eO@hgg4hu=;gHAY>lww^GO!7Eio+O%@@yGJ#j}p6);o%XH6`R&3GP2RIiFI2z zjS~vHD!!G(ktlm}d0u?le`_H0hsEiiXaA9z@>SnvBqKYAc|Yr@a4c)!{Z5~2_>&ko z^|sDp9A$Sh4>mMvcX-2ZI6o%Vo^1Rq7dehZK>n(uD-!c}d!y#yHDa2BR&?k6MMWDt z<#NX9}9L^{jxiHCgk~TeA`UFEwgYn*JED z$G|n2+-(Xn0|+uvR;oj;-ulHh(%qFb8(17*k~tg`R@J_zN>%$ zx+4lRzAUV;#vhWZ#c!}(kXr&;!k11yAl4do2dPx|bqNkdIg?4=g%mZC@wgL59+q3p zl`DThxkD-S@^QBf-S8VKlwTF5I#!1gd`oxA0w#wAkpQ67ix0Dbz|vVc$-5xP6Rb zp)=@0$D&DXp%OjQ<2Eky>g+e7y9Y^5ieW^0wU4FJqr?$9q|UBZFk3F*-kb{(L+Z2* z@+hONz&Lpj76J@SY9&Imgemi8e1WR-^#Z>dl`eeub99j8#L2_;q;w&t)TTd3Y|7?@ z&1(9Xm95+mSv2fM>gECc&vI(@^W}K@@>2JY52Go!3fGA=Hyz=q4URM4fJwN|<938s zx=$L{(%o=0n&;tvFg_PaV{EF?8u}*cI*`hwyUuI3DtMf%wSOJA9g;Xw5uGS6rU?F} z&hxuWj+xCN`_5QStU~gsbfZ^vY|E%ty0!bIcOkySePe6!+sIie`JZbkKabkyO@PNG zskQs!ypGGLyck|TECFN~<QUr6eg6c*%25aGR%UU5 zw`l!}6LCUt&BC01Bsw6ZAiV#<4BViHe^(=HO1t|dYoQBi-&~mHQ{Jrr6Sgqw>Nk4> z3UfKCEL7R!CzUUXpOX!6N2tGZ1l~*?-IPMHs7SqIUIr}LBe$YtEipABwf)?0#_}C% z=!z)@Bs2dUBxcG@|Er+XqCiC&og#CXB145GLzMzwd#fA4nb)GnVi}d} zU{bwsWt)|BjgykI>{~`1wI|xlo2)wO5Y$aiwMtlSekX6lBQ*C}Xw%h*m@EW|*^ITU z*4sPQ7SJJ3snaM!F5z<3J%+N4@}V0#^(I`}XGp1-&SlP0s+boVUQQK-wPMSL`?jYP zO~8pwGtcWE|K;e;0x8d`TH~j)YZJEev@$?xVaSyz^3jL@n){8wE@FYtG*eV;NxE4v zXTk+<|2k@FM*B01iH*OEdGH5Q+O@y73-IjST4}Q#fBM*vk-pK>OR%Yyt4&$WO_j4N z+0H3ZtCJSTfSDapW{#UoR*|2-oi!M1V6@KHIO^MmY2#L^(bPLswA5furdUwUppqvq zpVD`mjo@EF+Pc$S;r3xrlOSlA@qKS_RIit6L69ZV8+GGVjLUrh`Hc})E%SKR4seiWev#VbFkI%D5_(7$4b{hn)?dKVKtjbVP@xqy-6YM78Y22my4gPGdZHH8_&P8|UeF zcEU}k*9Ir}dV`^MJoipoc-hb3_q!x8-ex30Ss9`^BH?$_-BrZbR_fgd8kw~)4DuLC zrNwN25#ifb4~^MM+bL{n5jxYP2Vf~FMOrlb<_EaiV~j4F%p-$LplS@b!w9)uiZ>82tQwdc zYr$I`1ASJ2=YVxwQ#;_wN7xLZZZ?W(nrr6nq? z4=)!N&u@hybao3jxz4LF^bxxTDMq{+fbZ$CI{HxJBP93pa6YT0KN)>bT{G55Y0JLnik2~L{J3q4MSnDB8zzEy zHivqsHi4I2WAx+0QkKVMiZG7qY|34hjQLUkO(RA~Q*~*kvzlE}{3XqRcl*9EoxVJ- zh&G8O5LXd*23{CvmZDbe7h1Ij-oAQ<+a{TeIUYlN?Pi;?_eQz!$0%oc-If^E?qv7^ zVaELW*>vNfL7BAII<;`c4uJBb8GQW$mo;*d1$I>;eE@4_UVp@gf?o@2s{n zOdPP%UjOZ){)qirOh0O5b;VAngFs`Ncbsl5mv&X^6egb4 z?)3vukV>fgqva&lLM!4>x?oD@Mw0{Z%Uo;a%)Ef}+`$sNsx&D{{XDv@GrrkGh6Hjg z$C7DH|H4-3bz{@(wlKwXf&vC_x-2I*xI7==Tzou*s-?TLe1-&u06GqGn$*gwYFPq@ zLoEjA2udQ>QkqeB>LoJ`uk&bd_564yjz~IT8RoMgR*efsCJLVcxrn4@0V}Tri zT$LMjW>;<{n&i^kzLTG(NXFMwEmk#Xr&WNkg0V~%g>xh@L0tVdQlu<;DAd9M_08jmODHImHuLmQ!MCN13eHlM+Ak9ec z8}K!}%_2t=`oSO5L+fpi5mf&$NDq=ei&MV2Vc-r;=r1y3f9trbPBXP!u@Os)A^zC~ zSiZS)X-})A8-L)ll3mPf!%<&@yOqI5j;0)$S%S`3>KOK(^uTHSv%?`hVW|)1a3&R9 zqn=M2D+p8|^&lB~m`oizpeswF$oS4^?};q)kR#c#>nK+@Q}kcQIc-2)Jz~M-FUb#D zeq@T23Q{vIv|>yI_hB2y#{+HW$)%>0Zf>*TK$~W5K`VdLxEU$Hi^<5{DerWLKI|p4 zYg40SZSJ~Kjfht{CITU^KVeiF9gbf@V_VzSOM6l&gY%!n0Y(5WumlGWkG!LMaKm$E z`NZ9P9d>~a%G5U4IpDmvV>R8J!0sfCd`E8~%OTTR{x#iH5tGS}S_FYiG{8tShO=eg zM%$;AE=}Z9u@`QXPU*bn(75QL+DDG_vMM$~Jgvp_@fARcJ(Dd?EHEu}qtGY+QF?+) z-;NQz|Bo7i*^#lOB_yKoPJ=}{nC;$R67ETSw2RY_p5?p6qf(8w4n)x^Vp_NjI^^`* zP2g8rtX~~yWkkMac?3kgwiqq2 zg~4fHp5Bvd|D3LMj-!<$XL1iL;FkJ@PM|;oaPUw`;}pdmUP#3oNzP=k`zkw;Ef5tH z@)-n#bm9P-zm!l^DHWO6&AXDmzr=m3_qavw{tykcG=8DT@N!z|&`wq|(r#rPe&xv3 z_Obmt&ZCS{y)fr%Y@i!`>Sjb$#613YwI_yMzeGJ|-nTn-FYfiJ5mOHUNnVRwU_T2D zcMuM9mACQIuY{~gQ=-F#;en=Fj5c9Q9nHV)kypcWcgXC1&GR@W0-um}ZxRb2ZAg+6 z2nNzCxIY{!lT3x8s92kZkM@jX8rVj+r+E0mqBT08V-{t;}lgRX}p#9mbR$!*0ZRK!8wO_*28;9dixMN=C zW>eEf8a6n@OV>m0fd;wPu7@7UOvWBhAYN7f%ex{!7{6}f7r;UwhrUJNghO;dLVfnh zWuxJKm3;c_LL(K2+Hed1^=xw~zQwI*%<~UJCe>g6L#iHouhs28>$y#R7v$VVU&|V9 zp7K|J`K=&Wk9p0UyYO>^jl*Z20YNXh(p1G?j;W3LbB!gF?{G&*0w27wzL%}1hO3}{ zSV#y~wV%{JHUG}(+( zTg-;c6Ei%#O3WtdJ;cmT^naj$|IzOMg&K@N!W!|({RC=OpbSYwLoewvdruYD>A*#g zSWSu*_Sq)BjNGP z#Lj^UTTLB-X>A*(w0B*;DHeNVq+YyVzGNDov;Sd;cN7-~*&VP?t$Uj=>t(PKunDpS zmpU+y;Wg>}e0zp_uWCzgfgvZ=MrgamhovByh%dq5+dk$E&Ds3pQIrzL<2MLL7m9&^C zaFY_wSj4_6n8N3^!nnUDYwDA@NG+7BctfG}Q8vI&>W0|%6cmK4Lw|?78luB`OqL~+ zV$7kj&v}cfGYO~gWVq^Nn33eF`TA#MOv$4DKfZdp$oZ6>ydWaa13fpp{nC&+E(@eNc_*L?bpBd}-`Y`xnTJ&<~ z%o>m8MC%3Y|K9j~G>k~K_v} z%|nO+KloI1Pe1C+LMNAOthhyc*!!t0S~4;k+rC?ziX`*d5a2~J#t^@*Mni>kQBg)sC6IC$@G0-7S=YVH@?kb~`^ML;nw=G)F z`-hge4aN;AM~b}Ppcu~ljwfi3p(kM?;+V?rR^a@dn3Vn}vZC#LX2PqfBTFZX6X8$Q z_hBqt(CFU%1n%pX&z>9ybjc_*Kkd6ii0rb;kVbJwJ6A)mrxmJDqlGFN zBcrU{@8`Fs&kvLwtoA(9R7W>ZTERHMo6D3|`rlB`=(^zch5=a#u(hy4waSHVvi(;t zk>=u7u53^~YP9jl=>{Z>O*~yx=`i<;HNtfZ7ZfgbIzlhV^VCyq79UR1owc&BF>KNO z1x^L+#`gmcWhV=)K%qJr`f{KqdV~VE@nG!P$}~ga*9_#XudlW3+E$R^vf-`!ZDhu%I{}yp3p(&{P{~h1nf_#SpEGZ zKZQ~lldL;*GECC^IBCAT_1}q}W?*@9`Y@m9PaYZ5Ba-=S|E1d5{rQ4FmPLSaHsM^l zcyt3`iY;*W=u5Jqzp`bS(+!p4LVLk~07Ki1Tc>|>I5YpPm_fWEUY2jC1Fc}FDMofr zN8NhJ$55U{o-~->Hxb)*#nr;kb)wCM>BYL7zML4>&3_gu0h*f7Rbpo_@n+@PbrWvd z{5adhNm?{u$jFO)_U4b$K}IP62>fwnR5l47AE#fj@h$|g?O3O|6KuOo`{?!^=HDK#`` zR?%3KA18~Js(<;J3GSO}Yy?xymQkK@WG!U)o_HIP=i|Vx(AAZCMK1Fj@(Q7`(4CFb zRkY}pc;HRHW$SU06`>c-7DmT}P_9d@-G7I3%ndEjgZG#%0lFq_E#(MBS@U0+30wQb zc=lZ1A&Ncmi;WQrV9$mdV535#6BCBo3^tN=E-yd-u3Yr=y2kpIcK3TQ5G~o+qjz~r zDS5&U?$Jj%f$DrK+^;pSNO=1MzUAAwALdUNZr0^0q7zgUVRTB^EP3?zP|2;g6r2&Y zDVW{>;$E7sOLWH{^r5*$Ux^#$NZRc~ z`kXS>F=bLDK9e`dKN%NeyuJ&o(JBI%mGNy?msmyFRny1f-%Z1BbVtlJTf!Q=BEGx6 z$oOO=BQ(7FTnpK0REut>P@tJAw`7$EzcL> z2($aMLH_5Bf0wEnC5*)Ichp6i(C3HAj}cU$86c>ZhbI0BuSBU_iO=>!vJ-9mi}`m> zhy{VlydFX-{;!^c|7kz}kv-x6b=99d-H`<`3)^Xi0sVurILZZj+&5?Iur@JY5Z?{L zZ5JK1KJT-UHIrs?ux6-;{qqxpT*d6h<#FRQkU#e`!=^QalHT!yT!M zLiifDRrjR^H^k9Y>X6W=G^3HJZzgM_?BIImYizSWiGw$Fi&hsG+oCUQJ`4iyCU7_2 zTael9j$0GQ=susj`yHGg22H8g%L#;@?lkHR7F4d5K>isfnLc{e-;_7N277nTiLBdW zLOzkhn@8LU2p2GdwCM#rFTT2;Er(U&Ocp|{29QCAfW_qFAX|^sbRjOg_s>DTFjNxs zfH)%F2r|jo0qxRiFK7ckoPgC<$B@+VtRnr+7AoxyzBgVs1a@0B$r144Qo|mJ8l-OO zbU&2<4aKNfM@58xNn;4|y0>lGpQ^uR>Gr`*@|c{@>4o(|QKZ9Ur;HejR|% z{;SA1#Cr;yDDWQm=I1=WDfnmhIr&l;0v=D5JBvo+UdG_ISl$zt&(R>^KV-mNL(bi3 zds8;Cky}iRnp8iN4nm6=AMc(|gOhq5OgDV91q0yKD>XP`1f4F>WS)~byK{NWNgFK2 zZM^k6T&dL{53Z!b8_qdj2y8$shrOu(X?v$ zXvgf>nhvp{$ z89&m0Bn;&hVt&Zek<+Y@5jS&j9_s0aovt$$HFF-126H-Wy)0i_t=15skO&Z35?9o^ zB#?^NSqol$I+CI-akz$<)BN6gbTn)_3lI-_T7n-W|!Cs+djNdAvSgOrQ)PdJ%AR zLvXYnf`HU84@6Il@}oSaL!{1bX7V)skJpQ=54kUOO*ZUk%{Ff0=(R&u8zxW|fAx|X zR!Ok2gJOxoD6DmIG@?2^h@&LW1w_&DpD5|RQo`-=}}?giyE9&!Mx;x7%97ggtboBZLx1SSs*E~&@cDy_mg4MX^2X%Mfsl7P z2`}iJYo`bowoC8`knm;3dvi9 zr%=M1GgYUMMuqy$H)Yxrt& zW|M~r{r5tV6qM2<08&OY@ZG@Dd%fJkasNMVAbB>c7izw!h2cbV-2pxbS0g!ZlcPM=N+9#pG%y$iFqhAG zf_*}Mz)q=j6$*_!o$jsTm@c*^d3jkysM2X95-`^(P|RbFIGYxD9Wr^0tS(*TzMdO6 z)x96Qwp*5kaP^nvN2^5K*Bbp1rUwHT+Kt$K5agxJoH3+bkdb}d2fWW;Z%~0G_);gt z_wKzLS9%G2>41JjT*O#a?^Hnj)NRHzw*2~xI_NXE*h;_`#V)b#y*}vU3c;lc=W3Q^ z3!P^L%C#!^yCT_#QYu>qoT%9Z3AjG&jkb#BLO09jkqoFYHCQl)ZubX>ZIiMq6}r+g z>v>N~pHm+xm--S!bvKv}1F25trRLV6((C|Znhv8bwUE9;z_U4@PHQ=1?&gKy_cx7N zWnrW=DG&e|Z2qrrPp8#J1Ij|}aztRDP+NO@W-6P_jq3}z6%%K|UhL6j0}{z;nAhI- z{dUJvFf1qSeiOa(YjygkRd96q_cJ8Z9Yv^?K|Bb@D0WM2oPWrD9uDz{1q6bA2O>f+ z{(%?*4`!h454-2GH{Cn?vS$$Zr5WbKR+;Bj=v{&asHetp1c zynmB`%XQ&1%NN8L?7Z`Uzjn775{62={T4!L@=&86uoE@enXfu*(dOxl`1a&8%6qx8l-=)K8B;y>ySoDirv1pq`a8d%+r?B9bg4&)v5vhjUu8RlBO(h9Fpt%V_NA9 zA$#fr(rVXie&l>-9FDD#kQ$-=Yse(sC8?O*Wks`@{72LY!Wy|+t-|#K6tMa&CiR2E zQ1iA%OYFJ)Oz0(IGp)VjWL%%DcE=BbejngCKMyf5S2-p4?(mcIM`N)UmB@0M&d*pw zNMEd>7`#A8xJ%mO731ipi*9JMVBw!6#)zaz>0{F?(dg4YrOI8+ywk^I)Pd`*72O8w z!pG%)4kuslyhpny5g7c77ZA1B>L7?|dD$D%(Kp6Q@=J{|s#lakw00I`enI=`Gt9TL zP68VZ#yCNos=*8NS*0Fd_$oaC{y*g4*|HFE#)NU*JF>>8#tJ0#ZSGt_eY0hZPLHG9+5D=X4RiA%N6M|T`2%F;*2tTEX(Ropsdbvr z&epsGeZBZMyhv753Pj+Un?yoYmOAJkDHV8Q@JT$510iowfpGWnj=wPcIcbH8g$(zM zkJ=LwZ8AQDjP0A=_%N+JUApJvh5aP}h&w|>F3W*7j#8;%FM4;fd~qB89^tH@fU;xZ zzgR;rf9?0Ct$Dej`RhwuJ+&&p=%~S7tIL&@m>>RklqI9N*H3etkt6A{SqRcRxqXy^ z%4&)0Aa&>_lo0H7@%X!@G?AN!I~+J1n>+a8Rax)8uE)i*v^|3rFv|u>6n$qo0o!v& zQ4k3U<^S#mgF>W(z#D@wt*i|1P%?9T!q8msn0(Wu4S0|mr^YYg|BQSLUD7u-z-lL@ zXf?-y(k}9W|BEASY+Sd*$7%+iOZbvosze~MHLL&oD{mJ(Vn0L|4(=V?gJ26K<68b0 zQ2dcpQ%i<(3|0A%qY$@H4K9N4Q-!`WK7y7CoKX!lrkM;FWPaE-5AMU+8Jk8o<^C7f zyb;c(2P0P_W2Esp`q|D03x0a-?%

@@8aiUS4vaHw}8QPS=FtS5$+~VP9Ez@HYk# zqj=xr^7tgr*3R0z4nDXX{Gsl9IBLXcbAPSzB$K94ctUn}cgN)}+h^VVv#fE74e zMzM)OfWT=I!?E&-%{eOed|VIkGARrcsr2k=Rt2(s+185KL2Kpy$S<#pJWbZDhyPrj z*SB^fmB?g7=H>=G!5EBw06D* z(~+$+tA#>AjoOXavJXMH98F>AlmTyihqu<2o>;cQUF|OUM!kFysRgb_h3VWsqNzfn z8p-ss3G1zzl1aN7x+;^?SxR z>$y29J5{P48rA~(-E25OWLO)t-GsYj4+tDeOltiTkM=J9;=( zfY*aJ&pFM{>^XwT=XD1?Bfhdv4>(8j+>l2@M-KuZ|0=Sqb%$q=?1<2> za1>ON{WliC#^;ic=D3+klzFm`%f*$v2k(~rm%4qFoOVNDxu)=1H^lr(sa_+K;y{rL zzSY6Jtco%b=O5%d5-wO2|Nf4D^^tTQ+YpEXu}wExp|U0dWY-;7+PR|c=xkLu*?o9@ ztWMOhO^Y3bQ10%ee+6aM${tfv>woAP_f-MPHOr7gpV%*85x(FvOiU=*egWRovR8^p zi1$rzulsbSr{Y!jgX7W6CX)Y{Y~pt)hek2TCfA!!=s7g(n0 z`~voXfE%J!`x7yiA3jv*FjQ;AY1SGn6XKxb zkxz^+{A00y+X)>c5b9ZmQ zY+>^GU)_=3{bh16Nbfd3tsfxdH$-4sL(JGngI%&a6FHqG501cBlsuL_=j%Hn$Z@~i z=WXw@*e=+ac}#}>)oui(C5X1BJ9X0)JnU^&>)$F5qLvjHLT{V%AwvowU zUG0~3;v<^kR7d@Xg^IA94S|Qd)pL1JF+s`Rn5INCe$R+uKGQ{`%nAfY%Bg2h~6Gl+PWPhZgM(7HuwO))zaB%wDPNVq5X(FL&TQ^_VK1S%byrz zz0vi)$@2m=5{LfNt6Z#HGU^y-Zz!7h285P?y@x}s@uim3pH+ux*zsi8tPRn}iUC$~ zOgk)*Hn#U|58&Coq&WW%=^Fvrr-)?l3#z36=_mlnh3{ps)M#qNlR{?w>8g zul8JYPG8ok(^9crZc&eVvfuikR;h-xKc3b7a8<-+G^O_OSS4Nu_05|rhJ^p!+mYr( zp#pJ+AXss<)@oaN#ov)!lhv?qEM4>b`kyKw5&4>IB1_IfpY+D-hP>2x2GHrrhW$i` zfb|c5A1mn574y6GYp=*lK0Z&mA*2*w)Lj?HYgKPxO!N7_9RbQs@dAbt>>&Vq5syfq z`O3RM#A_8yD(D`$kAO}RT;-rptcE<^=78&XvB%pG>g3(Jc}GecGE{%dDj zly)vB0`>h(@zkN)>k?1>Urx5|g{xhPHuuUP5EKCJqf<1lG7QOf{TGRd>hr4j6fu;6 zGk`|K-QD&6MVWW+h0X(tx|3^QfC$Dmw)TjQ#qqJ3FYo^`{#c}=Etkv?0&qVmH$o_x zcpR3Z0Am@*J{r-?VCAZy)Q>M_R%^M@KY2J9kO6azuIbu1f<~J=gM<1MN{b>5YBn~u zFJ_i=<@6d=28_cL^`vhP`|E`qp9X_ul=>9D$$$}rd~Z>CE1x9rRogCiN4C#GLice0 z4H(=U*4x@2(Y8Ms{Yfx0)`Q@UIUU4hX_@~A*ZIHsS?1OAdA!0P<1rx9(pp@OFN5`m_NcXo_-^sc!CjZ$p zxB%Waa>>XvZIJEd8WXAM07+z;e+i_>*-m-z2h&B31Rb^y&P>{EUxVYXTZsXalyyJB zfx6@Rqq)ub^*ze6GR9DJvS6K#`fBqV9VP?l*AFeAoG@v-Fe8ahvG&KCzUY43G7X6m z&V5P%mzvB6!12vS)8}-2$(|WF)%tBW_nIXbKIvT6pAfLDr`?Esd?#MhQ zE@8wWcd5yJs$t}IgYBZT?MfRiGF=>VI-}oD0m914%3P1ZzB5`#dODEB6|0xQhoZg) ziV{hkF;U-1q}Wl&>oi)$4kt4jkMibiN40uhU>(ldL>nl?C?uTpABi4Wfi=`@R%16D*V zdC|-FNhJ-a6b^dp(uiZA;dQm*($PCDc!xZt3Am4HxGt?g>%pX z2=DGp0gUe}=CK5^i-mCUj(1n@xMqTvo(7 znaJdM-&p@o=#_AzAZ#=5u<|3d2tSG!2Ak7@csOh?ky=vj{JW_ClG;p;eYt= zrVEgq0@7gQm>Bn=L_vHt>rDCZgBPk1u@o53KMB!4U#`9-F>FRiN83;_a3Gruj)@Q6 zMk`ktao>{)0jWl8j#FM50jK*rK%Z@<>23 zq}1GS@A4`cMaoOu@n&(x(v`dL$o8XiWQvj^_Xi>a9Tf#kZs0ctcMsZzH5-5U+j_w& zw-XK2V|aFzB<1cdF`5s_m8)i*7U(T4x#8gg2XA*mPu1YUzoT8P7ULP(D>lY!ZIet* z7GpYSf~^gFZqCAA6{0<>5rQ$l@wGkD7U^|)-=v49vLo^Ncyg;HxvaASh#)#+`Y?e& z6AGD(h)fs@wbS;Y2pyu!+sk!ivS798Kl2X;%aCscuKpJWm>}8B^HOT}xpMythSv%` zf^~=|aBAhUnJVMow&ZH_*I91G^vm;%q!5dg6Awfm#qKe~OC&KrnBC9@KYLFXRfV3# zqx4^XJueJ-ewJc7CRy72mp5IWzSVB8FO#SLG+?c>1F7Odgop`f<8ltTFG~uyQ z@ubCNw-so=s`Hv8P*h;HagXGG+m@8cA|zz}l63Ma`-<<7ZLXkOT*83=Xp_z*-AZaZCr`4uNKVa z+P@O8(8&Z0i^bMzdhyp(HKF?j^8bvxexM)BH~Myr;^ARwTNxvzR7F|^oX;(b_@E-SlOSK)0*T>TU7Vp%Z2w%v6(yz*o$k#U zi=|C!SJc1W%TfQ=XYOatt97Aid$?6`V`F4j*Sd~o^hjh79X*P68My0544)UnyVchE zA6bSJ8cgf(baY(skrEM=9^;oqN=dmJ)rRJA zzy5l-!#`4&Y4PXuKA~N2@1<~v{C#Cxjo$!ozyG;gQfEYbYII ze{1K7d5&eC+|d?YD#_=kdy&kB4{D6SZooH<%s}dA5cEv1y?Ng}`UBU4aFpP7Z@1mp_TFZeWpB0a^Hx+GiCcx!+V8U`mxYl z%*Cze-YiU!tsc*J!?6n!w0EJ$!6x}6jW4!(OAm& zJCQBITs+L`*CUaqkBH$~ZeS$R$nm{hHRC%&$4pOx>=$ z)>&2qof%-W`Cck(XVr$uD3m{X&>peQ&CT@$hNOSjT!qQZ{0pc9n7nVTg8JCHt z{2z7aol<&3B7Tnvvr-EBxOiuvMssFey-si9JeeD#_r5p7c0eX%(4c2|082oaZ0e8#Qd;Y6b^_PHXeEFP@x7Lh|>(E^akObNH$*s3P!|0^VKhSLMHV!7ap&X}AEViYM(g!E7bh>jC zWq5;MR8&1WvED7ey^^x4T-7@DgFfSRePnXFR z>q*!hH+~pV_Q!9k(`>#=NrpOuTXa-HFvyW0 z;LZQ1B#N`co0RnPgJ$fbR*UIJp_SFhS@g>m3@;#QB@l6~)+2CfilqWzncjjQ^0EpF z%n5dO3+Lpcqh-}$7QKb%cUP@**Q2kFUu2kKMPX}D?L2ze!`+(Yx9DQ;FHmK1*lk2 zq=K2uBf`j$%Q1Ai*9uRgV_9hlmy0dF&yOZnR#uo0=gUzU#H@uSjox3=gY3pTmiLcj z^gR2a^8rkFknGaj=l*|sBic-O_=~qqu@{kY$kjE_z~8@_1MSyLcVGSRRcaF8GBWfh zn!cczwxe_ac8a~-HF%}V{9OwRsB4L$u311@4Xa*WzPX`H%xxn`Eg&GxV|Vg+bFf-O z&XA@a`sG3Hn7ha={nm22LHPNZB{!`Ca90`wFoTV)!}t3F_H2#CkvGJzj1wKFt7ouf z*0U-lP+Y*HmXXn6Eti{$n%bGz1lG zWNYm=rlc?!G3zDl{7_v;a?#lJU;!=tRX6q=oO3W$0+6^2DHp7X-zI)OlTTG`~X&ja>ByE|Qnnz?*fZwY|BTCh9s@HM+=^M@X4SE*G)wA^qe=IY9%m?eaaf`Zc59x2sxG|%VE)i}=0PlFrF z0{sQC@8N+D%ni15XlUHtPPQVc1N{Pfs(y0=~AOiv-9qP zOQpJjmVv>GmKKYC1B}D^Cn{a0p7g#CN%VGcXGAu$&cT7o@8EJUZ&p?ucQ4g}0eXd8 z8KNSJ)tW0%;2^)td8eVFvF=fg^nlbv^58KhfJ(}NXl`!aCc4vRN4ehSg`JX;^6*!+ zAQH|V4gr6WM<$jqAPmUv4YLf&SyK~}l3=*ixh+#Cj4>?sbqIv2-z-u!aTq{UAH|b? zGxJL8yoZr>{**P!$dn+!s@s8u-CmSytu9|@JKLswgh_`?i3KseNszs4sFtEa3YJo{ z0Qte6ddoDDwSPA@4)k)dz=t^fX|tttSZjkL=CKXbrg8a7Ao>q-72)E%adsA)&Kp?m zx7sPy@Ionp&@)!>Ucl`%Ty8I!B3W+pyF)BPiaI71QRvK$>0+A-Yi4cMic~uQ@ciWP z<#4TYrAXP?7*4ivbgzu&wwdcHaX*2vYmE{ol$4R_dt2KIZ^xmsBy2d z7I#OYceiXFz!M#JWc&EQdn5x^;YC|;@1cSe(o9ktJ5p&xr?<`jt ztH9l&yKA+3GfT%31<*k7vc>ZX=}O8_Y9s^O!S2I*Xh2=%x35B<2o2i07gh)YQGKe?{$&>FQ1<2!YX* z^isvPEG^l7n5H8j+F3X2j%FyaHj8d_NSti-zyM+^v)y*^9jMm4g5Bm;h$pgN%rGl? zc|oi9?;QHTK;gvPTqrb>L;nXwTOYUiBL+!NkLT-3bN^wC@Y;IGpmw9ZFg)u0gaSa= zvceP5gWOnbDqbG(R^^nbax{|Pta=)BqWJw3^=BbI$tfwJ)C7WgW?|ek9i4SGd3)We zEkkh`8GMFe!%oiuyZxKx`HAUSlb0U2el)PWyi!<9Ov4J+N_E3%d6dvoVrKmN8rjhn z$EAj&uC*UcerBM1)5{qv&-;y!?k6h-$M#t)c!uyF0sS-z{_kZ337?QV zd8hX$@!@>EF2+xS)LsZa>wCEOhqG08W6Pg*WR7NPs9S%?teaf~IZFHiyZ{1p8zsJ5 zTK+)V9_)@scu8H+cUxRsq*K{imT2VL(m7Qb&l0c7C*$Jgehc^gyko(D_utX)57WXT z@&6bBsO<2D%Bm((Mxcg$5<=y_KpOhuDY2i1d8w;XSB@%PGKHzZ7Bo?Q(D6_`G(ZWd z%nUl%k_xYs!s$Omq|Db+W}69x+9=R9^9Bb7{P9qKXodZSvNdW4j>Arr>=X`;6HRj# z7A(Fcgb6T@0Fj1*5IE+!<2yFU!zHp_{_X$31et!&DOEmML?1@e@w*bISEG=pI-|0C z^pREN5bgZNtWL+T0}}7V2~Od0Ekva3jLx{{lf^a=cjd%M7;0iY#hcgBAQpK|cYjKU zLRaD;9p*vaXw=QR4DA>}YFX!+ zSQhbN+flzs8_Yv}bg(Pb`pTT6w;{I2^OM8WGn4IgP0<#F_@EyyQAzDPc__qRvh)X= z;dgsSODbFkdvNQIyJoh%gsh&Qn4m6iB(B03lle)Jl;(X@l%pzoWeOLGWf4*Zm7nM~ zz)e=2cq4syk{VCw(!}-#2uGMri^p2%5h;Ur`a_^{PXo@oE8$VcwH@pDLwZN|)9E5j zD4sJ4;)s-ng;P)zVz1kp<3x)q{k@|ApNrfT8+%x;v_MQyhhl-9V6#_~1_!UsiTov+ zsl91`(Yiu+H0Ng^7f&xz%rq845AdVC*1Gr_u(mq zJd1|ngoHoEJGvYNek+h4sZd}_$qsJ7vtM1n2>9Wr1WX&g0X#>M*+}R@omGS0FE!)^ z!G^H$0M%+}bp^EL1XlSv^{Xo=_-ewZP!g(5N+5MZSj>0I5qoJTX2;{QT+Z zd6N~@=zyI=rv}gjmmxmHooNPE7IPJ**4Ed{C&cubSO&Dln?2D@E_al+6^y;$Va(!^ z(sO%5G zBfcF5eBZtCSq$1J!M+<^g!g346ySD~J9gmPVSt4zmB8awp0r54$-D}eok*PB*$YR& zJc!Nrks*pukUTo=8Zbhl-ANJfI3-%DBaLCvm)>^TanbhD(Sc`d#V3o{V@AkREsB4z zPq&eZB5sTu6EyC#jUwa50Gu%r+Sz{ta3Qk}s`L{&wd39>ZnN3``1(-H_*TCzg;-3v z9@XFOx)R34x__J+FLAv5piAtVV;V9c@6ZTrgj$V@q4;*E`*Zf&yN_fS1XuXBJ%|1t zIesr|1cL4&pAx7ZWS&C+<3U0_L$~SAr%moO!3xLo{>VVU_Wi-x;dmLG0Ea!eGWtQ# zog}&9`?fUsf=2E4@t0?qi}g@ntqvb7Jv~x3&-3dldykQnpr4#zQgg*Ol;p9I-V#Mk zyzi{JhDHz2n_~TCygcdKo{gMo$A41_i|&sY8BvpY-Z{R51CAF50i)%%JPJw71C!V? z?6&t`UC-uVR>3=OO8C>$Q;ywd0)tuj$YL1OJi2eTs*c4wY%oE!@^;QI|ijq=Br7E8oVDG@(( zu&z8}NV7yO7uQU-J`|OTifr4hhj=ur6$Tj@hDnzP$>UV0r{jgzZ}IiK0pnq7m*V>7 z@~^7Bg+;`sMC;4>NtsP)O(mqS&vd2z3Q-tb*YonEw6XC$dMq8It2O{zh?vi0?wFg2 z3p+7^LK$=DQ2{VUMwu7jUf@_chy{O)FR!Old%gs3^n|2WyZ-Uyd)1A1T}9?n&CH%zyc2m&vHcyaa*ES)qyr!A_bI(rJ;v$a)u<8&5FIAm^;RU5Np}N;Uh*%w^vv zy8a$}rSqUUUJZ}}-ow|a8RTp5P<3_AsQa=ayt0+x zg6|uP%^mJ@>_g2Q&+I>eUvCwVuU+denR-bDr2?=rMIus?-A2*loyo+Sa?)pKAgl5ak1_4W{5w3W^1YS2wA3M5_~FcA|-j>X0u{&jUq_{xjgo|u}=O- zyo&Q%?vb}TKIro$2u*ir1 z<+mUPz&k7y@;H2v#UK|R9KmN-R#A~wm*=!R^05qXA$I~v^jv&mAi_&#?1IWkHK$36 zLZ7*)6CM>A7XN;b9+goKNZZZ1Ds(uf%Mbrw@u)`QC+ z)JFynX#ku-CgRznvkrU~m}kP>=0ga<(jh9x5a8w})vSV-D9#UGs<+Llyfq@(uPtI- zBv2A;E%kh$!kaDC42g6;eG>MtJzE36qn7ZUscxiK)<>kbUO~(kyd%p2M8j%4<1c+F z8400bvAG-HQ=b%4R{D>UlGGMyTXMfmFcpZgz^@@(_P-;_5tDUN13oZv=zqtXWWTV! z`gYwbHsnyXa6|bPF*>TS5QKRN-Zn$|g_7lTCXI#(8p_&AhtW>Ud{jk8@c?f>LG*wC zYURr`2TC2n13Yx1PwUj}Z!PUL1PIsG!=LWn$g$IWU*8hBsa~vky8Ac;8QqPu6i$~ zVZQ`A+vODnLKkghbKv{O1^agUWlKVV`&ytVg1B8@>dYV#mlOxX9O>-CX9Vo?O z0i*Q^>S-f)V8`vlsX{MRI&9F8OcUE*t$K;dC}NTvp6jExg{Cf#!;;%46cFdbCefM1 z!?cq-a4*{7rFKds0+$*1yXUQi?bzL?oAj(Lo!;j6B&il@*0f4=yk}b3(O96NGf5I> z(qGH&K0L&;q3%J>LC!w4 z!~=9+DYo^crtqJy`sEyPQ0sHDt6-%@+TQSE0VuXCV(oTZ34LY5ihA^iv%Fisw$buVB3IE6;Ca&=5J~2v^x^`8i#; zpZw`m%rEw6U`WItH5Z~Oy4(pQVV%U4Hi1vxNHm(UR1f}nQh2~ZsubAk8x&7FKa?rY z#02>f<`kge3=`m$>Qae{GQ}ZL2Kx{{R!s+E_F&@xc<%q(*T~LNB4ZVFpIDNC#3Ch? zwLTocZAolrdk_&3afq`jA_9qs+j=O4-*1b6OiCm)$k(l@rA3_LosX~YNBq<$z^t_3 z8bCBefNaxjME=t^+oigXnVC06);b0nnLmF9_lEh#$DI?!aFc8t?)3~~kO@Tv2YWUP zxE`(H9$FuYo`++CUR`^v09TtQ+`(+KBX>U6A$)jgc&++FL!by8AVtGTBINU7JU7#1 zw$#n@<@0+7EbN^8;^3uvn;hNPOsy7II9FF!wm)E^e13jMH#hMt5rh9!e!(D0A0PDZ zOLhJemHNa$iZIgP2IyQ}|4kya2ng8vDOy_-+1j3b#KJ-r7S{iIorx?V0Sh3b5>+C; z{}IJL73EjAIL1n6qGgws-WI)e0F#q#I0cGPlI<#~wQzcDVigivnOrX;*V8{Vn)W9K z{=tF0nudnn;&|$ba&6UHflpkhK&z$!q;*)!jm3Afc4bCWJ0(Dqp%3W>MT(@h&kn*+ zXg{5eZ6q+}MgvhLwo3s)2sygBeXVnM!7ET$g!r_C(AJ#BoRWeFsM(0|ZmIudo(wOK z@5GPy2W#y|ReVA~N{DoGW*9vzpi^o1_CrIcZcV`|Z+vUMwaobv1M!)RUcZcH-$04wfn|@5_X{{(S%o`KQ$XnV>{o79)e;%058G$h_tqrMtvX9yyIeHlXT8w zxlkWL_Ugf->@Y1YPWIDK{LbH`l#~I#($W%WRsq_zN~1lgkPl8o$@J$uA1_sn4zp>V zgTuq`f1tQS!=rsE70WL3MU|m5NjSH9+ERpfJ=ARAQ=!FMJeG_w8H}Dqlf_FK(Ni&C zvls0A6gQs14+|@yI+t2rrHSmaKPowMm5K?GG}IfYY+;7d7=M6U{a(dt*Z~8FsN9?Y z2iC6vNx2@);kJ9b56)O|YBgDyK^&iV=n0bPgMg+b;>E?`SAMU@ftgat!%cuNSaK1I zrzg*9J5&t)1=b!kRCOiKatH`GBy?Lpc;6gC8tins=kEwgHETl?pi}s%PR`CC{UV)% zwKCSn>(gi{NNTp>dgjC&JtePUESWyL|Kv9kAy1-uoJV>$rWM5Cl~ksR2PprL(xKGVu0;#N9KX1cP%M7 zd9uhu$<)+*>oo|W8d}qnvG^u-lvmTc^3FtNkZ59h8vKSu3Z&(sX+)Wwo&g>0VB_P3 z8f9fnF$&DCN^dtU9SuOHUhv&inFuQac&wwmmT26=`SEs4fbuaM+Vd}Y%H+!9Wa^`p z)j!+k+QeFH4Hn(uy^n22Q{TsqJz|&Yt*5GaK|>fcaeJnd`>r6w&G#*CX_z3-K$u_u z7hbm-k#~Uj#{KwwS6l%Y#%20fmcb~LZH)@}ZF6OU4Z5D~7kgIQKOYrt=nSm3aP5nq04LWs zNzYFLt^_Jf63q)AE@y4JwHk~C8|<#6mfa<^d8Jz2quDGcxH5z~URwd@RP>B)09#me ziI7A-`!j;+cwzo=_H|IZ%@gJN+FGp2)Gg{BJcqITcYA0bdeYS5{&pj%ID~)wZyDWg ziR%Xhtn}&gXZ*5WH6|FZ;T^MsMH?Y1a^c>b-hE8c-|wcKrHj|ASyQUcL#-a5>+R91 zMJz_gO>l8?0UH}&;JLW%;a3?G9^Yj1q;G(t2ycyFZyMRPl)7 zyuFTVXP;4r)t;3znY+7ti{j(rf~7P6vT^bn?M_Zso$o1NVHtGxw}ay?R~F!K83{&G zP>|YVNJ5=3~R!U`o0vX+;$Io|D=Ae_FiT@o*QU`k=ju|mkx?ghUmGH{+w{3* z00S8AkZ-Z4p@l{l1wW?XMt*B}_Pb@WvJAxhhC*%Bj@&Uz?QpJUFrFG;IWLr(grpp~ zZdbSa&hf;Wj^S5&*YxzSWT!mGO1My5U{k1tYv0{~jn0mK(@JQztJbSaM=2R|lzt zw%8dv$p|7@RtG5V-T9haR!eU%^DRtktn~21@A3<5?^l0KrvfYpTa8TMa80Wh*x1aY z1KJzmjOm~b@V|-iFn{7BsXP^qi_Z*s_a^4)dHvl1K7`wPM(=A@2NAGW{f8x`uq+SH z_06vLw-Xz08&EUq1_M|b;GP?#kS=H;%;O-ERJ0Z{TQ>jZcspw5ejJLL-W`Kt(La20 zu;7I=HO*P=zi#C@bJpJy$!7p7Z8Vi%5XbP&_ferIfkwBp<)-=St@r){vgm$$D%{-y z>Zm(|<4|kK}n6I`E8l_|h7gYQb|BVwhA>Q|Fm3Ut~f_+QIeWPwveQTw}VZ(#py} z!CV~>8b<)wMv5H*=F26rS`zMLc{2jTuh#DiaiU}zCmO=Yc*WXGs8$>#W-3HaD;RB;V_Xn0VrSUQd*d{+eA0#gR z{>^SB@+ZFdF`q`cWni~NQLPyu+8-bS2%YXmRjLW!YMgh`ZI`Zn9o%=0nv{9ixqB|A zQz`KvUjBWa_(S8FGI>f_5p3K%eRE@1ITScuQ@K=%BoFusI;iG3&kU#BhqE5ZZbmq` za6mN)JQJGUN?mF2FtOg`Ir%w51dOXOw}*(s5B9_z5-|E4?Cf-F+$VRUlGAAxps+dEf@Y|s`ifeVTBn(HG4 zT}AGmKPnh!S|v05qGA*bX#cW5?*_G9lpM`yhIi*)>TL^T$73aXnphHH<0Chy}=Ixk$2TP`7h!W>CAQn>o65IbLHGW0sG>5c$ZJ#7UnHShNGjd zcV!%WTy@bsa-cSi<_FWQCmv^z93v~q!GY>W7Y99uwNF$s3;{;Jrr4M&!hk(?Xb-K0 z6n)wm{@CPx%1n2|!-#P>X)>|Q!^m+t^SpD>^KysdC~s}w1vwSQepegYt=9?M^DQHClq! zPZiZ&B-Y`?i9;>@wR^Ldc=Pb^e$gw}pd+v&6aDsBCyJxs#!psQgtUedhe3?#Z}(Jz zF6Ey;Knq40WSpPs6{9u2`yX#*PR~3f=A2I#a*$G(mqY1QHL4AoX^oYMSJA5TCnET^;v$)t4j;y~_BA(cv3jt$9^|y1GlV zH!V%!_g-o8hTp~bPPT&TWobEIOj23rq6OUtKI2w9cEcYW{xiNiH7T~Ypil2GTc)(M zD&8~}!~Dva6q4*_wpjNiF(s!GA`CPxilAQ$>hx~IAQOSizMX=e(4(Db`CxcvnRW_W zn`Z$hCf)NbDb!N6%6GIDg4ZY0itauz4r@lMN@uN%9Xr!k$N@0GabRSsMic~pE!EkP zIMFqYB zw}Q)X2zacr&Sl!xmVx@h4$G#-MRUt!%b<5te`o~}RSJ$1dlC0Kk=CW^u+dr@gV%ml z>gsc4xezBKvB;AWs5Kw`_KZKE5FjeoNSN?Mx1KxRpKCkXHES>*=13xq`P?P6ih1n+ zg>B{-VKA?5sO-yJZ}G+84La@WUW*i7lmGg)8|cgu7ym25y@FU=RsOfarcTrfUF^;d zSF^VZbLTegGq7{6%^=3aJosPloffauKG6X%!^WWwEKoz}p6&mr-x?hd6vQo;IvM1S zq`+l!X;cS7S}kpIbSDQ0_Y%=W8r6+uI@z3K(LbAI!gb#dEGx|O4#bb zr17}Nw_kLKitOPkY;3CNHlWTUjNhEOVi^XXoYz zt1~ui56`ZaXFTC_p;hdN{Bq>wZ102@k0hJtcs;6GJZJs9ibKA=>Y?3+vD;PFYATV~ zgrbP2G3NLP_=qdh$8c~!H)hv~rwd;~Qdx~BDz_0=nmRP?n^v-ZpzJKwmu**VdO2`x z!aRsKiMAGNW_(R+`hZ3}E6#5saZSz#M|R4+ssCe6m|h21&{9{0l~9zvexx&&!<&=U zn3v-zHzuG5&FJHuM#WM{d@mU1iEXdAq$FE`SPAt!?SneE`tgFmT`Y=8Oo$X50g<1G zU{4Uf z?rb`>0e|AR-ldy2N`cStvt{b3c4639BrrfkS*$&+qQL{c73%9B$SGA<&k*$hB;j^H z>g&0Icdzp)<0Htg4M4&E0{eT986&3W6}&;8WUY*?-q1v2#=Cc9;4hNmYE0>SwQujz zcx$sj<%}G~QiN%Mm5z~mMZ4p;~em{9$$Uo7v_XqZm#3!UZ&U$x7#SBc-j`R*O!{>&Qvg}H ze5=$CbJ}i?|CP+l2-whZe^&bSH?!)|gL&D0rA!k}fHoMD48R(`_}@|saw?P-=TZr8 zf!W3z7a$AfSQ7WzW3e?yH(652y?CZO{CCB-PwfVp~^Tw&&&(kv?a9n zI=y*qZ_Ou4OPfl{pPvG{(0|$g`-|qqW+86HOEK%as3C2i&xL1Om51D=&F$lBkl;5r zH?$Hu#-Lg7W}ug0`Q4_(6EI}E5Lu0^?LqV}y=NhE$!co(A|l`d4C>t@->oKA@XL9( z@GT$|PC7g~l6R9&Ng}(wiLa>oN(fsLS_r@FzWF9s^1yE<7lup zfxfYH7RG_JN@UakH`h!qxu-xrH7BnCPJcCFy&CTQ2V|JGD6hYV`qPt}>4$cvrcr>_ z)M$I4;-`Sy=R>|(&`}EWM?4aE8n~SDwM;ajivvG`sA!i~>zLnsp#Y5*m0aY5E{{W^ zt_8$=jQzRlV|4@caUf3$@nP1_isFuxjbNZKdC{ahP)b%&!DyGr`Vi{H#l@wig)i+b zEdb!Y!I90aC6$@2Ye2OpiIW8~sFX>;wS(?`dk_kF|Gv6dFT#z+M**T?w{faM?(WXb z?m9#fPJ`7D99cTdI}hHf7F&r8iX8q5HNMy*yE8 zMa^Y16Ykay02P1c<|`$LGx*OC#^G-|?ydo#7-~o~1a`NV7+&_gJ5dcd2SK1?~C1s@&RPhutRAc&@=JsON08@Wr0#RI?Qdw0!B+AV_pGi>?9WoTd@m=$G;kM{92!eA{Rob=YIWdHkJM#|(0p;cSeLB7?5-MK;qCp!i z7?t|%1BJlR8~%i$@@EC0R930|Az8#?4-B-gp3kB5$a(kvxNNznD;qUo`kRrNKCXHN zQ+!Ht1TroIj%EAH(_KiarszzGZdiTs`uvkYUpr{FHNSypn1E==08l81Q;mr`I11Qh)EEkF?0a?!QTQC5*Zl-?V_^*U{FlPmzu}H|K|F>WJ zw>+t~u(3A42W(Ji?dIkw`ba4t#=&wz501PRkwB#P^TZtjw5U>OG6)9;2YybO%Z-7P z#a~?76co*?l5v863YcLrXwb#BKlxUBPWmJ00T^^7d{tV4%ifqwg$_%T&%aBH zB2n-y4jM6UVhFoT5_P~`9pS+?H>S6@cX*`tE4Iy7#Le`I<%aFays-YuwsVHK>1ob$ zJ_h8|Ooj7tQI|OC_+f?hHZwsi)o&uLwkfi~)f39VB)#M>VS(<8+rIGE*~}A0L`3wT zKA)G41Rh~@cnJmzXNlOLH#n?EhzB8Ls}`ZNaj}VkKt1@W>KbZ&4=DTDx#eobc0i{X z^r>&(c89-?qyu!{07HGAa~%p6{pLuOyjPZ)1|&+U!Pzl1Kj81q*b!zq=bEjYd?htOzJ8cx2@H z><)LVgo+WSo8>*irHtDizsmCge0HmUgob)^OHkytwnseg<=N83uC+BXUi%N-vjylt zfdmN!GJMYO_)Z5X2FVowQbJK%pxpKpqYu!EVJP}nno&M}bRut|aWk^e{9VB)B0`3O z$24$(P5WQJ(clkZ&b7HdA(u^#-59zJw!KE{CbIJKL0RikNkA{iTNXdY10IcXose|# zM&%k1oTZgj&1DxcuhYvT_e#491^@#D$ub3ogh=JwrN*uQ5_>mOWk?Q!dk^>pL<2q( zV%plj?!cpEc+O>bV~(^!xymEnGgow%kB(%*K2am7RU7vassLY+LJ7wcX$m6GxiBZ~ZE|R5@H0!3^6C0IN`-FY zk23I!@nq3xnaECu@8i}AoanLW`EF$dtJQSNEJjIUo(Y;>s~@R~ib}DuRRH+oCME-7 zPDS2WA@8~EkDVE=j8;eShNuK67BO)}MIJ16qO_bCO;}o5njXK!X2S0MQ`IJ& zVGR`+=#l(UTwJ{PL@iwbAf_Xs?2kWDK79dpc;L-L2E8|b;e;J}A44MeS6UHAG7tVn zxwmEjcm|*x)Nr;CaNhbKtMe1^B@(`7Dmk=bNCty)EPmtfs^D>bbTs!2m&mn3Dm&LB zeZRr)~Z^ir){#*3~uZ)8jY^hYILW0^1P%5Xq*45 zxT}0?@_qXf($Z`&N>XrA64EFzLPB!1NUC%=y1N+yQc@EUlkjv=s1h7H;|4nMbk)Du4t5cubTD=8!M4>@)_ zd=*kuWJ^L%2n1@=yAVEC`TmwCc4^S|5FU4svhKo;n)D+#$#C}RuE85HZ zoftU?4{)Cl9I1Ez)l-dy?4Izuq=g5)mP>=a`>_r!S;GvO{x;t^ z?b)aEa4gZAqWuXs1cb7;17@bdw2tZ? zMv7d!3LTwF(QY!oM_z7D=^1@1QeWGju3FX616>~hyT@64D`IZ86f`spWoWJK0rsfb z!_8{z^ZW1R{PAXK-ShrPo0Urc4pU*MTCVqB(Oq!;LyAaQol=U$Hl{Q2M;epIC$0iYeH;fZn=2H^EQe? zosMucX9O~AO)H}}Tinrvao*VESN|#?4sCD>eWw8s1mbhZFOL33wgnQuxasUR{`!ih zFNyiEdk3J#z+xYPkG-(7gF!BfU#o$|`De187~?3pT7ngEnrp(#cGxzqdc{=q^-l~( z#FggFP;l7`lYj7fPB97? z*yvj@eExjD5f>)CaZAEzMRlRh=c%1vDf1a<^GobFDooeI^t)qU!kh`M;;1vq*+K zN23cWK1Zc%fH}psq`SIZY>p3l$Hpgnu6hTnyqD!o7(FB66i@VzbVI-qz?tgiQIQCp zuHZ1^v>z3p6mNITzh)C519WBQ6$pT~m79?PCZfVn88u$`>}}~*ONCuAML)PrpRPdo z@DZEuOqDKD&9iE?UHsK7s@VzhsBE}%2~QibSnam2cZ9|AWU1{YsR#m-7 zUi3fh?p$I6Xevmp90_Nlr_5=gqw?%Cv-37f3sN<@EaroLtH0KfF)&79w_8ArRwP&` z&*pcD`@cROiKO1z$x!)r@^`Gz#=l|cV?3U5l@EW9HL2ezMi9Drfu63kOvcF*>y9q6 zj*Ez7%KCC19Ur@I3`r?RL<0x}0WjMbFL!)N0TDy8eoFrWUz^#d1E>z6O!}V+;_MiJ zQw48-pH$NS8sD_hArzPo6d-cm?Hz0zZRsnkxpPp5tcStu$m?9ENx`^LhWK|6D^2_3 z;@FqiQF#imuK7n8PK#Pzt-~Q#>=wSv7gOJS@4RS@BLqEYbKAr0VfBLV;C=w_OIRCJzkuB z2vC;_oi9f+#jb+^Su#u1jW{jfvFbDj_}+`WT*BAPk!FHGw$HqA!9dONa)L8owr}#! z%?j*DBY{ia?0f!&im^c@U8 zX&?OCk?87EWettxXMb!KJF%uKTxT^4=F7f(#J`-B_BA;Al3Xpm^SS;2Fh0&qFzrBvRI+1Xe* z`)g673O2(B_pN|+;$a6QI4Wc1(J5yqcbuHcXjtjuBOZ}DWrw3#i+->$GH1XRTPoCs z)m~Z&6mZN%?9l?d6rld&W^ZAttMep~5EP^Ycx&|O2T>jd2J}r%;}a99>F(w50Qw== zlRe$A();`zqN1sCMtbm`l}?<9{Q@CSwgDDjKLLmAz&0~_68fru^QVCAWm^3;yMix~ zy0%NMjb(3Voq4m6pjn?V7B(6YK{%9oPDP)dR){L;Kfb!Fdf>b$9&uICRB1U==gWLO zU)5mz#$=Bd$-oea@rN#b(P_iiOibLvz{I@%&PK8=wtgQDzFzP(CuyR9YLIVj0SHmA z6v}%?|9TY>bjXXhySvLMAHaAiIf;Tfracm%0?0H@Ejpq8sVT0dmuylAo|~iH%R=7D zs^3Ny?ItMhP*5LVHDl`OE!j2Yg1WdT%gu>($ttt*qI z9{|$;v@wR*^#a)pFOj@dYRBHpw}MMbzQ|IpEc=ES6Q1Eu5-MBu8qiY<+)2rhr5CW6 zdw3Z6I;H^OHZ3liRPR#0*;LbFpYnyVh>s75s&h*>s3Sxqe$>-F49$w?y*sowci7&~ zD1U!_75DAblk(+ta+ZwuM(~KYVEYYjlrQ|pw58>PcbmhBN`4n`1Ew#qEn8dLIO#I$ zxykQ|bEV~_42^!Z{+DI^(g?Erze8Q8y}f*A+tBI-opv;Hcr^rwvrq|IveFGIsVI$1 zpW-U^hpv8gp8)A{U7wt}R}c5iL6(F372nTjXa=ye2VapoxD1hG9dvO&@bxUs%mM-p z$jk)gN;Pd?js(va-UJTA?}{JL&Y$NF z>GEN|CZ&>0$3s2eg(tQP4BG}#pUF0);L+7yr@V5;<-h$+KS>n+3UJZG+lRHoWQC z7RPc5cd%Co3ho`Ac4vFTt<5&P0D9$J{y%|l+C?l)vz+&l>)rkRGf8*^7a!2RGRDTn zF@bsEM4f#XC&A6{1pJwAOk3I5ozy^F>y1k>stD&hirtDUD>DQL1Y{`YJz2SSv=Mm7 z^&*t>?R$^(rLq#K&k&|Z$c@2BOslkFxU_lG-lFrp+%zU4QYf4gt0SKU4Wn~A>DWNC> z0|>QLAg|uU1a@biZI=L@q8gHbEC}xZ zlEk_HW$V5D7oeve_WyActx1gP(uw6dSA8MIxO-l0S`HGdKwG&k*TXJUlqY`_k^YX) z5VWe=)G_}WaNagQ_PTB+FDt6!){XsN;0rn;i)~Zdc*@nS%1TPV^tNJoCCu_;VoX!T zLa(~lZ^SiZGIAKVm6fUD((WBEn47z8t;l08y+Q9;*wPDBm5V^?%<>(vbl(hpzZOya z9z(upqS~Uu7A}!cQl$O&zBZ*CAoO8(JKi>&Vihg5HxV;#6(oJ~+adXN>EyQ z2A8jr$A>^JoGK@u@Jib}??w3mlL$W0qjUV8CF)m0z{rMo|&@_AU22z!{Sq%IsJapwpiB z_ANe^Lum|K-B$92;Gw9f$o_e$uz^v%aWE|{ys)T<&=1X4j}X5#)N@iv-rl#5O68OG zB?G3GDsDQ|Vd3ErIryKoi{qW~#^fBnPQD6r{!ST3THWXHB;C+ZACDfl37o>k7TxcF zHgH}ZLFk-x_3-!7dq5aVY`K|ePfN|hU1tqxOzYg5&U1O7{78-=T@#s^|I)ie&M7|j zDy02EAl(SskCXG4R8etpM-3CPn*eNprbfFmJQ60e|7q%V!Gwd>&P1^mY*RZISeGq6 z6W@~Vs5)sH#GicY_N0!Y@@LUlHYHN(9gc^SwVxA-h#Zc!TPnzcX+kqIoB5yuxbIw! zA~JrI@(WE&;j*$l@8Sl?DA;5v(7CxZ5J&?51XoH%hS15!fF@E;>rHD+rZ7E2Zr_yU z{`b5F0fO4+aiBmSk25+FMg~6(_Lw`4iyT@bN-t=(VR%eNBTHsf8l86^T3L07NkoyyqG4RJa0 z&Y!o!^=^Rll44!<7&W<~2PO-j8!CR*+0CE)Mak-3;drh#`*mp|8X7FvjF-jcayXn_ zT#^RJKD@RlRiFMj83zH9BRWthPIJj%JaVw$!$l#!g6rQ4ALGHRD=T9~^1!^WiAvcy zT~AO`Q?sYRc|N69#*Bf7+>r3#+0@hm#mf)XK@nwXVzy~1DM<{ZP#O>@DNstvIt{bB z8ak=<+8FJ?@WxMIU|^t7^oxS-)~@_5K&`I&IHa8s$DAkt)Vvo0`dw$ECGQv5xwNx%NjnZ9--$)wa%-3U^aBK zEvX{q`YIMmOAS7K*q6YTct`y^3HvGiS6OtGuLcCp`ye|1Mr|nB|F(P^UXz|)n9c3m zB^4E*zkGJtQ;t7Zj{b;B`k$~oe}7J^5*@jOh-1?=`;?H7E(|Y5m+~YOX44$}{Wx#G zxwAt)7|qPyxY-#(T@+JV>aWSi$*>QA1ozG8wm z(utDYIXRawoW}UA(o%NoZ%NO9?!sGbxrQci;UXr`C2$d$?|o}_wpCb$mkf4KyK7_# zw6Wng;rYnT%L}9-GG04g?MXaw!Z4W8S)Ok;*lwl#c3`%a7;03}mnS#-IXj%fgrK=t(>vlP6ggH_q_cFZU#m&7fa z6n%6yuwYdB`S@B4%1kL|!R*|Mu%Ow;6u~hJG^L&7sd+|!-QR9F8E1^-W`E2b$z@+i zAm>CCBYBbcG#RN{1#@#Iqq5-9Swh;b4e~TJ^}JdZ<%Qbsyv?(=5oc8gblT~sS2Gv+ zZXS_nv_ List[Path]: +def copy_images_list( + image_paths: List[Path], image_dir: Path, crop_border_pixels: Optional[int] = None, verbose: bool = False +) -> List[Path]: """Copy all images in a list of Paths. Useful for filtering from a directory. Args: image_paths: List of Paths of images to copy to a new directory. image_dir: Path to the output directory. + crop_border_pixels: If not None, crops each edge by the specified number of pixels. verbose: If True, print extra logging. Returns: A list of the copied image Paths. @@ -276,6 +281,13 @@ def copy_images_list(image_paths: List[Path], image_dir: Path, verbose) -> List[ shutil.copy(image_path, copied_image_path) copied_image_paths.append(copied_image_path) + if crop_border_pixels is not None: + file_type = image_paths[0].suffix + filename = f"frame_%05d{file_type}" + crop = f"crop=iw-{crop_border_pixels*2}:ih-{crop_border_pixels*2}" + ffmpeg_cmd = f"ffmpeg -y -i {image_dir / filename} -q:v 2 -vf {crop} {image_dir / filename}" + run_command(ffmpeg_cmd, verbose=verbose) + num_frames = len(image_paths) if num_frames == 0: @@ -630,6 +642,76 @@ def get_matching_summary(num_intial_frames: int, num_matched_frames: int) -> str return f"[bold green]COLMAP found poses for {num_matched_frames / num_intial_frames * 100:.2f}% of the images." +def polycam_to_json( + image_filenames: List[Path], + cameras_dir: Path, + output_dir: Path, + min_blur_score: float = 0.0, + crop_border_pixels: int = 0, +) -> List[str]: + """Convert Polycam data into a nerfstudio dataset. + + Args: + image_filenames: List of paths to the original images. + cameras_dir: Path to the polycam cameras directory. + output_dir: Path to the output directory. + min_blur_score: Minimum blur score to use an image. Images below this value will be skipped. + crop_border_pixels: Number of pixels to crop from each border of the image. + + Returns: + Summary of the conversion. + """ + + frame_json = io.load_from_json(cameras_dir / f"{image_filenames[0].stem}.json") + + # TODO Add per-frame intrinsics + + data = {} + data["fl_x"] = frame_json["fx"] + data["fl_y"] = frame_json["fy"] + data["cx"] = frame_json["cx"] - crop_border_pixels + data["cy"] = frame_json["cy"] - crop_border_pixels + data["w"] = frame_json["width"] - crop_border_pixels * 2 + data["h"] = frame_json["height"] - crop_border_pixels * 2 + data["camera_model"] = CAMERA_MODELS["perspective"].value + # Needs to be a string for camera_utils.auto_orient_and_center_poses + data["orientation_override"] = "none" + + frames = [] + skipped_frames = 0 + for i, image_filename in enumerate(image_filenames): + json_filename = cameras_dir / f"{image_filename.stem}.json" + frame_json = io.load_from_json(json_filename) + if "blur_score" in frame_json and frame_json["blur_score"] < min_blur_score: + skipped_frames += 1 + continue + frame = {} + frame["file_path"] = f"./images/frame_{i+1:05d}{image_filename.suffix}" + # Transform matrix to nerfstudio format. Please refer to the documentation for coordinate system conventions. + frame["transform_matrix"] = [ + [frame_json["t_20"], frame_json["t_21"], frame_json["t_22"], frame_json["t_23"]], + [frame_json["t_00"], frame_json["t_01"], frame_json["t_02"], frame_json["t_03"]], + [frame_json["t_10"], frame_json["t_11"], frame_json["t_12"], frame_json["t_13"]], + [0.0, 0.0, 0.0, 1.0], + ] + frames.append(frame) + data["frames"] = frames + + with open(output_dir / "transforms.json", "w", encoding="utf-8") as f: + json.dump(data, f, indent=4) + + summary = [] + if skipped_frames > 0: + summary.append(f"Skipped {skipped_frames} frames due to low blur score.") + summary.append(f"Final dataset is {len(image_filenames) - skipped_frames} frames.") + + if len(image_filenames) - skipped_frames == 0: + CONSOLE.print("[bold red]No images remain after filtering, exiting") + sys.exit(1) + + return summary + + @dataclass class ProcessImages: """Process images into a nerfstudio dataset. @@ -904,11 +986,11 @@ class ProcessRecord3D: This script does the following: 1. Scales images to a specified size. - 2. Converts Record3D poses into the nerfacto format. + 2. Converts Record3D poses into the nerfstudio format. """ data: Path - """Path the data, either a video file or a directory of images.""" + """Path to the record3D data.""" output_dir: Path """Path to the output directory.""" num_downscales: int = 3 @@ -971,9 +1053,128 @@ class ProcessRecord3D: CONSOLE.rule() +@dataclass +class ProcessPolycam: + """Process Polycam data into a nerfstudio dataset. + + To capture data, use the Polycam app on an iPhone or iPad with LiDAR. The capture must be in LiDAR or ROOM mode. + Developer mode must be enabled in the app settings, this will enable a raw data export option in the export menus. + The exported data folder is used as the input to this script. + + This script does the following: + + 1. Scales images to a specified size. + 2. Converts Polycam poses into the nerfstudio format. + """ + + data: Path + """Path the polycam export data folder. Can be .zip file or folder.""" + output_dir: Path + """Path to the output directory.""" + num_downscales: int = 3 + """Number of times to downscale the images. Downscales by 2 each time. For example a value of 3 + will downscale the images by 2x, 4x, and 8x.""" + use_uncorrected_images: bool = False + """If True, use the raw images from the polycam export. If False, use the corrected images.""" + max_dataset_size: int = 600 + """Max number of images to train on. If the dataset has more, images will be sampled approximately evenly. If -1, + use all images.""" + min_blur_score: float = 25 + """Minimum blur score to use an image. If the blur score is below this value, the image will be skipped.""" + crop_border_pixels: int = 15 + """Number of pixels to crop from each border of the image. Useful as borders may be black due to undistortion.""" + + verbose: bool = False + """If True, print extra logging.""" + + def main(self) -> None: + """Process images into a nerfstudio dataset.""" + + self.output_dir.mkdir(parents=True, exist_ok=True) + image_dir = self.output_dir / "images" + image_dir.mkdir(parents=True, exist_ok=True) + + summary_log = [] + + if self.data.suffix == ".zip": + with zipfile.ZipFile(self.data, "r") as zip_ref: + zip_ref.extractall(self.output_dir) + extracted_folder = zip_ref.namelist()[0].split("/")[0] + self.data = self.output_dir / extracted_folder + + if (self.data / "keyframes" / "corrected_images").exists() and not self.use_uncorrected_images: + polycam_image_dir = self.data / "keyframes" / "corrected_images" + polycam_cameras_dir = self.data / "keyframes" / "corrected_cameras" + else: + polycam_image_dir = self.data / "keyframes" / "images" + polycam_cameras_dir = self.data / "keyframes" / "cameras" + self.crop_border_pixels = 0 + if not self.use_uncorrected_images: + CONSOLE.print("[bold yellow]Corrected images not found, using raw images.") + + if not polycam_image_dir.exists(): + raise ValueError(f"Image directory {polycam_image_dir} doesn't exist") + + # Copy images to output directory + + polycam_image_filenames = [] + for f in polycam_image_dir.iterdir(): + polycam_image_filenames.append(f) + polycam_image_filenames = sorted(polycam_image_filenames, key=lambda fn: int(fn.stem)) + num_images = len(polycam_image_filenames) + idx = np.arange(num_images) + if self.max_dataset_size != -1 and num_images > self.max_dataset_size: + idx = np.round(np.linspace(0, num_images - 1, self.max_dataset_size)).astype(int) + + polycam_image_filenames = list(np.array(polycam_image_filenames)[idx]) + # Copy images to output directory + copied_image_paths = copy_images_list( + polycam_image_filenames, + image_dir=image_dir, + crop_border_pixels=self.crop_border_pixels, + verbose=self.verbose, + ) + num_frames = len(copied_image_paths) + + copied_image_paths = [Path("images/" + copied_image_path.name) for copied_image_path in copied_image_paths] + + if self.max_dataset_size > 0 and num_frames != num_images: + summary_log.append(f"Started with {num_frames} images out of {num_images} total") + summary_log.append( + "To change the size of the dataset add the argument --max_dataset_size to larger than the " + f"current value ({self.max_dataset_size}), or -1 to use all images." + ) + else: + summary_log.append(f"Started with {num_frames} images") + + # Downscale images + summary_log.append(downscale_images(image_dir, self.num_downscales, verbose=self.verbose)) + + # Save json + if num_frames == 0: + CONSOLE.print("[bold red]No images found, exiting") + sys.exit(1) + summary_log.extend( + polycam_to_json( + image_filenames=polycam_image_filenames, + cameras_dir=polycam_cameras_dir, + output_dir=self.output_dir, + min_blur_score=self.min_blur_score, + crop_border_pixels=self.crop_border_pixels, + ) + ) + + CONSOLE.rule("[bold green]:tada: :tada: :tada: All DONE :tada: :tada: :tada:") + + for summary in summary_log: + CONSOLE.print(summary, justify="center") + CONSOLE.rule() + + Commands = Union[ Annotated[ProcessImages, tyro.conf.subcommand(name="images")], Annotated[ProcessVideo, tyro.conf.subcommand(name="video")], + Annotated[ProcessPolycam, tyro.conf.subcommand(name="polycam")], Annotated[ProcessInsta360, tyro.conf.subcommand(name="insta360")], Annotated[ProcessRecord3D, tyro.conf.subcommand(name="record3d")], ] From 009e21be248418028e6303ecde593a20ef88fa87 Mon Sep 17 00:00:00 2001 From: Matthew Tancik Date: Tue, 15 Nov 2022 21:06:54 -0800 Subject: [PATCH 68/68] Fix loading in inference mode (#965) --- nerfstudio/pipelines/base_pipeline.py | 3 +++ 1 file changed, 3 insertions(+) diff --git a/nerfstudio/pipelines/base_pipeline.py b/nerfstudio/pipelines/base_pipeline.py index c0927c57a..d5a8b1ec0 100644 --- a/nerfstudio/pipelines/base_pipeline.py +++ b/nerfstudio/pipelines/base_pipeline.py @@ -360,8 +360,11 @@ class VanillaPipeline(Pipeline): """ state = {key.replace("module.", ""): value for key, value in loaded_state.items()} if self.test_mode == "inference": + state.pop("datamanager.train_camera_optimizer.pose_adjustment", None) state.pop("datamanager.train_ray_generator.image_coords", None) + state.pop("datamanager.train_ray_generator.pose_optimizer.pose_adjustment", None) state.pop("datamanager.eval_ray_generator.image_coords", None) + state.pop("datamanager.eval_ray_generator.pose_optimizer.pose_adjustment", None) self.load_state_dict(state) # type: ignore def get_training_callbacks(