microdf-python 1.5.2__py3-none-any.whl → 1.5.4__py3-none-any.whl

{microdf_python-1.5.2.dist-info → microdf_python-1.5.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: microdf-python
-Version: 1.5.2
+Version: 1.5.4
 Summary: Weighted pandas DataFrames and Series for survey microdata
 Author-email: Max Ghenis <max@policyengine.org>
 License: MIT
@@ -25,8 +25,28 @@ Dynamic: license-file
 # microdf
 Weighted pandas DataFrames and Series for survey microdata analysis.
 
-## Overview
-microdf provides `MicroDataFrame` and `MicroSeries` classes that extend pandas functionality with integrated weighting support, essential for accurate survey data analysis.
+## Why this exists
+
+Survey microdata comes with weights, and analysing it in pandas means getting two
+things right that pandas will not do for you.
+
+**The estimators are not the obvious ones.** A weighted median is not the median of
+weighted values. Weighted variance requires choosing between treating weights as
+frequencies or as precision. A top-1% share requires deciding what happens to a
+record that straddles the cutoff. Each of these is a decision, and hand-rolling it
+per analysis means making it differently each time. `microdf` makes each choice
+once, documents it, and tests it — quantiles follow the inverse CDF so they can be
+checked against R's `survey::svyquantile`, and variance treats weights as
+frequencies so integer weights agree with `numpy` on the replicated sample.
+
+**Weights have to survive the pipeline.** Before any estimator runs, weights must
+stay aligned with their rows through merges, filters, grouping and reindexing. When
+they do not, nothing raises. The pipeline completes and returns a plausible wrong
+number. This is the harder of the two problems, and it is why `microdf` carries
+weights inside the object rather than beside it.
+
+If you are computing a poverty rate or a Gini on weighted survey data, those are
+the two ways to get a believable-looking wrong answer.
 
 ## Key Features
 - **MicroDataFrame**: A pandas DataFrame with an integrated weight column

{microdf_python-1.5.2.dist-info → microdf_python-1.5.4.dist-info}/RECORD

@@ -18,8 +18,8 @@ microdf/tests/test_ufunc_weight_dispatch.py,sha256=abQ5I4wFRM3poxO76nbR_1dQymHka
 microdf/tests/test_version_metadata.py,sha256=M1EabzHLKZZw3Djd6Zu2UuMQtDLV6rZ1zDrOU7W_jf0,227
 microdf/tests/test_weight_propagation.py,sha256=3odbufFZ2o1rnyjx6PJ7kn1TPO5K2ho3RErczI7mqO4,18761
 microdf/tests/test_weighted_cov_corr.py,sha256=LTnFhMWnb28f7L_9kOhPiV5UlLMAUbC9OlLIaZ1XgLs,13954
-microdf_python-1.5.2.dist-info/licenses/LICENSE,sha256=uPs-ASYnzlldpf2z8jeRgQFeEH3FLhSuX0rw0OKWoDU,1067
-microdf_python-1.5.2.dist-info/METADATA,sha256=fgHteQKtnfg1645F3MUB6AQ1BBsYZkFBcHKby-wc6Fw,2305
-microdf_python-1.5.2.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
-microdf_python-1.5.2.dist-info/top_level.txt,sha256=T2WFPTygQQMdS3GF8YpZ12DKfMGrspbZ3r7z-e3KfiM,8
-microdf_python-1.5.2.dist-info/RECORD,,
+microdf_python-1.5.4.dist-info/licenses/LICENSE,sha256=uPs-ASYnzlldpf2z8jeRgQFeEH3FLhSuX0rw0OKWoDU,1067
+microdf_python-1.5.4.dist-info/METADATA,sha256=Ji44qsmfccMl7D8D3QGyHs0T9-JivxMOQqNOQ5gSdwc,3427
+microdf_python-1.5.4.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+microdf_python-1.5.4.dist-info/top_level.txt,sha256=T2WFPTygQQMdS3GF8YpZ12DKfMGrspbZ3r7z-e3KfiM,8
+microdf_python-1.5.4.dist-info/RECORD,,