Coordinates

QC Lab uses a complex-valued classical coordinate formalism to implement both Models and Algorithms. This enables simulations in QC Lab to be entierly invariant to the representation in which they are carried out. As such, the same algorithm can simulate a model in real or reciprocal space (or indeed, any space at all) without modification. The complex-valued classical coordinate formalism is introduced in detail in Miyazaki et al. 2024. We include a brief description of the formalism here and document some useful functions for converting between real-valued and complex-valued coordinates.

Complex-valued coordinate in QC Lab are denoted as z by convention whereas the real-valued position and momentum coordinates are q and p, respectively. The complex-valued coordinate can be constructed from the real-valued coordinates and the coordiante masses by introducing a set of “weights” h which is denoted classical_coordinate_weight in the Model object.

\[z_{n} = \sqrt{\frac{m_{n} h_{n}}{2}}\left(q + i\frac{p}{m_{n} h_{n}}\right)\]

Readers with a keen eye may notice that \(h_{n}\) has the same role of a frequency in relating the relative displacements of position and momentum. For that reason, it is often a convenient choice when working with harmonic oscillators to set \(h_{n}\) to the harmonic frequency. Algorithms in QC Lab are implemented in a manner that is invariant of the choice of weights. Likewise, ingredients in QC Lab are also invaraint to the choice of weights. However, Models may enforce some choice of weights as part of their initialization rather than enabling this to be changed by a user.

Conversions to and from complex-valued classical coordinates are conveniently implemented in the following functions.