Log file structure

LinMaze sessions are logged into an HDF5 file with a .vrl extension.

The file has the following structure:

time
time axis, array of float values of the computer’s time in seconds
g_time
time axis, array of integer values of the gramophone’s time in tenths of a millisecond
paused
array of zeros and ones, value is 1 if the simulation was paused at that point
input_1
the satte of the digital input 1, 1 is high 0 is low
input_2
the satte of the digital input 2, 1 is high 0 is low
output_1
the satte of the digital output 1, 1 is high 0 is low
output_2
the satte of the digital output 2, 1 is high 0 is low
output_3
the satte of the digital output 3, 1 is high 0 is low
output_4
the satte of the digital output 4, 1 is high 0 is low
position
the position in the maze in pixels
teleport
array of zeros and ones, 1 if there was a teleport at that point
velocity
array of signed integers with the velocity in pixels/record
zone
n×m matrix of ones and zeros. Each column is an array of ones and zeros for that zone
zone_types

a group of arrays of zeros and ones for each zone type that was defined

zone_types/example
1 when the mouse was in an ‘example’ zone, 0 otherwise

Metadata

The metadata of each session is saved in the attributes of the root of the file.

level_name
The name name of the Level this simulation used
RGB
A three element array with the ratio of Red, Green and Blue pixel values
zone_offset
The zone offset used for this simulation ie. the virtual position of the mice on the screen
velocity_ration
The velocity ratio used for this simulation ie. how many pixels the screen was moved for each full rotation of the wheel
transition_width
The width of the smooth transition between each Frame of the simulation
start_time
The time the simulation started as a UNIX timestamp
start_time_hr
The time the simulation started in a human readable format
start_time
The time the simulation ended as a UNIX timestamp
start_time_hr
The time the simulation ended in a human readable format
software_version
What version of GramophoneTools was used to make this log
screen_width
The set width of the screen
screen_height
The set height of the screen
runtime_limit
The runtime limit of the simulation in minutes (or None if it was not set)
left_monitor
The number of the monitor on the left side of the animal (or None if it was not used)
right_monitor
The number of the monitor on the right side of the animal (or None if it was not used)
device_serial
The serial number of the device that was used for this simulation