File size: 7,524 Bytes
d28d608
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
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
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
"""
Data Analysis Utilities
Common operations for data processing and analysis
"""

import pandas as pd
import numpy as np
from typing import Any, Dict, List, Optional, Union
import logging

logger = logging.getLogger(__name__)


def calculate_sum(df: pd.DataFrame, column_name: str, filter_condition: Optional[pd.Series] = None) -> float:
    """
    Calculate sum of a numeric column
    
    Args:
        df: Input DataFrame
        column_name: Name of column to sum
        filter_condition: Optional boolean Series for filtering
        
    Returns:
        Sum as float
    """
    try:
        if filter_condition is not None:
            filtered_df = df[filter_condition]
        else:
            filtered_df = df
        
        result = filtered_df[column_name].sum()
        logger.info(f"Sum of {column_name}: {result}")
        return float(result)
        
    except Exception as e:
        logger.error(f"Error calculating sum: {e}")
        raise


def count_rows(df: pd.DataFrame, filter_condition: Optional[pd.Series] = None) -> int:
    """
    Count rows in DataFrame with optional filter
    
    Args:
        df: Input DataFrame
        filter_condition: Optional boolean Series for filtering
        
    Returns:
        Count as integer
    """
    try:
        if filter_condition is not None:
            result = df[filter_condition].shape[0]
        else:
            result = df.shape[0]
        
        logger.info(f"Row count: {result}")
        return int(result)
        
    except Exception as e:
        logger.error(f"Error counting rows: {e}")
        raise


def aggregate_stats(df: pd.DataFrame, group_by: Union[str, List[str]], 
                    agg_func: Union[str, Dict[str, str]]) -> Dict[str, Any]:
    """
    Group by columns and apply aggregation functions
    
    Args:
        df: Input DataFrame
        group_by: Column(s) to group by
        agg_func: Aggregation function(s) - 'sum', 'mean', 'count', etc.
                  Can be a dict mapping column names to functions
        
    Returns:
        Dictionary with aggregated results
    """
    try:
        grouped = df.groupby(group_by)
        
        if isinstance(agg_func, str):
            result = grouped.agg(agg_func)
        else:
            result = grouped.agg(agg_func)
        
        # Convert to JSON-serializable format
        result_dict = result.to_dict()
        
        logger.info(f"Aggregation completed: {len(result)} groups")
        return result_dict
        
    except Exception as e:
        logger.error(f"Error in aggregation: {e}")
        raise


def find_max_min(df: pd.DataFrame, column_name: str) -> Dict[str, Any]:
    """
    Find maximum and minimum values in a column
    
    Args:
        df: Input DataFrame
        column_name: Name of column
        
    Returns:
        Dictionary with 'max' and 'min' values
    """
    try:
        max_val = df[column_name].max()
        min_val = df[column_name].min()
        
        # Find rows with max and min values
        max_row = df[df[column_name] == max_val].iloc[0].to_dict()
        min_row = df[df[column_name] == min_val].iloc[0].to_dict()
        
        result = {
            "max": float(max_val) if pd.api.types.is_numeric_dtype(df[column_name]) else str(max_val),
            "min": float(min_val) if pd.api.types.is_numeric_dtype(df[column_name]) else str(min_val),
            "max_row": max_row,
            "min_row": min_row
        }
        
        logger.info(f"Max: {max_val}, Min: {min_val}")
        return result
        
    except Exception as e:
        logger.error(f"Error finding max/min: {e}")
        raise


def calculate_mean(df: pd.DataFrame, column_name: str, filter_condition: Optional[pd.Series] = None) -> float:
    """
    Calculate mean of a numeric column
    
    Args:
        df: Input DataFrame
        column_name: Name of column
        filter_condition: Optional boolean Series for filtering
        
    Returns:
        Mean as float
    """
    try:
        if filter_condition is not None:
            filtered_df = df[filter_condition]
        else:
            filtered_df = df
        
        result = filtered_df[column_name].mean()
        logger.info(f"Mean of {column_name}: {result}")
        return float(result)
        
    except Exception as e:
        logger.error(f"Error calculating mean: {e}")
        raise


def calculate_median(df: pd.DataFrame, column_name: str) -> float:
    """
    Calculate median of a numeric column
    
    Args:
        df: Input DataFrame
        column_name: Name of column
        
    Returns:
        Median as float
    """
    try:
        result = df[column_name].median()
        logger.info(f"Median of {column_name}: {result}")
        return float(result)
        
    except Exception as e:
        logger.error(f"Error calculating median: {e}")
        raise


def calculate_std(df: pd.DataFrame, column_name: str) -> float:
    """
    Calculate standard deviation of a numeric column
    
    Args:
        df: Input DataFrame
        column_name: Name of column
        
    Returns:
        Standard deviation as float
    """
    try:
        result = df[column_name].std()
        logger.info(f"Std dev of {column_name}: {result}")
        return float(result)
        
    except Exception as e:
        logger.error(f"Error calculating std: {e}")
        raise


def value_counts(df: pd.DataFrame, column_name: str) -> Dict[str, int]:
    """
    Count unique values in a column
    
    Args:
        df: Input DataFrame
        column_name: Name of column
        
    Returns:
        Dictionary mapping values to counts
    """
    try:
        counts = df[column_name].value_counts().to_dict()
        # Convert keys to strings for JSON serialization
        result = {str(k): int(v) for k, v in counts.items()}
        
        logger.info(f"Value counts for {column_name}: {len(result)} unique values")
        return result
        
    except Exception as e:
        logger.error(f"Error calculating value counts: {e}")
        raise


def filter_dataframe(df: pd.DataFrame, conditions: Dict[str, Any]) -> pd.DataFrame:
    """
    Filter DataFrame based on multiple conditions
    
    Args:
        df: Input DataFrame
        conditions: Dictionary of column: value pairs for filtering
        
    Returns:
        Filtered DataFrame
    """
    try:
        filtered = df.copy()
        
        for column, value in conditions.items():
            if isinstance(value, (list, tuple)):
                # Filter for values in list
                filtered = filtered[filtered[column].isin(value)]
            else:
                # Exact match
                filtered = filtered[filtered[column] == value]
        
        logger.info(f"Filtered DataFrame: {filtered.shape[0]} rows remaining")
        return filtered
        
    except Exception as e:
        logger.error(f"Error filtering DataFrame: {e}")
        raise


def get_column_unique_values(df: pd.DataFrame, column_name: str) -> List[Any]:
    """
    Get unique values in a column
    
    Args:
        df: Input DataFrame
        column_name: Name of column
        
    Returns:
        List of unique values
    """
    try:
        unique_vals = df[column_name].unique().tolist()
        logger.info(f"Unique values in {column_name}: {len(unique_vals)}")
        return unique_vals
        
    except Exception as e:
        logger.error(f"Error getting unique values: {e}")
        raise