BMC

BMC is a cross-platform GPU-accelerated Monte Carlo simulation toolkit for photon radiotherapy with magnetic field effect considered. It is the main research work for my PhD study in the Medical School of Washington University in St. Louis. It includes many tools to perform Monte Carlo simulations for photon therapy, mainly designed the ViewRay's MRIdian MRI-guided radiotherapy platform. BMC simulations usually run many times (e.g. 42) faster than ordinary CPU version. Simulation of multi-beam complex treatment plans only takes 2.3 minutes in average to perform 0.5 billion "effective" photon histories. Three GUI tools are also provided to simplify user's operations, one of which is shown as follow

Papers

• A GPU-accelerated Monte Carlo dose calculation platform and its application toward validating an MRI-guided radiation therapy beam model

• Development of a fast Monte Carlo dose calculation system for online adaptive radiation therapy quality assurance

Dependency list:

• PINIT
• mathgl-2.3.2
• dcmtk-3.6.1
• zlib-1.2.11
• szip-2.1.1
• hdf5-1.8.19
• matio-1.5.10

They are all open-source and available from my another project named Dependencies.

Build guide:

• Download or git clone this BMC project

• Download or git clone my another project named Dependencies, and place it in the same level directory as BMC. It should look like this:

    MyProject
    |-BMC
    |-Dependencies
  

• Install the required tools for Windows or Linux platform (Linux have too many distributions, so you have to resolve the dependencies by yourself!)

1. Linux (Ubuntu 16.04.3 x64):

• clang and config (g++ seems to generate buggy codes for BMC. clang will generate correct codes.)

      sudo apt install clang libomp-dev
      sudo update-alternatives --config c++
  

• g++, gfortran

• cmake

• CUDA Toolkit 8 or 9 (8 tested on 14.04, 9 tested on 16.04)

  • first install the appropriate Nvidia driver(CUDA 9 minimum 384.00), then install the run file (do not use deb package) with GPU driver unselected.
  • for opengl only, instill sudo apt install mesa-common-dev libglu1-mesa-dev freeglut3-dev

• libgtk-3-dev

• libmatio-dev

• p7zip-full (for gMeshMM to call 7z) & curl (to send email when job is finished

2. Linux (Fedora 26 no fully tested):

• clang
• gfortran
• cmake
• CUDA Toolkit 8 or 9 (9 tested on Federa 26)
  • Install Nvidia driver first, then install run file without GPU driver selected
  • For openGL, install mesa-libGLU mesa-libGLU-devel
• gtk3-devel
• matio-devel
• p7zip + p7zip-plugins, curl

3. Windows (Win10 x64) (PINIT precompiled by ICC):

• Visual Studio 2015 or 2017 professional (2017 with update 3)

• CUDA toolkit 8 (VS 2015) /9 (VS2017, VS2015)

• cmake (>= 3.8.2), and add it to environment variable %path%

• Optional: MinGW gfortran x64 (PINIT.dll was precompiled by ICC. You can also use MinGW gfortran to recompile it, but it may bring more dll dependencies)

• Optinal (preincluded): 7z.exe (for gMeshMM to call 7z) & trash.exe & curl (to send email when job is finished).

• Build command

  • For Windows, open the attached Visual studio prompt (your may need to create it by yourself due to version and installation variance. Please change working directory to BMC) in the folder BMC, and type in build.bat. You can type in 'cleanALL.bat' to clean the whole build.
  • For Linux, open the terminal in the folder BMC and type in ./build.sh (you may need to do chmod +x build.sh and "Dependencies/wxWidgets-3.1/src/stc/gen_iface.py" first). You may need to retype in ./build.sh some times because make -j may have some file copy conflicts. You can type in './cleanALL.sh' to clean the whole build.

Run BMC

The executable files and running configurations are all in folder BMC/RunBMC

Since github restricts the largest uploading file size to 100M, I have to compress ViewRayCo.phsp by 7zip. You should extract it by 7zip and put it at the same place of ViewRayCo.7z before running BMC simulations.

In Windows, you should also run installDoseViewer.bat and installTetViewer.bat in 'RunBMC/Setup' to setup necessary association and copy 7z.exe and trash.exe to BMC/RunBMCdirectory

In both platform, the directory RunBMC is portable. You can move (better copy) it to wherever you want.

Disclaim

BMC is release without any warranty of its accuracy or correctness even though it has been well validated though many experiments. It''s currently for research only. Use with caution when applying to the real medical cases!

BMC was mainly developed on Windows platform, and Linux platform hasn't been thoroughly tested. However, most of the tools function correctly. If you run into any bug, please report to yuhewang.ustc@gmail.com

I will handle it as soon as possible. Thank you!