Data Analysis

#Data Analysis Scripts Below is a list of analysis functions and a brief overview. For detailed information and the full specification see the individual function's documentation.

###PPUtilities

• rdir: returns a list of files or directories (supports arbitrary file matching - ex: rdir([pwd, '*']);
• draw_heat_map: draws a heat map, supporting options for logarithmic mapping and color percentiles.
• hist2d: computes a 2d histogram from 2 dimensional data.

###SensorDistributions Dependencies: requires stats struct to be saved in directory

• gaps: plots the distribution of the duration a sensor was on
• np_js_distribution: plots the nosepoke joystick onset distribution
• np_post_distribution: plots the nosepoke post touch onset distribution
• multipcolor_np_js: generates a pcolor plot of a single mouse's progress in the nosepoke joystick onset distribution for all days with data.
• multipcolor_np_post: generates a pcolor plot of a single mouse's progress in the nosepoke post onset distribution for all days the mouse.

###Activity Heat Maps Dependencies: requires stats , velaccel, and velaccelraw structs to be saved in directory (generated by xy_getstats and compute_vel_accel_distr):

• multiday_video: generates a video showing the progression of the activity heat map for multiple days
• activity_summary_heat_maps: performs all of the analysis listed below on a single figure
• activity_heat_map: heat map of joystick position during valid trajectories
• velocity_heat_map: heat map of trajectory velocities using median
• velocityvar_heat_map: heat map of trajectory velocity variation using difference between 75th and 25th percentiles for each cell.
• accel_heat_map: heat map of trajectory acceleration at each point in (x,y) space using median measure
• accelvar_heat_map: heat map of trajectory acceleration variation at each point in (x,y) space using difference between 75th and 25th percentiles
• accelnorm_heat_map: heat map of the normal component of acceleration at each point in (x,y) space
• accelang_heat_map: heat map of the angular component of acceleration at each point in (x, y) space
• get_vel_accel_distr: loads information required for the above distributions/plots assuming that they have been saved to appropriate directories (data only). also combines data when appropriate rather than compute from scratch.
• compute_vel_accel_distr: computes all information required for the above distributions/plots (data only) - can be very slow. does it separately for each day.

###Trajectory Analysis Dependencies: requires stats structs to be saved in directories:

• trajectory_analysis: bins trajectories by hold time and then computes percentiles of trajectory distance at each time point
• multi_trajectory_analysis: calls trajectory_analysis of magnitude of several days on one set of plots

###Time Distributions Dependencies: requires stats structs to be saved in directories (future edits may change this to improve efficiency, requiring a separate struct containing raw data instead)

• hold_time_distr: plots distribution of hold times using js onset to js offset as measure of hold times
• rewarded_time_distr: plots distribution of rewarded hold times
• rewardrate_distr: plots distribution of reward rate by time interval
• joystick_to_reward_distr: plots distribution of joystick touch onset to reward distribution

#Post Processing GUI The post processing GUI (pp_gui) is a tool to visualize multiple plots and perform data analysis. It allows selection of multiple different days and allows selection of any combination of plots. The process for making a new function and adding support for it to the GUI is described on the page Guidelines for New Analysis Scripts