Crate feagi_brain_development

Crate feagi_brain_development 

Source
Expand description

§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.pyfeagi_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

Re-exports§

pub use connectivity::apply_block_connection_morphology;
pub use connectivity::apply_expander_morphology;
pub use connectivity::apply_patterns_morphology;
pub use connectivity::apply_projector_morphology;
pub use connectivity::apply_vectors_morphology;
pub use spatial::morton_decode_3d;
pub use spatial::morton_encode_3d;
pub use spatial::MortonSpatialHash;
pub use spatial::SpatialHashStats;
pub use types::AreaId;
pub use types::BduError;
pub use types::BduResult;
pub use types::Weight;
pub use models::BrainRegionHierarchy;
pub use models::CorticalAreaExt;
pub use types::Position;
pub use connectome_manager::ConnectomeConfig;
pub use connectome_manager::ConnectomeManager;
pub use neuroembryogenesis::DevelopmentProgress;
pub use neuroembryogenesis::DevelopmentStage;
pub use neuroembryogenesis::Neuroembryogenesis;
pub use cortical_type_utils::describe_cortical_type;
pub use cortical_type_utils::get_io_data_type;
pub use cortical_type_utils::uses_absolute_frames;
pub use cortical_type_utils::uses_cartesian_encoding;
pub use cortical_type_utils::uses_incremental_frames;
pub use cortical_type_utils::uses_percentage_encoding;
pub use cortical_type_utils::validate_connectivity;

Modules§

connectivity
Connectivity and synaptogenesis operations.
connectome_manager
ConnectomeManager - Core brain connectivity manager.
cortical_type_utils
Cortical Type Utilities for BDU
models
Core data models for FEAGI BDU.
neuroembryogenesis
Neuroembryogenesis - Brain Development from Genome.
spatial
Spatial indexing utilities for efficient position-based queries.
types
Core types for BDU operations.

Structs§

BrainRegion
Brain region metadata (genome representation)
CorticalArea
Cortical area metadata (genome representation)
CorticalID
Dimensions
Dimensions of an entire cortical area.
GenomeParser
Genome parser
GenomeSaver
Genome saver
ParsedGenome
Parsed genome data ready for ConnectomeManager

Enums§

RegionType
Type of brain region (placeholder for future functional/anatomical classification)

Constants§

VERSION
Crate version from Cargo.toml