3D HW

[oparry-ukaea]

Description

Add 3D HW equation system to the H3LAPD solver.
Resolves #214

Type of change

• New feature (non-breaking change which adds functionality)

Testing

HWTest.3DHWGrowthRates (in test/integration/solvers/H3LAPD/test_H3LAPD.cpp)

Runs the H3LAPD solver with the "HW3DSystem" equation system for a small number of steps with periodic BCs on all sides.
Particle number is set to 0.
Tests that growth rate of enstrophy matches analytical expected rate (see equation 9 in [this ref]).(https://pubs.aip.org/pop/article/6/6/2401/263757/Resistive-drift-wave-turbulence-in-a-three).
Passes iff rate matches to a tolerance of 5e-3 AND the solver returns 0.

N.B. Test of energy growth rate is turned off for now. (To be reviewed later).

Test Configuration:

OS: Ubuntu 22.04
Compiler: GCC 11.4.0 / OneAPI v2024.1.0
SYCL implementation: Hipsycl v0.9.4 / DPC++ v2024.1.0
MPI details: MPICH v4.0.2 / Intel MPI 2021.8 Build 20221129
Hardware: CPU (Intel Alder Lake)

Checklist:

• I have added tests that prove my fix is effective or that my feature works
• New and existing unit tests pass locally with my changes
• I have used understandable variable names
• I have run clang-format against my *.hpp and *.cpp changes
• I have run cmake-format against my changes to CMakeLists.txt
  - [ ] I have made corresponding changes to the documentation
• I have performed a self-review of my own code
• I have commented my code, particularly in hard-to-understand areas
• My changes generate no new warnings