MagneticReadoutProcessing is a Python library that makes it possible to store and further process raw data from magnetometers. The focus is on the processing of point clouds, on which the points are located on a circular path around a magnetic object to be viewed. Measurement data (hemisphere) can later be combined into a full 3D scan, visualized and compared with reference measurements. Its intended development purpose was to analyse permanent magnets in order to generate optimized hallbach arrays.


Marcel Ochsendorf¹

Estimated cost

Total price (material costs)


stable release

License: MIT

In the construction of low-field MRI devices based on permanent magnets, a large number of magnets are used. In order to realize a homogeneous B0 field with these magnets, which is necessary for many setups, the magnetic properties of these magnets have to be as similar to a certain degree. Due to the complex manufacturing process of neodymium magnets, the different properties, the direction of magnetization, can deviate from each other, which affects the homogeneity of the field. To adjust the field afterwards, a passive shimming process is typically performed, which is complex and time-consuming and requires manual corrections to the magnets used. To avoid this process, magnets can be systematically measured in advance. In this methodology, the recording, data storage and subsequent evaluation of the data play an important role. Various existing open-source solutions implement individual parts, but do not provide a complete data processing pipeline from aqusation to analysis and the data storage formats of these are not compatible to each other. For this use case, the MagneticReadoutProcessing library was created, which implements all major aspects of acquisition, storage, analysis, and each intermediate step can be customized by the user without having to create everything from scratch, favouring an exchange between different user groups. Complete documentation, tutorials and tests enable users to use and adapt the Framework as quickly as possible. The framework for the characterization of different magnets, which requires the integration of magnetic field sensors, was used for the evaluation.


Ochsendorf, Marcel, “Development of a permanent magnet characterisation framework for use in low-field MRI systems”, 29/02/2024, 10.13140/RG.2.2.36430.64325



1FH Aachen, RWTH Aachen