Knowledge Base

Define Project Wizard With the Folder Structure of the Video or Image Files

Aim

To automate adding a large number of participants or analyses. The videos or images are automatically assigned to analyses.

Prerequisites

• You have a large number of participants, or analyses.
• You want to analyze videos or images.
• The videos or images of the test participants are stored in a structured way. For example, the videos of the different participants are stored in separate folders.

Procedure

1. Choose File > New > Project Wizard.
2. Give the project a name, select the location to store it and select Video, or Images from the Source type list.
3. Select From file structure.

   The Project Preview window displays the project structure with the selected options.

4. Under Path, select the root of the folders where your videos or images are stored.
5. Under Predefined Templates, select one of the following:
   • one of the Predefined templates
   • Custom template — Use the building blocks under Choose File Template Parts to create your custom structure. See Custom Template
6. Click OK when ready.

Predefined Templates

The File template field shows the building blocks used for this template. For an explanation of the building blocks, see Custom Template.

Add All Videos to a Unique Participant

File template <WildCard>.<WildCard>

Each video found in the folders and subfolders will be added as analysis to a separate participant. Participants will be named Participant 1, Participant 2, etc. The analyses will be named Analysis 1. Video location plays no role here.

Folder Equals Participant Name

File template <ParticipantName>\<WildCard>.<WildCard>

Each video found in the folders and subfolders will be assigned as analysis to a separate participant. Each participant will get the name of the folder where the video was found. Note that this results in the same person being represented by several "participants" in FaceReader. All analyses will be named Analysis 1.

Folder Equals Unique Participant Name

File template <UniqueParticipantName>\<WildCard>.<WildCard>

Each participant will get the name of the folders found in the root folder. Each participant name will only be used once.

If more videos are found in the same folder, these will be added as analyses to the same participant. The analyses will be named Analysis 1, Analysis 2, ....etc.

Folder Equals Participant Index

File template <ParticipantIndex>\<WildCard>.<WildCard>

In case your folders have numbers instead of letters. Each participant will get the folder number and the videos in this folder or subfolders are assigned as analyses to this participant. The analyses will be named Analysis 1, Analysis 2, ....etc.

Folder Equals Participant Index, Subfolders Equal Analysis Index

File template <ParticipantIndex>\<AnalysisIndex>\<WildCard>.<WildCard>

Use this template when your folders and subfolders have numbers instead of letters. Each subfolder may contain only one video file. Each participant will get the number of the folder directly under the root folder specified in the Path field. Each analysis will get the number of the subfolder and the name of the file.

Custom Template

To create your structure, click one or more items under Choose File Template Parts.

• Use a slash (\) to indicate a new folder.
• Use a dot (.) to separate the filename from the extension.

ParticipantIndex

For folders and files with numerical names. Uses the folder numbers for the participants numbers.

UniqueParticipantName

Uses the folder or file names for the participant names. Each participant name will be used once.

ParticipantName

Uses the folder or file names for the participant names. Different participants can have the same name.

ParticipantAge

Reads the participant age from the file name and enters this as category for the independent variable Age.

Example: file name is 32_male_commercial 1.avi

Use building blocks <ParticipantAge>_<Wildcard>.<Wildcard>

ParticipantGender

Reads the gender from the file name and enters this as category for the independent variable Gender.

Example: file name is 32_male_commercial 1.avi

Use building blocks: <Wildcard>_<ParticipantGender>_<Wildcard>.<Wildcard>

You can also combine ParticipantAge and ParticipantGender in the following way:

<ParticipantAge>_<ParticipantGender>_<Wildcard>.<Wildcard>

AnalysisIndex

For subfolders or files with numerical names. Each subfolder may contain only one video file. Uses the folder numbers for the analysis names.

Wildcard

Allows any character.

Source: FaceReader 10 Reference Manual (Help), Noldus Information Technology