chaos_map.h

Go to the documentation of this file.

 
#ifndef OAKFIELD_CHAOS_MAP_H
#define OAKFIELD_CHAOS_MAP_H
 
#include "oakfield/operator_split.h"
 
#include <stdbool.h>
#include <stddef.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
struct SimContext;
 
typedef enum SimChaosMapType {
    SIM_CHAOS_MAP_STANDARD = 0, 
    SIM_CHAOS_MAP_IKEDA,        
    SIM_CHAOS_MAP_EXPONENTIAL,  
    SIM_CHAOS_MAP_QUADRATIC,    
    SIM_CHAOS_MAP_HENON,        
    SIM_CHAOS_MAP_LOZI,         
    SIM_CHAOS_MAP_TINKERBELL    
} SimChaosMapType;
 
typedef enum SimChaosKickMode {
    SIM_CHAOS_KICK_DRIFT = 0, 
    SIM_CHAOS_DRIFT_KICK,     
    SIM_CHAOS_KICK_DRIFT_KICK 
} SimChaosKickMode;
 
typedef enum SimChaosWrapMode {
    SIM_CHAOS_WRAP_NONE = 0, 
    SIM_CHAOS_WRAP_PERIODIC, 
    SIM_CHAOS_WRAP_CLAMP,    
    SIM_CHAOS_WRAP_MIRROR    
} SimChaosWrapMode;
 
typedef enum SimChaosEscapeMode {
    SIM_CHAOS_ESCAPE_NONE = 0, 
    SIM_CHAOS_ESCAPE_CLAMP,    
    SIM_CHAOS_ESCAPE_RESET,    
    SIM_CHAOS_ESCAPE_NAN       
} SimChaosEscapeMode;
 
typedef struct SimChaosMapOperatorConfig {
    size_t input_field;               
    size_t output_field;              
    SimChaosMapType map_type;         
    SimChaosKickMode kick_mode;       
    unsigned int iterations_per_step; 
    double blend;                     
    /* Standard map parameters */
    double k;           
    double angle_scale; 
    /* Ikeda map parameters */
    double ikeda_u;         
    double ikeda_a;         
    double ikeda_b;         
    double ikeda_offset_re; 
    double ikeda_offset_im; 
    /* Exponential map parameters */
    double exp_scale_re; 
    double exp_scale_im; 
    double exp_c_re;     
    double exp_c_im;     
    /* Quadratic map parameters */
    double quad_a_re; 
    double quad_a_im; 
    double quad_b_re; 
    double quad_b_im; 
    double quad_c_re; 
    double quad_c_im; 
    /* Henon map parameters */
    double henon_a;         
    double henon_b;         
    double henon_x_gain;    
    double henon_y_gain;    
    double henon_offset_re; 
    double henon_offset_im; 
    /* Lozi map parameters */
    double lozi_a;           
    double lozi_b;           
    double lozi_x_gain;      
    double lozi_y_gain;      
    double lozi_offset_re;   
    double lozi_offset_im;   
    double lozi_abs_epsilon; 
    /* Tinkerbell map parameters */
    double tinkerbell_a;         
    double tinkerbell_b;         
    double tinkerbell_c;         
    double tinkerbell_d;         
    double tinkerbell_x2_gain;   
    double tinkerbell_y2_gain;   
    double tinkerbell_xy_gain;   
    double tinkerbell_offset_re; 
    double tinkerbell_offset_im; 
    /* Optional per-element parameter fields (SIZE_MAX disables). */
    size_t k_field; 
    size_t u_field; 
    size_t a_field; 
    size_t b_field; 
    size_t c_field; 
    size_t d_field; 
    /* Wrapping configuration */
    SimChaosWrapMode wrap_mode_re; 
    SimChaosWrapMode wrap_mode_im; 
    double wrap_min_re;            
    double wrap_max_re;            
    double wrap_min_im;            
    double wrap_max_im;            
    /* Escape handling */
    SimChaosEscapeMode escape_mode; 
    double escape_radius;           
    double escape_reset_re;         
    double escape_reset_im;         
} SimChaosMapOperatorConfig;
 
SimResult sim_add_chaos_map_operator(struct SimContext *context,
                                     const SimChaosMapOperatorConfig *config, size_t *out_index);
 
SimResult sim_chaos_map_config(struct SimContext *context, size_t operator_index,
                               SimChaosMapOperatorConfig *out_config);
 
SimResult sim_chaos_map_update(struct SimContext *context, size_t operator_index,
                               const SimChaosMapOperatorConfig *config);
 
#ifdef __cplusplus
}
#endif
 
#endif /* OAKFIELD_CHAOS_MAP_H */