def test_percentile(self):
self.assertEqual(calculate.percentile([1, 2, 3, 4], 3), 75)
self.assertEqual(
calculate.percentile([1, 2, 3, 3, 4], 3, kind='strict'), 40)
self.assertEqual(calculate.percentile([1, 2, 3, 3, 4], 3, kind='weak'),
80)
self.assertEqual(calculate.percentile([1, 2, 3, 3, 4], 3, kind='mean'),
60)
self.assertRaises(ValueError, calculate.percentile, ['a', 2, 3], 3)
self.assertRaises(ValueError,
calculate.percentile, [1, 2, 3, 4],
3,
kind='mystery-meat')
def test_percentile(self):
self.assertEqual(calculate.percentile([1, 2, 3, 4], 3), 75)
self.assertEqual(calculate.percentile([1, 2, 3, 3, 4], 3, kind='strict'), 40)
self.assertEqual(calculate.percentile([1, 2, 3, 3, 4], 3, kind='weak'), 80)
self.assertEqual(calculate.percentile([1, 2, 3, 3, 4], 3, kind='mean'), 60)
with self.assertRaises(ValueError):
calculate.percentile(['a', 2, 3], 3)
calculate.percentile([1,2,3,4], 3, kind='mystery-meat')
def decile(data_list, score, kind='weak'):
"""
Accepts a sample of values and a single number to add to it
and determine the decile equivilent of its percentile rank.
By default, the method used to negotiate gaps and ties
is "weak" because it returns the percentile of all values
at or below the provided value. For an explanation of
alternative methods, refer to the calculate.percentile
function.
h3. Example usage
>> import calculate
>> calculate.decile([1, 2, 3, 3, 4], 3)
9
h3. Documentation
* "percentile rank":http://en.wikipedia.org/wiki/Percentile_rank
* "decile":http://en.wikipedia.org/wiki/Decile
"""
# Use calculate.percentile to fetch the precise percentile
# ranking of the desired value
percentile_score = calculate.percentile(data_list, score, kind=kind)
# Now translate that value to a decile value
if percentile_score == 100.0:
# If the value is 100, it's easy, return 10
return 10
else:
# Otherwise, reduce the value to single digits,
# shave off the decimal by converting it to an
# integer, and then add one, so that, for example,
# 0.X numbers are in the first decile, and 9.X
# numbers are in the 10th. - where we want them.
decile = int(percentile_score * 0.1) + 1
return decile
def decile(array, score, kind='weak'):
"""
Accepts an array of values and a singleton score.
The score is run against the array to determine its percentile score.
The value is then translated into a decile grouping and returned as an integer.
By default, the percentile method used is weak. Others are detailed in the documentation below.
h3. Example usage
>>> import calculate
>>> calculate.decile([1, 2, 3, 3, 4], 3)
9
h3. Dependencies
* "scipy":http://www.scipy.org/SciPy
h3. Documentation
* "percentile rank":http://en.wikipedia.org/wiki/Percentile_rank
* "decile":http://en.wikipedia.org/wiki/Decile
"""
from calculate import percentile
if not isinstance(array, list):
raise TypeError('first value input must be a list')
percentile_score = percentile(array, score, kind=kind)
if percentile_score == 100.0:
return 10
else:
decile = int(percentile_score * 0.1) + 1
return decile
def decile(array, score, kind='weak'):
"""
Accepts an array of values and a singleton score.
The score is run against the array to determine its percentile score.
The value is then translated into a decile grouping and returned as an integer.
By default, the percentile method used is weak. Others are detailed in the documentation below.
h3. Example usage
>>> import calculate
>>> calculate.decile([1, 2, 3, 3, 4], 3)
9
h3. Dependencies
* "scipy":http://www.scipy.org/SciPy
h3. Documentation
* "percentile rank":http://en.wikipedia.org/wiki/Percentile_rank
* "decile":http://en.wikipedia.org/wiki/Decile
"""
from calculate import percentile
if not isinstance(array, list):
raise TypeError('first value input must be a list')
percentile_score = percentile(array, score, kind=kind)
if percentile_score == 100.0:
return 10
else:
decile = int(percentile_score * 0.1) + 1
return decile
