ratcave_utils

Command-line utility programs for scanning, calibrating, and debugging the ratCAVE Virtual Reality system.

Once installed, all programs can be run from the command line (see examples below). Almost all programs require a Motive Project File (.ttp) as a first argument. Help text for each program is available throught the "--help" option.

Installation

Download the source from github and install from the setup.py file:

cd ratcave_utils
python setup.py install

After installing, To see what commands are available, simply type the following to get a list of available commands:

ratcave_utils

Help text is available for every subcommand as well:

ratcave_utils scan_arena --help

scan_arena --help

Examples

Debugging: Get Rigid Body Live Tracking Info

Verify that you can track something using MotivePy! This program will stream the 3D coordinates of a rigid body to the stdout:

track_rigidbody my_project_file.ttp

Debugging: Generate a Test Dots Image

The arena scanning and projector calibration scripts require that the cameras be able to track white dots projected onto the arena's surface. The Motive gui is useful for verifying the correct settings, and this program will simply put a fullscreen dot pattern up to make debugging simpler.

dots_test

Arena Scanning: Collect a Point Cloud of your Arena, and Meshify It

scan_arena motive_project.ttp my_arena.obj --nsides 5 --body Arena

Projector Calibration: Map 2D Projection points and 3D Marker positions into a 3D Projector Location

calibrate_projector motive_project.ttp