fangqq/mcxstudio repository overview

⁠MCXStudio - An all-in-one package for the full MCX/MMC suite (including iso2mesh)

MCXStudio-all-on-one package contains everything you need to run MCX/MMC simulations. This image contains all executables mcx/mcxcl/mmc as well as the matlab/octave interface mcxlab/mmclab/mcxlabcl functions. In addition, it also bundled iso2mesh/zmat to utilize all mesh generation functionalities for pre- and post-processing for mmc, visualization and other general purpose use.

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

docker pull fangqq/mcxstudio:v2025

you can then execute simulations via Octave commands that invokes mcxlabcl and other provided functions

# to list all supported GPUs
docker run --rm --gpus all "fangqq/mcxstudio:v2025" octave-cli --eval "mcxlabcl('gpuinfo')"

# to list all supported GPUs using executables
docker run --rm --gpus all "fangqq/mcxstudio:v2025" mcxcl -L

# to list built-in examples
docker run --rm --gpus all "fangqq/mcxstudio:v2025" mcx --bench cube60planar

# to run a simulating using the `run_my_simulation.m` input file in the current host folder
docker run --gpus all -v `pwd`:/app "fangqq/mcxstudio:v2025" octave-cli --eval "/app; run_my_simulation"