Raw, user-submitted point-by-point data for pro tennis matches
Latest commit 94ebd46 Jun 20, 2016 @JeffSackmann 2,300 matches
Permalink
Failed to load latest commit information.
.gitattributes 🍭 Added .gitattributes & .gitignore files Mar 11, 2015
.gitignore 🍭 Added .gitattributes & .gitignore files Mar 11, 2015
MatchChart 0.1.5.xlsm new template Jan 6, 2016
README.md updated template name in readme Jan 6, 2016
charting-m-matches.csv 2,300 matches Jun 20, 2016
charting-m-points.csv 2,300 matches Jun 20, 2016
charting-m-stats-KeyPointsReturn.csv 2,300 matches Jun 20, 2016
charting-m-stats-KeyPointsServe.csv 2,300 matches Jun 20, 2016
charting-m-stats-NetPoints.csv 2,300 matches Jun 20, 2016
charting-m-stats-Overview.csv 2,300 matches Jun 20, 2016
charting-m-stats-Rally.csv 2,300 matches Jun 20, 2016
charting-m-stats-ReturnDepth.csv 2,300 matches Jun 20, 2016
charting-m-stats-ReturnOutcomes.csv 2,300 matches Jun 20, 2016
charting-m-stats-ServeBasics.csv 2,300 matches Jun 20, 2016
charting-m-stats-ServeDirection.csv 2,300 matches Jun 20, 2016
charting-m-stats-ServeInfluence.csv 2,300 matches Jun 20, 2016
charting-m-stats-ShotDir.csv 1700 + bugfixes Jan 17, 2016
charting-m-stats-ShotDirOutcomes.csv 2,300 matches Jun 20, 2016
charting-m-stats-ShotDirection.csv 2,300 matches Jun 20, 2016
charting-m-stats-ShotTypes.csv 2,300 matches Jun 20, 2016
charting-m-stats-SnV.csv 2,300 matches Jun 20, 2016
charting-m-stats-SvBreakSplit.csv 2,300 matches Jun 20, 2016
charting-m-stats-SvBreakTotal.csv 2,300 matches Jun 20, 2016
charting-w-matches.csv 2,300 matches Jun 20, 2016
charting-w-points.csv 2,300 matches Jun 20, 2016
charting-w-stats-KeyPointsReturn.csv 2,300 matches Jun 20, 2016
charting-w-stats-KeyPointsServe.csv 2,300 matches Jun 20, 2016
charting-w-stats-NetPoints.csv 2,300 matches Jun 20, 2016
charting-w-stats-Overview.csv 2,300 matches Jun 20, 2016
charting-w-stats-Rally.csv 2,300 matches Jun 20, 2016
charting-w-stats-ReturnDepth.csv 2,300 matches Jun 20, 2016
charting-w-stats-ReturnOutcomes.csv 2,300 matches Jun 20, 2016
charting-w-stats-ServeBasics.csv 2,300 matches Jun 20, 2016
charting-w-stats-ServeDirection.csv 2,300 matches Jun 20, 2016
charting-w-stats-ServeInfluence.csv 2,300 matches Jun 20, 2016
charting-w-stats-ShotDirOutcomes.csv 2,300 matches Jun 20, 2016
charting-w-stats-ShotDirection.csv 2,300 matches Jun 20, 2016
charting-w-stats-ShotTypes.csv 2,300 matches Jun 20, 2016
charting-w-stats-SnV.csv 2,300 matches Jun 20, 2016
charting-w-stats-SvBreakSplit.csv 2,300 matches Jun 20, 2016
charting-w-stats-SvBreakTotal.csv 2,300 matches Jun 20, 2016
charting-w-ufe-fe.csv 1700 + bugfixes Jan 17, 2016

README.md

The Match Charting Project

The goal of the Match Charting Project (MCP) is to amass detailed records of professional matches. Organizations such as the ATP, WTA, ITF, and Grand Slam tournaments record some data, but not in a consistent way, and rarely make any of it available to the public.

MCP match records contain shot-by-shot data for every point of a match, including the type of shot, direction of shot, depth of returns, types of errors, and more. There is no publicly-available data like this anywhere else. To get an idea of the possibilities, aggregate match-level data is available for every submitted match at my website[1].

I started this project in late 2013[2], and since then, dozens of contributors[3] have recorded over 1,400 matches. This repo contains both the raw point-by-point data from these matches and extensive match-level aggregate totals.

Files are separated into men's ('-m-') and women's ('-w-') matches. The '-matches' files contain metadata for each match, including the player names, tournament, date, surface, and more. The '-points' files contain extensive data on each point.

The user-submitted data is found only in the '1st', '2nd', and 'Notes' columns of the points files. All of the other columns are automatically generated by the excel doc[4] used by project contributors. While some of the columns are a bit redundant, many of the others make it easier to analyze the data.

If you have any interest in working with the raw, shot-by-shot data, I strongly encourage you to contribute to the project by charting a match (or twenty) yourself. Not only is it a nice way to give back to the project and help it grow, it is also the best way to learn exactly what you can find in the data.

Here's a guide to help you get started charting your first match: http://www.tennisabstract.com/blog/2015/09/23/the-match-charting-project-quick-start-guide/

Whether you intend to start by charting matches or by jumping straight into the raw data, you'll want to take a look at the 'Instructions' tab of the MatchChart excel doc, which goes into detail regarding the charting notation.

I've now also added several '-stats-' files for both men and women. These contain the aggregate stat lines displayed in each match report. Again, many of the row names will be easier to understand if you've charted a match or two. The rows and columns track very closely to what are shown in the match reports (e.g. http://tennisabstract.com/charting/20150321-M-Irving_CH-SF-Gilles_Muller-Tim_Smyczek.html ). The only difference is that almost all of the data in the '-stats-' files are integer totals, while the match reports display most as percentages.

New matches are submitted several times per week. As the project continues to grow, I will update these files periodically, approximately once per 100 additional matches. Follow me on Twitter[5] for updates on new matches and other improvements to the database.

License

Creative Commons License
Crowdsourced shot-by-shot professional tennis data by The Tennis Abstract Match Charting Project is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.
Based on a work at https://github.com/JeffSackmann/tennis_MatchChartingProject

In other words: Attribution is required. Non-commercial use only.


[1] http://www.tennisabstract.com/charting/meta.html

[2] http://heavytopspin.com/2013/11/26/the-match-charting-project/

[3] http://www.tennisabstract.com/charting/meta.html#contributors

[4] MatchChart 0.1.x.xlsm, included in this repo

[5] http://www.twitter.com/tennisabstract