0 Fork 0

Files

T

guzhujushi e9624cb3a7 feat(stats): describe 落地，修掉一个静默填 NaN 的 bug（L0 8/12）

src/stats/descriptive.py 由用户本人实现，这里做审查 + 代修。

describe:
- 真 bug：df_num.describe().T 把表转反（行=变量、列=指标），而 docstring 与
  test_describe_reports_expected_keys 定的是"行=指标、列=变量"。转置后
  .loc[指标名] = <按变量索引的 Series> 与列名零交集，pandas 不报错，直接把
  missing / missing_ratio / skewness / kurtosis 四行整行填成 NaN（静默丢数据）；
  weights 分支则报 cannot set a row with mismatched columns。去掉 .T 一处修好三件事
- 补 median 行（pandas 只有 50%，测试契约定的是 median）
- 入参放宽到 list / tuple / ndarray（00_quickstart.py 传的就是 ndarray）
- weights 校验补齐：维度 / 长度 / NaN / 负值 / 和为 0（原先和为 0 时裸抛 ZeroDivisionError）
- docstring 按 4.7 补 Parameters / Returns / Raises

zscore: 修 RET505；docstring 补齐；DataFrame 取列处按坑 8 用 cast 收窄
coefficient_of_variation: 均值为 0 改抛 ValueError（取值问题不是类型问题）；
  空数组提前报错（原先静默 nan + RuntimeWarning）；错别字与文案修正

tests: 去掉 test_stats.py 的模块级 pytestmark —— 它把 6 条测试全部跳过（含已实现的
  describe），正是决策 26 要禁的写法。改为逐条 skip 未实现的 5 条，并新增 20 条用例。

验证：pytest 102 passed / 39 skipped（原 82/40）；ruff All checks passed；pyright 0 errors。
examples/01_clean_and_describe.py 填掉 TODO(L0)，实测 exit 0。

docs: STATUS.md L0 8/12 + 决策 35/36 + 三处待拍板口径；CHANGELOG 记录；
      personal-pitfalls 追加第 11 条（pandas 对不齐就静默填 NaN）

2026-10-03 13:17:58 +08:00

00_quickstart.py

chore: 初始化 MCM/ICM Toolkit 仓库骨架

2026-10-01 17:43:48 +08:00

01_clean_and_describe.py

feat(stats): describe 落地，修掉一个静默填 NaN 的 bug（L0 8/12）

2026-10-03 13:17:58 +08:00

03_monte_carlo.py

chore: 初始化 MCM/ICM Toolkit 仓库骨架

2026-10-01 17:43:48 +08:00

04_decision_topsis.py

chore: 初始化 MCM/ICM Toolkit 仓库骨架

2026-10-01 17:43:48 +08:00

README.md

chore: 补 S 档卡片 / examples；clean.py 收尾，xfail 清零

2026-10-02 15:48:12 +08:00

README.md

例子

每个模块一个能直接跑的最小例子。

当前状态：这些脚本是用法规格，函数实现填好之前跑不通（会抛 NotImplementedError）。实现顺序见 docs/03-roadmap.md。

00_quickstart.py 与 01_clean_and_describe.py 用到的函数大多已实现，可以跑；两者末尾各有 TODO(L0)，等 stats / viz 补齐。

文件	对应模块	覆盖的 L 档
`00_quickstart.py`	全流程	L0
`01_clean_and_describe.py`	`data` + `stats`	L0
`02_regression_compare.py`	`models`	L1
`03_monte_carlo.py`	`solve/simulate`	L0
`04_decision_topsis.py`	`decision`	L1
`05_sensitivity.py`	`solve/sensitivity`	L1

跑法：

.\.venv\Scripts\python.exe examples\03_monte_carlo.py