Supplemental material for the blenderFace method
This supplemental material is also available at OSF and belongs to the article:
Zinkernagel, A., Alexandrowicz, R. W., Lischetzke, T., & Schmitt, M. (2018). The blenderFace method: video-based measurement of raw movement data during facial expressions of emotion using open-source software. Behavior Research Methods. https://doi.org/10.3758/s13428-018-1085-9
The supplemental material contains the following files:
- The Step_by_Step_Instructions_V1.6.pdf for Blender (starting from version 2.80 up to the actual version) describes how to perform the tracking procedure in detail with Blender.
- The Step_by_Step_Instructions_V1.5.avi (70 MB) for Blender (version 2.80 and upwards) show an example tracking procedure in a short video (20 min). This video is also used as a reference in the Step_by_Step_Instructions.pdf.
- The Subject_01.mp4 file (20 MB) is an example video of a participant. It is used in the Step_by_Step_Instructions.avi and you can use it to test and train the blenderFace method by yourself.
- The Blender files 01_End_of_Tracking_static_markers.blend, 02_End_of_Tracking_facial_markers_and_building_the_facial_surface.blend, 03_End_of_Tracking_emotional_markers.blend and 04_Measurements_for_scaling_blenderFace_data.blend are saved blender files at different stages of the tracking process. These files are also referred to in the Step_by_Step_Instructions_V1.5.pdf. You can use it to test or train different stages of the tracking procedure.
- The python script Export_Tracks_V1.23.py is a blender script to export the movement of the tracked markers into a CSV file.
- The files Subject_01.csv and Subject_02.csv are exportet raw movement data of two tracked participants. At least data of two participants are needed for postprocessing with the blenderFace R package. This data is also included as external data in the blenderFace R package.
- The file Blender_Scalingdata.csv contains the data needed for rescaling the raw data of Subject_01.csv and Subject_02.csv. This file is also included as external data in the blenderFace R package.
- The file blenderFace_Vignette.pdf is the Vignette of the blenderFace R package. It gives an overview of how to postprocess the raw data in the csv files.
- The blenderFace R package is available at Github and may be easily installed into your R environment. This is also described in the Step_by_Step_Instructions.pdf
BlenderFace-Instructions for older versions of blender (up to Version 1.79) are available at https://uni-wuppertal.sciebo.de/s/Z2WCGjyhmCTxWxY. Older versions of Blender are available at https://www.blender.org/download/previous-versions/.
If you have any questions regarding the blenderFace method, please do not hesitate to contact me at zinkernagel[at]uni-wuppertal.de.
zuletzt bearbeitet am: 21.02.2025