Skip to content

Latest commit

 

History

History
142 lines (100 loc) · 8.07 KB

README.md

File metadata and controls

142 lines (100 loc) · 8.07 KB

AutonomyCLTrust

This is a research project conducted by Jiahe Pan at the University of Melbourne, Australia, under supervision of Jonathan Eden, Denny Oetomo and Wafa Johal. We utilize a shared control teleoperated target reaching task based on Fitts' Law to investigate the effects of task difficulty and robot autonomy on the human operator's task performance, cognitive load and trust. We use the Franka Emika robot arm and the Novint Falcon haptic device for the target reaching task, and Tobii eye trackers for one of the cognitive load measures. Experiments are conducted with 24 participants.

Project Links

Contents


ROS2 Workspace

A laptop with Ubuntu 22.04 and ROS2 (Humble) installations are required. The ros2_ws workspace contains the following two ROS packages inside the /src folder:

  • cpp_pubsub
  • tutorial_interfaces

cpp_pubsub

This package contains the code files for the primary task, including receiving information from and sending control commands to the robot, data logging scripts, and rendering the task scene in RViz. Specifically, it contains the following sub-folders:

Folder Description
/cpp_pubsub Contains package files including useful functions to process the pupil diameter data, store parameters to run experiments, and the definition of the DataLogger Python class.
/data_logging/csv_logs Contains the raw data (.csv format) collected from all participants, including a header file for each participant with the calculated task performances for each trial condition.
/launch Contains ROS launch files to run the nodes defined in the /src folder, including launching the controller with both the Gazebo simulator and the real robot, and to start the RViz rendering of the task.
/scripts Contains the definition of the TrajRecorder Python class, used for receiving and saving control commands and robot poses into temporary data structures, before logging the data to csv files using a DataLogger instance. Also contains the fitts_task_tobii.py Python script used for scheduling the sequence of targets and running the experiment.
/src Contains C++ source code for the ROS nodes used, including class definitions of the GazeboController and RealController for controlling the robot in simulation and the real world respectively, the PositionTalker for reading the position of the Falcon joystick, and the MarkerPublisher for publishing visualization markers into the RViz rendering.
/urdf Contains an auto-generated URDF file of the Franka Emika robot arm.

tutorial_interfaces

This packcage contains custom ROS message and service definitions. Specifically, there are two custom msg interfaces (in the /msg directory) defined for communication and data logging:

Msg Description
Falconpos.msg A simple definition of a 3D coordinate in Euclidean space. Attributes: x, y, z
PosInfo.msg A definition of the state vector of the system for a given timestamp. Attributes: ref_position[], human_position[], robot_position[], tcp_position[], time_from_start

Eye-Tracking

The implementation uses a laptop with Ubuntu 22.04 and ROS2 (Humble) installations.

In order to use the Tobii eye-tracker, first install the required SDK from PyPI:

pip install tobii-research

Then, it can be imported into Python as:

import tobii_research as tr

To connect to and receive information from the eye-tracker:

found_eyetrackers = tr.find_all_eyetrackers()
my_eyetracker = found_eyetrackers[0]
my_eyetracker.subscribe_to(tr.EYETRACKER_GAZE_DATA, 
                           gaze_data_callback, 
                           as_dictionary=True)

# Basic definition of the callback function
def gaze_data_callback(self, gaze_data):

    left_eye_gaze = gaze_data['left_gaze_point_on_display_area']
    right_eye_gaze = gaze_data['right_gaze_point_on_display_area']
    
    left_pupil_diameter = gaze_data['left_pupil_diameter']
    right_pupil_diameter = gaze_data['right_pupil_diameter']

To disconnect:

my_eyetracker.unsubscribe_from(tr.EYETRACKER_GAZE_DATA, gaze_data_callback)

For more details of implementation, please refer to fitts_task_tobii.py located in the /cpp_pubsub/scripts/ directory.


Dataframes

The data logged throughout each of the experimental sessions are written to .csv files. These include both the main measures of interest and the initial demographics information collected at the start of each session. The final processed .csv files are all located in the /data directory. Their descriptions are summarized below:

Measure Description
Movement Times The metric for task performance, measured as the movement time between consecutive targets around the ring
Pupil Diameter Pupil diameter (mm) for both left and right eyes, and averaged across them
Perceived Autonomy Participants' perceived level of robot autonomy, rated on a 10-point Likert scale
Perceived Trust Participants' self-reported trust using a 10-point Likert scale
NASA-TLX Self-reported cognitive load levels across all 6 aspects of the NASA-TLX questionnaire
MDMT Self-reported trust levels across all 8 dimensions of the MDMT questionnaire

Note, the raw data logged from the task, including recordings for each individual trial and an overall header file across all trials for each participant, are located in /ros2_ws/src/cpp_pubsub/data_logging/csv_logs. These raw csv files are then preprocessed using the get_all_times.py script inside the /data/task folder, where they are then stored into the following two subfolders:

  • /all_times - preprocessed header files for each participant, including all 24 trials
  • /half_header_files - the preprocessed header files with trials 1-12 removed, since they were the practice trials according to the experimental design and therefore were not used for the main analysis

For the exact steps on how the data preprocessing, refer to order.txt located in the /data folder.


Data Analysis

The data analysis was performed in RStudio, leveraging existing libraries in the R programming langauge. All R scripts are located in the /R_analysis directory, which has the following three sub-folders:

  • main_measures: Individual analysis of autonomy's effect on each of the main measures using ANOVAs and linear models
  • extra_analyses: Additional analyses through auxiliary measures using ANOVAs and linear models, and correlation analyses between the measures

All scripts load /data/all_data.csv as the dataframe containing all the data from the study. Plots are also generated in R, and the code are embedded within the above R scripts.


Paper and Citation Info

The paper has been accepted as a full paper at HRI 2025. The preprint can be found on arXiv. If you find our work useful, please consider citing it:

@article{pan2024using,
  title={Using Fitts' Law to Benchmark Assisted Human-Robot Performance},
  author={Pan, Jiahe and Eden, Jonathan and Oetomo, Denny and Johal, Wafa},
  journal={arXiv preprint arXiv:2412.05412},
  year={2024}
}