mumax
Overview
Mumax is a GPU-accelerated micromagnetic simulation program developed at the DyNaMat group of Prof. Van Waeyenberge at Ghent University. The code is written and maintained by Arne Vansteenkiste.
Version 3.10beta is installed on the CSF.
Restrictions on use
There are no restrictions on accessing the software on the CSF. It is released under the GPL v3 License and all usage should adhere to that license.
All users are requested to cite their use of Mumax in any publications that arise from that usage: “The design and verification of mumax3”, AIP Advances 4, 107133 (2014).
Set up procedure
We now recommend loading modulefiles within your jobscript so that you have a full record of how the job was run. See the example jobscript below for how to do this. Alternatively, you may load modulefiles on the login node and let the job inherit these settings.
Load one of the following modulefiles:
module load apps/binapps/mumax/3.10beta
The modulefile will automatically load the required CUDA modulefile for you.
The following programs are available:
mumax3 mumax3-convert mumax3-httpfsd mumax3-plot mumax3-script mumax3-server
Running the application
Please do not run mumax on the login node. Jobs should be submitted to the GPU nodes via batch. Note that there is no need to specify a particular GPU id on the mumax command-line. Your job will be assigned a specific GPU and the software will automatically use that GPU.
GPU batch job submission
Create a batch submission script (which will load the modulefile in the jobscript), for example:
#!/bin/bash --login #$ -cwd # Job will run from the current directory # NO -V line - we load modulefiles in the jobscript #$ -l v100=1 # Use a single GPU #$ -pe smp.pe 8 # (Optional line) Use up to 8 CPU cores per GPU. # We now recommend loading the modulefile in the jobscript (use your required version) module load apps/binapps/mumax/3.10beta mumax3 my_simulation.mx3
Submit the jobscript using:
qsub scriptname
where scriptname is the name of your jobscript.
Post-processing
The job will create an output directory named my_simulation.out. In there you will find various output files including the .ovf file generated by mumax3. You can can convert these to images, such as PNG images, using:
mumax3-convert -png m000000.ovf # # Will write out: m000000.png
See the mumax3-convert online documentation for more information.
To plot the values in the generated table.txt file you should do the following to use the mumax3-plot utility:
module load apps/dpsf apps/gnuplot/5.0.2 mumax3-plot table.txt # # Will write out: m.svg
See the mumax3-plot online documentation for more information.
Further info
Updates
None.