Yihuier
一会儿轻松解决信用评分卡建模
基于 Scorecard--Function 重构的面向对象版本。
特性
- 面向对象设计 - 统一的 Yihuier 类管理数据和状态
- 完整建模流程 - EDA → 数据处理 → 分箱 → 变量选择 → 模型评估 → 评分卡实现 → 监控
- 模块化架构 - 9个独立模块，职责清晰
- 类型提示 - 完整的类型注解，更好的IDE支持
快速开始
安装
# 使用 pip
pip install yihuier
# 或使用 uv
uv pip install yihuier
基础使用
import pandas as pd
from yihuier import Yihuier
# 加载数据
data = pd.read_csv('data.csv')
yh = Yihuier(data, target='dlq_flag')
# 数据预处理
data_clean = yh.dp_module.delete_missing_var(threshold=0.15)
# 变量分箱
bin_df, iv_value = yh.binning_module.binning_num(
col_list=['v1', 'v2', 'v3'],
max_bin=5,
method='ChiMerge'
)
# WOE转换
woe_df = yh.binning_module.woe_df_concat()
data_woe = yh.binning_module.woe_transform()
# 变量选择
xg_imp, xg_rank, xg_cols = yh.var_select_module.select_xgboost(
col_list=data_woe.drop(['dlq_flag'], axis=1).columns.tolist(),
imp_num=10
)
# 模型训练
from sklearn.linear_model import LogisticRegression
model = LogisticRegression()
model.fit(data_woe[xg_cols], data_woe['dlq_flag'])
# 模型评估
y_pred = model.predict_proba(x_test)[:, 1]
yh.me_module.plot_roc(y_test, y_pred)
yh.me_module.plot_model_ks(y_test, y_pred)
模块概览
| 模块 | 功能 | 文档 |
|---|---|---|
EDAModule |
探索性数据分析 | 📖 EDA 模块 |
DataProcessingModule |
数据预处理 | 📖 数据预处理 |
BinningModule |
变量分箱 | 📖 分箱模块 |
VarSelectModule |
变量选择 | 📖 变量选择 |
ModelEvaluationModule |
模型评估 | 📖 模型评估 |
ScorecardImplementModule |
评分卡实现 | 📖 评分卡实现 |
ScorecardMonitorModule |
评分卡监控 | 📖 评分卡监控 |
ClusterModule |
聚类分析 | 📖 聚类模块 |
PipelineModule |
流水线 | 📖 流水线模块 |
📚 完整文档
开发
# 克隆项目
git clone https://github.com/ency/yihuier.git
cd yihuier
# 安装开发依赖
uv pip install -e ".[dev]"
# 运行测试
pytest tests/ -v
# 代码格式化
ruff format yihuier/
ruff check yihuier/
许可证
MIT License
致谢
- 原项目: Scorecard--Function
- 相关文章: 知乎专栏
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
yihuier-0.3.0.tar.gz
(1.6 MB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
yihuier-0.3.0-py3-none-any.whl
(46.4 kB
view details)
File details
Details for the file yihuier-0.3.0.tar.gz.
File metadata
- Download URL: yihuier-0.3.0.tar.gz
- Upload date:
- Size: 1.6 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f4524557c0667db49341d4151ece2b5ecf18b7fb456887e5f912b5f0fc373326
|
|
| MD5 |
a4f691b86ad02823b7b1c5603c7c5767
|
|
| BLAKE2b-256 |
91ce9ffc1ec2a775cae8e48b5c38ec751e86c218c877664b36ce48dff119e8d0
|
Provenance
The following attestation bundles were made for yihuier-0.3.0.tar.gz:
Publisher:
publish.yml on encyc/yihuier
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
yihuier-0.3.0.tar.gz -
Subject digest:
f4524557c0667db49341d4151ece2b5ecf18b7fb456887e5f912b5f0fc373326 - Sigstore transparency entry: 1936828368
- Sigstore integration time:
-
Permalink:
encyc/yihuier@c03266496a515c2f34cbe81da29c4fb86a5bbc42 -
Branch / Tag:
refs/tags/v0.3.0 - Owner: https://github.com/encyc
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@c03266496a515c2f34cbe81da29c4fb86a5bbc42 -
Trigger Event:
release
-
Statement type:
File details
Details for the file yihuier-0.3.0-py3-none-any.whl.
File metadata
- Download URL: yihuier-0.3.0-py3-none-any.whl
- Upload date:
- Size: 46.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9fd1f499e1ce2e502cb137e770bcb9881cfe60e1fbe8d56a30ab93fee2c7a32b
|
|
| MD5 |
b310ee34cbace9639a515e19f4b4d4fd
|
|
| BLAKE2b-256 |
44d2dd4cdc78d73ad115119441945cd9191339ee25c0540e8b932f294774d16b
|
Provenance
The following attestation bundles were made for yihuier-0.3.0-py3-none-any.whl:
Publisher:
publish.yml on encyc/yihuier
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
yihuier-0.3.0-py3-none-any.whl -
Subject digest:
9fd1f499e1ce2e502cb137e770bcb9881cfe60e1fbe8d56a30ab93fee2c7a32b - Sigstore transparency entry: 1936828561
- Sigstore integration time:
-
Permalink:
encyc/yihuier@c03266496a515c2f34cbe81da29c4fb86a5bbc42 -
Branch / Tag:
refs/tags/v0.3.0 - Owner: https://github.com/encyc
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@c03266496a515c2f34cbe81da29c4fb86a5bbc42 -
Trigger Event:
release
-
Statement type:
