4
0
mirror of https://github.com/nerfstudio-project/nerfstudio.git synced 2026-11-11 02:24:38 +08:00
Commit Graph

42 Commits

Author SHA1 Message Date
Otto Seiskari
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
Chris Sweeney
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
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
Gina Wu
593950efec
Update colmap installation instructions with conda (#2473) 2023-09-27 10:45:58 -07:00
Frederik Warburg
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
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
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
Fré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
Rohan Mathur
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
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
Rohan Mathur
9dc7fc2e44
Added documentation for equirectangular input (#1561)
* added documentation for equirectangular

* fixed typo and mentioned 3fps is empirical
2023-03-07 15:28:21 -08:00
Matthew Tancik
df784e96e7
Colmap docs note (#1380) 2023-02-08 11:23:34 -08:00
Mason McGough
92636c3434
Docs fix (#1244)
* Add the following fixes to documentation:

* Fix trailing backslash in “Use docker image” section
* Replace escaped backslash with double-escaped backslash (see Sphinx issue: https://github.com/sphinx-doc/sphinx/issues/6730)
* Close backtick in `contributing.md`
* Add “run” to instructions for “Render Video”
* Remove unnecessary “,” in “Render Video”
* Correct “before preceding” to “before proceeding”
* Correct “viewpoinrts” to “viewpoints”
* Add missing “.” in “Process data”
* Specify “bash” for code blocks (for consistency with other blocks in the page)
* Fix code block in `viewer_quickstart.rst` (”Copy to clipboard” widget now works)
* Fix some code formatting issues in `export_geometry.md`

* Correct "harmoincs" to "harmonics" in docs.
2023-01-17 09:28:20 -08:00
matsuren
408ab709ec
Fix typo (#1231)
* Fix typo COLAMP->COLMAP

* Fix more typo

Co-authored-by: Matthew Tancik <tancik@berkeley.edu>
2023-01-16 12:12:55 -08:00
Matthew Tancik
6f85d7118f
Add docs for KIRI Engine (#1124)
Add docs for KIRI engine
2022-12-13 18:37:31 -08:00
Matthew Tancik
a6d5b02446
Add metashape to docs (#1004) 2022-11-22 10:30:12 -08:00
Matthew Tancik
95a27ecba5
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
2022-11-15 17:55:29 -08:00
Matthew Tancik
28b86f8718
Allow specifying colmap path (#917) 2022-11-07 12:11:10 -08:00
Matthew Tancik
761645de05
Minor doc updates (#903) 2022-11-05 22:00:28 -07:00
Matthew Tancik
ec901c893d
Add support for insta360 data (#781)
* Add support for insta360 data

* Update docs

* Revert unrelated changes

* remove cropping on normal videos

* Address comments
2022-10-15 22:25:21 -07:00
Yudong Jin
2bf9214fd2
Update custom_dataset.md (#771)
* Update custom_dataset.md

Train with the given websocket-port:

```shell
ns-train nerfacto record3d-data --data {RECORD3D_CAPTURE_DIR/EXR_RGBD} --viewer.websocket-port 7007
```

Then I get `ns-train: error: unrecognized arguments: --viewer.websocket-port 7007`.

It is recommended to put `record3d-data` at the end of all arguments.

```shell
ns-train nerfacto --data {RECORD3D_CAPTURE_DIR/EXR_RGBD} --viewer.websocket-port 7007 record3d-data
```

* Update custom_dataset.md

Update
```
ns-train nerfacto nerfstudio-data --data {PROCESSED_DATA_DIR}
```
to
```
ns-train nerfacto --data {PROCESSED_DATA_DIR} nerfstudio-data
```
2022-10-15 09:52:49 -07:00
Ethan Weber
9c52d5df19
fix discord link 2022-10-10 17:10:13 -07:00
evonneng
ef4d72c78d
add video link to record3d (#731) 2022-10-07 14:04:48 -07:00
Ethan Weber
ee94f23f83
turn on camera opt by default (#727)
* camera opt by default

* fix tests
2022-10-07 11:21:21 -07:00
Alexander Kristoffersen
9afe03eb4c
Pose Opt Doc typo (#726)
small doc typo.
2022-10-07 10:36:20 -07:00
Ethan Weber
cac177717f
Pose optimization (#721)
* pose opt default nerfacto.

* added SO3 cam pose optimization which is slightly faster (~2.2m/iter) than BARF

* integrating record3d

* fix linting errors

* fix save checkpoint logic

* added record3d data

* workaround to avoid flag

* moved dict

* black

* record3d docs

* re-add typing to exp_map.

* Pose optimization refactor

* Fix camera optimizer param group logic

* Update docs + comments

* Update docs, shorten names

* Appease pylint

* repeat -> tile, apply missing name change

* Fix optimizer as scheduler bug

* Fix test

Co-authored-by: akristoffersen <akristoffersen@berkeley.edu>
Co-authored-by: Justin Kerr <justin.g.kerr@gmail.com>
Co-authored-by: Brent Yi <yibrenth@gmail.com>
2022-10-07 10:11:33 -07:00
akanazawa
e307afee0a
Update custom_dataset.md (#723)
instant-gnp to the nerfacto
2022-10-06 22:35:09 -07:00
Alexander Kristoffersen
2aca915d61
Record3D docs added to Custom Data docs (#718)
* alex/record3d_docs_add

* alex/record3d_docs_add

* link from dataparsers to custom_dataset added.

* images are now appearing

Co-authored-by: evonneng <evonne_ng@berkeley.edu>
2022-10-06 14:10:48 -07:00
Matthew Tancik
4282aa124e
Update colmap install guide (#696) 2022-10-05 13:45:17 -07:00
evonneng
917d02c695
adding viewer video + other doc related updates (#688) 2022-10-05 02:59:59 -07:00
Jake Austin
a6ad3a40c4
Updating docs for custom data (#672) 2022-10-04 22:01:03 -07:00
akanazawa
305e0a9dab
Update custom_dataset.md
minor typo and pointers to our discord
2022-10-04 11:50:18 -07:00
evonneng
5e56e7b229
update quickstart + readme (#641)
* updated quickstart and readme

* damn ctrl c on macs
2022-10-03 22:38:43 -07:00
Matthew Tancik
d7c34ca2bd
Reorganize documentation (#631)
restructure_docs
2022-10-03 12:59:46 -07:00