Struct FftExecutor 

pub struct FftExecutor { /* private fields */ }

Reusable concrete FFT executor with an explicitly owned backend-neutral cache.

Use this executor for repeated concrete FFT calls that should reuse backend plans. The immediate TensorFftExt and TensorReadFftExt methods stay one-shot and do not retain hidden process-global, thread-local, or backend-owned plan state between calls.

Implementations

impl FftExecutor

pub fn new(plans: FftPlanCache) -> Self

Create an executor from a caller-configured FFT execution cache.

pub const fn plan_cache(&self) -> &FftPlanCache

Inspect the owned backend-neutral FFT cache.

pub fn plan_cache_mut(&mut self) -> &mut FftPlanCache

Mutably inspect or configure the owned backend-neutral FFT cache.

pub fn cache_stats(&self) -> CacheStats

Snapshot aggregate statistics for every backend cache namespace.

pub fn clear_cache(&mut self)

Remove every retained backend plan or workspace from this executor.

pub fn fft<B: FftBackend>( &mut self, input: &Tensor, n: Option<usize>, axis: isize, norm: FftNorm, backend: &mut B, ) -> Result<Tensor>

Execute a complex or full-spectrum real FFT while reusing owned plans.

Errors

Returns tenferro_tensor::Error::Validation with AxisOutOfBounds or InvalidArgument for invalid axis/n, tenferro_tensor::Error::Extension with ErrorKind::Unsupported for unsupported dtypes, or a typed backend source for execution.

pub fn ifft<B: FftBackend>( &mut self, input: &Tensor, n: Option<usize>, axis: isize, norm: FftNorm, backend: &mut B, ) -> Result<Tensor>

Execute an inverse complex FFT while reusing owned plans.

Errors

Returns tenferro_tensor::Error::Validation with AxisOutOfBounds or InvalidArgument for invalid axis/n, tenferro_tensor::Error::Extension with ErrorKind::Unsupported for a non-complex input, or a typed backend source for execution.

pub fn rfft<B: FftBackend>( &mut self, input: &Tensor, n: Option<usize>, axis: isize, norm: FftNorm, backend: &mut B, ) -> Result<Tensor>

Execute a real FFT while reusing owned plans.

Errors

Returns tenferro_tensor::Error::Validation with AxisOutOfBounds or InvalidArgument for invalid axis/n, tenferro_tensor::Error::Extension with ErrorKind::Unsupported for a non-real input, or a typed backend source for execution.

pub fn irfft<B: FftBackend>( &mut self, input: &Tensor, n: Option<usize>, axis: isize, norm: FftNorm, backend: &mut B, ) -> Result<Tensor>

Execute an inverse real FFT while reusing owned plans.

Errors

Returns tenferro_tensor::Error::Validation with AxisOutOfBounds, InvalidArgument, or spectrum-length details, tenferro_tensor::Error::Extension with ErrorKind::Unsupported for a non-complex input, or a typed backend source for execution.

Trait Implementations

impl Default for FftExecutor

fn default() -> FftExecutor

Returns the “default value” for a type.