Skip to content

Simple tool for converting Reality Capture CSV files to NERF JSON files for https://github.com/NVlabs/instant-ngp

Notifications You must be signed in to change notification settings

henrypearce4D/rc2nerf

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Reality Capture camera location to NERF conversion tool with per camera intrinsics

This tool is for use with https://github.com/NVlabs/instant-ngp and allows the use of Reality Capture camera locations.

Installation

Copy rc2nerf.py file into instant-ngp\scripts folder

Usage

Use Reality Capture to align cameras.

Export cameras

File -> Export -> Export Cameras...

Save the CSV file exported from Agisoft Metashape into the directory that contains your /imagesfolder.

Open a shell (CMD, Powershell, Bash, etc.) and navigate to the directory with your XML 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:

Commands

Example:

python "[PATH TO iNGP]\rc2nerf.py" --csv_in "[NAME_OF_XML_FILE].xml" --imgfolder .\images

The quotes are only required if you have spaces in any of the folder or file names.

Additional command examples

Disable the agisoft scale and scene orientation

python "[PATH TO iNGP]\rc2nerf.py" --csv_in "[NAME_OF_XML_FILE].xml" --imgfolder .\images --no_scale --no_scene_orientation

Scale the scene down by 0.01

python "[PATH TO iNGP]\rc2nerf.py" --csv_in "[NAME_OF_XML_FILE].xml" --imgfolder .\images --scale 0.01

Display the cameras in 3d and set the camera size (for debugging)

python "[PATH TO iNGP]\rc2nerf.py" --csv_in "[NAME_OF_XML_FILE].xml" --imgfolder .\images --plot --camera_size 1

Arguments:

Argument Default Value Description
--csv_in None specify xml 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 agisoft orientation
--no_scale False disable the agisoft 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

About

Simple tool for converting Reality Capture CSV files to NERF JSON files for https://github.com/NVlabs/instant-ngp

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%