sim-lib-interference-compute 0.1.0

#![forbid(unsafe_code)]
#![deny(missing_docs)]

//! Normalized tile-local `f32` lowering over the canonical Tensor executor.
//!
//! The host keeps physical geometry and absolute phase in `f64`. Each prepared
//! tile exposes only bounded offsets and residual phase to ordinary open Tensor
//! operations, so no executor needs interference-specific behavior.
//!
//! The lowering preserves the homogeneous, isotropic, three-dimensional scalar
//! free-field scope. It does not add polarization, impedance, interfaces,
//! obstacles, or diffraction. Amplitude-squared metrics are normalized
//! observables, not physical intensity, power, or energy.

mod constants;
mod coordinates;
mod dense;
mod diff;
mod evidence;
mod lower;
mod preflight;
mod provider;
mod resident;
mod tile;

pub use constants::{
    PlaneTileConstants, PointTileConstants, SourcePhaseEstimate, SourceTileConstants,
};
pub use dense::{DenseExecutionEvidence, DenseF32Field, solve_dense_f32_cpu};
pub use diff::{
    ConformanceMetric, DifferentialError, DifferentialMaximum, DifferentialReport,
    DifferentialTolerances, ScalarTolerance, compare_dense_to_reference,
    compare_materialized_to_reference,
};
pub use evidence::{
    HARDWARE_DETERMINISM_REPEATS, HardwareEvidenceMetrics, HardwareEvidenceReport,
    HardwareMeasurementResult,
};
pub use lower::{LoweredTile, LoweringPlan};
pub use preflight::{
    LoweringError, PhaseBudget, PreflightCheck, REQUIRED_TENSOR_OPERATION_NAMES, TileProfile,
};
pub use provider::{
    CpuFallbackReason, InterferenceComputeLib, ProviderRoute, TensorStudyConfig,
    TensorStudySnapshot, TensorStudySolver, interference_compute_lib_symbol,
};
pub use tile::{PlaneTile, TilePlan};

/// Checked modeled and optional physical-provider evidence recipes.
pub static RECIPES: sim_cookbook::EmbeddedDir =
    include!(concat!(env!("OUT_DIR"), "/cookbook_recipes.rs"));

#[cfg(test)]
mod hardware_tests;
#[cfg(test)]
mod modeled_tests;
#[cfg(test)]
mod tests;