trustformers_debug/simulation_tools/
mod.rs

1//! Simulation Tools for Model Testing and Analysis
2//!
3//! This module provides comprehensive simulation tools for what-if analysis,
4//! perturbation testing, adversarial probing, robustness testing, and edge
5//! case discovery for TrustformeRS models.
6//!
7//! ## Architecture
8//!
9//! The simulation tools system is organized into several focused modules:
10//! - [`types`] - Core types, enums, and configuration for simulation tools
11//! - [`what_if_analysis`] - What-if analysis for model behavior exploration
12//! - [`perturbation_testing`] - Perturbation testing and robustness assessment
13//! - [`adversarial_analysis`] - Adversarial analysis and attack resistance testing
14//! - [`edge_case_discovery`] - Edge case discovery and risk assessment
15//! - [`analyzer`] - Main SimulationAnalyzer orchestrating all components
16//! - [`reporting`] - Simulation reporting and summary generation
17
18pub mod adversarial_analysis;
19pub mod analyzer;
20pub mod edge_case_discovery;
21pub mod perturbation_testing;
22pub mod reporting;
23pub mod types;
24pub mod what_if_analysis;
25
26// Re-export core types for backward compatibility
27pub use analyzer::SimulationAnalyzer;
28pub use types::*;
29
30// Re-export component types for easy access
31pub use what_if_analysis::{
32    BoundaryComplexity, BoundaryCrossingAnalysis, BoundaryPoint, CounterfactualInsight,
33    CrossingDirection, DecisionBoundaryExploration, FeatureChange, FeatureImportanceRank,
34    FeatureInteractionSensitivity, FeatureSensitivityAnalysis, LocalLinearityAnalysis,
35    PredictionStabilityAnalysis, Scenario, ScenarioImpactAnalysis, WhatIfAnalysisResult,
36};
37
38pub use perturbation_testing::{
39    CascadingFailureAnalysis, FailureFrequencyAnalysis, FailureMode, FailureModesAnalysis,
40    FailureSeverityAnalysis, MitigationStrategy, PerturbationDetail, PerturbationIntensityResult,
41    PerturbationTestResult, RobustnessAssessment, SensitivityHotspot, TimeToFailureAnalysis,
42    TriggeringCondition,
43};
44
45pub use adversarial_analysis::{
46    AdversarialExample, AdversarialProbingResult, AdversarialRobustnessAssessment,
47    AttackDifficultyAnalysis, AttackSuccessAnalysis, CertifiedRobustnessAnalysis,
48    ComplexityAssessment, DefenseRecommendation, RobustnessGuarantee, VulnerabilityHotspot,
49};
50
51pub use edge_case_discovery::{
52    CoverageAnalysis, CoverageGap, EdgeCase, EdgeCaseClassification, EdgeCaseDiscoveryResult,
53    EdgeCasePattern, EdgeCaseRiskAssessment, RiskMitigationPriority, SystematicIssue,
54    UncoveredRegion,
55};
56
57pub use reporting::SimulationReport;