ShapEV 0.0.1

ShapEV

A package for identifying Equivalent Value based on joint SHAP values.

ShapEV is an python package that identifies Equivalent Value among features based on cooperative game theory. By leveraging SHAP values, ShapEV decomposes feature contributions and their interactions, defining joint SHAP values to capture combined feature effects. For more details, refer to the original publication: Joint Model Interpretation (JMI).

An Equivalent Value is proposed based on the joint SHAP value, reflecting each feature's overall contribution to the regression target. ShapEV applies this equivalent value to represent the collective behavior of interacting features, allowing users to substitute original individual features with a unified Equivalent Value.

On the modified dataset, ShapEV calculates the contribution of the proposed Equivalent Value by comparing it to SHAP contributions. This validation confirms that, within the SHAP framework, the equivalent value linearly correlates with the target when showing high correlation.

About

Maintained by Bin Cao. Please feel free to open issues in the Github or contact Bin Cao (bcao686@connect.hkust-gz.edu.c) in case of any problems/comments/suggestions in using the code.