nx_rvq.nx

nx_rvq.nx -- RESIDUAL VECTOR QUANTIZATION, moonshot rung #3 and the literal structure inside SoundStream / Lyra-v2 / Encodec: a stack of S codebooks where stage k quantises the RESIDUAL left by stages 0..k-1. Reconstruction is the sum of the chosen stage centroids; each added stage costs log2(K) bits and shrinks the residual -> a rate-distortion knob. The neural codec replaces these fixed centroids with learned ones over a learned latent; the structure is identical. Composes nx_vq (+ nx_vq_train trains each stage on its residuals). license_tier: ORIGINAL