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