HASMI: A configurable Python framework for automated harmonic analysis and scan orchestration at EMIL

We present HASMI (Harmonic Analyzer State Machine Interface), a highly configurable Python framework designed to automate data acquisition and analytical tasks for optimizing coordinated undulator and monochromator movements at synchrotron beamlines. Built upon EPICS, HASMI features a comprehensive scan library and a command-line interface for managing multi-actuator scans. The framework offers extensive customization through a user-configurable database for defining scan types, actual scan parameters, and user preferences. Integrated analytical tools enable precise identification of undulator harmonic positions using advanced techniques such as convolution and customized cross-correlation. Beamline operations are automated and parameterized through a generalized state machine, which provides both an intuitive command-line interface and a dedicated EPICS interface. The state machine operates efficiently as a continuous background service alongside the monochromator IOC. By integrating multiple alignment scans, visualization, and automated data analysis into a streamlined 'one-button' procedure, HASMI significantly enhances the speed, performance, and reliability of beamline operations for users of the four hard X-ray CPMU17-DCM branches at EMIL.