baseballforecaster 0.0.7

A monte-carlo forecaster and drafter for baseball performance

# baseballforecaster

baseballforecaster is a Python library built on top of pybaseball for forecasting baseball performance and simulating fantasy baseball drafts. Currently, full-season monte carlo-based forecasting and drafting is available to generate risk-adjusted players to more accurately measure performance. We are developing in-season monte carlo-based forecasting, full season and in-season lookup-based forecasting, as well as full-season and in-season ML-based forecasting.

The Forecaster module is the standard method for full-season forecasting and drafting. The user can select the time period for analysis, the number of simulations, number of draft rounds, number of drafters, and number of draft iterations. Dictionaries are constructed for each player, by each specified timestamp(date or year), by scraping data using pybaseball. Mean-shift clustering from sklearn is used to create player groups and to serve as a reference point for comparisons and developing performance distributions for each player, so we have more information for sampling. We then use monte-carlo simulations to develop full-season player performance distributions and generate risk-adjusted scores. Fantasy points totals are then calculated using standard fantasy baseball scoring.

Finally, we adapt a monte carlo search tree approach for drafting players to accurately value position importance, performance, and risk. An excel file of the results is then saved for further analysis.

We will continue to allow for greater flexbility and complexity as we develop and improve these techniques. You can further explore the source code in the src folder.

Installation

Installation is made simple by using pip:

pip install baseballforecaster

You can also simply clone the repo and run the following:

pip install -e .

Usage

Here is a simple example using Forecaster We will use the pybaseball library to scrape and consolidate the data and we can use tkinter to provide a simple GUI for the user to enter the time period for analysis, the number of simulations, draft rounds, number of drafters, draft iterations, and the exploration factor. Then, just pass the Forecaster object into the Drafter object to use the forecasted player scores to simulate a fantasy baseball draft. All results are then conveniently stored as pandas dataframes for further analysis

Forecaster Example :

#import the libraries
from baseballforecaster import Forecaster, Drafter, entry, get_dates

#perform the analysis:
if __name__ == "__main__":

    #get parameters for forecasting
    simulations, num_competitors, num_rounds, num_iterations = entry()

    #get the time period for forecastings
    time_period = get_dates()

    #create Forecaster object
    forecaster = Forecaster(simulations, num_competitors, num_rounds, num_iterations,time_period)

    #perform monte carlo simulation to forecast player performance
    forecaster.monte_carlo_forecast()

    #define the drafter object
    drafter = Drafter(forecaster)

    #simulate a fantasy baseball draft
    drafter.draft()

    #save the forecasting, clustering, and drafting results
    drafter.excel_converter()

Contributing

We are open to pull requests and look forward to expanding this library further to tackle more complex games. Please open an issue to discuss any changes or improvements. To install baseballforecaster, along with the tools you need to develop and run tests, run the following in your virtualenv:

$pip install -e .[dev]

License

MIT