MuSTEM is a transmission electron microscopy (TEM) simulation suite, in particular for scanning transmission electron microscopy (STEM) images, that was developed mainly at the University of Melbourne. The computing suite is based on the multislice method. More detail can be found in the manual and the following scientific paper:
GPU version PGI Visual Fortran and Microsoft Visual Studio
CPU version Any Fortran 90 compiler and MKL libraries (for fast Fourier transform routines)
<<<<<<< HEAD MuSTEM is built using the PGI Fortran compiler and Microsoft Visual Studio 2015, please make sure that this software is correctly installed before proceeding. Create a new Visual Studio project and add the source code (all .f90 files) contained in this repository. Modify the project properties so that Microsoft Visual Studio passes the following commands to the PGI compiler:
MuSTEM is built using the PGI Fortran compiler and Microsoft Visual Studio 2015, please make sure that this software is correctly installed before proceeding. Create a new Visual Studio project and add the source code contained in this repository. The GPU version of the code requires the source files in the GPU_routines folder and the CPU only version of the code requires the source files in the CPU_routines folder. Modify the project properties so that Microsoft Visual Studio passes the following commands to the PGI compiler:
ac5e79459831b613bf2ae10ceac423c70be45b81
Build commands:
-Mpreprocess -Bstatic -Mbackslash -mp -Mcuda=cuda8.0 -I"C:\Program Files\PGI\win64\17.3\include" -I"c:\program files\pgi\win64\17.3\include" -I"C:\Program Files\PGI\Microsoft Open Tools 14\include" -I"C:\Program Files (x86)\Windows Kits\10\Include\shared" -I"C:\Program Files (x86)\Windows Kits\10\Include\um" -fast -ta=tesla -Minform=warn
To build the single precision version add the command -Dsingle_precision. For the Double precision version add the command -Ddouble_precision. To build the GPU version (requires the PGI compiler) add the command -Dgpu. The code also requires recursive routines to be enabled (The /recursive command in the Intel Visual Fortran compiler) for correct calculation of the absorptive form factors.
Linker commands:
-Bstatic -mp -Mcuda=cuda8.0 -ta=tesla -o"$(Outdir)\MuSTEM_Open.exe" -Wl,/libpath:"C:\Program Files\PGI\win64\17.3\lib" -Wl,/libpath:"C:\Program Files\PGI\win64\2017\cuda\8.0\lib64" cufft.lib
The links to the PGI CUDA libraries and Windows kits may need to be modified depending on the install directories. $(Outdir) represents the output directory of the Microsoft Visual Studio build.
Some example simulations are included on the MuSTEM website.
Please contact Dr. Hamish Brown with project suggestions and contributions.
- Professor Les J Allen
- Dr. Hamish G Brown - Maintainer
- Dr. Adrian J D'Alfonso
- Dr. Scott D Findlay
- Dr. Ben D Forbes
This project is licensed under the GNU GPLv3.0 - see the LICENSE.txt file for details.
Les Allen, Adrian D'Alfonso and Scott Findlay originally took the initiative to make this code publicly available, with Adrian D'Alfonso taking on the considerable task of setting up the GPU code. Hamish Brown and Ben Forbes have subsequently made substantial refinements and extensions, with Ben Forbes responsible for several efficiency improvements. The code was developed mainly at the University of Melbourne. We would like to acknowledge the contributions of Mark Oxley and Chris Rossouw to the theoretical and numerical aspects of collaborative research that underpins μSTEM 4.9.
In particular, the code IONIZER, whose primary author has been Mark Oxley, was used to set up the parametrized atomic scattering factors for ionization used in μSTEM 4.9. Eireann Cosgriff, Torgny Josefsson, Nathan Lugg, Andrew Martin, Gary Ruben and Chris Witte have been or still are members of the group at Melbourne University at various stages and all made contributions to our understanding of inelastic scattering and the simulation thereof.