APEXPRIT's picture
Upload folder using huggingface_hub
59f824e verified
Raw History Blame
7.43 kB
"""Visualization helpers for temporal deception analysis outputs."""
from __future__ import annotations
from typing import Dict, List, Optional
import matplotlib.pyplot as plt
import numpy as np
from src.utils.config import TemporalConfig
class TemporalVisualizer:
"""Publication-quality temporal analysis visualizations."""
def __init__(self):
"""Initialize plotting style for publication-quality figures."""
plt.style.use("seaborn-v0_8-whitegrid")
plt.rcParams.update(
{
"figure.dpi": 300,
"savefig.dpi": 300,
"axes.titlesize": 14,
"axes.labelsize": 12,
"legend.fontsize": 10,
"xtick.labelsize": 10,
"ytick.labelsize": 10,
"font.size": 11,
}
)
self._temporal_cfg = TemporalConfig()
def plot_deception_timeline(
self,
probabilities: np.ndarray,
timestamps: np.ndarray,
smoothed: np.ndarray,
suspicious_intervals: List[Dict],
spikes: List[Dict],
save_path: Optional[str] = None,
) -> plt.Figure:
"""Create the main deception timeline plot."""
probs = np.asarray(probabilities, dtype=np.float64)
times = np.asarray(timestamps, dtype=np.float64)
smooth = np.asarray(smoothed, dtype=np.float64)
n = min(len(probs), len(times), len(smooth))
probs = probs[:n]
times = times[:n]
smooth = smooth[:n]
fig, ax = plt.subplots(figsize=(12, 5))
if n > 0:
ax.plot(times, probs, color="#93c5fd", linewidth=1.2, alpha=0.8, label="Raw probability")
ax.plot(times, smooth, color="#1e3a8a", linewidth=2.0, label="Smoothed probability")
threshold = float(getattr(self._temporal_cfg, "spike_threshold", 0.7))
ax.axhline(threshold, color="#dc2626", linestyle="--", linewidth=1.4, label="Spike threshold")
ax.axhline(0.5, color="#6b7280", linestyle="--", linewidth=1.2, label="Decision boundary")
for i, interval in enumerate(suspicious_intervals):
start_t = float(interval.get("start_time", 0.0))
end_t = float(interval.get("end_time", start_t))
ax.axvspan(
start_t,
end_t,
color="#fecaca",
alpha=0.35,
label="Suspicious interval" if i == 0 else None,
)
if spikes:
spike_x = [float(item.get("timestamp", 0.0)) for item in spikes]
spike_y = [float(item.get("probability", 0.0)) for item in spikes]
ax.scatter(
spike_x,
spike_y,
marker="^",
color="#ef4444",
edgecolors="black",
linewidths=0.3,
s=40,
zorder=5,
label="Spikes",
)
ax.set_title("Temporal Deception Analysis")
ax.set_xlabel("Time (seconds)")
ax.set_ylabel("Deception Probability")
ax.set_ylim(0.0, 1.02)
ax.legend(loc="best")
fig.tight_layout()
if save_path:
fig.savefig(save_path, bbox_inches="tight")
return fig
def plot_suspicious_regions(
self,
suspicious_intervals: List[Dict],
total_duration: float,
save_path: Optional[str] = None,
) -> plt.Figure:
"""Create a Gantt-style suspicious interval chart."""
fig, ax = plt.subplots(figsize=(11, 4))
severity_color = {
"low": "#facc15",
"medium": "#fb923c",
"high": "#ef4444",
}
if not suspicious_intervals:
ax.barh([0], [max(total_duration, 1.0)], left=[0.0], color="#e5e7eb", alpha=0.4)
ax.text(0.5 * max(total_duration, 1.0), 0, "No suspicious intervals", ha="center", va="center")
ax.set_yticks([0])
ax.set_yticklabels(["N/A"])
else:
for idx, interval in enumerate(suspicious_intervals):
start = float(interval.get("start_time", 0.0))
end = float(interval.get("end_time", start))
width = max(0.0, end - start)
severity = str(interval.get("severity", "low")).lower()
color = severity_color.get(severity, "#facc15")
ax.barh(idx, width, left=start, color=color, edgecolor="black", alpha=0.85)
ax.set_yticks(np.arange(len(suspicious_intervals)))
ax.set_yticklabels([f"Interval {i + 1}" for i in range(len(suspicious_intervals))])
ax.set_xlim(0.0, max(float(total_duration), 1.0))
ax.set_xlabel("Time (seconds)")
ax.set_ylabel("Suspicious Intervals")
ax.set_title("Suspicious Regions Timeline")
fig.tight_layout()
if save_path:
fig.savefig(save_path, bbox_inches="tight")
return fig
def plot_temporal_summary(
self,
temporal_features: Dict[str, float],
save_path: Optional[str] = None,
) -> plt.Figure:
"""Create a multi-panel summary dashboard of temporal statistics."""
fig, axes = plt.subplots(1, 3, figsize=(15, 4.5))
# Panel 1: synthetic distribution from mean/std when raw sequence is unavailable.
mean_p = float(temporal_features.get("mean_probability", 0.0))
std_p = float(max(temporal_features.get("std_probability", 0.0), 1e-3))
synthetic = np.clip(np.random.normal(loc=mean_p, scale=std_p, size=800), 0.0, 1.0)
axes[0].hist(synthetic, bins=20, color="#60a5fa", edgecolor="black", alpha=0.85)
axes[0].axvline(mean_p, color="#1d4ed8", linestyle="--", linewidth=2)
axes[0].set_title("Probability Distribution")
axes[0].set_xlabel("Deception Probability")
axes[0].set_ylabel("Count")
# Panel 2: key metrics.
key_names = [
"mean_probability",
"max_probability",
"spike_count",
"suspicious_time_ratio",
"longest_suspicious_duration",
]
key_vals = [float(temporal_features.get(name, 0.0)) for name in key_names]
axes[1].barh(np.arange(len(key_names)), key_vals, color="#34d399", edgecolor="black", alpha=0.85)
axes[1].set_yticks(np.arange(len(key_names)))
axes[1].set_yticklabels([name.replace("_", " ") for name in key_names])
axes[1].set_title("Key Temporal Metrics")
axes[1].set_xlabel("Value")
# Panel 3: severity pie chart proxy from max probability.
max_p = float(temporal_features.get("max_probability", 0.0))
if max_p < 0.7:
sev = [1.0, 0.0, 0.0]
elif max_p < 0.85:
sev = [0.4, 0.6, 0.0]
else:
sev = [0.2, 0.3, 0.5]
axes[2].pie(
sev,
labels=["Low", "Medium", "High"],
colors=["#facc15", "#fb923c", "#ef4444"],
autopct="%1.0f%%",
startangle=90,
)
axes[2].set_title("Severity Breakdown")
fig.tight_layout()
if save_path:
fig.savefig(save_path, bbox_inches="tight")
return fig