Commit Graph
118 Commits
Author SHA1 Message Date
SebastiaanandJ.Y. 096116097a installation.md: Remove manual gsplat installation for Windows (#3333)
* installation.md: Remove manual gsplat installation for Windows

* installation.md: Reformat and clarify Windows instructions.

* Update installation.md

installation.md: Minor change in wording

---------

Co-authored-by: J.Y. <132313008+jb-ye@users.noreply.github.com>
2024-08-19 15:44:41 +00:00
Sebastiaan bf3664a19a Update installation.md: Add missing Pixi documentation (#3302) 2024-07-12 16:25:04 -04:00
pculbertson-bdai 592615ff51 Make awscli an optional dependency (#3279)
* removed awscli from deps + added warning during attempted download.

* update docs to flag manual awscli install to users.

* add awscli to dev dependencies

* add proper awscli error handling to ns-download-data

* minor typing fix for ns-download-data when awscli is not installed
2024-07-03 19:43:59 +00:00
Congrong Xu 4fb09bebd6 Update installation.md (#3213) 2024-06-12 13:13:29 -04:00
Congrong Xu 43ab3616f1 Update installation guide for Windows (tcnn+gsplat) (#3212)
* Update installation.md

* Update installation.md
2024-06-11 14:29:26 -04:00
Pablo Velaandmaturk 8d5502db1a Add Pixi as an option for installation (#3130)
* pixi installation optiont

* chore: Update .gitignore to include /third_party and include pixi lock file

* feat: Update download and training commands for dozer data

The commit updates the download and training commands for the dozer data in the `pixi.toml` file. It renames the `download-sample-data` command to `download-dozer-data` and modifies the `train-example-splat` and `train-example-nerf` commands to include the dozer data as a dependency.

This makes it easy to run an example training for both nerfacto and splatfacto

* update to include range between 3.8 -3.10

* Add Pixi installation instructions to the installation.md file

---------

Co-authored-by: maturk <30566358+maturk@users.noreply.github.com>
2024-05-19 11:56:30 +03:00
Justin Kerr a64026f8db shift principle points by .5 in undistortion (#3071)
* shift principle points by .5

* fix ordering

* add fisheye offset
2024-04-12 15:32:22 -04:00
Brent Yi 1bc5b424b4 Update viewer docs (#2826)
* Update viewer docs

* Typo
2024-01-26 22:30:50 -08:00
VasuAgrawal 5988c7ee7c Add documentation on existing datasets (#2806) 2024-01-23 09:54:13 -08:00
Brent Yi 55b7a2c8ef Update docs to recommend torch 2.1 (#2748) 2024-01-11 15:12:41 -08:00
Otto SeiskariandMatias Turkulainen 626441e15e Add instructions for data collection and processing with Spectacular AI tools (#2668)
* Add instructions for using Spectacular AI tools

Adds easy support for new device types: OAK-D, RealSense and
Azure Kinect, as well as an alternative pipeline for iOS.

* Grammar fixes in docs/quickstart/custom_dataset.md (Spectacular AI section)

Co-authored-by: Matias Turkulainen <30566358+maturk@users.noreply.github.com>

* Fix section label in the Spectacular AI section of custom_dataset.md

* Update custom_dataset.md: typo fix.

"montions" -> "motions"

---------

Co-authored-by: Matias Turkulainen <30566358+maturk@users.noreply.github.com>
2023-12-15 18:37:27 +02:00
Boris Feld a894c6d938 Update first_nerf.md (#2677)
Update documentation to mention that Comet visualizer can be used without the viwer
2023-12-14 08:47:51 -08:00
Chris SweeneyandBrent Yi 6ccbc2de45 Add support for Project Aria datasets. (#2617)
* Add support for Project Aria datasets.

1) An export script for processing Project Aria datasets
2) Add support for Fisheye624 cameras
3) Add support for center-crop masking and sampling

Example commands for running nerfstudio on Project Aria data:

python scripts/datasets/process_project_aria.py --vrs_file=<path_to_vrs> --mps_data_dir=<path to MPS directory> --output_dir=<nerfstudio_data_dir>

ns-train nerfacto --data <nerfstudio_data_dir>  nerfstudio-data --orientation-method none

* Clean up type errors

* Fix formatting

* Fix linter errors, import, and use absolute file paths

* Add aria subcommand to ns-process-data

* Appease ruff

* Add Aria to docs

* Fix docs, add back import try/except

* nit: path.as_posix() -> str(path)

---------

Co-authored-by: Brent Yi <yibrenth@gmail.com>
2023-12-12 22:18:13 +00:00
SeaOtocinclus 6cbe070949 Update data_conventions.md (#2534)
Fix typo in `distortion` word
2023-10-16 23:11:43 +00:00
Cyrus Vachha e9a3bae859 Update URLs for readme and image references (#2527)
* Update URLs for readme and image references

Update the image URLs and documentation links due to change in docs url structure. Files edited include readme, documentation, and legacy viewer files.

* Updating url in custom dataset
2023-10-13 22:23:20 -07:00
Piero Toffanin 42cabedc60 Add ODM data processor (#2517)
* Add ODM data processor

* Fix ruff warnings

* Re-format with black

* Add annotations

* Add explicit dtype

* Add explicit dtype

* Revert "Add explicit dtype"

This reverts commit 6f3cde1671.
2023-10-12 20:08:45 -07:00
Jami PekkanenandMatthew Tancik 81db1808a7 Add documentation about unknown depth pixel convention (#2490)
Updated the documentation to explicate that zero value in depth images is treated as unknown depth. This behavior is defined in https://github.com/nerfstudio-project/nerfstudio/blob/a484d255b4f71c55915afcfc52d90ec88963779f/nerfstudio/model_components/losses.py#L242

Co-authored-by: Matthew Tancik <matt@lumalabs.ai>
2023-10-08 21:26:10 -07:00
Gina Wu 593950efec Update colmap installation instructions with conda (#2473) 2023-09-27 10:45:58 -07:00
Sid Mehta 7269a7ee16 Add Comet Logging (#2431)
* initial commit

* fixed naming

* added comet_ml as depedency

* added comet to docs

* Update custom_gui.md

* Update models.md

* Update benchmarking.md

* added Comet to ReadMe

* added decorator

* fixed link and added comet examples

* fixed link and added comet example

* fixed format

* fixed type ignore error

* fixed readme typo

* fixed typo
2023-09-15 09:21:09 -07:00
MocaxandMatthew Tancik aaa6c3aa1d Fix the starting command of docker. (#2357)
To prevent abusing of root privilege, please use custom user privilege to start.

If not, sometimes the Docker images may be started with the permissions of root or other users. If you modify the mounted files in the container , it will cause permission errors or other errors.

Co-authored-by: Matthew Tancik <matt@lumalabs.ai>
2023-08-25 01:08:56 +00:00
Kate Yurkova c599d0f3a1 fix: Allow custom user ID (#2334) 2023-08-12 20:17:38 +00:00
Kate Yurkova 5eb83e8acd Account for num_gpus rename in docs + test configs (#2332)
* fix: num-gpus to num-devices

* fix: Update test_config1.yml

* fix: Update test_config2.yml
2023-08-12 11:09:44 +00:00
Frederik WarburgandEthan Weber 9b03299d40 Train and eval data splits (Nerfbusters) (#2207)
* nerfbusters dataparser

* nerfbuster dataparser and visualization of eval views

* resolved some errors from  pyright

* enable ns-process-data to take two videos as input and use one for eval and the other for train

* resolve some pyright issues

* instead of data being a tuple, I added eval_data as another argument

* implemented train eval split for all cases

* implemented train eval split for all cases

* reverting equi changes

* reverting reality capture changes

* raise valueerror

* revert comment

* added split override code back to dataparser

* reverted one change

* using image border now

* adding docs

---------

Co-authored-by: Ethan Weber <eweb0124@gmail.com>
2023-08-04 10:11:55 -04:00
Brent Yi 72da747fc2 Remove system-level CUDA install from install instructions (#2289)
* Remove system-level CUDA install from Linux install instructions

* Remove system-level CUDA from Windows install instructions

* Un-flip CUDA 11.7 / 11.8
2023-08-01 22:50:22 +00:00
Brent Yi dab39c25b4 More robust install instructions (#2277)
Add cuda-toolkit install to readme/docs
2023-08-01 20:35:22 +00:00
Cyrus Vachha 8682e481b1 Render VR180 video (#2261)
* Render VR180 video

Adding the VR180 camera model to render VR180 video and images. I condensed the omnidirectional stereo and VR180 render post processing in the render script. I have updated the documentation for VR180 support.

* Condensing formatting of camera types

Condensing the if statement for camera type intrinsics.
2023-07-24 07:26:20 -07:00
Cyrus Vachha 554dec77f2 Omnidirectional Stereo Update - Alignment and Compositing (#2217)
Update to omnidirectional stereo rendering (VR 360) to fix slight positional alignment to accurately composite with Blender objects. Modified documentation for ODS and the Blender add-on to include details on Blender camera settings to composite with the Nerfstudio ODS camera model.
2023-07-13 07:59:10 -07:00
KaerMorh 18ab50dc6b Correct path notation for Windows in documentation (#2171)
Fixed an error in the documentation where the incorrect path notation was used for Windows systems. The documentation had paths denoted with "./", which is incorrect for Windows. This has been corrected to ".\", the appropriate notation for Windows.

This change ensures that Windows users correctly follow the instructions in the documentation without encountering any path-related issues.
2023-07-04 08:14:15 -07:00
Ilya Basharov 5c4b0a1dd6 add build-arg cuda version to dockerfile (#2139) 2023-07-01 17:06:05 +00:00
jlightfoot f22e9f4db9 Fix quickstart doc for remote host viewing setup (#2101)
Fix remote viewing setup doc

SSH command should specific localport:remotehost:remoteport rather than localport:localhost:remoteport in -L switch.  Changed description for clarity.
2023-06-22 16:22:45 +00:00
893730fa05 installation.md: Use https instead of ssh for git clone. (#2030)
* installation.md: Use https instead of ssh for git clone.

Https git clone can be run by anyone directly, without account, whereas ssh git on Github requires having a Github account set up.

* Add .git

---------

Co-authored-by: Matthew Tancik <mattt4001@gmail.com>
Co-authored-by: Matthew Tancik <tancik@berkeley.edu>
2023-06-04 19:23:12 -07:00
Cyrus Vachha 6993f75dc8 Render Omni-directional stereo video (360 3D VR) (#1986)
* Render Omni-directional stereo (360 3D VR)

Adding the omni-directional stereo camera model to render 3D 360 video and images for VR. This includes the camera models for the left and right eyes and additions to the render script to stack the left and right renders for the final render.
I have also updated the documentation on the custom_dataset page to have information on ODS but let me know if there is a better place to put it.

* Updated ODS camera model and render paths

Updates based on suggested code changes including adding a helper function for ODS and improving path creation.
I also added a part where if a user tries to render a video with an output path that doesn't have an extension it will automatically add .mp4 to the end. Otherwise this usually results in an error when there is no file extension when rendering a video.

* Updated formatting for render and cam path scripts

Updated python formatting for render and camera_paths script

* Adding type checking for ODS function and reformatting camera type code

Added the type checking and doc string for the ODS camera rays function and reformatted the cam_type ray if statements.
2023-05-26 18:01:13 -07:00
Matthew Tancik a90602060b Update installation docs (#1970)
* Update installation docs

* Update instructions

* Make tcnn consistent
2023-05-22 17:39:32 -07:00
e898f562e6 Switching to Torch 2.0 by default. (#1922)
* Update requirements for torch 2.0

* Update docs

* Fix missing _LRScheduler import

* Fix pylint issues

* Update docs, drop 1.13

* Fix pip postfix version

* fix docs

* Allow python 1.13 (for now)

* Minor fix for torch.compile

* Switch to torch.compile

* ruff

* Fix test

---------

Co-authored-by: Matt Tancik <mattt4001@gmail.com>
Co-authored-by: Matthew Tancik <tancik@berkeley.edu>
2023-05-17 16:03:17 -07:00
J.YandEthan Weber 7851dfa9db Fix bug related to distributed data parallel training (#1856)
* Fix bug related to distributed data parallel training

* fix format by black

* Add nerfacto-big multi-gpu commands

* cleaned up docs

* reverted default dataset to poster

---------

Co-authored-by: Ethan Weber <eweb0124@gmail.com>
2023-05-15 14:23:29 -07:00
Matthew Tancik 72a14b0b22 Move scripts folder into nerfstudio (#1897)
move scripts folder into nerfstudio
2023-05-09 16:44:21 -07:00
Matthew Tancik df514b121c Update docs for ns-viewer (#1892) 2023-05-09 10:07:11 -07:00
Brent Yi 63c6303736 Bump minimum Python version to 3.8 (#1876)
* Bump minimum Python version to 3.8

* typing_extensions.Literal -> typing.Literal

* ns-dev-test

* typing_extensions.get_args => typing.get_args

* Format with older version of black

* Bump `black`

* Run black
2023-05-06 13:29:48 -07:00
Matthew Tancik 610fe8bbd4 Update logging docs (#1863) 2023-05-03 10:00:46 -07:00
Frédéric DevernayandFrédéric Devernay 9a0ecb6fd7 Support equirectangular sensor with metashape (#1841)
* Document how to use equirectangular sensor with metashape

* equirectangular sensor is actually supported by nerfstudio!

* Update custom_dataset.md

* equirectangular: fix COLMAP workflow

* metashape_utils.py: black

---------

Co-authored-by: Frédéric Devernay <f-dy@users.noreply.github.com>
2023-05-01 14:44:00 -07:00
Rohan Mathur bf3ae6ac5c Added docs wording change and also --crop-bottom (#1767)
* added docs wording change and also --crop-bottom

* fixed linting
2023-04-20 09:58:02 -07:00
Matthew Tancik 4e6c52c8fd Update sphinx docs (#1695) 2023-04-04 11:08:09 -07:00
Alex-Zhang b0dca720a8 Update installation.md (#1675)
* Update installation.md

install ninja to speed up installation of tinycuda-nn

* Update installation.md

* update readme and installation
2023-03-31 16:00:53 -07:00
Rohan MathurandMatthew Tancik ea9a066f8f Removed deprecated insta360 (#1621)
* removed insta360 and also updated equirect images docs to include cropping

* removed unused import

---------

Co-authored-by: Matthew Tancik <tancik@berkeley.edu>
2023-03-17 12:54:45 -07:00
Matthew Tancik f58aa9348e Prevent colmap from opening (#1627) 2023-03-17 11:03:13 -07:00
Julian RendellandMatthew Tancik fac13d0bab Adding explicit pytorch version for Cuda 11.7 installs (#1611)
Co-authored-by: Matthew Tancik <tancik@berkeley.edu>
2023-03-15 20:56:34 -07:00
Matthew Tancik 1b18b44d81 Update 360 docs (#1593)
* Update 360 docs

* Update custom_dataset.md

* Update custom_dataset.md
2023-03-12 11:14:58 -07:00
Rohan Mathur 403ab26f0c Changed percent-crop to crop-factor so it's less confusing (#1575)
* changed percent-crop arg to crop-factor so it's more clear that it's a float

* added error if crop values are less than 0 or more than 1

* added value hint and changed error to console thing

* added imports

* fixed linter issues

* refixed linter issues
2023-03-09 12:23:50 -08:00
Rohan Mathur 1f8a07c10e Fixed percent crop typo (#1573)
I put 20 instead of 0.2
2023-03-08 19:39:27 -08:00
Jaldert Rombouts b66dc0c20c Correct instructions for Docker build (#1557)
This fixes the instruction for the cuda-architecture specific Docker build.
2023-03-08 07:47:43 -08:00