cardioception.stats.behaviours

cardioception.stats.behaviours(summary_df: DataFrame, variables: List[str] = ['participant_id', 'Modality'], additional_variables=[]) → DataFrame

Extract behavioural parameters from a set of result files from the HRD task.

For each participant/repeated measure/group, the following parameters are returned:

• threshold

  The threshold of the psychometric curve as estimated during the task by the Psi staircase.

• slope

  The slope of the psychometric curve as estimated during the task by the Psi staircase.

• decision_mean_rt

  The average response time to decide whether the tone is faster or slower than the heart rate.

• decision_median_rt

  The median response time to decide whether the tone is faster or slower than the heart rate.

• confidence_mean_rt

  The average response time to provide the confidence ratings.

• confidence_median_rt

  The median response time to provide the confidence ratings.

• confidence_mean

  The average confidence level (using the same scale as what was used during the task).

• dprime

  The sensitivity (SDT indices) in discriminating whether the tone is faster than the heart rate or not.

• criterion

  The bias (SDT indices) in discriminating whether the tone is faster than the heart rate or not.

Warning

This function requires metadpy.

Parameters

summary_df

The data frame merges the individual result data frames. Multiple variables / condition can be specified using separate columns with the variables argument.

variables

The variables coding for group / repeated measures. The default is participant_id and Modality.

additional_variables

Additional variables for group / repeated measures.

Returns

results_df

The data frame containing, for each participant/condition/group, the psychometric variables.