This repository implements both F- and X-engines for a GPU-based correlator, developed for the MeerKAT Extension Radio Telescope by the South African Radio Astronomy Observatory (SARAO). A B-engine for beamforming is planned, but not yet included.

Detailed documentation can be found in the doc/ folder, and can be built with Sphinx. Included is also a guide for development.

The following requirements are what we consider to be the minimum for making use of this module. Listed are the tested / supported software versions and hardware generations. Other platforms may well work, but have not been tested.

• An Nvidia GPU. For the XB-engine, it needs to be of compute capability 7.2 or greater and have tensor cores.
• Mellanox OFED Drivers v5.3.1 for ibverbs functionality. (Any v5+ should work.) For best performance, ibverbs is recommended. Currently fgpu can operate without ibverbs, but the functionality is not available (yet) in xbgpu.

• Ubuntu 20.04
• Python 3.8.
• CUDA version 11.4. (Most early development was done using 10.1, which may still work but has not been tested for some time.)