Download the PHP package garethellis/cricket-stats-helper without Composer
On this page you can find all versions of the php package garethellis/cricket-stats-helper. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download garethellis/cricket-stats-helper
More information about garethellis/cricket-stats-helper
Files in garethellis/cricket-stats-helper
Package cricket-stats-helper
Short Description A simple PHP library for calculating cricket statistics such as batting average, bowling average and bowling economy. Can also convert number of overs bowled in scorecard notation to number of balls bowled, and vice-versa.
License
Informations about the package cricket-stats-helper
Cricket Stats Helper
A simple PHP library for calculating cricket statistics such as batting average, bowling average and bowling economy. Can also convert number of overs bowled in scorecard notation to number of balls bowled, and vice-versa.
Installation
Install with composer, obvs:
Usage
To use the stats helper, simply create a new instance of it.
Balls per over
The standard number of balls in an over in cricket is six. However, in some formats of the sport you will see variations in this. Indeed, until 1979 in Australia all Test Cricket overs lasted eight balls. Thus, you can change the number of balls in an over on which to base the various calculations in two ways. Firstly, in the constructor:
Secondly, using a setter method:
Calculating Batting Average
A batting average is a measure of a batsman's productivity in terms of runs scored per dismissal (it is not quite the same as runs scored per innings). You can calculate the batting average as follows:
Note, each argument to this method must be of type int.
Calculating Bowling Average
A bowling average is a measure of a bowler's productivity in terms of their ratio of wickets taken to runs conceded. To calculate the bowling average using this library:
Note, each argument to this method must be of type int.
Calculating Bowling Economy
Bowling economy is a measure of a bowler's ability to restrict batsmen from scoring runs. To calculate the bowling economy:
Runs conceded must be of type int. Overs bowled can be a whole number (int or string) or a decimal (float or string). Decimals must be provided in "scorecard notation" style, i.e. "10.3" means 10 overs and 3 balls, not 10 and one-third overs.
Converting between overs and balls
As mentioned above, cricket scorecard notation is different from conventional decimal notation. If you see that someone bowled "9.5" overs, this means they bowled 9 overs (probably 6 balls each) and 5 balls, for a total of 59 balls - it does not mean that they bowled 9-and-a-half overs. As well as the above methods for producing stats, some helper methods are provided for converting between over scorecard notation and balls, in case you want to produce any stats of your own.
Converting from overs to balls
As with bowling economy, overs here can be a whole number (int or string) or a decimal (float or string). Decimals must be provided in "scorecard notation" style, i.e. "10.3" means 10 overs and 3 balls, not 10 and one-third overs.
Converting from balls to overs
The number of overs returned will be in "scorecard notation" style (see above).