feagi-brain-development 0.0.22

Brain Development Utilities - Synaptogenesis and Connectivity
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

// Copyright 2025 Neuraville Inc.
// SPDX-License-Identifier: Apache-2.0

/*!
# FEAGI BDU (Brain Development Utilities)

This crate implements high-performance brain development operations including:
- Synaptogenesis (synapse creation based on morphology rules)
- Connectivity rules (projection, topology, patterns)
- Spatial hashing and coordinate transformations

## Architecture

Mirrors the Python structure:
- `feagi/bdu/connectivity/` → `feagi_brain_development::connectivity`
- `feagi/bdu/morton_spatial_hash.py` → `feagi_brain_development::spatial`

## Performance Goals

- 40x-100x faster than Python implementation
- Sub-second projection mappings for 128×128×20 areas
- SIMD-optimized coordinate transformations
- Parallel processing for large mappings

## Python Integration

NPU-native synaptogenesis functions are exposed via PyO3 bindings in `feagi-rust-py-libs`.
Python code calls these functions directly with area IDs - no FFI overhead.

Copyright 2025 Neuraville Inc.
Licensed under the Apache License, Version 2.0
*/

/// Crate version from Cargo.toml
pub const VERSION: &str = env!("CARGO_PKG_VERSION");

pub mod connectivity;
pub mod connectome_manager;
pub mod cortical_type_utils;
pub mod neuroembryogenesis;
pub mod region_io_designation;
mod rng;
pub mod spatial;
pub mod types;

// Note: models/ and genome/ have been moved to feagi-types and feagi-evo respectively

// Re-export NPU-native synaptogenesis functions (primary API)
pub use connectivity::{
    apply_block_connection_morphology, apply_expander_morphology, apply_patterns_morphology,
    apply_projector_morphology, apply_vectors_morphology,
};

pub use spatial::{morton_decode_3d, morton_encode_3d, MortonSpatialHash, SpatialHashStats};

// Re-export local BDU types
pub use region_io_designation::{
    merged_designated_lists, parse_designated_id_list, validate_cross_region_mapping_proposal,
    validate_merged_designations_against_connectivity, DESIGNATED_INPUTS_KEY,
    DESIGNATED_OUTPUTS_KEY,
};
pub use types::{AreaId, BduError, BduResult, Weight};

// Re-export core types from feagi_data_structures (single source of truth)
pub use feagi_structures::genomic::cortical_area::{
    CorticalArea, CorticalAreaDimensions as Dimensions, CorticalID,
};
pub use feagi_structures::genomic::{BrainRegion, RegionType};
pub mod models;
pub use models::{BrainRegionHierarchy, CorticalAreaExt};

// Re-export Position from local types
pub use types::Position;

// Re-export genome operations from feagi-evo
pub use feagi_evolutionary::{GenomeParser, GenomeSaver, ParsedGenome};

// Re-export connectome manager
pub use connectome_manager::{BrainRegionIoRegistry, ConnectomeConfig, ConnectomeManager};

// Re-export neuroembryogenesis
pub use neuroembryogenesis::{DevelopmentProgress, DevelopmentStage, Neuroembryogenesis};

// Re-export cortical type utilities (Phase 3)
pub use cortical_type_utils::{
    describe_cortical_type, get_io_data_type, uses_absolute_frames, uses_cartesian_encoding,
    uses_incremental_frames, uses_percentage_encoding, validate_connectivity,
};

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_basic_projection() {
        // Smoke test to ensure modules compile
        let result = connectivity::rules::syn_projector(
            "src_area",
            "dst_area",
            42,
            (128, 128, 3),
            (128, 128, 1),
            (0, 0, 0),
            None,
            None,
        );
        assert!(result.is_ok());
    }
}