iMotions Facial Expression Data Skill

Process iMotions facial expression data and extract emotion metrics with pandas.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/calebeynon/MarketRuns --skill imotions-facial-expression-data-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: iMotions Facial Expression Data Skill
Source: https://github.com/calebeynon/MarketRuns/tree/main/.claude/skills/imotions-data
Command: npx skills add https://github.com/calebeynon/MarketRuns --skill imotions-facial-expression-data-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pandas, pathlib, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps researchers process and analyze complex facial expression data collected using iMotions software, linking it directly to experimental events.

Core Features & Use Cases

  • Data Loading: Easily load iMotions CSV data for specific sessions and participants.
  • Phase Filtering: Precisely filter data by experimental segment, round, and phase (e.g., 'MarketPeriod').
  • Emotion Extraction: Extract key emotion metrics and aggregate them for analysis.
  • Use Case: Analyze how participants' 'Joy' and 'Sadness' levels change during specific trading periods within a MarketRuns experiment session.

Quick Start

Load the iMotions data for participant 'R3' in session 1 and filter for the 'MarketPeriod' of segment 2, round 5.

Frequently Asked Questions about iMotions Facial Expression Data Skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I process iMotions facial expression data for behavioral economics experiments?

To process iMotions facial expression data for behavioral economics experiments, you can use this Skill to load CSV files, filter by experimental segments, and extract emotion metrics. It requires pandas for data manipulation and specific logic to map annotations to oTree periods.

Can I analyze emotion metrics like Joy and Sadness during specific oTree trading periods?

Yes, you can analyze emotion metrics like Joy and Sadness during specific oTree trading periods. This Skill extracts key emotion metrics and aggregates them, enabling correlation with experimental events such as sell decisions within a MarketRuns session.

How do I filter iMotions facial expression data by experimental phase and round?

You filter iMotions facial expression data by using the Skill's phase filtering capabilities to precisely segment data by experimental segment, round, and phase. This allows targeted analysis of specific intervals like a MarketPeriod within a session.

Does this data processing Skill require pandas to map iMotions annotations to oTree periods?

Yes, this data processing Skill requires pandas to map iMotions annotations to oTree experimental periods. Pandas is a necessary dependency for manipulating the CSV data and executing the logic required to align facial expression metrics with experimental events.

What is the best way to correlate facial expression data with experimental sell decisions?

The best way to correlate facial expression data with experimental sell decisions is to map iMotions annotations to oTree periods using this Skill. It facilitates the extraction of action unit data and emotion metrics, enabling direct correlation with behavioral events.

Are there limitations when extracting action unit data from iMotions CSV files?

A limitation when extracting action unit data from iMotions CSV files is that the Skill relies on specific logic to map annotations to oTree periods. It is tailored for the MarketRuns experiment, so adapting it to other experimental frameworks may require custom adjustments.