https://github.com/supposeduck30/python-tennis-match-simulator
Tennis match simulator in python that simulates a tennis match game by game based on player ranking.
https://github.com/supposeduck30/python-tennis-match-simulator
python python-3 python-script simulator sports-analytics tennis tennis-analytics
Last synced: 2 months ago
JSON representation
Tennis match simulator in python that simulates a tennis match game by game based on player ranking.
- Host: GitHub
- URL: https://github.com/supposeduck30/python-tennis-match-simulator
- Owner: Supposeduck30
- License: mit
- Created: 2025-06-20T23:05:16.000Z (4 months ago)
- Default Branch: master
- Last Pushed: 2025-06-29T21:21:34.000Z (3 months ago)
- Last Synced: 2025-07-11T08:43:14.368Z (3 months ago)
- Topics: python, python-3, python-script, simulator, sports-analytics, tennis, tennis-analytics
- Language: Python
- Homepage:
- Size: 148 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Tennis Match Simulator in Python
## A fully functional tennis match simulator in python made from scratch which simulates a realistic best of 3 set tennis match point by point
This project was built with no external libraries at all, and it simulates the game purely off of math and randomness. This project:
- Asks for player names and their world ranking
- Simulates points, games, and sets with randomness weighted by player ranking
- Prints out a game by game report and a match result
## 🚀 How to run this project
1. Ensure Python is installed on your device (You can verify this by running the command python --version in your terminal/command prompt)
2. Download the script
- If you have git installed, run "clone https://github.com/Supposeduck30/tennis-match-simulator.git" in terminal/command prompt
- Or, download the zip file and extract it
3. Navigate to the directory containing the script
4. Run it by inputting into the command prompt/terminal "python Tennis_Match_Outcome_Generator.py"
5. ALTERNATIVE - Paste the code into an online python compiler or an IDE to run it
#### THE CODE IS IN THE .py FILE INSIDE OF THE FOLDER
## 🕓 Version History
### 1.0.0
- Terminal based
- Asks for ranks and names of players
- Simulates the match game by game randomly weighted towards rank
- Outputs the score of each set
### 1.1.0
- Asks for ranks and names of players
- Simulates the match point by point
- Outputs a game by game summary with the score of each game
- Incorporates serving logic (who serves first, alternating serves, person is more likely to win their service game)
## 🔧 How to tweak the project for your own uses
1. Fork the repository
2. Clone the fork
3. Make your changes to the code
4. Commit and push your changes to the fork
5. OPTIONAL - Create a pull request if you want the main repository to change the code with what you changed
## 📊 How it works
- With the input of the ranks, it then simulates each game, randomizing who serves first and alternating from there
- A higher ranked player is mlre likely to win their service game
- It outputs the score of each game and who won
- The randomness makes it so the higher ranked is more likely to win, but there can be upsets
- The higher the difference in rank, the more likely it is for the higher ranked person to win
## Screenshots
## 
## 
## ⚠️ Warnings/Known issues
- If both players are inputted with the same rankings, it still works
- This simulator may oversimply the effects of rankings on match outcomes
## ⚖️ LICENSE
### MIT LICENSE