fangqq/mcx repository overview

⁠MCX - GPU-accelerated 3D Light Transport Simulator

Monte Carlo eXtreme, or MCX, is a Monte Carlo photon simulator for modeling light transport in 3D turbid media. It uses NVIDIA graphics processing units (GPUs) to simulate thousands of photons simultaneously, making it one of the fastest and most accurate photon modeling tools.

This docker image contains NVIDIA CUDA runtimes as well as the mcx binary package (including executable mcx, examples under /mcx/examples and other files). You can only execute simulations on a host that has NVIDIA GPUs and a working driver.

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

docker pull fangqq/mcx:v2025.10

you can then execute simulations via

# to list all supported GPUs
docker run --rm --gpus all "fangqq/mcx:v2025.10" mcx -L

# to list built-in benchmarks
docker run --rm --gpus all "fangqq/mcx:v2025.10" mcx --bench

# to run built-in benchmark
docker run --rm --gpus all "fangqq/mcx:v2025.10" mcx --bench cube60

# to run a simulation using the `input.json` input file in the current host folder
docker run --gpus all -v `pwd`:/data "fangqq/mcx:v2025.10" mcx -f /data/input.json