Add heatmap overlays on Explanations (#10)

* add `heatmap_overlay` method on XAIBase's `Explanation` type * Update tests and references
Julia-XAI · Feb 20, 2024 · 4c8909a · 4c8909a
1 parent 6401798
commit 4c8909a
Show file tree

Hide file tree

Showing 179 changed files with 253 additions and 202 deletions.
diff --git a/src/overlay.jl b/src/overlay.jl
@@ -1,8 +1,10 @@
+const AbstractImage{T<:Colorant} = AbstractMatrix{T}
+
 const DEFAULT_OVERLAY_ALPHA = 0.6
 const DEFAULT_RESIZE_METHOD = Lanczos(1)
 
 """
-    heatmap_overlay(val, img)
+    heatmap_overlay(val, image)
 
 Create a heatmap from `val` and overlay it on top of an image.
 Assumes 4D input array following the WHCN convention
@@ -18,10 +20,21 @@ Refer to the [`heatmap`](@ref) documentation for more information.
 """
 function heatmap_overlay(
     val::AbstractArray{T,N},
-    im::AbstractMatrix{<:Colorant};
+    im::AbstractImage;
     alpha=DEFAULT_OVERLAY_ALPHA,
     resize_method=DEFAULT_RESIZE_METHOD,
     heatmap_kwargs...,
+) where {T,N}
+    options = HeatmapOptions(; heatmap_kwargs...)
+    return heatmap_overlay(val, im, alpha, resize_method, options)
+end
+
+function heatmap_overlay(
+    val::AbstractArray{T,N},
+    im::AbstractImage,
+    alpha::Real,
+    resize_method,
+    options::HeatmapOptions,
 ) where {T,N}
     N != 4 && throw(InputDimensionError)
     if size(val, 4) != 1
@@ -35,7 +48,6 @@ function heatmap_overlay(
         throw(ArgumentError("alpha must be in the range [0, 1]"))
     end
 
-    options = HeatmapOptions(; heatmap_kwargs...)
     hm = heatmap(val, options)
     hmsize = size(hm)
     imsize = size(im)
@@ -44,3 +56,29 @@ function heatmap_overlay(
     end
     return im * (1 - alpha) + hm * alpha
 end
+
+#=================#
+# XAIBase support #
+#=================#
+
+"""
+    heatmap_overlay(expl::Explanation, image)
+
+Visualize `Explanation` from XAIBase as a vision heatmap and overlay it on top of an image.
+Assumes WHCN convention (width, height, channels, batch dimension) for `explanation.val`
+and batch size 1.
+
+This will use the default heatmapping style for the given type of explanation.
+Refer to the [`heatmap`](@ref) and [`heatmap_overlay`](@ref) documentation
+for a list of supported keyword arguments that can be used to override the defaults.
+"""
+function heatmap_overlay(
+    expl::Explanation,
+    im::AbstractImage;
+    alpha=DEFAULT_OVERLAY_ALPHA,
+    resize_method=DEFAULT_RESIZE_METHOD,
+    heatmap_kwargs...,
+)
+    options = HeatmapOptions(expl; heatmap_kwargs...)
+    return heatmap_overlay(expl.val, im, alpha, resize_method, options)
+end
diff --git a/test/references/grays_norm_extrema.txt b/test/references/grays_norm_extrema.txt
@@ -0,0 +1 @@
+[0m[38;5;16;48;5;102m▀[38;5;59;48;5;188m▀[0m
diff --git a/test/references/heatmap/grays_abssum_centered.txt b/test/references/heatmap/grays_abssum_centered.txt
@@ -0,0 +1 @@
+[0m[38;5;145;48;5;188m▀[38;5;188;48;5;188m▀[0m
diff --git a/test/references/heatmap/grays_abssum_extrema.txt b/test/references/heatmap/grays_abssum_extrema.txt
@@ -0,0 +1 @@
+[0m[38;5;16;48;5;145m▀[38;5;59;48;5;188m▀[0m
diff --git a/test/references/heatmap/grays_maxabs_centered.txt b/test/references/heatmap/grays_maxabs_centered.txt
@@ -0,0 +1 @@
+[0m[38;5;188;48;5;188m▀[38;5;188;48;5;188m▀[0m
diff --git a/test/references/heatmap/grays_maxabs_extrema.txt b/test/references/heatmap/grays_maxabs_extrema.txt
@@ -0,0 +1 @@
+[0m[38;5;16;48;5;145m▀[38;5;59;48;5;188m▀[0m
diff --git a/test/references/heatmap/grays_norm_centered.txt b/test/references/heatmap/grays_norm_centered.txt
@@ -0,0 +1 @@
+[0m[38;5;187;48;5;188m▀[38;5;188;48;5;188m▀[0m
diff --git a/test/references/heatmap/grays_norm_extrema.txt b/test/references/heatmap/grays_norm_extrema.txt
@@ -0,0 +1 @@
+[0m[38;5;16;48;5;102m▀[38;5;59;48;5;188m▀[0m
diff --git a/test/references/heatmap/grays_sum_centered.txt b/test/references/heatmap/grays_sum_centered.txt
@@ -0,0 +1 @@
+[0m[38;5;145;48;5;188m▀[38;5;188;48;5;188m▀[0m
diff --git a/test/references/heatmap/grays_sum_extrema.txt b/test/references/heatmap/grays_sum_extrema.txt
@@ -0,0 +1 @@
+[0m[38;5;16;48;5;145m▀[38;5;59;48;5;188m▀[0m
diff --git a/test/references/heatmap/grays_sumabs_centered.txt b/test/references/heatmap/grays_sumabs_centered.txt
@@ -0,0 +1 @@
+[0m[38;5;145;48;5;188m▀[38;5;188;48;5;188m▀[0m
diff --git a/test/references/heatmap/grays_sumabs_extrema.txt b/test/references/heatmap/grays_sumabs_extrema.txt
@@ -0,0 +1 @@
+[0m[38;5;16;48;5;145m▀[38;5;59;48;5;188m▀[0m
diff --git a/test/references/inferno.txt → ...ferences/heatmap/inferno_sum_centered.txt b/test/references/inferno.txt → ...ferences/heatmap/inferno_sum_centered.txt
diff --git a/test/references/heatmap/jet_abssum_centered.txt b/test/references/heatmap/jet_abssum_centered.txt
@@ -0,0 +1 @@
+[0m[38;5;202;48;5;124m▀[38;5;196;48;5;88m▀[0m
diff --git a/test/references/heatmap/jet_abssum_extrema.txt b/test/references/heatmap/jet_abssum_extrema.txt
@@ -0,0 +1 @@
+[0m[38;5;18;48;5;220m▀[38;5;45;48;5;88m▀[0m
diff --git a/test/references/heatmap/jet_maxabs_centered.txt b/test/references/heatmap/jet_maxabs_centered.txt
@@ -0,0 +1 @@
+[0m[38;5;196;48;5;124m▀[38;5;160;48;5;88m▀[0m
diff --git a/test/references/heatmap/jet_maxabs_extrema.txt b/test/references/heatmap/jet_maxabs_extrema.txt
@@ -0,0 +1 @@
+[0m[38;5;18;48;5;220m▀[38;5;45;48;5;88m▀[0m
diff --git a/test/references/heatmap/jet_norm_centered.txt b/test/references/heatmap/jet_norm_centered.txt
@@ -0,0 +1 @@
+[0m[38;5;196;48;5;124m▀[38;5;160;48;5;88m▀[0m
diff --git a/test/references/heatmap/jet_norm_extrema.txt b/test/references/heatmap/jet_norm_extrema.txt
@@ -0,0 +1 @@
+[0m[38;5;18;48;5;220m▀[38;5;39;48;5;88m▀[0m
diff --git a/test/references/heatmap/jet_sum_centered.txt b/test/references/heatmap/jet_sum_centered.txt
@@ -0,0 +1 @@
+[0m[38;5;202;48;5;124m▀[38;5;196;48;5;88m▀[0m
diff --git a/test/references/heatmap/jet_sum_extrema.txt b/test/references/heatmap/jet_sum_extrema.txt
@@ -0,0 +1 @@
+[0m[38;5;18;48;5;220m▀[38;5;45;48;5;88m▀[0m
diff --git a/test/references/heatmap/jet_sumabs_centered.txt b/test/references/heatmap/jet_sumabs_centered.txt
@@ -0,0 +1 @@
+[0m[38;5;202;48;5;124m▀[38;5;196;48;5;88m▀[0m
diff --git a/test/references/heatmap/jet_sumabs_extrema.txt b/test/references/heatmap/jet_sumabs_extrema.txt
@@ -0,0 +1 @@
+[0m[38;5;18;48;5;220m▀[38;5;45;48;5;88m▀[0m
diff --git a/test/references/abssum_centered.txt → ...ences/heatmap/seismic_abssum_centered.txt b/test/references/abssum_centered.txt → ...ences/heatmap/seismic_abssum_centered.txt
diff --git a/test/references/abssum_centered_2.txt → ...ces/heatmap/seismic_abssum_centered_2.txt b/test/references/abssum_centered_2.txt → ...ces/heatmap/seismic_abssum_centered_2.txt
diff --git a/test/references/abssum_extrema.txt → ...rences/heatmap/seismic_abssum_extrema.txt b/test/references/abssum_extrema.txt → ...rences/heatmap/seismic_abssum_extrema.txt
diff --git a/test/references/abssum_extrema_2.txt → ...nces/heatmap/seismic_abssum_extrema_2.txt b/test/references/abssum_extrema_2.txt → ...nces/heatmap/seismic_abssum_extrema_2.txt
diff --git a/test/references/maxabs_centered.txt → ...ences/heatmap/seismic_maxabs_centered.txt b/test/references/maxabs_centered.txt → ...ences/heatmap/seismic_maxabs_centered.txt
diff --git a/test/references/maxabs_centered_2.txt → ...ces/heatmap/seismic_maxabs_centered_2.txt b/test/references/maxabs_centered_2.txt → ...ces/heatmap/seismic_maxabs_centered_2.txt
diff --git a/test/references/abssum_extrema_grays.txt → ...rences/heatmap/seismic_maxabs_extrema.txt b/test/references/abssum_extrema_grays.txt → ...rences/heatmap/seismic_maxabs_extrema.txt
diff --git a/test/references/abssum_extrema_jet.txt → ...nces/heatmap/seismic_maxabs_extrema_2.txt b/test/references/abssum_extrema_jet.txt → ...nces/heatmap/seismic_maxabs_extrema_2.txt
diff --git a/test/references/abssum_centered_grays.txt → ...erences/heatmap/seismic_norm_centered.txt b/test/references/abssum_centered_grays.txt → ...erences/heatmap/seismic_norm_centered.txt
diff --git a/test/references/norm_centered_2.txt → ...ences/heatmap/seismic_norm_centered_2.txt b/test/references/norm_centered_2.txt → ...ences/heatmap/seismic_norm_centered_2.txt
diff --git a/test/references/abssum_extrema_seismic.txt → ...ferences/heatmap/seismic_norm_extrema.txt b/test/references/abssum_extrema_seismic.txt → ...ferences/heatmap/seismic_norm_extrema.txt
diff --git a/test/references/maxabs_extrema.txt → ...rences/heatmap/seismic_norm_extrema_2.txt b/test/references/maxabs_extrema.txt → ...rences/heatmap/seismic_norm_extrema_2.txt
diff --git a/test/references/abssum_centered_jet.txt → ...ferences/heatmap/seismic_sum_centered.txt b/test/references/abssum_centered_jet.txt → ...ferences/heatmap/seismic_sum_centered.txt
diff --git a/test/references/maxabs_centered_grays.txt → ...rences/heatmap/seismic_sum_centered_2.txt b/test/references/maxabs_centered_grays.txt → ...rences/heatmap/seismic_sum_centered_2.txt
diff --git a/test/references/maxabs_extrema_2.txt → ...eferences/heatmap/seismic_sum_extrema.txt b/test/references/maxabs_extrema_2.txt → ...eferences/heatmap/seismic_sum_extrema.txt
diff --git a/test/references/maxabs_extrema_grays.txt → ...erences/heatmap/seismic_sum_extrema_2.txt b/test/references/maxabs_extrema_grays.txt → ...erences/heatmap/seismic_sum_extrema_2.txt
diff --git a/test/references/abssum_centered_seismic.txt → ...ences/heatmap/seismic_sumabs_centered.txt b/test/references/abssum_centered_seismic.txt → ...ences/heatmap/seismic_sumabs_centered.txt
diff --git a/test/references/maxabs_centered_jet.txt → ...ces/heatmap/seismic_sumabs_centered_2.txt b/test/references/maxabs_centered_jet.txt → ...ces/heatmap/seismic_sumabs_centered_2.txt
diff --git a/test/references/maxabs_extrema_jet.txt → ...rences/heatmap/seismic_sumabs_extrema.txt b/test/references/maxabs_extrema_jet.txt → ...rences/heatmap/seismic_sumabs_extrema.txt
diff --git a/test/references/maxabs_extrema_seismic.txt → ...nces/heatmap/seismic_sumabs_extrema_2.txt b/test/references/maxabs_extrema_seismic.txt → ...nces/heatmap/seismic_sumabs_extrema_2.txt
diff --git a/test/references/jet_sum_extrema.txt b/test/references/jet_sum_extrema.txt
@@ -0,0 +1 @@
+[0m[38;5;18;48;5;220m▀[38;5;45;48;5;88m▀[0m
diff --git a/test/references/maxabs_centered_seismic.txt b/test/references/maxabs_centered_seismic.txt
diff --git a/test/references/norm_centered_grays.txt b/test/references/norm_centered_grays.txt
diff --git a/test/references/norm_centered_jet.txt b/test/references/norm_centered_jet.txt
diff --git a/test/references/norm_centered_seismic.txt b/test/references/norm_centered_seismic.txt
diff --git a/test/references/norm_extrema.txt b/test/references/norm_extrema.txt
diff --git a/test/references/norm_extrema_2.txt b/test/references/norm_extrema_2.txt
diff --git a/test/references/norm_extrema_grays.txt b/test/references/norm_extrema_grays.txt
diff --git a/test/references/norm_extrema_jet.txt b/test/references/norm_extrema_jet.txt
diff --git a/test/references/norm_extrema_seismic.txt b/test/references/norm_extrema_seismic.txt
diff --git a/test/references/overlay/grays_abssum_centered.txt b/test/references/overlay/grays_abssum_centered.txt
@@ -0,0 +1 @@
+[0m[38;5;174;48;5;104m▀[38;5;114;48;5;188m▀[0m
diff --git a/test/references/overlay/grays_abssum_extrema.txt b/test/references/overlay/grays_abssum_extrema.txt
@@ -0,0 +1 @@
+[0m[38;5;88;48;5;61m▀[38;5;28;48;5;188m▀[0m
diff --git a/test/references/overlay/grays_maxabs_centered.txt b/test/references/overlay/grays_maxabs_centered.txt
@@ -0,0 +1 @@
+[0m[38;5;174;48;5;104m▀[38;5;114;48;5;188m▀[0m
diff --git a/test/references/overlay/grays_maxabs_extrema.txt b/test/references/overlay/grays_maxabs_extrema.txt
@@ -0,0 +1 @@
+[0m[38;5;88;48;5;61m▀[38;5;28;48;5;188m▀[0m
diff --git a/test/references/overlay/grays_norm_centered.txt b/test/references/overlay/grays_norm_centered.txt
@@ -0,0 +1 @@
+[0m[38;5;174;48;5;104m▀[38;5;114;48;5;188m▀[0m
diff --git a/test/references/overlay/grays_norm_extrema.txt b/test/references/overlay/grays_norm_extrema.txt
@@ -0,0 +1 @@
+[0m[38;5;88;48;5;61m▀[38;5;28;48;5;188m▀[0m
diff --git a/test/references/overlay/grays_sum_centered.txt b/test/references/overlay/grays_sum_centered.txt
@@ -0,0 +1 @@
+[0m[38;5;174;48;5;104m▀[38;5;114;48;5;188m▀[0m
diff --git a/test/references/overlay/grays_sum_extrema.txt b/test/references/overlay/grays_sum_extrema.txt
@@ -0,0 +1 @@
+[0m[38;5;88;48;5;61m▀[38;5;28;48;5;188m▀[0m
diff --git a/test/references/overlay/grays_sumabs_centered.txt b/test/references/overlay/grays_sumabs_centered.txt
@@ -0,0 +1 @@
+[0m[38;5;174;48;5;104m▀[38;5;114;48;5;188m▀[0m
diff --git a/test/references/overlay/grays_sumabs_extrema.txt b/test/references/overlay/grays_sumabs_extrema.txt
@@ -0,0 +1 @@
+[0m[38;5;88;48;5;61m▀[38;5;28;48;5;188m▀[0m
diff --git a/test/references/overlay_inferno.txt → ...ferences/overlay/inferno_sum_centered.txt b/test/references/overlay_inferno.txt → ...ferences/overlay/inferno_sum_centered.txt
diff --git a/test/references/overlay/jet_abssum_centered.txt b/test/references/overlay/jet_abssum_centered.txt
@@ -0,0 +1 @@
+[0m[38;5;196;48;5;90m▀[38;5;136;48;5;138m▀[0m
diff --git a/test/references/overlay/jet_abssum_extrema.txt b/test/references/overlay/jet_abssum_extrema.txt
@@ -0,0 +1 @@
+[0m[38;5;89;48;5;138m▀[38;5;43;48;5;138m▀[0m
diff --git a/test/references/overlay/jet_maxabs_centered.txt b/test/references/overlay/jet_maxabs_centered.txt
@@ -0,0 +1 @@
+[0m[38;5;196;48;5;54m▀[38;5;100;48;5;138m▀[0m
diff --git a/test/references/overlay/jet_maxabs_extrema.txt b/test/references/overlay/jet_maxabs_extrema.txt
@@ -0,0 +1 @@
+[0m[38;5;89;48;5;138m▀[38;5;43;48;5;138m▀[0m
diff --git a/test/references/overlay/jet_norm_centered.txt b/test/references/overlay/jet_norm_centered.txt
@@ -0,0 +1 @@
+[0m[38;5;196;48;5;90m▀[38;5;100;48;5;138m▀[0m
diff --git a/test/references/overlay/jet_norm_extrema.txt b/test/references/overlay/jet_norm_extrema.txt
@@ -0,0 +1 @@
+[0m[38;5;89;48;5;138m▀[38;5;43;48;5;138m▀[0m
diff --git a/test/references/overlay/jet_sum_centered.txt b/test/references/overlay/jet_sum_centered.txt
@@ -0,0 +1 @@
+[0m[38;5;196;48;5;90m▀[38;5;136;48;5;138m▀[0m
diff --git a/test/references/overlay/jet_sum_extrema.txt b/test/references/overlay/jet_sum_extrema.txt
@@ -0,0 +1 @@
+[0m[38;5;89;48;5;138m▀[38;5;43;48;5;138m▀[0m
diff --git a/test/references/overlay/jet_sumabs_centered.txt b/test/references/overlay/jet_sumabs_centered.txt
@@ -0,0 +1 @@
+[0m[38;5;196;48;5;90m▀[38;5;136;48;5;138m▀[0m
diff --git a/test/references/overlay/jet_sumabs_extrema.txt b/test/references/overlay/jet_sumabs_extrema.txt
@@ -0,0 +1 @@
+[0m[38;5;89;48;5;138m▀[38;5;43;48;5;138m▀[0m
diff --git a/...erences/overlay_abssum_centered_grays.txt → ...ences/overlay/seismic_abssum_centered.txt b/...erences/overlay_abssum_centered_grays.txt → ...ences/overlay/seismic_abssum_centered.txt
diff --git a/...ferences/overlay_abssum_extrema_grays.txt → ...rences/overlay/seismic_abssum_extrema.txt b/...ferences/overlay_abssum_extrema_grays.txt → ...rences/overlay/seismic_abssum_extrema.txt
diff --git a/...eferences/overlay_abssum_centered_jet.txt → ...ences/overlay/seismic_maxabs_centered.txt b/...eferences/overlay_abssum_centered_jet.txt → ...ences/overlay/seismic_maxabs_centered.txt
diff --git a/...references/overlay_abssum_extrema_jet.txt → ...rences/overlay/seismic_maxabs_extrema.txt b/...references/overlay_abssum_extrema_jet.txt → ...rences/overlay/seismic_maxabs_extrema.txt
diff --git a/...ences/overlay_abssum_centered_seismic.txt → ...erences/overlay/seismic_norm_centered.txt b/...ences/overlay_abssum_centered_seismic.txt → ...erences/overlay/seismic_norm_centered.txt
diff --git a/...rences/overlay_abssum_extrema_seismic.txt → ...ferences/overlay/seismic_norm_extrema.txt b/...rences/overlay_abssum_extrema_seismic.txt → ...ferences/overlay/seismic_norm_extrema.txt
diff --git a/...erences/overlay_maxabs_centered_grays.txt → ...ferences/overlay/seismic_sum_centered.txt b/...erences/overlay_maxabs_centered_grays.txt → ...ferences/overlay/seismic_sum_centered.txt
diff --git a/...ferences/overlay_maxabs_extrema_grays.txt → ...eferences/overlay/seismic_sum_extrema.txt b/...ferences/overlay_maxabs_extrema_grays.txt → ...eferences/overlay/seismic_sum_extrema.txt
diff --git a/...eferences/overlay_maxabs_centered_jet.txt → ...ences/overlay/seismic_sumabs_centered.txt b/...eferences/overlay_maxabs_centered_jet.txt → ...ences/overlay/seismic_sumabs_centered.txt
diff --git a/...references/overlay_maxabs_extrema_jet.txt → ...rences/overlay/seismic_sumabs_extrema.txt b/...references/overlay_maxabs_extrema_jet.txt → ...rences/overlay/seismic_sumabs_extrema.txt
diff --git a/test/references/overlay_maxabs_centered_seismic.txt b/test/references/overlay_maxabs_centered_seismic.txt
diff --git a/test/references/overlay_maxabs_extrema_seismic.txt b/test/references/overlay_maxabs_extrema_seismic.txt
diff --git a/test/references/overlay_norm_centered_grays.txt b/test/references/overlay_norm_centered_grays.txt
diff --git a/test/references/overlay_norm_centered_jet.txt b/test/references/overlay_norm_centered_jet.txt
diff --git a/test/references/overlay_norm_centered_seismic.txt b/test/references/overlay_norm_centered_seismic.txt
diff --git a/test/references/overlay_norm_extrema_grays.txt b/test/references/overlay_norm_extrema_grays.txt
diff --git a/test/references/overlay_norm_extrema_jet.txt b/test/references/overlay_norm_extrema_jet.txt
diff --git a/test/references/overlay_norm_extrema_seismic.txt b/test/references/overlay_norm_extrema_seismic.txt
diff --git a/test/references/overlay_rescale_maxabs_centered_jet.txt b/test/references/overlay_rescale_maxabs_centered_jet.txt
diff --git a/test/references/overlay_rescale_maxabs_centered_seismic.txt b/test/references/overlay_rescale_maxabs_centered_seismic.txt
diff --git a/test/references/overlay_rescale_maxabs_extrema_jet.txt b/test/references/overlay_rescale_maxabs_extrema_jet.txt
diff --git a/test/references/overlay_rescale_maxabs_extrema_seismic.txt b/test/references/overlay_rescale_maxabs_extrema_seismic.txt
diff --git a/test/references/overlay_rescale_norm_centered_jet.txt b/test/references/overlay_rescale_norm_centered_jet.txt
diff --git a/test/references/overlay_rescale_norm_centered_seismic.txt b/test/references/overlay_rescale_norm_centered_seismic.txt
diff --git a/test/references/overlay_rescale_norm_extrema_jet.txt b/test/references/overlay_rescale_norm_extrema_jet.txt
diff --git a/test/references/overlay_rescale_norm_extrema_seismic.txt b/test/references/overlay_rescale_norm_extrema_seismic.txt
diff --git a/test/references/overlay_rescale_sum_centered_grays.txt b/test/references/overlay_rescale_sum_centered_grays.txt
diff --git a/test/references/overlay_rescale_sum_centered_jet.txt b/test/references/overlay_rescale_sum_centered_jet.txt
diff --git a/test/references/overlay_rescale_sum_centered_seismic.txt b/test/references/overlay_rescale_sum_centered_seismic.txt
diff --git a/test/references/overlay_rescale_sum_extrema_grays.txt b/test/references/overlay_rescale_sum_extrema_grays.txt
diff --git a/test/references/overlay_rescale_sum_extrema_jet.txt b/test/references/overlay_rescale_sum_extrema_jet.txt
diff --git a/test/references/overlay_rescale_sum_extrema_seismic.txt b/test/references/overlay_rescale_sum_extrema_seismic.txt
diff --git a/test/references/overlay_rescale_sumabs_centered_grays.txt b/test/references/overlay_rescale_sumabs_centered_grays.txt
diff --git a/test/references/overlay_rescale_sumabs_centered_jet.txt b/test/references/overlay_rescale_sumabs_centered_jet.txt
diff --git a/test/references/overlay_rescale_sumabs_centered_seismic.txt b/test/references/overlay_rescale_sumabs_centered_seismic.txt
diff --git a/test/references/overlay_rescale_sumabs_extrema_grays.txt b/test/references/overlay_rescale_sumabs_extrema_grays.txt
diff --git a/test/references/overlay_rescale_sumabs_extrema_jet.txt b/test/references/overlay_rescale_sumabs_extrema_jet.txt
diff --git a/test/references/overlay_rescale_sumabs_extrema_seismic.txt b/test/references/overlay_rescale_sumabs_extrema_seismic.txt
diff --git a/test/references/overlay_rescaled/grays_abssum_centered.txt b/test/references/overlay_rescaled/grays_abssum_centered.txt
@@ -0,0 +1,3 @@
+[0m[38;5;102;48;5;102m▀[38;5;102;48;5;102m▀[38;5;108;48;5;108m▀[38;5;108;48;5;108m▀[38;5;114;48;5;114m▀[38;5;114;48;5;114m▀[0m
+[0m[38;5;138;48;5;138m▀[38;5;138;48;5;144m▀[38;5;144;48;5;144m▀[38;5;144;48;5;186m▀[38;5;150;48;5;186m▀[38;5;150;48;5;186m▀[0m
+[0m[38;5;174;48;5;174m▀[38;5;180;48;5;180m▀[38;5;180;48;5;180m▀[38;5;186;48;5;186m▀[38;5;186;48;5;186m▀[38;5;186;48;5;186m▀[0m
diff --git a/test/references/overlay_rescaled/grays_abssum_extrema.txt b/test/references/overlay_rescaled/grays_abssum_extrema.txt
@@ -0,0 +1,3 @@
+[0m[38;5;16;48;5;16m▀[38;5;16;48;5;16m▀[38;5;16;48;5;16m▀[38;5;22;48;5;58m▀[38;5;28;48;5;64m▀[38;5;28;48;5;64m▀[0m
+[0m[38;5;52;48;5;95m▀[38;5;52;48;5;95m▀[38;5;58;48;5;101m▀[38;5;65;48;5;144m▀[38;5;101;48;5;150m▀[38;5;107;48;5;150m▀[0m
+[0m[38;5;131;48;5;131m▀[38;5;137;48;5;137m▀[38;5;138;48;5;174m▀[38;5;180;48;5;180m▀[38;5;186;48;5;186m▀[38;5;186;48;5;186m▀[0m
diff --git a/test/references/overlay_rescaled/grays_maxabs_centered.txt b/test/references/overlay_rescaled/grays_maxabs_centered.txt
@@ -0,0 +1,3 @@
+[0m[38;5;102;48;5;102m▀[38;5;102;48;5;102m▀[38;5;108;48;5;108m▀[38;5;108;48;5;144m▀[38;5;114;48;5;150m▀[38;5;114;48;5;150m▀[0m
+[0m[38;5;138;48;5;138m▀[38;5;138;48;5;144m▀[38;5;144;48;5;180m▀[38;5;144;48;5;186m▀[38;5;150;48;5;186m▀[38;5;150;48;5;186m▀[0m
+[0m[38;5;174;48;5;174m▀[38;5;180;48;5;180m▀[38;5;180;48;5;180m▀[38;5;186;48;5;186m▀[38;5;186;48;5;186m▀[38;5;186;48;5;186m▀[0m
diff --git a/test/references/overlay_rescaled/grays_maxabs_extrema.txt b/test/references/overlay_rescaled/grays_maxabs_extrema.txt
@@ -0,0 +1,3 @@
+[0m[38;5;16;48;5;16m▀[38;5;16;48;5;16m▀[38;5;16;48;5;16m▀[38;5;22;48;5;58m▀[38;5;28;48;5;64m▀[38;5;28;48;5;64m▀[0m
+[0m[38;5;52;48;5;95m▀[38;5;52;48;5;95m▀[38;5;58;48;5;101m▀[38;5;65;48;5;144m▀[38;5;101;48;5;150m▀[38;5;107;48;5;150m▀[0m
+[0m[38;5;131;48;5;131m▀[38;5;137;48;5;137m▀[38;5;138;48;5;174m▀[38;5;180;48;5;180m▀[38;5;186;48;5;186m▀[38;5;186;48;5;186m▀[0m
diff --git a/test/references/overlay_rescaled/grays_norm_centered.txt b/test/references/overlay_rescaled/grays_norm_centered.txt
@@ -0,0 +1,3 @@
+[0m[38;5;102;48;5;102m▀[38;5;102;48;5;102m▀[38;5;108;48;5;108m▀[38;5;108;48;5;108m▀[38;5;114;48;5;114m▀[38;5;114;48;5;114m▀[0m
+[0m[38;5;138;48;5;138m▀[38;5;138;48;5;144m▀[38;5;144;48;5;144m▀[38;5;144;48;5;186m▀[38;5;150;48;5;186m▀[38;5;150;48;5;186m▀[0m
+[0m[38;5;174;48;5;174m▀[38;5;180;48;5;180m▀[38;5;180;48;5;180m▀[38;5;186;48;5;186m▀[38;5;186;48;5;186m▀[38;5;186;48;5;186m▀[0m
diff --git a/test/references/overlay_rescaled/grays_norm_extrema.txt b/test/references/overlay_rescaled/grays_norm_extrema.txt
@@ -0,0 +1,3 @@
+[0m[38;5;16;48;5;16m▀[38;5;16;48;5;16m▀[38;5;16;48;5;16m▀[38;5;22;48;5;58m▀[38;5;28;48;5;64m▀[38;5;28;48;5;64m▀[0m
+[0m[38;5;52;48;5;95m▀[38;5;52;48;5;95m▀[38;5;58;48;5;101m▀[38;5;65;48;5;144m▀[38;5;101;48;5;150m▀[38;5;107;48;5;150m▀[0m
+[0m[38;5;131;48;5;131m▀[38;5;137;48;5;137m▀[38;5;138;48;5;174m▀[38;5;180;48;5;180m▀[38;5;186;48;5;186m▀[38;5;186;48;5;186m▀[0m
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		[0m[38;5;16;48;5;102m▀[38;5;59;48;5;188m▀[0m
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		[0m[38;5;145;48;5;188m▀[38;5;188;48;5;188m▀[0m
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		[0m[38;5;16;48;5;145m▀[38;5;59;48;5;188m▀[0m
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		[0m[38;5;188;48;5;188m▀[38;5;188;48;5;188m▀[0m
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		[0m[38;5;187;48;5;188m▀[38;5;188;48;5;188m▀[0m
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		[0m[38;5;202;48;5;124m▀[38;5;196;48;5;88m▀[0m
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		[0m[38;5;18;48;5;220m▀[38;5;45;48;5;88m▀[0m
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		[0m[38;5;196;48;5;124m▀[38;5;160;48;5;88m▀[0m
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		[0m[38;5;18;48;5;220m▀[38;5;39;48;5;88m▀[0m
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		[0m[38;5;174;48;5;104m▀[38;5;114;48;5;188m▀[0m