rivrs-sparse 0.1.1

Sparse linear algebra solvers
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46

//! Reusable test infrastructure for validating SSIDS solver components.
//!
//! This module provides four subsystems:
//!
//! - **[`cases`]**: Unified test case loading from the matrix registry with filtering.
//! - **[`harness`]**: `SolverTest` trait and result types for per-phase validation.
//! - **[`validator`]**: `NumericalValidator` with configurable tolerances.
//! - **[`generators`]**: Random and structured sparse symmetric matrix generators.
//!
//! Gated behind the `test-util` Cargo feature flag. Not included in production builds.
//!
//! # Quick Start
//!
//! ```rust,no_run
//! use rivrs_sparse::testing::{load_test_cases, NumericalValidator, TestCaseFilter};
//!
//! let cases = load_test_cases(&TestCaseFilter::hand_constructed()).unwrap();
//! let validator = NumericalValidator::new();
//! for case in &cases {
//!     let result = validator.validate_factorization(case);
//!     assert!(result.passed);
//! }
//! ```

pub mod cases;
pub mod generators;
pub mod harness;
pub mod mc64_validation;
pub mod perturbations;
pub mod strategies;
pub mod validator;

pub use cases::{SolverTestCase, TestCaseFilter, TestMatrixProperties, load_test_cases};
pub use generators::{
    RandomMatrixConfig, generate_arrow, generate_banded, generate_random_symmetric,
    generate_tridiagonal,
};
pub use harness::{MetricResult, MockSolver, SolverTest, TestResult};
pub use mc64_validation::{
    ScalingViolationReport, classify_scaling_violations, verify_spral_scaling_properties,
};
pub use perturbations::{
    TortureTestConfig, cause_delays, generate_dense_symmetric_indefinite,
    generate_dense_symmetric_pd, make_dblk_singular, make_singular,
};
pub use validator::NumericalValidator;