sklears-core 0.1.1

Core traits, types, and utilities for sklears machine learning library
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
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92

# Trait Explorer Module

This module provides comprehensive trait exploration and analysis capabilities for the sklears-core crate. It's designed as a modular system following the 2000-line policy for maintainable code organization.

> **Latest release:** `0.1.0` (March 20, 2026). See the [workspace release notes](../../../../docs/releases/0.1.0.md) for highlights and upgrade guidance.

## Module Structure

- `trait_explorer_core.rs` - Core framework, configuration, and orchestration
- `mod.rs` - Module exports and public API

## Core Components

### 1. Configuration System (`ExplorerConfig`)
- Comprehensive configuration with builder pattern
- Support for interactive mode, performance analysis, visual graphs
- Validation and error handling for configuration parameters

### 2. Main Explorer Framework (`TraitExplorer`)
- Central coordination for all trait exploration activities
- Integration with specialized analyzer components
- Caching support for improved performance
- Metrics tracking for exploration activities

### 3. Result Management (`TraitExplorationResult`)
- Complete result container with metadata
- JSON export capabilities
- Summary statistics and reporting

### 4. Core Utilities
- Complexity score calculation
- Trait similarity analysis
- Relationship discovery algorithms
- Integration interfaces for analyzer modules

## SciRS2 Compliance

The module fully complies with SciRS2 policies:
- Uses `scirs2_autograd::ndarray` for array operations
- Uses `scirs2_core::random` for random number generation
- Follows proper error handling patterns
- Integrates with the SciRS2 ecosystem

## Usage Example

```rust
use sklears_core::trait_explorer::{TraitExplorer, ExplorerConfig};

// Configure the explorer
let config = ExplorerConfig::new()
    .with_interactive_mode(true)
    .with_performance_analysis(true)
    .with_visual_graph(true)
    .with_max_depth(8);

// Create and initialize explorer
let mut explorer = TraitExplorer::new(config)?;
explorer.load_from_crate("sklears-core")?;

// Explore a specific trait
let analysis = explorer.explore_trait("Estimator")?;
println!("Complexity score: {}", analysis.complexity_score);

// Export results
let json_output = analysis.to_json()?;
```

## Testing

The module includes comprehensive unit tests covering:
- Configuration builder pattern
- Complexity score calculation
- Caching functionality
- Metrics tracking
- Explorer creation and validation

## Future Expansion

This core module provides the foundation for additional specialized analyzers:
- Dependency analysis modules
- Performance analysis components
- Graph generation systems
- Example generation frameworks
- Security and cross-platform analyzers

## Integration

The module is fully integrated with the existing sklears-core infrastructure:
- Uses existing error handling (`crate::error`)
- Leverages API reference generator (`crate::api_reference_generator`)
- Follows established architectural patterns
- Maintains backward compatibility