fangqq/mcxlab repository overview

⁠MCXLAB - MATLAB/Octave Integrated MCX

MCXLAB is the native MEX version of MCX for MATLAB and GNU Octave. It compiles the entire MCX code into a MEX function which can be called directly inside MATLAB or Octave. The input and output files in MCX are replaced by convenient in-memory struct variables in MCXLAB, thus, making it much easier to use and interact. MATLAB/Octave also provides convenient plotting and data analysis functions. With MCXLAB, your analysis can be streamlined and speed- up without involving disk files.

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

docker pull fangqq/mcxlab:v2025

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

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

# to list built-in examples
docker run --rm --gpus all "fangqq/mcxlab:v2025" octave-cli --eval "cd /mcxlab/examples; demo_mcxlab_basic"

# 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/mcxlab:v2025" octave-cli --eval "/app; run_my_simulation"