feat: optional [shap] extra + SHAP plot helper for donor scores

Đang mở
  • Có gì không ổn?
#5 1 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
4/5
Thời gian dự kiến
3-5 ngày
Mức phù hợp với người mới
54/100
Loại issue
Tính năng
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
matplotlib, python, scikit-learn
Lĩnh vực
data-visualization, machine-learning

Hướng nghiên cứu

Start with philanthropy.inspection.donor_feature_importance and examples/method_reference_lalakiya2025.py to understand the existing permutation-importance interface and example. Then inspect the project’s optional-dependency configuration and estimator tests; done means SHAP is installable through the shap extra, an opt-in helper can produce a summary/beeswarm plot for fitted estimators, and core dependencies and default behavior remain unchanged.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

roadmap

philanthropy.inspection.donor_feature_importance gives permutation-based feature attribution for fitted estimators (dependency-free). The method in the ICCED 2025 paper (DOI 10.1109/ICCED68324.2025.11325064) leans on SHAP for the same "which signals move the score" story.

Proposal

  • Add an optional extra: pip install philanthropy[shap].
  • Ship a thin helper wrapping SHAP for fitted PhilanthroPy estimators, plus a summary/beeswarm plot.
  • Keep SHAP out of core deps (core stays scikit-learn / pandas / numpy / matplotlib / seaborn).
  • Permutation importance stays the default; SHAP is opt-in.

Pairs naturally with examples/method_reference_lalakiya2025.py, which currently uses permutation importance as the SHAP analog.

Ngôn ngữ chính
Python
Star
11
Fork
23
Merge trung bình
1 ngày 8 giờ
Pull request đã merge (30 ngày)
35

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của PhilanthroPy-Project/PhilanthroPy

Tất cả issue của PhilanthroPy-Project/PhilanthroPy

Issue tương tự

Thêm issue về Python

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.