50 lines
1.5 KiB
Python
50 lines
1.5 KiB
Python
|
#!/usr/bin/env python
|
||
|
|
|
||
|
|
from agate.aggregations.base import Aggregation
|
||
|
|
from agate.aggregations.has_nulls import HasNulls
|
||
|
|
from agate.aggregations.percentiles import Percentiles
|
||
|
|
from agate.data_types import Number
|
||
|
|
from agate.exceptions import DataTypeError
|
||
|
|
from agate.utils import Quantiles
|
||
|
|
from agate.warns import warn_null_calculation
|
||
|
|
|
||
|
|
|
||
|
|
class Deciles(Aggregation):
|
||
|
|
"""
|
||
|
|
Calculate the deciles of a column based on its percentiles.
|
||
|
|
|
||
|
|
Deciles will be equivalent to the 10th, 20th ... 90th percentiles.
|
||
|
|
|
||
|
|
"Zeroth" (min value) and "Tenth" (max value) deciles are included for
|
||
|
|
reference and intuitive indexing.
|
||
|
|
|
||
|
|
See :class:`Percentiles` for implementation details.
|
||
|
|
|
||
|
|
This aggregation can not be applied to a :class:`.TableSet`.
|
||
|
|
|
||
|
|
:param column_name:
|
||
|
|
The name of a column containing :class:`.Number` data.
|
||
|
|
"""
|
||
|
|
def __init__(self, column_name):
|
||
|
|
self._column_name = column_name
|
||
|
|
|
||
|
|
def validate(self, table):
|
||
|
|
column = table.columns[self._column_name]
|
||
|
|
|
||
|
|
if not isinstance(column.data_type, Number):
|
||
|
|
raise DataTypeError('Deciles can only be applied to columns containing Number data.')
|
||
|
|
|
||
|
|
has_nulls = HasNulls(self._column_name).run(table)
|
||
|
|
|
||
|
|
if has_nulls:
|
||
|
|
warn_null_calculation(self, column)
|
||
|
|
|
||
|
|
def run(self, table):
|
||
|
|
"""
|
||
|
|
:returns:
|
||
|
|
An instance of :class:`Quantiles`.
|
||
|
|
"""
|
||
|
|
percentiles = Percentiles(self._column_name).run(table)
|
||
|
|
|
||
|
|
return Quantiles([percentiles[i] for i in range(0, 101, 10)])
|