Struct GradientDebugger 

pub struct GradientDebugger { /* private fields */ }

Main gradient debugger

Implementations

impl GradientDebugger

pub fn new(config: DebugConfig) -> Self

Create a new gradient debugger

pub fn with_gradient_config( config: DebugConfig, gradient_config: GradientDebugConfig, ) -> Self

Create with custom gradient configuration

pub fn set_layer_parameter_count(&mut self, layer_name: &str, count: usize)

Report the real number of elements in layer_name’s gradient tensor, for callers that have access to the actual tensor (and not just the reduced norm/mean/std Self::record_gradient_flow takes). Once set, vanishing/exploding-region reports for this layer (see super::visualization::RegionExtent::affected_parameters) carry this real count instead of an honest None. Creates the layer’s history entry if record_gradient_flow has not been called for it yet.

pub fn record_gradient_flow( &mut self, layer_name: &str, gradient_norm: f64, gradient_mean: f64, gradient_std: f64, ) -> Result<()>

Record gradient flow for a layer from REDUCED statistics.

The per-element quantities on GradientFlow (gradient_max, gradient_min, dead_neurons_ratio, active_neurons_ratio) are honestly None here: norm, mean and std do not determine them. Call Self::record_gradient_values instead when the real gradient tensor is at hand and those fields are wanted.

pub fn record_gradient_values( &mut self, layer_name: &str, gradients: &[f64], ) -> Result<()>

Record gradient flow for a layer from the REAL per-element gradients.

Computes every GradientFlow field from the supplied values: the L2 norm, the mean, the population standard deviation, the true max/min, and the real dead fraction (elements whose magnitude is at or below GradientDebugConfig::dead_gradient_magnitude). Also records the real element count so region reports can name a real affected_parameters.

Returns an error for an empty slice rather than reporting a zero-gradient layer that was never measured.

pub fn get_status(&self) -> GradientDebugStatus

Get current gradient debugging status

pub fn generate_comprehensive_report( &self, ) -> Result<ComprehensiveGradientReport>

Generate comprehensive debugging report

pub fn analyze_gradient_conflicts(&self) -> GradientConflictAnalysis

Analyze gradient conflicts between layers

pub fn generate_gradient_flow_visualization(&self) -> GradientFlowVisualization

Generate gradient flow visualization

pub fn generate_enhanced_layer_analysis(&self) -> EnhancedLayerGradientAnalysis

Generate enhanced layer analysis

pub fn get_performance_insights(&self) -> PerformanceInsights

Get performance insights

pub fn next_step(&mut self)

Advance to next step

pub fn reset(&mut self)

Reset debugger state

pub fn get_layer_alerts(&self, layer_name: &str) -> Vec<&GradientAlert>

Get alerts for a specific layer

pub fn get_layer_history(&self, layer_name: &str) -> Option<&GradientHistory>

Get gradient history for a layer

pub fn get_monitored_layers(&self) -> Vec<&String>

Get all monitored layers

pub fn generate_recommendations(&self) -> Result<Vec<GradientRecommendation>>

Generate recommendations based on current analysis

pub async fn start(&mut self) -> Result<()>

Start the gradient debugger

pub async fn generate_report(&self) -> Result<ComprehensiveGradientReport>

Generate comprehensive gradient report

pub async fn quick_analysis(&self) -> Result<GradientQuickAnalysis>

Quick analysis for immediate insights

Trait Implementations

impl Debug for GradientDebugger

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.