fangqq/mmc repository overview

⁠MMC - Mesh-based Monte Carlo for complex media

Mesh-based Monte Carlo, or MMC, is a Monte Carlo (MC) solver for photon migration in 3D turbid media. Different from existing MC software designed for layered (such as MCML) or voxel-based media, MMC can represent a complex domain using a volumetric mesh. This not only greatly improves the accuracy of the solutions when modeling objects with curved/complex boundaries, but also gives an efficient way to sample the problem domain and uses less memory. The current version of MMC supports SSE4 on the CPU as well as OpenCL based massively parallel computing on NVIDIA/AMD/Intel CPUs and GPUs.

A list of publications related to MMC (including DMMC, MMC-SSE4, MMC-OpenCL and wide-field MMC) can be found at http://mcx.space/wiki/index.cgi?Citation#MMC⁠

To use this package, please first pull this image to your local OS by

docker pull fangqq/mmc:v2025

you can then execute simulations via

# to list the supported GPUs
docker run --rm --gpus all "fangqq/mmc:v2025" mmc -L

# to run a simulating using the `input.json` input file in the current host folder
docker run --gpus all -v `pwd`:/app "fangqq/mmc:v2025" mmc -f /app/input.json