Skip to main content

rill_core/math/vector/
mod.rs

1//! # Векторные операции для DSP
2//!
3//! Этот модуль предоставляет встроенный предметно-ориентированный язык (eDSL) для векторных операций,
4//! оптимизированных под SIMD инструкции.
5//!
6//! ## Основные возможности
7//! - Базовые векторные типы для f32 и f64 с различной шириной SIMD
8//! - Арифметические операции (+, -, *, /, %)
9//! - Математические функции (sin, cos, exp, ln, sqrt, ...)
10//! - Система выражений для ленивых вычислений и оптимизаций
11//! - Автоматическая детекция SIMD возможностей процессора
12//!
13//! ## Использование
14//! ```
15//! use rill_core::vector::prelude::*;
16//!
17//! let a = ScalarVector4::splat(1.0);
18//! let b = ScalarVector4::splat(2.0);
19//! let c = a + b;
20//! assert_eq!(c, ScalarVector4::splat(3.0));
21//! ```
22//!
23//! ## Архитектура
24//! Модуль организован следующим образом:
25//! - `traits` - основные трейты (`Vector`, `VectorOps`, `VectorMath`)
26//! - `ops` - реализации арифметических операций
27//! - `math` - математические функции
28//! - `simd` - SIMD реализации для разных архитектур
29//! - `expr` - система выражений и оптимизации
30//! - `scalar` - скалярные fallback реализации
31//!
32//! ## Поддерживаемые платформы
33//! - x86/x86_64: SSE2, SSE4.1, AVX, AVX2, AVX512 (через детекцию во время выполнения)
34//! - ARM: NEON (AArch64)
35//! - WebAssembly: SIMD128
36//! - Скалярный fallback для платформ без SIMD
37
38#![allow(unused_imports)]
39#![allow(dead_code)]
40
41pub mod math;
42pub mod ops;
43pub mod traits;
44// pub mod expr;  // временно отключено из-за ошибок компиляции
45pub mod macros;
46pub mod scalar;
47
48#[cfg(any(target_arch = "x86", target_arch = "x86_64"))]
49pub mod simd;
50
51// Re-exports
52pub use math::*;
53pub use ops::*;
54pub use traits::*;
55// pub use expr::*;  // временно отключено
56pub use macros::*;
57pub use scalar::*;
58
59/// Prelude для удобного импорта
60pub mod prelude {
61    pub use crate::math::vector::math::*;
62    pub use crate::math::vector::ops::*;
63    pub use crate::math::vector::traits::*;
64    // pub use crate::math::vector::expr::*;  // временно отключено
65    pub use crate::math::vector::macros::*;
66    pub use crate::math::vector::scalar::*;
67
68    // Типы векторов
69    #[cfg(feature = "simd")]
70    pub use crate::math::vector::simd::*;
71
72    // Скалярные типы
73    pub use crate::math::vector::scalar::{ScalarVector1, ScalarVector2, ScalarVector4, ScalarVector8};
74}