Merge pull request #36 from ajmwagar/feature/precompute-bin

Precomputed scattering matrix binary format (.pksc)

Author: ajmwagar

pedalkernel/src/compiler/compiled.rs

@@ -2586,3 +2586,64 @@ impl PedalProcessor for CompiledPedal {
         out
     }
 }
+
+// ═══════════════════════════════════════════════════════════════════════════
+// Precompute extraction — used by crate::precompute
+// ═══════════════════════════════════════════════════════════════════════════
+
+/// Extract precomputed scattering data from a compiled pedal.
+///
+/// Called by [`crate::precompute::extract_precomputed`]; lives here so it
+/// has access to the `pub(super)` fields of [`CompiledPedal`] and
+/// [`MultiNlStage`].
+pub(crate) fn extract_precomputed_from_compiled(
+    compiled: &CompiledPedal,
+    pedal_source: &str,
+    sample_rate: f64,
+) -> crate::precompute::PrecomputedScattering {
+    use crate::precompute::{
+        pedal_hash, PrecomputedInterpTable, PrecomputedScattering, PrecomputedStage,
+    };
+
+    let hash = pedal_hash(pedal_source);
+    let mut stages = Vec::new();
+    let mut interp_tables = Vec::new();
+
+    for (stage_idx, mnl) in compiled.multi_nl_stages.iter().enumerate() {
+        let adaptor = mnl.adaptor();
+        let n = adaptor.num_ports();
+        let scattering = adaptor.power_scattering().to_vec();
+        let port_resistances = adaptor.port_resistances();
+        let vs_injection = mnl.vs_injection().map(ToOwned::to_owned);
+        let extract_coeffs = mnl.extract_coeffs().map(ToOwned::to_owned);
+        let extract_vs = mnl.extract_vs();
+
+        stages.push(PrecomputedStage {
+            stage_type: 1, // MultiNL
+            n_ports: n,
+            scattering,
+            vs_injection,
+            port_resistances,
+            extract_coeffs,
+            extract_vs,
+        });
+
+        if let Some(table) = mnl.interp_table() {
+            interp_tables.push(PrecomputedInterpTable {
+                stage_index: stage_idx,
+                n_ports: n,
+                has_vs_injection: table.has_vs_injection(),
+                resistances: table.resistances().to_vec(),
+                matrices: table.matrices().to_vec(),
+                injections: table.injections().to_vec(),
+            });
+        }
+    }
+
+    PrecomputedScattering {
+        pedal_hash: hash,
+        sample_rate,
+        stages,
+        interp_tables,
+    }
+}

pedalkernel/src/compiler/mod.rs

@@ -29,6 +29,7 @@ mod warnings;
 pub(crate) mod wdf_leaf;
 
 pub use compile::{compile_pedal, compile_pedal_with_options, CompileOptions};
+pub(crate) use compiled::extract_precomputed_from_compiled;
 pub use compiled::CompiledPedal;
 pub use component::{Component, PinDirection};
 pub use split::{compile_split_pedal, SplitCompiledPedal};

pedalkernel/src/compiler/stage.rs

@@ -3737,6 +3737,35 @@ impl MultiNlStage {
             }
         }
     }
+
+    // ── Precompute accessors ─────────────────────────────────────────────
+    // Minimal read-only accessors for `precompute::extract_precomputed`.
+
+    /// The R-type adaptor containing the scattering matrix and port data.
+    pub(crate) fn adaptor(&self) -> &RTypeAdaptor {
+        &self.adaptor
+    }
+
+    /// VS injection vector (present when driven by an ideal voltage source).
+    pub(crate) fn vs_injection(&self) -> Option<&Vec<f64>> {
+        self.vs_injection.as_ref()
+    }
+
+    /// Node-voltage extraction coefficients (present when output is read from
+    /// MNA node voltages directly rather than WDF port waves).
+    pub(crate) fn extract_coeffs(&self) -> Option<&Vec<f64>> {
+        self.extract_coeffs.as_ref()
+    }
+
+    /// VS component of the extraction formula.
+    pub(crate) fn extract_vs(&self) -> f64 {
+        self.extract_vs
+    }
+
+    /// Pot interpolation table (present for single-pot stages).
+    pub(crate) fn interp_table(&self) -> Option<&crate::tree::ScatteringInterpolationTable> {
+        self.interp_table.as_ref()
+    }
 }
 
 // ═══════════════════════════════════════════════════════════════════════════

pedalkernel/src/lib.rs

@@ -32,6 +32,7 @@ pub mod models;
 pub mod oversampling;
 pub mod pedalboard;
 pub mod pedals;
+pub mod precompute;
 #[cfg(feature = "runtime-warnings")]
 pub mod runtime_warnings;
 pub mod thermal;