alice-edge 0.1.0

Embedded Model Generator - Don't send data, send the law
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
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130

//! ALICE-Edge: Embedded Model Generator (Ultimate Optimization)
//!
//! "Don't send data. Send the law."
//!
//! Ultra-lightweight procedural compression for embedded systems.
//! Runs on Cortex-M, ESP32, AVR, RISC-V - anywhere with 1KB of stack.
//!
//! # Optimization Level: LUDICROUS
//!
//! - **Algorithm**: Closed-form formulas for Sum(x) and Sum(x²) - O(1)
//! - **Loop**: Calculates ONLY Sum(y) and Sum(xy). Other sums eliminated.
//! - **Factorization**: Reduces multiplications via algebraic transformation.
//! - **Division**: Minimized to essential operations only.
//! - **Safety**: Unsafe pointer arithmetic for zero bounds checks.
//!
//! # Philosophy
//!
//! Raw sensor data never leaves the device. Instead, we fit a mathematical
//! model on-device and transmit only the coefficients. This provides:
//!
//! - **Compression**: 1000 samples → 8 bytes (slope + intercept)
//! - **Privacy**: Raw data is discarded immediately
//! - **Bandwidth**: 100-1000x reduction in transmission
//!
//! # Example
//!
//! ```
//! use alice_edge::{fit_linear_fixed, evaluate_linear_fixed, int_to_q16};
//!
//! // Sensor readings (e.g., temperature * 100)
//! let samples = [2500, 2510, 2520, 2530, 2540]; // 25.00°C rising
//!
//! // Fit model on-device
//! let (slope, intercept) = fit_linear_fixed(&samples);
//!
//! // Transmit only 8 bytes instead of 20 bytes!
//! // transmit_coefficients(slope, intercept);
//!
//! // On receiver: reconstruct any point
//! let temp_at_3 = evaluate_linear_fixed(slope, intercept, int_to_q16(3));
//! assert!(temp_at_3 != 0); // 非ゼロの予測値
//! ```
//!
//! # Related Projects
//!
//! - [ALICE-Zip](https://github.com/ext-sakamoro/ALICE-Zip) - Full compression engine
//! - [ALICE-DB](https://github.com/ext-sakamoro/ALICE-DB) - Model-based database
//! - [ALICE-Streaming-Protocol](https://github.com/ext-sakamoro/ALICE-Streaming-Protocol) - Video streaming

// SPDX-License-Identifier: MIT
#![allow(
    clippy::cast_possible_truncation,
    clippy::cast_possible_wrap,
    clippy::cast_precision_loss,
    clippy::cast_sign_loss,
    clippy::cast_lossless,
    clippy::similar_names,
    clippy::many_single_char_names,
    clippy::module_name_repetitions,
    clippy::inline_always,
    clippy::too_many_lines
)]
#![cfg_attr(not(feature = "std"), no_std)]

// asp_bridge 一時 disable (libasp crates.io 未 publish、0.2.0 で復活予定)
// #[cfg(feature = "asp")]
// pub mod asp_bridge;
#[cfg(feature = "codec")]
pub mod codec_bridge;
#[cfg(feature = "dashboard")]
pub mod dashboard;
#[cfg(feature = "db")]
pub mod db_bridge;
#[cfg(feature = "depth-camera")]
pub mod depth_capture;
#[cfg(feature = "edge-pipeline")]
pub mod edge_pipeline;
#[cfg(feature = "ffi")]
pub mod ffi;
#[cfg(feature = "ml")]
pub mod ml_bridge;
#[cfg(feature = "mqtt")]
pub mod mqtt_bridge;
#[cfg(feature = "ml")]
pub mod object_classifier;
#[cfg(feature = "std")]
pub mod ota;
#[cfg(feature = "pyo3")]
pub mod python;
pub mod ring_buffer;
#[cfg(feature = "sdf")]
pub mod sdf_compress;
pub mod sensor_fusion;
#[cfg(feature = "sensors")]
pub mod sensors;
#[cfg(feature = "std")]
pub mod telemetry;
#[cfg(feature = "std")]
pub mod watchdog;
#[cfg(feature = "zip")]
pub mod zip_bridge;

// D-split modules (extracted from monolithic lib.rs).
pub mod adaptive_polyfit;
pub mod constant_fit;
#[cfg(feature = "std")]
pub mod delta;
#[cfg(feature = "ml")]
pub mod inference_trait;
pub mod piecewise;
pub mod q16_linear;
#[cfg(feature = "std")]
pub mod robust;
pub mod simd_fit;

#[cfg(test)]
mod integration_tests;

// Backward-compat re-exports.
pub use crate::adaptive_polyfit::*;
pub use crate::constant_fit::*;
#[cfg(feature = "std")]
pub use crate::delta::*;
#[cfg(feature = "ml")]
pub use crate::inference_trait::*;
pub use crate::piecewise::*;
pub use crate::q16_linear::*;
#[cfg(feature = "std")]
pub use crate::robust::*;
pub use crate::simd_fit::*;