From 3377b66146c5f1a70a470f89b5ed7443da6c5b8c Mon Sep 17 00:00:00 2001
From: adrhill <adrian.hill@mailbox.org>
Date: Tue, 8 Apr 2025 17:00:00 +0200
Subject: [PATCH 01/12] Add ProgressMeter to NoiseAugmentation

---
 Project.toml              |  2 ++
 src/input_augmentation.jl | 14 ++++++++++----
 2 files changed, 12 insertions(+), 4 deletions(-)

diff --git a/Project.toml b/Project.toml
index 8c56c08..35bd01a 100644
--- a/Project.toml
+++ b/Project.toml
@@ -7,6 +7,7 @@ version = "0.10.1"
 ADTypes = "47edcb42-4c32-4615-8424-f2b9edc5f35b"
 DifferentiationInterface = "a0c0ee7d-e4b9-4e03-894e-1c5f64a51d63"
 Distributions = "31c24e10-a181-5473-b8eb-7969acd0382f"
+ProgressMeter = "92933f4c-e287-5a05-a399-4b506db050ca"
 Random = "9a3f8284-a2c9-5f02-9a11-845980a1fd5c"
 Reexport = "189a3867-3050-52da-a836-e630ba90ab69"
 Statistics = "10745b16-79ce-11e8-11f9-7d13ad32a3b2"
@@ -16,6 +17,7 @@ XAIBase = "9b48221d-a747-4c1b-9860-46a1d8ba24a7"
 ADTypes = "1"
 DifferentiationInterface = "0.6"
 Distributions = "0.25"
+ProgressMeter = "1.10.4"
 Random = "<0.0.1, 1"
 Reexport = "1"
 Statistics = "<0.0.1, 1"
diff --git a/src/input_augmentation.jl b/src/input_augmentation.jl
index 993c416..3d032b9 100644
--- a/src/input_augmentation.jl
+++ b/src/input_augmentation.jl
@@ -29,17 +29,20 @@ struct NoiseAugmentation{A<:AbstractXAIMethod,D<:Sampleable,R<:AbstractRNG} <:
     n::Int
     distribution::D
     rng::R
+    show_progress::Bool
 
     function NoiseAugmentation(
-        analyzer::A, n::Int, distribution::D, rng::R=GLOBAL_RNG
+        analyzer::A, n::Int, distribution::D, rng::R=GLOBAL_RNG, show_progress=true
     ) where {A<:AbstractXAIMethod,D<:Sampleable,R<:AbstractRNG}
         n < 1 && throw(ArgumentError("Number of samples `n` needs to be larger than zero."))
-        return new{A,D,R}(analyzer, n, distribution, rng)
+        return new{A,D,R}(analyzer, n, distribution, rng, show_progress)
     end
 end
-function NoiseAugmentation(analyzer, n::Int, std::T=1.0f0, rng=GLOBAL_RNG) where {T<:Real}
+function NoiseAugmentation(
+    analyzer, n::Int, std::T=1.0f0, rng=GLOBAL_RNG, show_progress=true
+) where {T<:Real}
     distribution = Normal(zero(T), std^2)
-    return NoiseAugmentation(analyzer, n, distribution, rng)
+    return NoiseAugmentation(analyzer, n, distribution, rng, show_progress)
 end
 
 function call_analyzer(input, aug::NoiseAugmentation, ns::AbstractOutputSelector; kwargs...)
@@ -48,17 +51,20 @@ function call_analyzer(input, aug::NoiseAugmentation, ns::AbstractOutputSelector
     output_indices = ns(output)
     output_selector = AugmentationSelector(output_indices)
 
+    p = Progress(aug.n; desc="Sampling NoiseAugmentation...", showspeed=aug.show_progress)
     # First augmentation
     input_aug = similar(input)
     input_aug = sample_noise!(input_aug, input, aug)
     expl_aug = aug.analyzer(input_aug, output_selector)
     sum_val = expl_aug.val
+    next!(p)
 
     # Further augmentations
     for _ in 2:(aug.n)
         input_aug = sample_noise!(input_aug, input, aug)
         expl_aug = aug.analyzer(input_aug, output_selector)
         sum_val += expl_aug.val
+        next!(p)
     end
 
     # Average explanation

From a9a493bd93b44b18a2272490e4cf5aa0ee2bbaf5 Mon Sep 17 00:00:00 2001
From: adrhill <adrian.hill@mailbox.org>
Date: Tue, 8 Apr 2025 17:00:09 +0200
Subject: [PATCH 02/12] Add GPU tests

---
 test/Project.toml |  2 ++
 test/runtests.jl  |  3 +++
 test/test_gpu.jl  | 39 +++++++++++++++++++++++++++++++++++++++
 3 files changed, 44 insertions(+)
 create mode 100644 test/test_gpu.jl

diff --git a/test/Project.toml b/test/Project.toml
index a8c6b4b..1bf524e 100644
--- a/test/Project.toml
+++ b/test/Project.toml
@@ -4,9 +4,11 @@ BenchmarkTools = "6e4b80f9-dd63-53aa-95a3-0cdb28fa8baf"
 Distributions = "31c24e10-a181-5473-b8eb-7969acd0382f"
 Flux = "587475ba-b771-5e3f-ad9e-33799f191a9c"
 JET = "c3a54625-cd67-489e-a8e7-0a5a0ff4e31b"
+JLArrays = "27aeb0d3-9eb9-45fb-866b-73c2ecf80fcb"
 JLD2 = "033835bb-8acc-5ee8-8aae-3f567f8a3819"
 JuliaFormatter = "98e50ef6-434e-11e9-1051-2b60c6c9e899"
 LinearAlgebra = "37e2e46d-f89d-539d-b4ee-838fcccc9c8e"
+Metal = "dde4c033-4e86-420c-a63e-0dd931031962"
 PkgJogger = "10150987-6cc1-4b76-abee-b1c1cbd91c01"
 Random = "9a3f8284-a2c9-5f02-9a11-845980a1fd5c"
 ReferenceTests = "324d217c-45ce-50fc-942e-d289b448e8cf"
diff --git a/test/runtests.jl b/test/runtests.jl
index c99e335..356f7dd 100644
--- a/test/runtests.jl
+++ b/test/runtests.jl
@@ -33,6 +33,9 @@ using JET
         @info "Testing analyzers on batches..."
         include("test_batches.jl")
     end
+    @testset "GPU tests" begin
+        include("test_gpu.jl")
+    end
     @testset "Benchmark correctness" begin
         @info "Testing whether benchmarks are up-to-date..."
         include("test_benchmarks.jl")
diff --git a/test/test_gpu.jl b/test/test_gpu.jl
new file mode 100644
index 0000000..a791d54
--- /dev/null
+++ b/test/test_gpu.jl
@@ -0,0 +1,39 @@
+using ExplainableAI
+using Test
+
+using Flux
+using Metal, JLArrays
+
+if Metal.functional()
+    @info "Using Metal as GPU device"
+    device = mtl # use Apple Metal locally
+else
+    @info "Using JLArrays as GPU device"
+    device = jl # use JLArrays to fake GPU array
+end
+
+model = Chain(Dense(10 => 32, relu), Dense(32 => 5))
+input = rand(Float32, 10, 8)
+@test_nowarn model(input)
+
+model_gpu = device(model)
+input_gpu = device(input)
+@test_nowarn model_gpu(input_gpu)
+
+analyzer_types = (Gradient, SmoothGrad, InputTimesGradient)
+
+@testset "Run analyzer (CPU)" begin
+    @testset "$A" for A in analyzer_types
+        analyzer = A(model)
+        expl = analyze(input, analyzer)
+        @test expl isa Explanation
+    end
+end
+
+@testset "Run analyzer (GPU)" begin
+    @testset "$A" for A in analyzer_types
+        analyzer_gpu = A(model_gpu)
+        expl = analyze(input_gpu, analyzer_gpu)
+        @test expl isa Explanation
+    end
+end

From 5974a12ab47e77f08e30c2d5b14950025894082b Mon Sep 17 00:00:00 2001
From: adrhill <adrian.hill@mailbox.org>
Date: Tue, 8 Apr 2025 17:00:22 +0200
Subject: [PATCH 03/12] GPU friendly implementation of SmoothGrad

---
 src/ExplainableAI.jl      |  3 ++-
 src/input_augmentation.jl | 17 ++++++++++-------
 2 files changed, 12 insertions(+), 8 deletions(-)

diff --git a/src/ExplainableAI.jl b/src/ExplainableAI.jl
index 2ed8ea9..f65dd53 100644
--- a/src/ExplainableAI.jl
+++ b/src/ExplainableAI.jl
@@ -6,7 +6,8 @@ import XAIBase: call_analyzer
 
 using Base.Iterators
 using Distributions: Distribution, Sampleable, Normal
-using Random: AbstractRNG, GLOBAL_RNG
+using Random: AbstractRNG, GLOBAL_RNG, rand!
+using ProgressMeter: Progress, next!
 
 # Automatic differentiation
 using ADTypes: AbstractADType, AutoZygote
diff --git a/src/input_augmentation.jl b/src/input_augmentation.jl
index 3d032b9..cf8043d 100644
--- a/src/input_augmentation.jl
+++ b/src/input_augmentation.jl
@@ -52,18 +52,19 @@ function call_analyzer(input, aug::NoiseAugmentation, ns::AbstractOutputSelector
     output_selector = AugmentationSelector(output_indices)
 
     p = Progress(aug.n; desc="Sampling NoiseAugmentation...", showspeed=aug.show_progress)
+
     # First augmentation
-    input_aug = similar(input)
-    input_aug = sample_noise!(input_aug, input, aug)
-    expl_aug = aug.analyzer(input_aug, output_selector)
+    noisy_input = similar(input)
+    noisy_input = sample_noise!(noisy_input, input, aug)
+    expl_aug = aug.analyzer(noisy_input, output_selector)
     sum_val = expl_aug.val
     next!(p)
 
     # Further augmentations
     for _ in 2:(aug.n)
-        input_aug = sample_noise!(input_aug, input, aug)
-        expl_aug = aug.analyzer(input_aug, output_selector)
-        sum_val += expl_aug.val
+        noisy_input = sample_noise!(noisy_input, input, aug)
+        expl_aug = aug.analyzer(noisy_input, output_selector)
+        sum_val .+= expl_aug.val
         next!(p)
     end
 
@@ -78,7 +79,9 @@ end
 function sample_noise!(
     out::A, input::A, aug::NoiseAugmentation
 ) where {T,A<:AbstractArray{T}}
-    out .= input .+ rand(aug.rng, aug.distribution, size(input))
+    out = rand!(aug.rng, aug.distribution, out)
+    out .+= input
+    return out
 end
 
 """

From 032b617221f65d3a376c9c8f7033dbe76096be6f Mon Sep 17 00:00:00 2001
From: adrhill <adrian.hill@mailbox.org>
Date: Tue, 8 Apr 2025 17:04:26 +0200
Subject: [PATCH 04/12] Test `IntegratedGradients` as well

---
 src/input_augmentation.jl | 4 ++--
 test/test_gpu.jl          | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/input_augmentation.jl b/src/input_augmentation.jl
index cf8043d..6b37482 100644
--- a/src/input_augmentation.jl
+++ b/src/input_augmentation.jl
@@ -123,9 +123,9 @@ function call_analyzer(
     # Further augmentations
     input_delta = (input - input_ref) / (aug.n - 1)
     for _ in 1:(aug.n)
-        input_aug += input_delta
+        input_aug .+= input_delta
         expl_aug = aug.analyzer(input_aug, output_selector)
-        sum_val += expl_aug.val
+        sum_val .+= expl_aug.val
     end
 
     # Average gradients and compute explanation
diff --git a/test/test_gpu.jl b/test/test_gpu.jl
index a791d54..b7e112b 100644
--- a/test/test_gpu.jl
+++ b/test/test_gpu.jl
@@ -20,7 +20,7 @@ model_gpu = device(model)
 input_gpu = device(input)
 @test_nowarn model_gpu(input_gpu)
 
-analyzer_types = (Gradient, SmoothGrad, InputTimesGradient)
+analyzer_types = (Gradient, SmoothGrad, InputTimesGradient, IntegratedGradients)
 
 @testset "Run analyzer (CPU)" begin
     @testset "$A" for A in analyzer_types

From 8d50760aea110641c7970b2bb2778872375f280e Mon Sep 17 00:00:00 2001
From: adrhill <adrian.hill@mailbox.org>
Date: Tue, 8 Apr 2025 17:04:36 +0200
Subject: [PATCH 05/12] Bump version

---
 CHANGELOG.md | 4 ++++
 Project.toml | 2 +-
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index b6e04d4..b6ed513 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,9 @@
 # ExplainableAI.jl
 
+## Version `v0.10.2`
+- ![Feature][badge-feature] Tested GPU support for `Gradient`, `InputTimesGradient`, `SmoothGrad`, `IntegratedGradients`
+- ![Feature][badge-feature] `NoiseAugmentation` and `SmoothGrad` show a progress meter by default.
+
 ## Version `v0.10.1`
 - ![Bugfix][badge-bugfix] Fix bug in `NoiseAugmentation` constructor ([#183])
 
diff --git a/Project.toml b/Project.toml
index 35bd01a..ad994f8 100644
--- a/Project.toml
+++ b/Project.toml
@@ -1,7 +1,7 @@
 name = "ExplainableAI"
 uuid = "4f1bc3e1-d60d-4ed0-9367-9bdff9846d3b"
 authors = ["Adrian Hill <gh@adrianhill.de>"]
-version = "0.10.1"
+version = "0.10.2-DEV"
 
 [deps]
 ADTypes = "47edcb42-4c32-4615-8424-f2b9edc5f35b"

From a8424049ea9473dbf6d94636331997e094035ab6 Mon Sep 17 00:00:00 2001
From: adrhill <adrian.hill@mailbox.org>
Date: Tue, 8 Apr 2025 17:08:59 +0200
Subject: [PATCH 06/12] Update IG reference

---
 src/input_augmentation.jl                     |   1 +
 .../cnn/IntegratedGradients_max.jld2          | Bin 13127 -> 13127 bytes
 2 files changed, 1 insertion(+)

diff --git a/src/input_augmentation.jl b/src/input_augmentation.jl
index 6b37482..ea910b2 100644
--- a/src/input_augmentation.jl
+++ b/src/input_augmentation.jl
@@ -22,6 +22,7 @@ e.g. `std = 0.1 * (maximum(input) - minimum(input))`.
 ## Keyword arguments
 - `rng::AbstractRNG`: Specify the random number generator that is used to sample noise from the `distribution`. 
   Defaults to `GLOBAL_RNG`. 
+- `show_progress:Bool`: Show progress meter while sampling augmentations. Defaults to `true`.
 """
 struct NoiseAugmentation{A<:AbstractXAIMethod,D<:Sampleable,R<:AbstractRNG} <:
        AbstractXAIMethod
diff --git a/test/references/cnn/IntegratedGradients_max.jld2 b/test/references/cnn/IntegratedGradients_max.jld2
index 4e3b68de3bf85c335bcb6df0790e02cca2235a9b..ad72aebe3afcac0bd12f4e6384014affb67a458a 100644
GIT binary patch
literal 13127
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
CW|9a1

literal 13127
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
O@&CY0*m78N>i+?TNq@os


From 319419463d31d43b3339c7c8d35c43cf0c5700b6 Mon Sep 17 00:00:00 2001
From: adrhill <adrian.hill@mailbox.org>
Date: Tue, 8 Apr 2025 17:11:39 +0200
Subject: [PATCH 07/12] Update CHANGELOG

---
 CHANGELOG.md | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index b6ed513..794ea47 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,8 +1,8 @@
 # ExplainableAI.jl
 
 ## Version `v0.10.2`
-- ![Feature][badge-feature] Tested GPU support for `Gradient`, `InputTimesGradient`, `SmoothGrad`, `IntegratedGradients`
-- ![Feature][badge-feature] `NoiseAugmentation` and `SmoothGrad` show a progress meter by default.
+- ![Feature][badge-feature] Tested GPU support for `Gradient`, `InputTimesGradient`, `SmoothGrad`, `IntegratedGradients` ([#184])
+- ![Feature][badge-feature] `NoiseAugmentation`s show a progress meter by default. Turn off via `show_progress=false` ([#184])
 
 ## Version `v0.10.1`
 - ![Bugfix][badge-bugfix] Fix bug in `NoiseAugmentation` constructor ([#183])
@@ -231,6 +231,7 @@ Performance improvements:
 [VisionHeatmaps]: https://julia-xai.github.io/XAIDocs/VisionHeatmaps/stable/
 [TextHeatmaps]: https://julia-xai.github.io/XAIDocs/TextHeatmaps/stable/
 
+[#184]: https://github.com/Julia-XAI/ExplainableAI.jl/pull/184
 [#183]: https://github.com/Julia-XAI/ExplainableAI.jl/pull/183
 [#180]: https://github.com/Julia-XAI/ExplainableAI.jl/pull/180
 [#179]: https://github.com/Julia-XAI/ExplainableAI.jl/pull/179

From c144e9629298b9a113600dc92129085cac47b74d Mon Sep 17 00:00:00 2001
From: adrhill <adrian.hill@mailbox.org>
Date: Tue, 8 Apr 2025 17:33:22 +0200
Subject: [PATCH 08/12] Ignore JET failures on pre-release

---
 .github/workflows/ci.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 7c6f9fb..cfb0363 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -22,7 +22,7 @@ jobs:
         version:
           - 'lts'
           - '1'
-          - 'pre'
+          # - 'pre'
     steps:
       - uses: actions/checkout@v4
       - uses: julia-actions/setup-julia@v2

From 73381464dd6c2eac5120307e9f4e1c7418e4b3bd Mon Sep 17 00:00:00 2001
From: adrhill <adrian.hill@mailbox.org>
Date: Tue, 8 Apr 2025 17:39:44 +0200
Subject: [PATCH 09/12] Cleaner fix for JET issue

---
 .github/workflows/ci.yml | 2 +-
 test/runtests.jl         | 8 +++++---
 2 files changed, 6 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index cfb0363..7c6f9fb 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -22,7 +22,7 @@ jobs:
         version:
           - 'lts'
           - '1'
-          # - 'pre'
+          - 'pre'
     steps:
       - uses: actions/checkout@v4
       - uses: julia-actions/setup-julia@v2
diff --git a/test/runtests.jl b/test/runtests.jl
index 356f7dd..0ba1e87 100644
--- a/test/runtests.jl
+++ b/test/runtests.jl
@@ -15,9 +15,11 @@ using JET
             @info "- running Aqua.jl tests..."
             Aqua.test_all(ExplainableAI; ambiguities=false)
         end
-        @testset "JET tests" begin
-            @info "- running JET.jl type stability tests..."
-            JET.test_package(ExplainableAI; target_defined_modules=true)
+        if VERSION <= v"1.12" # TODO: remove. As of PR #184, JET fails on pre-release builds.
+            @testset "JET tests" begin
+                @info "- running JET.jl type stability tests..."
+                JET.test_package(ExplainableAI; target_defined_modules=true)
+            end
         end
     end
 

From ceb26fab09564583c8b33e9dc5e41415d18e6b9f Mon Sep 17 00:00:00 2001
From: adrhill <adrian.hill@mailbox.org>
Date: Tue, 8 Apr 2025 18:10:54 +0200
Subject: [PATCH 10/12] Exclude JET on Julia 1.12

---
 test/runtests.jl | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/test/runtests.jl b/test/runtests.jl
index 0ba1e87..ca6f855 100644
--- a/test/runtests.jl
+++ b/test/runtests.jl
@@ -15,7 +15,7 @@ using JET
             @info "- running Aqua.jl tests..."
             Aqua.test_all(ExplainableAI; ambiguities=false)
         end
-        if VERSION <= v"1.12" # TODO: remove. As of PR #184, JET fails on pre-release builds.
+        if VERSION < v"1.12" # TODO: remove. As of PR #184, JET fails on pre-release builds.
             @testset "JET tests" begin
                 @info "- running JET.jl type stability tests..."
                 JET.test_package(ExplainableAI; target_defined_modules=true)

From b09f09b6d7d962f67ebb288de84d8c3b3dbc2cb9 Mon Sep 17 00:00:00 2001
From: adrhill <adrian.hill@mailbox.org>
Date: Tue, 8 Apr 2025 18:38:14 +0200
Subject: [PATCH 11/12] Exclude pre-release entirely

---
 .github/workflows/ci.yml | 2 +-
 test/runtests.jl         | 8 +++-----
 2 files changed, 4 insertions(+), 6 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 7c6f9fb..cfb0363 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -22,7 +22,7 @@ jobs:
         version:
           - 'lts'
           - '1'
-          - 'pre'
+          # - 'pre'
     steps:
       - uses: actions/checkout@v4
       - uses: julia-actions/setup-julia@v2
diff --git a/test/runtests.jl b/test/runtests.jl
index ca6f855..356f7dd 100644
--- a/test/runtests.jl
+++ b/test/runtests.jl
@@ -15,11 +15,9 @@ using JET
             @info "- running Aqua.jl tests..."
             Aqua.test_all(ExplainableAI; ambiguities=false)
         end
-        if VERSION < v"1.12" # TODO: remove. As of PR #184, JET fails on pre-release builds.
-            @testset "JET tests" begin
-                @info "- running JET.jl type stability tests..."
-                JET.test_package(ExplainableAI; target_defined_modules=true)
-            end
+        @testset "JET tests" begin
+            @info "- running JET.jl type stability tests..."
+            JET.test_package(ExplainableAI; target_defined_modules=true)
         end
     end
 

From 3d23d8b162b42e6ddecc49cbd6b94fcb82ffe4e6 Mon Sep 17 00:00:00 2001
From: adrhill <adrian.hill@mailbox.org>
Date: Tue, 8 Apr 2025 18:45:47 +0200
Subject: [PATCH 12/12] Fix silencing of progress meter

---
 src/input_augmentation.jl | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/input_augmentation.jl b/src/input_augmentation.jl
index ea910b2..8753faa 100644
--- a/src/input_augmentation.jl
+++ b/src/input_augmentation.jl
@@ -52,7 +52,7 @@ function call_analyzer(input, aug::NoiseAugmentation, ns::AbstractOutputSelector
     output_indices = ns(output)
     output_selector = AugmentationSelector(output_indices)
 
-    p = Progress(aug.n; desc="Sampling NoiseAugmentation...", showspeed=aug.show_progress)
+    p = Progress(aug.n; desc="Sampling NoiseAugmentation...", enabled=aug.show_progress)
 
     # First augmentation
     noisy_input = similar(input)