CavePainting/technical user documentation

Importing Bat Marker Data

CavePainting can import data representing the 3D positions of points through time. A marker file is a plain-text CSV file in which each row is a time step and each group of four columns are the X, Y, and Z positions for a marker, followed by the number 1 in the fourth column. For example, the following describes two markers' positions (sets of four columns) over three timesteps (rows):

0.5,0.5,0.5,1,0.2,-0.2,0.3,1
0.6,0.4,0.5,1,0.3,-0.1,0.2,1
0.7,0.3,0.4,1,0.4,0.0,0.1,1

Config file variables:

• BatMarkersFile: path to a marker file.
• BatMarkersScale: a scaling parameter to map the coordinates in the marker file to world coordinates in CavePainting.
• BatMarkersSize: the radius, in the world coordinate frame, of the spheres representing the markers.
• BatMarkersTimestepIncrement: the number of rows in the marker file to skip between creating frames.
• BatMarkersFrame: ???