This tool is for use with https://github.com/NVlabs/instant-ngp and allows the use of Reality Capture camera locations.
Copy rc2nerf.py file into instant-ngp\scripts folder
Use Reality Capture to align cameras.
Export cameras alignment
Alignment -> Export -> Registration -> Internal/External camera parameters...
Save the CSV file exported from Reality Capture into the directory that contains your /images folder.
Open a shell (CMD, Powershell, Bash, etc.) and navigate to the directory with your CSV file and /images folder:
cd [PATH TO FOLDER]
Run the rc2nerf.py on this CSV file using the following command, replacing the text in brackets […] with the file names and paths on your machine:
Example:
python "[PATH TO iNGP]\rc2nerf.py" --csv_in "[NAME_OF_CSV_FILE].csv" --imgfolder .\images
The quotes are only required if you have spaces in any of the folder or file names.
Scale the scene down by 0.01
python "[PATH TO iNGP]\rc2nerf.py" --csv_in "[NAME_OF_CSV_FILE].csv" --imgfolder .\images --scale 0.01
Display the cameras in 3d and set the camera size (for debugging only, requires installing matplotlib
and pytransform3d
)
python "[PATH TO iNGP]\rc2nerf.py" --csv_in "[NAME_OF_CSV_FILE].csv" --imgfolder .\images --plot --camera_size 1
Arguments:
Argument | Default Value | Description |
---|---|---|
--csv_in | None | specify csv file location |
--out | transforms.json | specify output file path |
--imgfolder | .\images | location of image folder |
--imgtype | jpg | ex.: jpg, png, ... |
--aabb_scale | 16 | sets the aabb scale |
--no_scene_orientation | False | disable the Reality Capture orientation |
--no_scale | False | disable the Reality Capture scale |
--no_center | False | disable the scene centering |
--plot | False | display the camera positions |
--camera_size | 0.1 | the size of the displayed cameras |
--debug_ignore_images | False | ignores the input images, for debugging only |
--threads | 8 | number of threads to use when reading images |