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

Runtime parameters and integration state. More...

#include <sim_runtime_state.h>

Collaboration diagram for SimRuntimeState:

Public Attributes

double dt
 
SimTimeModel time_model
 
size_t step_index
 
double time_accumulated
 
uint32_t drift_mode_depth
 
double drift_time_override
 
bool drift_time_override_active
 
uint64_t * field_dirty_counts
 
uint64_t * field_stable_counts
 
double * field_phase_ema
 
double * field_phase_last_time
 
uint8_t * field_phase_lock_state
 
uint8_t * field_phase_initialized
 
SimFieldStatsdrift_field_stats
 
size_t drift_field_stats_step_index
 
bool * drift_field_stats_valid
 
bool * drift_field_stats_requested
 
SimComplexDouble ** drift_field_snapshots
 
size_t * drift_field_snapshot_capacity
 
size_t * drift_field_snapshot_count
 
size_t * drift_field_snapshot_step_index
 
bool * drift_field_snapshot_valid
 
bool * drift_field_snapshot_requested
 
SimFieldStatsfield_stats_cache
 
size_t * field_stats_cache_step_index
 
SimFieldStatsComputeConfig field_stats_config
 
SimFieldStatsRuntimeProfile field_stats_profile
 
SimFieldTopologyRuntimeStatefield_topology_cache
 
size_t * field_health_cache_step_index
 
size_t * field_health_nan_counts
 
size_t * field_health_inf_counts
 
size_t measurement_cache_step_index
 
bool measurement_cache_valid
 
double measurement_energy
 
double measurement_dissipation
 
double measurement_remainder
 
size_t measurement_remainder_sources
 
bool measurement_energy_valid
 
bool measurement_dissipation_valid
 
bool measurement_remainder_valid
 
SimRuntimeComplexSample ** visual_sample_cache
 
size_t * visual_sample_cache_capacity
 
size_t * visual_sample_cache_count
 
size_t * visual_sample_cache_step_index
 
size_t * visual_sample_cache_source_count
 
size_t * visual_sample_cache_stride
 
bool * visual_sample_cache_valid
 
SimRuntimePhasePortraitMetricsphase_portrait_metrics_cache
 
size_t * phase_portrait_metrics_cache_step_index
 
size_t * phase_portrait_metrics_cache_sample_count
 
bool * phase_portrait_metrics_cache_valid
 
SimRuntimeWaveformSampleStatswaveform_sample_stats_cache
 
size_t * waveform_sample_stats_cache_step_index
 
size_t * waveform_sample_stats_cache_sample_count
 
bool * waveform_sample_stats_cache_valid
 
size_t visual_sample_target_samples
 
size_t visual_sample_max_samples
 
size_t continuity_capacity
 
uint32_t current_step_warp_mask
 
FluxLensState flux_lens
 
FluxLensWorkspace flux_workspace
 
SimStepMetrics step_metrics [SIM_STEP_METRIC_HISTORY]
 
size_t step_metrics_head
 
size_t step_metrics_count
 
bool step_metrics_valid
 
SimStepMetrics step_metrics_latest
 
bool pending_cancel
 
SimRuntimeLoopStopReason last_stop_reason
 
SimRuntimeLoopError last_loop_error
 
SimRuntimeCallerStepMode last_caller_step_mode
 
size_t caller_step_streak
 
uint32_t external_driver_depth
 
SimRuntimeLoopProgress loop_progress
 
SimRuntimeLoopProgress last_loop_progress
 
bool last_loop_progress_valid
 

Detailed Description

Runtime parameters and integration state.

Member Data Documentation

◆ caller_step_streak

size_t SimRuntimeState::caller_step_streak

Consecutive caller-owned steps observed with the same primitive.

◆ continuity_capacity

size_t SimRuntimeState::continuity_capacity

Allocated length for continuity counter arrays.

◆ current_step_warp_mask

uint32_t SimRuntimeState::current_step_warp_mask

Warp levels observed during the active step.

◆ drift_field_snapshot_capacity

size_t* SimRuntimeState::drift_field_snapshot_capacity

Per-field allocated element capacity.

◆ drift_field_snapshot_count

size_t* SimRuntimeState::drift_field_snapshot_count

Per-field element count stored.

◆ drift_field_snapshot_requested

bool* SimRuntimeState::drift_field_snapshot_requested

Per-field snapshot request flags.

◆ drift_field_snapshot_step_index

size_t* SimRuntimeState::drift_field_snapshot_step_index

Per-field step index for snapshot.

◆ drift_field_snapshot_valid

bool* SimRuntimeState::drift_field_snapshot_valid

Per-field snapshot validity.

◆ drift_field_snapshots

SimComplexDouble** SimRuntimeState::drift_field_snapshots

Per-field snapshots captured during drift.

◆ drift_field_stats

SimFieldStats* SimRuntimeState::drift_field_stats

Per-field stats cached from drift evaluation.

◆ drift_field_stats_requested

bool* SimRuntimeState::drift_field_stats_requested

Per-field request flags for drift stats capture.

◆ drift_field_stats_step_index

size_t SimRuntimeState::drift_field_stats_step_index

Step index associated with cached drift stats.

◆ drift_field_stats_valid

bool* SimRuntimeState::drift_field_stats_valid

Per-field validity bits for cached drift stats.

◆ drift_mode_depth

uint32_t SimRuntimeState::drift_mode_depth

>0 when executing drift-only evaluations (no side effects).

◆ drift_time_override

double SimRuntimeState::drift_time_override

Optional stage time override while in drift.

◆ drift_time_override_active

bool SimRuntimeState::drift_time_override_active

True when sim_context_time should return the drift override.

◆ dt

double SimRuntimeState::dt

Integration timestep.

◆ external_driver_depth

uint32_t SimRuntimeState::external_driver_depth

Nested caller-owned external-driver claims.

◆ field_dirty_counts

uint64_t* SimRuntimeState::field_dirty_counts

Per-field continuity counters (dirty).

◆ field_health_cache_step_index

size_t* SimRuntimeState::field_health_cache_step_index

Step index associated with cached health counts.

◆ field_health_inf_counts

size_t* SimRuntimeState::field_health_inf_counts

Per-field Inf counts (cached).

◆ field_health_nan_counts

size_t* SimRuntimeState::field_health_nan_counts

Per-field NaN counts (cached).

◆ field_phase_ema

double* SimRuntimeState::field_phase_ema

Per-field phase coherence EMA.

◆ field_phase_initialized

uint8_t* SimRuntimeState::field_phase_initialized

Per-field EMA init marker.

◆ field_phase_last_time

double* SimRuntimeState::field_phase_last_time

Per-field last timestamp used for EMA (seconds).

◆ field_phase_lock_state

uint8_t* SimRuntimeState::field_phase_lock_state

Per-field hysteresis lock flag.

◆ field_stable_counts

uint64_t* SimRuntimeState::field_stable_counts

Per-field continuity counters (stable).

◆ field_stats_cache

SimFieldStats* SimRuntimeState::field_stats_cache

Per-field stats cache (current step).

◆ field_stats_cache_step_index

size_t* SimRuntimeState::field_stats_cache_step_index

Step index associated with cached stats.

◆ field_stats_config

SimFieldStatsComputeConfig SimRuntimeState::field_stats_config

Feature mask for optional field stats work.

◆ field_stats_profile

SimFieldStatsRuntimeProfile SimRuntimeState::field_stats_profile

Rolling field stats timing/cache profile.

◆ field_topology_cache

SimFieldTopologyRuntimeState* SimRuntimeState::field_topology_cache

Per-field topology cache/state.

◆ flux_lens

FluxLensState SimRuntimeState::flux_lens

Flux lens state (single lens per context).

◆ flux_workspace

FluxLensWorkspace SimRuntimeState::flux_workspace

Scratch workspace for flux computations.

◆ last_caller_step_mode

SimRuntimeCallerStepMode SimRuntimeState::last_caller_step_mode

Most recent caller-owned stepping primitive observed.

◆ last_loop_error

SimRuntimeLoopError SimRuntimeState::last_loop_error

Most recent runtime/loop error.

◆ last_loop_progress

SimRuntimeLoopProgress SimRuntimeState::last_loop_progress

Most recent completed caller-owned bounded-loop snapshot.

◆ last_loop_progress_valid

bool SimRuntimeState::last_loop_progress_valid

True when last_loop_progress contains a retained final snapshot.

◆ last_stop_reason

SimRuntimeLoopStopReason SimRuntimeState::last_stop_reason

Most recent terminal/non-running reason.

◆ loop_progress

SimRuntimeLoopProgress SimRuntimeState::loop_progress

Current caller-owned bounded-loop progress snapshot.

◆ measurement_cache_step_index

size_t SimRuntimeState::measurement_cache_step_index

Step index associated with cached measurement taps.

◆ measurement_cache_valid

bool SimRuntimeState::measurement_cache_valid

True when cached measurement taps are current.

◆ measurement_dissipation

double SimRuntimeState::measurement_dissipation

Cached global dissipation measurement.

◆ measurement_dissipation_valid

bool SimRuntimeState::measurement_dissipation_valid

Cached dissipation tap validity.

◆ measurement_energy

double SimRuntimeState::measurement_energy

Cached global energy measurement.

◆ measurement_energy_valid

bool SimRuntimeState::measurement_energy_valid

Cached energy tap validity.

◆ measurement_remainder

double SimRuntimeState::measurement_remainder

Cached remainder norm measurement.

◆ measurement_remainder_sources

size_t SimRuntimeState::measurement_remainder_sources

Cached remainder source count.

◆ measurement_remainder_valid

bool SimRuntimeState::measurement_remainder_valid

Cached remainder tap validity.

◆ pending_cancel

bool SimRuntimeState::pending_cancel

True while a cancel request is being applied.

◆ phase_portrait_metrics_cache

SimRuntimePhasePortraitMetrics* SimRuntimeState::phase_portrait_metrics_cache

Per-field phase-portrait metrics cache.

◆ phase_portrait_metrics_cache_sample_count

size_t* SimRuntimeState::phase_portrait_metrics_cache_sample_count

Downsampled sample count used for cached phase-portrait metrics.

◆ phase_portrait_metrics_cache_step_index

size_t* SimRuntimeState::phase_portrait_metrics_cache_step_index

Step index associated with cached phase-portrait metrics.

◆ phase_portrait_metrics_cache_valid

bool* SimRuntimeState::phase_portrait_metrics_cache_valid

Per-field validity marker for cached phase-portrait metrics.

◆ step_index

size_t SimRuntimeState::step_index

Monotonic step counter for diagnostics.

◆ step_metrics

SimStepMetrics SimRuntimeState::step_metrics[SIM_STEP_METRIC_HISTORY]

Circular buffer of recent step metrics.

◆ step_metrics_count

size_t SimRuntimeState::step_metrics_count

Number of populated entries (<= history).

◆ step_metrics_head

size_t SimRuntimeState::step_metrics_head

Next write index inside the metrics buffer.

◆ step_metrics_latest

SimStepMetrics SimRuntimeState::step_metrics_latest

Most recent metrics sample.

◆ step_metrics_valid

bool SimRuntimeState::step_metrics_valid

True once at least one metrics sample has been recorded.

◆ time_accumulated

double SimRuntimeState::time_accumulated

Simulation time accumulated from accepted steps (seconds).

◆ time_model

SimTimeModel SimRuntimeState::time_model

Time evolution semantics (continuous vs map).

◆ visual_sample_cache

SimRuntimeComplexSample** SimRuntimeState::visual_sample_cache

Per-field downsampled sample cache.

◆ visual_sample_cache_capacity

size_t* SimRuntimeState::visual_sample_cache_capacity

Per-field allocated sample capacity.

◆ visual_sample_cache_count

size_t* SimRuntimeState::visual_sample_cache_count

Per-field cached sample count.

◆ visual_sample_cache_source_count

size_t* SimRuntimeState::visual_sample_cache_source_count

Source element count used for cached samples.

◆ visual_sample_cache_step_index

size_t* SimRuntimeState::visual_sample_cache_step_index

Step index associated with cached samples.

◆ visual_sample_cache_stride

size_t* SimRuntimeState::visual_sample_cache_stride

Stride used while producing cached samples.

◆ visual_sample_cache_valid

bool* SimRuntimeState::visual_sample_cache_valid

Per-field validity marker for cached samples.

◆ visual_sample_max_samples

size_t SimRuntimeState::visual_sample_max_samples

Upper bound for canonical target sample count.

◆ visual_sample_target_samples

size_t SimRuntimeState::visual_sample_target_samples

Canonical target sample count for visual downsample.

◆ waveform_sample_stats_cache

SimRuntimeWaveformSampleStats* SimRuntimeState::waveform_sample_stats_cache

Per-field waveform sample stats cache.

◆ waveform_sample_stats_cache_sample_count

size_t* SimRuntimeState::waveform_sample_stats_cache_sample_count

Sample count used for cached waveform sample stats.

◆ waveform_sample_stats_cache_step_index

size_t* SimRuntimeState::waveform_sample_stats_cache_step_index

Step index associated with cached waveform sample stats.

◆ waveform_sample_stats_cache_valid

bool* SimRuntimeState::waveform_sample_stats_cache_valid

Per-field validity marker for cached waveform sample stats.


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