Duel

Show/hide data providers

Data providers

• Hudl StatsBomb
• Stats Perform / Opta
• Wyscout (v2)
• Wyscout (v3)
• DataFactory
• Sportec Solutions
• Metrica (JSON)

kloppy.domain.DuelEvent dataclass

A contest between two players of opposing sides in the match. Duel events come in pairs: one for the attacking team, one for the defending team. If the duel is a take on, the offensive one has type TAKE_ON.

Event Specific Attributes

Name	Description	Hudl StatsBomb	Stats Perform / Opta	Wyscout (v2)	Wyscout (v3)	DataFactory	Sportec Solutions	Metrica (JSON)
event_type	EventType.DUEL TYPE: EventType
event_name	"duel" TYPE: str
result	The outcome of the duel. TYPE: DuelResult
qualifiers	A list of qualifiers providing additional information about the duel. TYPE: List[Union[DuelQualifier, CounterAttackQualifier]]

Event Data General Attributes

Name	Description	Hudl StatsBomb	Stats Perform / Opta	Wyscout (v2)	Wyscout (v3)	DataFactory	Sportec Solutions	Metrica (JSON)
event_id	Event identifier given by provider. Alias for record_id. TYPE: str
time	Time in the match the event takes place. TYPE: Time
coordinates	Coordinates where event happened. TYPE: Point
team	Team related to the event. TYPE: Team
player	Player related to the event. TYPE: Player
ball_owning_team	Team in control of the ball during the event. TYPE: Optional[Team]
ball_state	Whether the ball is in play. TYPE: Optional[BallState]
raw_event	The data provider's raw representation of the event. TYPE: object
dataset	A reference to the dataset the event is part of. TYPE: Dataset
prev_record	A reference to the previous event. TYPE: Optional[Self]
next_record	A reference to the next event. TYPE: Optional[Self]
related_event_ids	Event identifiers of related events. TYPE: List[str]
freeze_frame	A snapshot with the location of other players at the time of the event. TYPE: Optional['Frame']
attacking_direction	The playing direction of team during the event. TYPE: AttackingDirection
state	Additional game state information. TYPE: Dict[str, Any]	-	-	-	-	-	-	-

kloppy.domain.models.event.DuelResult

Name	Description	Hudl StatsBomb	Stats Perform / Opta	Wyscout (v2)	Wyscout (v3)	DataFactory	Sportec Solutions	Metrica (JSON)
WON	When winning the duel (player touching the ball first)
LOST	When losing the duel (opponent touches the ball first)
NEUTRAL	When neither player wins duel [Mainly for WyScout v2]