explainiverse 0.2.3__py3-none-any.whl → 0.2.5__py3-none-any.whl

explainiverse/__init__.py

@@ -33,7 +33,7 @@ from explainiverse.adapters.sklearn_adapter import SklearnAdapter
 from explainiverse.adapters import TORCH_AVAILABLE
 from explainiverse.engine.suite import ExplanationSuite
 
-__version__ = "0.2.3"
+__version__ = "0.2.5"
 
 __all__ = [
     # Core

explainiverse/core/registry.py

@@ -370,6 +370,8 @@ def _create_default_registry() -> ExplainerRegistry:
     from explainiverse.explainers.global_explainers.sage import SAGEExplainer
     from explainiverse.explainers.counterfactual.dice_wrapper import CounterfactualExplainer
     from explainiverse.explainers.gradient.integrated_gradients import IntegratedGradientsExplainer
+    from explainiverse.explainers.gradient.gradcam import GradCAMExplainer
+    from explainiverse.explainers.gradient.deeplift import DeepLIFTExplainer, DeepLIFTShapExplainer
     
     registry = ExplainerRegistry()
     
@@ -479,6 +481,57 @@ def _create_default_registry() -> ExplainerRegistry:
         )
     )
     
+    # Register GradCAM (for CNNs)
+    registry.register(
+        name="gradcam",
+        explainer_class=GradCAMExplainer,
+        meta=ExplainerMeta(
+            scope="local",
+            model_types=["neural"],
+            data_types=["image"],
+            task_types=["classification"],
+            description="GradCAM/GradCAM++ - visual explanations for CNNs via gradient-weighted activations (requires PyTorch)",
+            paper_reference="Selvaraju et al., 2017 - 'Grad-CAM: Visual Explanations from Deep Networks' (ICCV)",
+            complexity="O(forward_pass + backward_pass)",
+            requires_training_data=False,
+            supports_batching=True
+        )
+    )
+    
+    # Register DeepLIFT (for neural networks)
+    registry.register(
+        name="deeplift",
+        explainer_class=DeepLIFTExplainer,
+        meta=ExplainerMeta(
+            scope="local",
+            model_types=["neural"],
+            data_types=["tabular", "image"],
+            task_types=["classification", "regression"],
+            description="DeepLIFT - reference-based attributions via activation differences (requires PyTorch)",
+            paper_reference="Shrikumar et al., 2017 - 'Learning Important Features Through Propagating Activation Differences' (ICML)",
+            complexity="O(forward_pass + backward_pass)",
+            requires_training_data=False,
+            supports_batching=True
+        )
+    )
+    
+    # Register DeepSHAP (DeepLIFT + SHAP)
+    registry.register(
+        name="deepshap",
+        explainer_class=DeepLIFTShapExplainer,
+        meta=ExplainerMeta(
+            scope="local",
+            model_types=["neural"],
+            data_types=["tabular", "image"],
+            task_types=["classification", "regression"],
+            description="DeepSHAP - DeepLIFT averaged over background samples for SHAP values (requires PyTorch)",
+            paper_reference="Lundberg & Lee, 2017 - combines DeepLIFT with SHAP",
+            complexity="O(n_background * forward_pass)",
+            requires_training_data=True,
+            supports_batching=True
+        )
+    )
+    
     # =========================================================================
     # Global Explainers (model-level)
     # =========================================================================

explainiverse/explainers/__init__.py

@@ -27,6 +27,8 @@ from explainiverse.explainers.global_explainers.partial_dependence import Partia
 from explainiverse.explainers.global_explainers.ale import ALEExplainer
 from explainiverse.explainers.global_explainers.sage import SAGEExplainer
 from explainiverse.explainers.gradient.integrated_gradients import IntegratedGradientsExplainer
+from explainiverse.explainers.gradient.gradcam import GradCAMExplainer
+from explainiverse.explainers.gradient.deeplift import DeepLIFTExplainer, DeepLIFTShapExplainer
 
 __all__ = [
     # Local explainers
@@ -36,6 +38,9 @@ __all__ = [
     "AnchorsExplainer",
     "CounterfactualExplainer",
     "IntegratedGradientsExplainer",
+    "GradCAMExplainer",
+    "DeepLIFTExplainer",
+    "DeepLIFTShapExplainer",
     # Global explainers
     "PermutationImportanceExplainer",
     "PartialDependenceExplainer",

explainiverse/explainers/gradient/__init__.py

@@ -7,5 +7,12 @@ typically via the PyTorchAdapter.
 """
 
 from explainiverse.explainers.gradient.integrated_gradients import IntegratedGradientsExplainer
+from explainiverse.explainers.gradient.gradcam import GradCAMExplainer
+from explainiverse.explainers.gradient.deeplift import DeepLIFTExplainer, DeepLIFTShapExplainer
 
-__all__ = ["IntegratedGradientsExplainer"]
+__all__ = [
+    "IntegratedGradientsExplainer", 
+    "GradCAMExplainer",
+    "DeepLIFTExplainer",
+    "DeepLIFTShapExplainer",
+]