Learned Precision Tool use in Carrion Crows. Moll et al.
Description
Each Matlab file ('Trial_data_*crow-number*_*session-number*.mat') contains a struct ('AllTrials') with raw DeepLabCut derived pose estimation data from one of the three crows (crow 1, crow 2, crow 3) for a given session.
Files
Steps to reproduce
Each Matlab file ('Trial_data_*crow*_*session-number*.mat') contains a struct ('AllTrials') with raw DeepLabCut derived pose estimation data from one of the three crows (crow 1, crow 2, crow 3) for a given session. Each line in a 'AllTrials' struct represents one trial. For example, after loading the Trial_data.mat file into Matlab for a given session, the stick-tip position data of the first trial of this session is contained in a three column matrix in 'AllTrials(1).stickTip.xyz'. This matrix contains DeepLabCut derived three-dimensional position data in centimeters, rotated such that they align with the 3 axes of the conditioning chamber (cf. ‘graphical_explanation_of_variables.pdf’). Each line of the matrix contains the x, y and z value (1st, 2nd, and 3rd column, respectively) of a given frame of the full video of the trial (1st line, first frame, last line, last frame; frame rate: 200 Hz). Key points within each trial are given as frame number in AllTrials(*trial #*).info. For example: - ‘AllTrials(1).info.stick_in_out_disp(1)’ indicates the frame number at which the stick was fully pulled out of the dispenser (for the first time in this trial). - ‘AllTrials(1).info.stick_in_out_disp(2)’ indicates the frame number when the stick was reinserted into the dispenser (for the last time in this trial). - ‘AllTrials(1).info.first_in_last_out(1)’ indicates the frame number at which the stick-tip enters the Plexiglas box (for the first time in this trial). - ‘AllTrials(1).info.first_in_last_out(2)’ indicates the frame number at which the stick-tip exits the Plexiglas box (for the last time in this trial). Trial types are given in AllTrials(*trial #*).info. For example: - ‘AllTrials(1).info.num_pellets’ contains the number of pellets at the beginning of a trial. Only trials with 1 pellet were analyzed further. In trials with more pellets (>1) the 'AllTrials(1).pellet.xyz' is unreliable, as DeepLabCut was only trained to track 1 pellet. - ‘AllTrials(1).info.poscat’ contains the position category, i.e. whether this trial was a Left, Middle, or Right trial (1: Left, 2: Middle, 3: Right). If AllTrials(*trial #*).info.poscat==4, the pellet was NOT placed in one of the three standard positions initially and the trial was not analyzed further.
Institutions
- Eberhard Karls Universitat Tubingen