MOP-MCML: A User Guide and Technical Introduction

Posted on In Word count in article: 1.5k Reading time ≈ 5 mins.
A practical, theory-grounded guide to the MOP-MCML simulator for modeling photon transport in layered biological tissues, featuring Mean Optical Path (MOP) analysis and enhanced visualization.

This manual provides a comprehensive guide for researchers modeling light propagation in biological tissues. Building upon the foundational physical models of standard MCML, the MOP-MCML framework extends capabilities to quantify the Mean Optical Path (MOP) traversed by photons from emission to detection. This document details the underlying principles, new features, input/output specifications, visualization tools, and a complete end-to-end workflow with validation examples.

1. Background and Objectives

In the design of wearable or implantable biomedical systems, Near-Infrared Spectroscopy (NIRS) is a cornerstone technology for assessing tissue physiology. However, relying solely on surface measurements of Reflectance () and Transmittance () is often insufficient for engineering robust sensors. Practical design requires a deeper understanding of internal photon behavior, specifically:

  • "Reachability": Does light penetrate to the target layer (e.g., muscle or deep vessels)?
  • Pathlength: What is the effective optical pathlength for applying the Beer-Lambert law?

MOP-MCML addresses these needs by introducing:

  • Configurable geometric detection regions (photodiodes).
  • User-defined source profiles (Point, Gaussian, Flat-top).
  • Direct computation and visualization of the Mean Optical Path (MOP).
  • Device-consistent estimation of and .

2. Overview of MCML

The Monte Carlo Multi-Layer (MCML) model, developed in the 1990s, remains the gold standard for steady-state optical simulations in turbid media [1]. It models tissue as a semi-infinite stack of layers aligned along the -axis. Each layer is defined by its optical properties at a specific wavelength :

Where:

  • : Absorption coefficient ()
  • : Scattering coefficient ()
  • : Anisotropy factor (dimensionless)
  • : Refractive index

The reduced scattering coefficient is given by .

MCML simulates photon packets undergoing random walk events (absorption, scattering, reflection/refraction) [2]. The statistical error of the simulation decreases with the total number of photon packets :

3. Simulation Principles and Computational Methods

3.1 Photon Packets and Free-Path Sampling

The step size between interaction events is sampled from an exponential distribution:

In biological tissues (visible–NIR), the mean free path ranges from to . After each step, the photon's weight is attenuated by absorption, and its direction is updated using a phase function (e.g., Henyey–Greenstein).

3.2 Computing Reflectance and Transmittance

Standard MCML calculates and by accumulating all photons exiting the upper or lower surfaces, effectively assuming an infinite detector.

MOP-MCML introduces finite detectors. We define rectangular Photodiodes (PDs) on the reflection ( ) and transmission ( ) planes. Reflectance and Transmittance are calculated only from photons striking the active area:

Where is the count of photons hitting the specific PD geometry. This approach aligns simulation results with real-world sensor measurements.

3.3 Mean Optical Path and Penetration Depth

For the detected photon trajectories [3], the total pathlength of the -th photon is .

We define the Intensity-Weighted Mean Optical Path (), which is most relevant for intensity-based sensing:

Under the diffusion approximation, the theoretical penetration depth is:

This theoretical value serves as a benchmark for verifying numerical results.

4. Source–Detector Separation and DPF

4.1 Source–Detector Separation (SDS)

Geometry is critical in NIRS. MOP-MCML allows precise placement of sources and detectors. The SDS is calculated as:

  • Reflection Mode:
  • Transmission Mode:

4.2 The Differential Pathlength Factor (DPF)

The Modified Beer–Lambert Law (MBLL) relates absorbance changes to absorption changes :

We can express in terms of the geometric distance and a scaling factor, the DPF:

In the diffusive regime, is relatively constant, meaning scales linearly with . MOP-MCML allows you to calculate directly for complex, multilayer geometries where analytical solutions fail.

5. From MCML to MOP-MCML: Key Extensions

5.1 Measurement Geometry Modeling

MOP-MCML adds specific geometric definitions to the input file:

  • detectors: Rectangular PDs defined by center coordinates and side lengths.
  • Sources:
    • Type 1: Point Source
    • Type 2: Gaussian Beam
    • Type 3: Flat-top Uniform Beam

5.2 Enhanced Output Statistics

New outputs include:

  • Device-consistent and : Based on finite detector aperture.
  • : Intensity-weighted mean optical path.
  • Summary File: A summary.csv is automatically generated, appending and from batch runs for easy analysis.

5.3 Improved I/O and Visualization

The output .mco file format is extended to include geometric metadata. This enables the MATLAB visualization scripts to:

  • Draw exact source and detector positions.
  • Visualize the source profile (e.g., inverted triangle for point, semi-transparent shape for area).
  • Overlay these on the photon fluence map for clear interpretation.

6. Installation and Usage

6.1 Clone and Build

MOP-MCML is written in C.

1
git clone https://github.com/Pasdeau/MOP-MCML.git

Build Commands:

  • Linux/macOS:
    1
    gcc -O3 -o mop-mcml *.c -lm
  • Windows: Use Visual Studio with Release configuration and /O2 optimization.

6.2 Input File (.mci) Essentials

The input file structure dictates the simulation. Key additions for MOP-MCML are the source type and geometric coordinates for PDs. Ensure strict adherence to the format (avoid sparse blank lines between data blocks).

6.3 Running the Simulation

1
./mop-mcml your_input_file.mci

6.4 MATLAB Visualization

Using the provided MATLAB scripts:

  1. Parse: Read the .mco file.
  2. Render: Use imagesc to plot .
  3. Overlay: The script automatically draws the source (top) and detectors (reflection/transmission) based on the file metadata.

7. Validation Results

We verified MOP-MCML against analytical models and standard test cases.

  1. Single-Layer Tissue ( nm):
    • Simulated penetration depth agreed with diffusion theory ( cm) within .
    • Transmittance matched theoretical expectations.
  2. Non-Scattering Medium:
    • Compared against Beer-Lambert Law ( ).
    • Error was across .

8. Practical Guide: Parameter Selection

  1. Photon Count: Start with for quick scans, then use or for final high-precision results.
  2. SDS Optimization: Use batch mode to scan multiple SDS values to find the sweet spot between signal strength () and penetration depth.
  3. Detector Sizing: Match the simulated PD size to your physical hardware (e.g., mm) to get realistic photon counts.
  4. Troubleshooting: If MATLAB fails to parse .mco, check if the geometric metadata lines exist at the end of the file. Legacy readers may need updates.

9. Examples

A. Batch Simulation Input (.mci)

This example defines two runs with different source wavelengths ( nm vs nm).

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
1.0   # file version
2     # Number of runs

### Run 1: Fat 700nm ###
fat700.mco A  # Output file
200000        # Photon count
0.001 0.002   # dz, dr
1000 1000 1   # Grid dimensions

1             # Number of layers
1.0           # n_ambient
# n     mua   mus   g    d
1.455 1.11  122   0.90 1.0 
1.0           # n_bottom

1.2 0.0 0.05 0.8 0.0 0.05  # PD Geometry: Rx Ry Rl Tx Ty Tl
1   0.8 0.0 0.05           # Source Geometry: Type x y Size

### Run 2: Fat 800nm ###
fat800.mco A
...

B. Visualization: Optical Path Distribution

The figure below compares Reflection Mode (left) and Transmission Mode (right). Note how photon paths distribute differently, affecting the sampled volume.

C. Multilayer Ankle Model

A complex model simulating light propagation through Epidermis, Dermis, Hypodermis, and Ligament layers. By setting SDS mm, we verified that photons successfully probe the ligament layer ( mm).

References

[1] S.L. Jacques. "History of Monte Carlo modeling of light transport in tissues using mcml.c." J. Biomed. Opt., 27(8), 083002, 2022. DOI: 10.1117/1.JBO.27.8.083002.
[2] S. Chatterjee, P.A. Kyriacou. "Monte Carlo Analysis of Optical Interactions in Reflectance and Transmittance Finger Photoplethysmography." Sensors, 19(4), 2019. DOI: 10.3390/s19040789.
[3] S. Chatterjee et al. "Monte Carlo investigation of the effect of blood volume and oxygen saturation..." Biomed. Phys. Eng. Express, 2(6), 065018, 2016. DOI: 10.1088/2057-1976/2/6/065018.
[4] A.N. Bashkatov et al. "Optical properties of skin, subcutaneous, and muscle tissues: a review." J. Innov. Opt. Health Sci., 4(01): 9–38, 2011. DOI: 10.1142/S1793545811001319.
[5] I. Saliba, W. Wang et al. "A Review of Chronic Lateral Ankle Instability..." J. Clin. Med., 13, 442, 2024. DOI: 10.3390/jcm13020442.