Hamiltonian learning reveals optoelectronic mechanisms across thermodynamic state space in soft semiconductors
Predicting optoelectronic response across thermodynamic state space requires coupling finite-temperature nuclear dynamics to electronic structure at scales where direct first-principles calculations are impractical. Machine-learning force fields and Hamiltonian-learning models provide scalable predictions, but integrating them into reliable and interpretable workflows remains challenging. Here, we introduce FLOW-OTTER, a modular, model-agnostic framework that automates molecular dynamics, Hamiltonian prediction, observable extraction, reliability assessment, and Hamiltonian-level interpretation. We demonstrate FLOW-OTTER in halide perovskites, soft semiconductors whose anharmonic fluctuations strongly modulate electronic response. Using FLOW-OTTER, we show that independently learned nuclear and electronic models remain predictive when composed end-to-end, reproducing experimental temperature- and pressure-dependent band-gap trends using models trained only on first-principles targets at zero pressure. By resolving the nonlinear evolution of Pb-$s$/Br-$p$ antibonding at the valence-band maximum, it identifies the microscopic origin of the asymmetric pressure response. FLOW-OTTER thus establishes Hamiltonian learning as a general route from thermodynamic trajectories to experimentally grounded optoelectronic mechanisms.