# Dominance index

The dominance index is the innovative index that objectively indicates the pressure that team A or B is exerting in the match.

### How is it computed?

The calculation is relatively simple. Each event is given a weight expressed in points, and the sum of the points in the 30-second time frame gives the result. \
The most complex part is to correctly weigh all events

### What values do we have available?

In the calls where the dominance index is indicated there are two values:

* dominance\_index
* dominance\_index\_2\_5\_avg 

The first value contains a JSON updated every 30 seconds that shows the current game performance. The average value of 2.5 minutes shows the average score of the last 5 samples.

Two values are present because the first one can be useful to draw and humanly interpret graphs, the second one instead gives a dry value that numerically indicates the pressure of the team in that moment, so it can be useful for strategies or bots.

### How should it be interpreted?

The higher the value, the higher the pace of the team. 

The difference between the value of team A and that of team B indicates dominance. \
If the dominance is positive, team A is dominating, if it is negative, team B is dominating, if the gap is wide, either negative or positive, the dominance is very marked.

### How can it be plotted?

Indicatively the dominance index can be drawn in two ways:

#### With line chart 

![Dominance index line chart](https://1849281761-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MO7VPtH3yGUfnmbVIHd%2Fuploads%2FFTY1iL0PkQqPO1nUzEX4%2Fdownload%20\(3\).png?alt=media\&token=e93cdb4a-bc82-479a-a2ce-b8999d5693a0)

The graph shows not only the difference between the two indices but also the rhythm of the match. The higher the value, the higher the rhythm of the two teams.

**With bar chart**

![Dominance index bar chart](https://1849281761-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MO7VPtH3yGUfnmbVIHd%2Fuploads%2FfTCw2RfHEUOXsOtiJmIM%2Fdownload.png?alt=media\&token=ced7217d-8dfa-461c-b1b5-7780893ea08e)

The bar chart plots the difference of the two indices and at a glance shows the tendency of dominance of one of the two teams .\
To generate a bar char just do the difference between the index of dominance A and B.\
If result is negative team B dominance vice versa dominates the A team

To help you draw the graph quickly, we wrote a COLAB document that interprets the response of the MATCH VIEW call and prints the graphs.

[**`GO TO COLAB FILE`**](https://colab.research.google.com/drive/1tkPTJK5OBesFBMVsQBPitLZN_lz87vU7?usp=sharing)

### What calls are available?

Dominance index are available in this calls:

* [Emulation totalcorner today](https://info.soccerfootball.info/v1/emulated/totalcorner/match-today)
* [Emulation totalcorner schedule](https://info.soccerfootball.info/v1/emulated/totalcorner/match-schedule)
* [Live full](https://info.soccerfootball.info/v1/live/live-full)
* [Live basic](https://info.soccerfootball.info/v1/live/live-basic)
* [Match day basic](https://info.soccerfootball.info/v1/matches/day-basic)
* [Match day full](https://info.soccerfootball.info/v1/matches/day-full)
* [Match view basic](https://info.soccerfootball.info/v1/matches/view-basic)
* [Match view full](https://info.soccerfootball.info/v1/matches/view-full)
* [Match by basic](https://info.soccerfootball.info/v1/matches/by-basic)
* [Match by full](https://info.soccerfootball.info/v1/matches/by-full)
* [Match view  progressive](https://info.soccerfootball.info/v1/matches/view-progressive)