microdf-python 1.0.2__py3-none-any.whl → 1.1.0__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- microdf/microdataframe.py +191 -10
- microdf/tests/test_microseries_dataframe.py +57 -0
- {microdf_python-1.0.2.dist-info → microdf_python-1.1.0.dist-info}/METADATA +1 -3
- microdf_python-1.1.0.dist-info/RECORD +10 -0
- microdf_python-1.0.2.dist-info/RECORD +0 -10
- {microdf_python-1.0.2.dist-info → microdf_python-1.1.0.dist-info}/WHEEL +0 -0
- {microdf_python-1.0.2.dist-info → microdf_python-1.1.0.dist-info}/licenses/LICENSE +0 -0
- {microdf_python-1.0.2.dist-info → microdf_python-1.1.0.dist-info}/top_level.txt +0 -0
microdf/microdataframe.py
CHANGED
|
@@ -12,6 +12,80 @@ from microdf.microseries import MicroSeries, MicroSeriesGroupBy
|
|
|
12
12
|
logger = logging.getLogger(__name__)
|
|
13
13
|
|
|
14
14
|
|
|
15
|
+
class _MicroLocIndexer:
|
|
16
|
+
"""Custom loc indexer that returns MicroDataFrame with proper weights."""
|
|
17
|
+
|
|
18
|
+
def __init__(self, mdf: "MicroDataFrame"):
|
|
19
|
+
self._mdf = mdf
|
|
20
|
+
# Get the parent's loc indexer
|
|
21
|
+
self._parent_loc = pd.DataFrame.loc.fget(mdf)
|
|
22
|
+
|
|
23
|
+
def __getitem__(self, key):
|
|
24
|
+
# Use the parent DataFrame's loc indexer
|
|
25
|
+
result = self._parent_loc[key]
|
|
26
|
+
|
|
27
|
+
if isinstance(result, pd.DataFrame):
|
|
28
|
+
# Get the filtered weights based on the result's index
|
|
29
|
+
new_weights = self._mdf.weights.reindex(result.index)
|
|
30
|
+
return MicroDataFrame(result, weights=new_weights)
|
|
31
|
+
elif isinstance(result, pd.Series):
|
|
32
|
+
# Single row or column selected
|
|
33
|
+
if result.name in self._mdf.columns:
|
|
34
|
+
# Column was selected - return MicroSeries with all weights
|
|
35
|
+
return MicroSeries(result, weights=self._mdf.weights)
|
|
36
|
+
else:
|
|
37
|
+
# Row was selected - return as-is (scalar values for each col)
|
|
38
|
+
return result
|
|
39
|
+
else:
|
|
40
|
+
# Scalar value
|
|
41
|
+
return result
|
|
42
|
+
|
|
43
|
+
def __setitem__(self, key, value):
|
|
44
|
+
self._parent_loc[key] = value
|
|
45
|
+
self._mdf._link_all_weights()
|
|
46
|
+
|
|
47
|
+
|
|
48
|
+
class _MicroILocIndexer:
|
|
49
|
+
"""Custom iloc indexer that returns MicroDataFrame with proper weights."""
|
|
50
|
+
|
|
51
|
+
def __init__(self, mdf: "MicroDataFrame"):
|
|
52
|
+
self._mdf = mdf
|
|
53
|
+
# Get the parent's iloc indexer
|
|
54
|
+
self._parent_iloc = pd.DataFrame.iloc.fget(mdf)
|
|
55
|
+
|
|
56
|
+
def __getitem__(self, key):
|
|
57
|
+
# Use the parent DataFrame's iloc indexer
|
|
58
|
+
result = self._parent_iloc[key]
|
|
59
|
+
|
|
60
|
+
if isinstance(result, pd.DataFrame):
|
|
61
|
+
# Get the filtered weights based on the result's index
|
|
62
|
+
new_weights = self._mdf.weights.iloc[
|
|
63
|
+
self._mdf.index.get_indexer(result.index)
|
|
64
|
+
]
|
|
65
|
+
new_weights = pd.Series(new_weights.values, index=result.index)
|
|
66
|
+
return MicroDataFrame(result, weights=new_weights)
|
|
67
|
+
elif isinstance(result, pd.Series):
|
|
68
|
+
# Single row or column selected
|
|
69
|
+
if isinstance(key, tuple) and len(key) == 2:
|
|
70
|
+
# df.iloc[:, col_idx] - column selection
|
|
71
|
+
row_key = key[0]
|
|
72
|
+
if isinstance(row_key, slice) and row_key == slice(None):
|
|
73
|
+
# All rows selected for a column
|
|
74
|
+
return MicroSeries(result, weights=self._mdf.weights)
|
|
75
|
+
# Check if this is a column (result index matches mdf index)
|
|
76
|
+
if result.index.equals(self._mdf.index):
|
|
77
|
+
return MicroSeries(result, weights=self._mdf.weights)
|
|
78
|
+
# Row selection - return as-is
|
|
79
|
+
return result
|
|
80
|
+
else:
|
|
81
|
+
# Scalar value
|
|
82
|
+
return result
|
|
83
|
+
|
|
84
|
+
def __setitem__(self, key, value):
|
|
85
|
+
self._parent_iloc[key] = value
|
|
86
|
+
self._mdf._link_all_weights()
|
|
87
|
+
|
|
88
|
+
|
|
15
89
|
class MicroDataFrame(pd.DataFrame):
|
|
16
90
|
def __init__(self, *args, weights=None, **kwargs):
|
|
17
91
|
"""A DataFrame-inheriting class for weighted microdata. Weights can be
|
|
@@ -26,6 +100,23 @@ class MicroDataFrame(pd.DataFrame):
|
|
|
26
100
|
self._link_all_weights()
|
|
27
101
|
self.override_df_functions()
|
|
28
102
|
|
|
103
|
+
@property
|
|
104
|
+
def loc(self) -> _MicroLocIndexer:
|
|
105
|
+
"""Label-based indexer that preserves MicroDataFrame type and weights.
|
|
106
|
+
|
|
107
|
+
:return: Custom loc indexer for MicroDataFrame
|
|
108
|
+
"""
|
|
109
|
+
return _MicroLocIndexer(self)
|
|
110
|
+
|
|
111
|
+
@property
|
|
112
|
+
def iloc(self) -> _MicroILocIndexer:
|
|
113
|
+
"""Integer-based indexer that preserves MicroDataFrame type and
|
|
114
|
+
weights.
|
|
115
|
+
|
|
116
|
+
:return: Custom iloc indexer for MicroDataFrame
|
|
117
|
+
"""
|
|
118
|
+
return _MicroILocIndexer(self)
|
|
119
|
+
|
|
29
120
|
def override_df_functions(self) -> None:
|
|
30
121
|
"""Override DataFrame functions to work with weighted operations."""
|
|
31
122
|
for name in MicroSeries.FUNCTIONS:
|
|
@@ -643,6 +734,7 @@ class MicroDataFrame(pd.DataFrame):
|
|
|
643
734
|
|
|
644
735
|
class MicroDataFrameGroupBy(pd.core.groupby.generic.DataFrameGroupBy):
|
|
645
736
|
def _init(self, by: Union[str, List]):
|
|
737
|
+
self._by = by
|
|
646
738
|
self.columns = list(self.obj.columns)
|
|
647
739
|
if isinstance(by, list):
|
|
648
740
|
for column in by:
|
|
@@ -656,6 +748,10 @@ class MicroDataFrameGroupBy(pd.core.groupby.generic.DataFrameGroupBy):
|
|
|
656
748
|
for col in self.columns
|
|
657
749
|
if pd.api.types.is_numeric_dtype(self.obj[col])
|
|
658
750
|
]
|
|
751
|
+
# Store reference to weights groupby for column selection
|
|
752
|
+
self._weights_groupby = copy.deepcopy(
|
|
753
|
+
super().__getitem__("__tmp_weights")
|
|
754
|
+
)
|
|
659
755
|
for fn_name in MicroSeries.SCALAR_FUNCTIONS:
|
|
660
756
|
|
|
661
757
|
def get_fn(name):
|
|
@@ -669,11 +765,9 @@ class MicroDataFrameGroupBy(pd.core.groupby.generic.DataFrameGroupBy):
|
|
|
669
765
|
except Exception:
|
|
670
766
|
# Skip columns that can't be aggregated
|
|
671
767
|
pass
|
|
672
|
-
|
|
673
|
-
|
|
674
|
-
|
|
675
|
-
else MicroDataFrame()
|
|
676
|
-
)
|
|
768
|
+
# Return plain DataFrame - aggregated results don't have
|
|
769
|
+
# per-row weights (weights were already applied)
|
|
770
|
+
return pd.DataFrame(results) if results else pd.DataFrame()
|
|
677
771
|
|
|
678
772
|
return fn
|
|
679
773
|
|
|
@@ -691,12 +785,99 @@ class MicroDataFrameGroupBy(pd.core.groupby.generic.DataFrameGroupBy):
|
|
|
691
785
|
except Exception:
|
|
692
786
|
# Skip columns that can't be aggregated
|
|
693
787
|
pass
|
|
694
|
-
|
|
695
|
-
|
|
696
|
-
|
|
697
|
-
else MicroDataFrame()
|
|
698
|
-
)
|
|
788
|
+
# Return plain DataFrame - aggregated results don't have
|
|
789
|
+
# per-row weights (weights were already applied)
|
|
790
|
+
return pd.DataFrame(results) if results else pd.DataFrame()
|
|
699
791
|
|
|
700
792
|
return fn
|
|
701
793
|
|
|
702
794
|
setattr(self, fn_name, get_fn(fn_name))
|
|
795
|
+
|
|
796
|
+
def __getitem__(
|
|
797
|
+
self, key: Union[str, List]
|
|
798
|
+
) -> Union["MicroSeriesGroupBy", "MicroDataFrameGroupBy"]:
|
|
799
|
+
"""Select columns from the groupby object while preserving weights.
|
|
800
|
+
|
|
801
|
+
This ensures that operations like groupby(col)["y"].sum() or
|
|
802
|
+
groupby(col)[["y"]].sum() use weighted aggregation.
|
|
803
|
+
|
|
804
|
+
:param key: Column name or list of column names
|
|
805
|
+
:return: MicroSeriesGroupBy for single column, MicroDataFrameGroupBy
|
|
806
|
+
for multiple columns
|
|
807
|
+
"""
|
|
808
|
+
if isinstance(key, str):
|
|
809
|
+
# Single column - return MicroSeriesGroupBy
|
|
810
|
+
result = super().__getitem__(key)
|
|
811
|
+
result.__class__ = MicroSeriesGroupBy
|
|
812
|
+
result._init()
|
|
813
|
+
result.weights = self._weights_groupby
|
|
814
|
+
return result
|
|
815
|
+
else:
|
|
816
|
+
# Multiple columns - return a new MicroDataFrameGroupBy
|
|
817
|
+
# with only the selected columns
|
|
818
|
+
result = super().__getitem__(key)
|
|
819
|
+
result.__class__ = MicroDataFrameGroupBy
|
|
820
|
+
# Re-initialize with the subset of columns
|
|
821
|
+
result._by = self._by
|
|
822
|
+
result.columns = list(key) if hasattr(key, "__iter__") else [key]
|
|
823
|
+
result.numeric_columns = [
|
|
824
|
+
col
|
|
825
|
+
for col in result.columns
|
|
826
|
+
if pd.api.types.is_numeric_dtype(result.obj[col])
|
|
827
|
+
]
|
|
828
|
+
result._weights_groupby = self._weights_groupby
|
|
829
|
+
# Set up the column attributes as MicroSeriesGroupBy
|
|
830
|
+
for col in result.columns:
|
|
831
|
+
col_gb = super().__getitem__(col)
|
|
832
|
+
col_gb.__class__ = MicroSeriesGroupBy
|
|
833
|
+
col_gb._init()
|
|
834
|
+
col_gb.weights = self._weights_groupby
|
|
835
|
+
setattr(result, col, col_gb)
|
|
836
|
+
# Set up the scalar and vector functions
|
|
837
|
+
for fn_name in MicroSeries.SCALAR_FUNCTIONS:
|
|
838
|
+
|
|
839
|
+
def get_scalar_fn(name, res):
|
|
840
|
+
def fn(*args, **kwargs):
|
|
841
|
+
results = {}
|
|
842
|
+
for col in res.numeric_columns:
|
|
843
|
+
try:
|
|
844
|
+
results[col] = getattr(
|
|
845
|
+
getattr(res, col), name
|
|
846
|
+
)(*args, **kwargs)
|
|
847
|
+
except Exception:
|
|
848
|
+
pass
|
|
849
|
+
# Return plain DataFrame - aggregated results don't
|
|
850
|
+
# have per-row weights (weights were already applied)
|
|
851
|
+
return (
|
|
852
|
+
pd.DataFrame(results)
|
|
853
|
+
if results
|
|
854
|
+
else pd.DataFrame()
|
|
855
|
+
)
|
|
856
|
+
|
|
857
|
+
return fn
|
|
858
|
+
|
|
859
|
+
setattr(result, fn_name, get_scalar_fn(fn_name, result))
|
|
860
|
+
for fn_name in MicroSeries.VECTOR_FUNCTIONS:
|
|
861
|
+
|
|
862
|
+
def get_vector_fn(name, res):
|
|
863
|
+
def fn(*args, **kwargs):
|
|
864
|
+
results = {}
|
|
865
|
+
for col in res.numeric_columns:
|
|
866
|
+
try:
|
|
867
|
+
results[col] = getattr(
|
|
868
|
+
getattr(res, col), name
|
|
869
|
+
)(*args, **kwargs)
|
|
870
|
+
except Exception:
|
|
871
|
+
pass
|
|
872
|
+
# Return plain DataFrame - aggregated results don't
|
|
873
|
+
# have per-row weights (weights were already applied)
|
|
874
|
+
return (
|
|
875
|
+
pd.DataFrame(results)
|
|
876
|
+
if results
|
|
877
|
+
else pd.DataFrame()
|
|
878
|
+
)
|
|
879
|
+
|
|
880
|
+
return fn
|
|
881
|
+
|
|
882
|
+
setattr(result, fn_name, get_vector_fn(fn_name, result))
|
|
883
|
+
return result
|
|
@@ -287,3 +287,60 @@ def test_reset_index_inplace() -> None:
|
|
|
287
287
|
assert "second" in mdf_multi.columns
|
|
288
288
|
assert list(mdf_multi.index) == [0, 1, 2, 3]
|
|
289
289
|
np.testing.assert_array_equal(mdf_multi.weights.values, weights)
|
|
290
|
+
|
|
291
|
+
|
|
292
|
+
def test_loc_preserves_weights() -> None:
|
|
293
|
+
"""Test that .loc[] returns MicroDataFrame with proper weights (issue
|
|
294
|
+
#265)."""
|
|
295
|
+
df = mdf.MicroDataFrame(
|
|
296
|
+
{"one": [1, 1, 1, 1, 1]}, weights=[10, 20, 30, 40, 50]
|
|
297
|
+
)
|
|
298
|
+
|
|
299
|
+
# Filter all rows (should get same weights)
|
|
300
|
+
filtered = df.loc[df.one == 1]
|
|
301
|
+
assert isinstance(filtered, MicroDataFrame)
|
|
302
|
+
assert filtered.one.sum() == 150.0 # Weighted sum
|
|
303
|
+
|
|
304
|
+
# Partial filter
|
|
305
|
+
df2 = mdf.MicroDataFrame(
|
|
306
|
+
{"x": [1, 2, 3, 4, 5]}, weights=[10, 20, 30, 40, 50]
|
|
307
|
+
)
|
|
308
|
+
subset = df2.loc[df2.x > 2]
|
|
309
|
+
assert isinstance(subset, MicroDataFrame)
|
|
310
|
+
assert subset.x.sum() == 500.0 # 3*30 + 4*40 + 5*50 = 500
|
|
311
|
+
np.testing.assert_array_equal(subset.weights.values, [30.0, 40.0, 50.0])
|
|
312
|
+
|
|
313
|
+
|
|
314
|
+
def test_iloc_preserves_weights() -> None:
|
|
315
|
+
"""Test that .iloc[] returns MicroDataFrame with proper weights."""
|
|
316
|
+
df = mdf.MicroDataFrame(
|
|
317
|
+
{"x": [1, 2, 3, 4, 5]}, weights=[10, 20, 30, 40, 50]
|
|
318
|
+
)
|
|
319
|
+
|
|
320
|
+
# Select rows by position
|
|
321
|
+
subset = df.iloc[2:5]
|
|
322
|
+
assert isinstance(subset, MicroDataFrame)
|
|
323
|
+
assert subset.x.sum() == 500.0 # 3*30 + 4*40 + 5*50 = 500
|
|
324
|
+
np.testing.assert_array_equal(subset.weights.values, [30.0, 40.0, 50.0])
|
|
325
|
+
|
|
326
|
+
|
|
327
|
+
def test_groupby_column_selection() -> None:
|
|
328
|
+
"""Test that groupby column selection preserves weights (issue #193)."""
|
|
329
|
+
d = mdf.MicroDataFrame(
|
|
330
|
+
dict(g=["a", "a", "b"], y=[1, 2, 3]), weights=[4, 5, 6]
|
|
331
|
+
)
|
|
332
|
+
|
|
333
|
+
# Test single column string selection
|
|
334
|
+
result_str = d.groupby("g")["y"].sum()
|
|
335
|
+
assert result_str["a"] == 14.0 # 1*4 + 2*5 = 14
|
|
336
|
+
assert result_str["b"] == 18.0 # 3*6 = 18
|
|
337
|
+
|
|
338
|
+
# Test list column selection
|
|
339
|
+
result_list = d.groupby("g")[["y"]].sum()
|
|
340
|
+
assert result_list.loc["a", "y"] == 14.0
|
|
341
|
+
assert result_list.loc["b", "y"] == 18.0
|
|
342
|
+
|
|
343
|
+
# Aggregated results should be plain DataFrame (no spurious weight column)
|
|
344
|
+
result_all = d.groupby("g").sum()
|
|
345
|
+
assert "weight" not in result_all.columns
|
|
346
|
+
assert list(result_all.columns) == ["y"]
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: microdf-python
|
|
3
|
-
Version: 1.0
|
|
3
|
+
Version: 1.1.0
|
|
4
4
|
Summary: Weighted pandas DataFrames and Series for survey microdata
|
|
5
5
|
Author-email: Max Ghenis <max@policyengine.org>
|
|
6
6
|
License: MIT
|
|
@@ -20,8 +20,6 @@ Requires-Dist: linecheck; extra == "dev"
|
|
|
20
20
|
Requires-Dist: pytest; extra == "dev"
|
|
21
21
|
Requires-Dist: pytest-cov; extra == "dev"
|
|
22
22
|
Requires-Dist: setuptools; extra == "dev"
|
|
23
|
-
Provides-Extra: docs
|
|
24
|
-
Requires-Dist: jupyter_book; extra == "docs"
|
|
25
23
|
Dynamic: license-file
|
|
26
24
|
|
|
27
25
|
[](https://github.com/PolicyEngine/microdf/actions)
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
microdf/__init__.py,sha256=ldRvhE8t4cD7qlxQ5yLndMnWEUYpDw4m-jCDV_psXkY,319
|
|
2
|
+
microdf/microdataframe.py,sha256=X91fUvDS9xMzj2FFAoa6g9EhR_mJv60DXtvK4iIlMrM,33237
|
|
3
|
+
microdf/microseries.py,sha256=MFBStp1IaNVABaf3_Ap_VwXSC3bA8V7rXD4TEG_091g,22452
|
|
4
|
+
microdf/tests/conftest.py,sha256=u-EMyX1-u_nM-YO0RJYCzYHQDXxUI2WQE6GkyJlErqg,150
|
|
5
|
+
microdf/tests/test_microseries_dataframe.py,sha256=U33uBNW6uiF8c7ygDJjwYX_tJJc_i7OKHi-O746XQLY,11398
|
|
6
|
+
microdf_python-1.1.0.dist-info/licenses/LICENSE,sha256=uPs-ASYnzlldpf2z8jeRgQFeEH3FLhSuX0rw0OKWoDU,1067
|
|
7
|
+
microdf_python-1.1.0.dist-info/METADATA,sha256=vPKXByn0atLs1zxTwc6XqESm7iE1wQ4lNtVIIAPBfQA,2420
|
|
8
|
+
microdf_python-1.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
|
|
9
|
+
microdf_python-1.1.0.dist-info/top_level.txt,sha256=T2WFPTygQQMdS3GF8YpZ12DKfMGrspbZ3r7z-e3KfiM,8
|
|
10
|
+
microdf_python-1.1.0.dist-info/RECORD,,
|
|
@@ -1,10 +0,0 @@
|
|
|
1
|
-
microdf/__init__.py,sha256=ldRvhE8t4cD7qlxQ5yLndMnWEUYpDw4m-jCDV_psXkY,319
|
|
2
|
-
microdf/microdataframe.py,sha256=TU4MPHlGSICibPgGkATJYDpVBQ2NNXnyBAqw3kjteeI,25771
|
|
3
|
-
microdf/microseries.py,sha256=MFBStp1IaNVABaf3_Ap_VwXSC3bA8V7rXD4TEG_091g,22452
|
|
4
|
-
microdf/tests/conftest.py,sha256=u-EMyX1-u_nM-YO0RJYCzYHQDXxUI2WQE6GkyJlErqg,150
|
|
5
|
-
microdf/tests/test_microseries_dataframe.py,sha256=2pm_fLZPbv-ccDKnEyqIiw-_pTZwt9J2lnM5YsZHzx4,9401
|
|
6
|
-
microdf_python-1.0.2.dist-info/licenses/LICENSE,sha256=uPs-ASYnzlldpf2z8jeRgQFeEH3FLhSuX0rw0OKWoDU,1067
|
|
7
|
-
microdf_python-1.0.2.dist-info/METADATA,sha256=sOLX9w2xCHwyNeLcW7BpXu6iiTTeaTmxNdMsdJpmD7s,2486
|
|
8
|
-
microdf_python-1.0.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
|
|
9
|
-
microdf_python-1.0.2.dist-info/top_level.txt,sha256=T2WFPTygQQMdS3GF8YpZ12DKfMGrspbZ3r7z-e3KfiM,8
|
|
10
|
-
microdf_python-1.0.2.dist-info/RECORD,,
|
|
File without changes
|
|
File without changes
|
|
File without changes
|