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

Aperta
  • Qualcosa non va?
#5 1 commento 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
4/5
Tempo stimato
3-5 giorni
Idoneità per principianti
54/100
Tipo di issue
Funzionalità
Chiarezza
Abbastanza chiara
Stato di attività
Attiva
Stack tecnologico
matplotlib, python, scikit-learn
Ambito
data-visualization, machine-learning

Direzione di ricerca

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.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

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 is scikit-learn / pandas / numpy / joblib; matplotlib and seaborn are the optional viz extra).
  • 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.

Lingua principale
Python
Stelle
11
Fork
23
Merge medio
1g 11h
PR unite (30g)
30

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di PhilanthroPy-Project/PhilanthroPy

Tutte le issue di PhilanthroPy-Project/PhilanthroPy

Issue simili

Altre issue su Python

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.