/
aggregation_breakdown_result.py
47 lines (33 loc) · 1.64 KB
/
aggregation_breakdown_result.py
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
from typing import List
import pandas as pd
from vortexasdk.api.aggregation_breakdown_item import AggregationBreakdownItem
from vortexasdk.api.search_result import Result
from vortexasdk.logger import get_logger
from vortexasdk.result_conversions import create_dataframe, create_list
logger = get_logger(__name__)
class AggregationBreakdownResult(Result):
"""Container class that holds the result obtained from calling a top hits endpoint."""
def to_list(self) -> List[AggregationBreakdownItem]:
"""Represents time series as a list."""
# noinspection PyTypeChecker
return create_list(super().to_list(), AggregationBreakdownItem)
def to_df(self, columns=None) -> pd.DataFrame:
"""Represents the aggregation breakdown as a dataframe.
Returns a `pd.DataFrame`, of time series items with columns:
id: ID of the reference record
value: Value of the time series for a given ID
count: Number of records contributing to this time series record.
label: Label of the reference record.
# Example:
If we're aggregating top vessel origins, then the `id` column holds the ID of a location, the `label` holds the name of the location,
the `value` column holds the number of voyages contributing to this aggregation record, and the `count` column holds
the number of vessels.
"""
df = create_dataframe(
columns=columns,
default_columns=DEFAULT_COLUMNS,
data=super().to_list(),
logger_description="AggregationBreakdown",
)
return df
DEFAULT_COLUMNS = ["id", "value", "count", "label"]