MatchUp Format Code
DRAFT DOCUMENTATION
Please note that this documentation is in draft and is not finalised.
We would encourage you provide any comments, questions, or suggestions for changes by use in-line commenting on this page. To do so simply highlight a section of text and then click on the "Comment" option that appears.
Within tennis there are various scoring methods. The basis of all scoring can be broken into;
- the number of sets
- the number of games
- the type of games
- how the MatchUp is decided when there is a tie
OR
- Timed games
There are also 5 stand out types of formats; Standard, Short Sets, Pro sets, Tiebreaker Sets and Timed games.
Historically, capturing these scoring methods can be tricky, usually requiring long descriptions eg Best 2 Out Of 3 Short Sets (Win By One) (7 Point Match Tiebreak in lieu of the 3rd set).
The Match UpFormat Code tries to alleviate this by compacting all formats into a machine and human readable format. From this, system architects can create mappings between a description and the match format code easily.
The Match Up Format Code consists of
SET{number of sets, usually 1,3,5}
-S:{number of games}
{NOAD} if no-advantage games are played. If omitted, advantage games are assumed
/TB{number of tiebreak rounds}
@{when the tiebreaker is to be started}
OR
-S:TB{number of tiebreak games}
Some matches require a different format for the final set. This can be defined by replacing -S: with a -F:.
Timed matches are also possible. These are points based eg T90P or games based T90G.
Some examples to help you understand how the MatchUp Format Code works are below.
Additionally, CourtHive have produced a Score Format Generator, allowing you to input your match format to create a compliant Tennis Open Data Standard MatchUp Format Code.
Sets (number) or Timed | Set format [Tie break] | Final set format/ Match Tie Break | Match Up Format Code | Match Up Score Format Examples | Description | As Used in |
|---|---|---|---|---|---|---|
SET3 | S:6/TB7 | SET3-S:6/TB7 | 6-3 3-6 7-6(7-3) | Best 2 Out Of 3 Sets (Win By Two) 6 games with Tiebreak to 7. | Standard match | |
SET3 | S:4/TB5 | F:TB5 | SET3-S:4/TB5-F:TB5 | 5-3 4-5 [10-8] | Best 2 Out Of 3 Short Sets (Win By Two) 4 games with Tiebreak to 5. | Short sets ITF |
SET5 | S:6/TB7 | F:6 | SET5-S:6/TB7-F:6 | 7-6(7-5) 6-4 4-6 4-6 12-10 | Best 3 Out Of 5 Sets (Win By Two) 6 games with Tiebreak to 7 (No Tiebreak in 5th set). | Wimbledon singles 2018 |
SET5 | S:6/TB7 | F:6/TB7@12 | SET5-S:6/TB7-F:6/TB7@12 | 7-6(7-5) 6-4 4-6 4-6 13-12(7-5) | Best 3 Out Of 5 Sets (Win By Two) 6 games with Tiebreak to 7 (5th set tiebreak starting at 12). | Wimbledon singles 2019 |
SET5 | S:6/TB7 | F:6/TB10 | SET5-S:6/TB7-F:6/TB10 | 7-6(7-5) 6-4 4-6 4-6 7-6(10-5) | Best 3 Out Of 5 Sets (Win By Two) 6 games with Tiebreak to 7 (5th set tiebreak to 10). | Australian Open singles 2019 |
SET1 | S:8/TB7 | SET1-S:8/TB7 | 8-7(7-5) | 1 set of 8 games with Tiebreak to 7. | Pro Set | |
SET5 | S:4NOAD/TB5@3 | SET5-S:4/TB5@3 | 4-3(5-3) 2-4 3-4(3-5) 4-0 4-2 | Best 3 Out Of 5 Sets (Win By One) 4 games with Tiebreak to 5 starting at 3. | Fast4 | |
SET3 | S:TB10 | SET3-S:TB10 | [10-4] [5-10] [10-6] | Best 2 out of 3 sets tiebreak only to 10 points. | Tie break only match | |
T30P | T30 | 21-12 | Timed 90 minute game - points based | Timed 90 mins | ||
T30G | T30 | 7-3 | Timed 90 minute game - game based | Timed 90 mins | ||
| SET3 | S:T20 | SET3-S:T20 | 7-0 4-4 5-3 | 3 sets of 20 minutes. |
Go back to Tennis Open Data Standards home page.