PitchKit
API Reference@pitchkit/data-providersmetricaInterfaces

MetricaEvent

Defined in: packages/data-providers/src/metrica/types.ts:57

One row of a RawEventsData.csv file.

Coordinates are absolute. Teams swap ends at half time, and which end each starts at differs between the two games, so a team's shots sit near x = 1 in one half and near x = 0 in the other. See attackingDirection.

Start and end positions can fall slightly outside 0..1: a shot that goes in ends at x = 1.01 or -0.02, because the ball crossed the goal line.

Indexable

[key: string]: unknown

Properties

PropertyModifierTypeDescriptionDefined in
End Framereadonlynumber0 on the opening kick-off of Sample Game 1; elsewhere a real frame.packages/data-providers/src/metrica/types.ts:73
End Time [s]readonlynumber-packages/data-providers/src/metrica/types.ts:74
End Xreadonlynumber | nullnull where the file has NaN: every RECOVERY, CHALLENGE, FAULT RECEIVED, SET PIECE and CARD, and some BALL LOST.packages/data-providers/src/metrica/types.ts:92
End Yreadonlynumber | null-packages/data-providers/src/metrica/types.ts:93
endX?readonlynumber"End X", lifted. Absent where that is null.packages/data-providers/src/metrica/types.ts:100
endY?readonlynumber"End Y", lifted. Absent wherever endX is.packages/data-providers/src/metrica/types.ts:102
Fromreadonlystring | nullThe player the event belongs to, spelled as in the tracking header. Set on every event in both sample games.packages/data-providers/src/metrica/types.ts:79
Periodreadonlynumber1 or 2. The sample games have no extra time.packages/data-providers/src/metrica/types.ts:67
Start FramereadonlynumberThe tracking frame this event starts on. Events and tracking share a clock.packages/data-providers/src/metrica/types.ts:69
Start Time [s]readonlynumberSeconds since kick-off, continuous across both halves.packages/data-providers/src/metrica/types.ts:71
Start Xreadonlynumber | nullnull where the file has NaN, which is every SET PIECE and CARD. The event after a set piece (usually its PASS) carries the position.packages/data-providers/src/metrica/types.ts:86
Start Yreadonlynumber | null-packages/data-providers/src/metrica/types.ts:87
Subtypereadonlystring | nullHyphen-joined qualifiers, or null when the event has none. A header that scores is "HEAD-ON TARGET-GOAL": three subtypes, one of which contains a space. hasSubtype reads them.packages/data-providers/src/metrica/types.ts:65
TeamreadonlyMetricaTeam-packages/data-providers/src/metrica/types.ts:58
Toreadonlystring | nullThe receiving player. Set on every PASS and on nothing else.packages/data-providers/src/metrica/types.ts:81
TypereadonlyMetricaEventType-packages/data-providers/src/metrica/types.ts:59
x?readonlynumber"Start X", lifted for a PitchKit accessor. Absent where that is null.packages/data-providers/src/metrica/types.ts:96
y?readonlynumber"Start Y", lifted. Absent wherever x is.packages/data-providers/src/metrica/types.ts:98

On this page