fugue-evo 0.1.0

A Probabilistic Genetic Algorithm Library for Rust
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
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114

# RealVector Reference

Fixed-length vector of real-valued genes for continuous optimization.

## Module

```rust,ignore
use fugue_evo::genome::real_vector::RealVector;
```

## Construction

```rust,ignore
// From vector
let genome = RealVector::new(vec![1.0, 2.0, 3.0]);

// With dimension
let genome = RealVector::zeros(10);

// Random within bounds
let genome = RealVector::random(&bounds, &mut rng);
```

## Methods

### Access

| Method | Return | Description |
|--------|--------|-------------|
| `genes()` | `&[f64]` | Immutable gene access |
| `genes_mut()` | `&mut [f64]` | Mutable gene access |
| `dimension()` | `usize` | Number of genes |
| `get(i)` | `Option<f64>` | Get gene at index |

### Vector Operations

| Method | Description |
|--------|-------------|
| `add(&other)` | Element-wise addition |
| `sub(&other)` | Element-wise subtraction |
| `scale(factor)` | Multiply all genes by factor |
| `norm()` | Euclidean norm |
| `euclidean_distance(&other)` | Distance between vectors |
| `dot(&other)` | Dot product |

### Statistics

| Method | Description |
|--------|-------------|
| `mean()` | Mean of genes |
| `variance()` | Variance of genes |
| `sum()` | Sum of genes |

## Trace Representation

Genes are stored at indexed addresses:

```rust,ignore
// Trace structure
addr!("gene", 0) → genes[0]
addr!("gene", 1) → genes[1]
// ...
```

## Usage with Operators

### Recommended Crossover

```rust,ignore
// Simulated Binary Crossover
SbxCrossover::new(20.0)

// Blend Crossover
BlendCrossover::new(0.5)

// Uniform Crossover
UniformCrossover::new()
```

### Recommended Mutation

```rust,ignore
// Polynomial Mutation
PolynomialMutation::new(20.0)

// Gaussian Mutation
GaussianMutation::new(0.1)
```

## Example

```rust,ignore
use fugue_evo::prelude::*;

let bounds = MultiBounds::symmetric(5.12, 10);
let mut genome = RealVector::random(&bounds, &mut rng);

// Modify genes
genome.genes_mut()[0] = 1.0;

// Vector operations
let other = RealVector::random(&bounds, &mut rng);
let distance = genome.euclidean_distance(&other);

// Use in GA
let result = SimpleGABuilder::<RealVector, f64, _, _, _, _, _>::new()
    .bounds(bounds)
    // ...
```

## See Also

- [Continuous Optimization Tutorial](../../tutorials/continuous-optimization.md)
- [Custom Genome Types](../../how-to/custom-genome.md)