sim_field_stats.h

#pragma once
#include <stddef.h>
#include <stdint.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
struct SimField;
 
typedef struct SimFieldStats {
    double mean_re;                         
    double mean_im;                         
    double mean;                            
    double mean_abs;                        
    double rms;                             
    double var_re;                          
    double var_im;                          
    double var_abs;                         
    double max_abs;                         
    double phase_coherence;                 
    double circularity;                     
    double spectral_entropy;                
    double spectral_bandwidth;              
    double phase_coherence_weighted;        
    double phase_coherence_ema;             
    double phase_coherence_k0;              
    size_t phase_sample_count;              
    uint8_t phase_lock_state;               
    uint8_t phase_regime;                   
    uint8_t topology_valid;                 
    size_t count;                           
    size_t topology_positive_singularities; 
    size_t topology_negative_singularities; 
    size_t topology_seam_edge_count;        
    size_t topology_ambiguous_cell_count;   
    uint64_t
        continuity_dirty_ops; 
    uint64_t continuity_stable_ops; 
} SimFieldStats;
 
void sim_field_stats_compute(const struct SimField *field, SimFieldStats *out);
 
#ifdef __cplusplus
}
#endif