NeuroCGMD
Installation
Menu
Home  /  Reference  /  Architecture

Architecture

A documented simulation architecture that combines coarse-grained dynamics, selective force refinement, adaptive learning, and CG-to-AA reconstruction within one workflow.

Architecture

Force composition

F_total = F_classical + F_QCloud + alpha * F_ML_residual

where alpha = 0.35 in the documented reference configuration when QCloud is active, 1.0 otherwise

Force propagation chain

StageOperation
1. Classical forcesBonded (harmonic) + nonbonded (LJ shifted) + optional electrostatics
2. QCloud couplingForce deltas on selected regions, bounded and capped
3. ML residualLearned corrections, scaled when QCloud active
4. Langevin integratorVelocity-Verlet with thermostat: v += dt/2 * F/m, x += dt * v
5. State updateNew positions and velocities stored in state registry
6. Back-mappingCG → AA via interpolation (post-simulation)

eval_stride architecture

The eval_stride parameter controls the frequency of full QCloud + ML evaluations:

The appropriate eval_stride depends on the cost of the refinement layer and the objectives of the run. In practice, it functions as the main trade-off between refinement frequency and throughput.

QCloud feedback loop

The event analyzer tracks per-particle correction magnitudes with exponential decay. Spikes beyond the baseline trigger event classification and priority score updates that feed back into the next region selection cycle. This creates a closed-loop prioritization mechanism.