sim_diagnostics.h

Go to the documentation of this file.

 
#ifndef OAKFIELD_SIM_DIAGNOSTICS_H
#define OAKFIELD_SIM_DIAGNOSTICS_H
 
#include "math/special_functions.h"
#include <stdbool.h>
#include <stdint.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
typedef enum SimDiagnosticBackendKind {
    SIM_DIAGNOSTIC_BACKEND_CPU = 0,      
    SIM_DIAGNOSTIC_BACKEND_CUDA = 1,     
    SIM_DIAGNOSTIC_BACKEND_METAL = 2,    
    SIM_DIAGNOSTIC_BACKEND_UNKNOWN = 255 
} SimDiagnosticBackendKind;
 
typedef struct SimDiagnostics {
    SimSpecialFallbackFn fallback_user; 
    void *fallback_userdata;            
    volatile int fault_lock;            
    uint64_t fault_count;               
    SimSpecialEvalReport fault_last;    
    char fault_function[64];            
    uint64_t kernel_dispatch_count;     
    uint64_t kernel_fallback_count;     
    bool kernel_last_valid;             
    bool kernel_last_fallback_used;     
    SimDiagnosticBackendKind
        kernel_last_requested_backend; 
    SimDiagnosticBackendKind
        kernel_last_executed_backend;     
    char kernel_last_operator[64];        
    char kernel_last_fallback_reason[96]; 
    bool enable_invariant_checks;         
    uint64_t representation_complex_promotions; 
    uint64_t representation_domain_adjustments; 
#if SIM_DIAGNOSTICS
    /* Aggregated special-function health metrics (lifetime counters). */
    uint64_t reflection_count;         
    uint64_t recurrence_shift_samples; 
    double max_recurrence_shift;       
    uint64_t stirling_tail_samples;    
    double max_stirling_tail;          
    uint64_t pole_proximity_samples;   
    double min_pole_distance;          
#endif
} SimDiagnostics;
 
#ifdef __cplusplus
}
#endif
 
#endif /* OAKFIELD_SIM_DIAGNOSTICS_H */