2025/07/19 by Treize, Roberts
#FOS: Physical sciences #Soft Condensed Matter (cond-mat.soft)
paper · doi:10.48550/arxiv.2508.03701
This paper presents MHDMacroscopicballanalysis, an open-source Python toolkit developed to study the rotational dynamics of magnetized spherical particles immersed in viscous media under externally applied rotating magnetic fields. The toolkit extracts the orientation of the magnetic moment from grayscale video frames using image processing and enables detailed comparisons with synchronized magnetic field vector data. We outline the motivation, core algorithms, implementation, and validation of the toolkit in the context of macroscopic experiments simulating magnetohydrodynamic (MHD) particle behavior. The full source code and documentation are freely available on GitHub at https://github.com/robertstreize/mhd-rotation-tools, with a citable version archived on Zenodo at https://doi.org/10.5281/zenodo.1234567.