Oakfield API Documentation 1.0.0
Numerical core APIs
Loading...
Searching...
No Matches
FluxLensState Struct Reference

Persistent flux-lens band state and analysis buffers for a simulation context. More...

#include <sim_flux_lens.h>

Collaboration diagram for FluxLensState:

Public Attributes

bool enabled
 
bool locked
 
bool force_update
 
bool band_ready
 
size_t field_index
 
double smoothing
 
double min_bandwidth
 
size_t update_period
 
size_t last_update_step
 
double band_lo
 
double band_hi
 
double target_band_lo
 
double target_band_hi
 
double band_max_component
 
double band_max_magnitude
 
double max_k
 
double complex * band_spec
 
double complex * band_phys
 
size_t band_capacity
 
double * S
 
double * Pi
 
double * bucket_k
 
double * bucket_pi
 
double * bucket_S
 
double * bucket_absS
 
size_t bucket_capacity
 
size_t bucket_count
 
double pi_min
 
double pi_max
 
double absS_total
 
FluxMarks marks
 
size_t scratch_bytes
 

Detailed Description

Persistent flux-lens band state and analysis buffers for a simulation context.

The state owns band spectra, physical reconstructions, and bucket arrays after flux_lens_ensure_capacity(); release them with flux_lens_release().

Member Data Documentation

◆ absS_total

double FluxLensState::absS_total

Total absolute work-density from latest analysis.

◆ band_capacity

size_t FluxLensState::band_capacity

Allocated element capacity for band buffers.

◆ band_hi

double FluxLensState::band_hi

Active upper band edge.

◆ band_lo

double FluxLensState::band_lo

Active lower band edge.

◆ band_max_component

double FluxLensState::band_max_component

Maximum component magnitude inside reconstructed band.

◆ band_max_magnitude

double FluxLensState::band_max_magnitude

Maximum complex magnitude inside reconstructed band.

◆ band_phys

double complex* FluxLensState::band_phys

Owned physical reconstruction buffer.

◆ band_ready

bool FluxLensState::band_ready

True when band_lo/band_hi describe an initialized band.

◆ band_spec

double complex* FluxLensState::band_spec

Owned spectral band buffer.

◆ bucket_absS

double* FluxLensState::bucket_absS

Owned absolute work-density bucket array.

◆ bucket_capacity

size_t FluxLensState::bucket_capacity

Allocated element capacity for bucket arrays.

◆ bucket_count

size_t FluxLensState::bucket_count

Number of populated bucket entries.

◆ bucket_k

double* FluxLensState::bucket_k

Owned bucket-center wavenumber array.

◆ bucket_pi

double* FluxLensState::bucket_pi

Owned bucket flux array.

◆ bucket_S

double* FluxLensState::bucket_S

Owned bucket work-density array.

◆ enabled

bool FluxLensState::enabled

True when flux-lens analysis is active.

◆ field_index

size_t FluxLensState::field_index

Context field index analyzed by the lens.

◆ force_update

bool FluxLensState::force_update

True when the next update should ignore period throttling.

◆ last_update_step

size_t FluxLensState::last_update_step

Step index of the most recent mark refresh.

◆ locked

bool FluxLensState::locked

True when the current band should not chase new marks.

◆ marks

FluxMarks FluxLensState::marks

Latest spectral landmarks.

◆ max_k

double FluxLensState::max_k

Maximum represented wavenumber.

◆ min_bandwidth

double FluxLensState::min_bandwidth

Minimum allowed spectral band width.

◆ Pi

double* FluxLensState::Pi

Owned cumulative flux array.

◆ pi_max

double FluxLensState::pi_max

Maximum Pi value from the latest analysis.

◆ pi_min

double FluxLensState::pi_min

Minimum Pi value from the latest analysis.

◆ S

double* FluxLensState::S

Owned spectral work-density array.

◆ scratch_bytes

size_t FluxLensState::scratch_bytes

Context-accounted bytes owned by this state.

◆ smoothing

double FluxLensState::smoothing

Relaxation factor for target band updates.

◆ target_band_hi

double FluxLensState::target_band_hi

Desired upper band edge before relaxation.

◆ target_band_lo

double FluxLensState::target_band_lo

Desired lower band edge before relaxation.

◆ update_period

size_t FluxLensState::update_period

Number of steps between automatic mark refreshes.


The documentation for this struct was generated from the following file: