MCCL Examples

hayakawa16 edited this page Apr 23, 2017 · 11 revisions

Monte Carlo Command Line Options

Command-line Parameters

help - displays brief description of parameters described below
infile - the default is infile.txt in the root of the application, accepts relative and absolute paths
outpath - default is the root of the application, accepts relative and absolute paths
outname - default is the infile name, this value is appended if there is a parameter sweep
paramsweep - takes the sweep parameter name and values in the format:
paramsweep=<SweepParameterType>,Start,Stop,Count
paramsweepdelta - takes the sweep parameter name and values in the format:
paramsweepdelta=<SweepParameterType>,Start,Stop,Delta
geninfiles - generates sample infiles and names them infile_XXX.txt

Values for SweepParameterType

mua1 - absorption coefficient for tissue layer 1
mus1 - scattering coefficient for tissue layer 1
n1 - refractive index for tissue layer 1
g1 - anisotropy for tissue layer 1

mua2 - absorption coefficient for tissue layer 2
mus2 - scattering coefficient for tissue layer 2
n2 - refractive index for tissue layer 2
g2 - anisotropy for tissue layer 2

muai - absorption coefficient for tissue layer i
musi - scattering coefficient for tissue layer i
ni - refractive index for tissue layer i
gi - anisotropy for tissue layer i

Program Structure

Example: Create a folder called MonteCarlo with 2 sub-folders “Application” and “Simulation”. In Application place all the files needed to run mc.exe (Same files as the zip file). In Simulation place any input files, myinfile.txt.

  • MonteCarlo (folder)
    • Application (folder)
    • Simulation (folder)
    • Results (folder)

Possible Inputs

Run the simulation from the Results folder specifying one of the txt input files:

C:\MonteCarlo\Application\mc infile=C:\MonteCarlo\Simulation\myinfile.txt

Input File: C:\MonteCarlo\Simulation\myinfile.txt with OutputName="results" specified in myinfile.txt
Output Path: C:\MonteCarlo\Results
Results Folder Name: results

Run the simulation specifying one of the txt input files and an output folder

C:\MonteCarlo\Application\mc infile=C:\MonteCarlo\Simulation\infile_database.txt outpath=C:\MonteCarlo\NewResults

Input File: C:\MonteCarlo\Simulation\infile_database.txt with OutputName="results" specified in infile_database.txt
Output Path: C:\MonteCarlo\NewResults
Results Folder Name: results

Run the simulation specifying one of the txt input files:

C:\MonteCarlo\Application\mc infile=C:\MonteCarlo\Simulation\myinfile.txt paramsweepdelta=mua1,0.01,0.04,0.01

Input File: C:\MonteCarlo\Simulation\myinfile.txt with OutputName="results" specified in myinfile.txt
Output Path: C:\MonteCarlo\Results
Results Folder Names:

  • results_mua1_0.01
  • results_mua1_0.02
  • results_mua1_0.03
  • results_mua1_0.04

Run the simulation specifying one of the txt input files and an output folder

C:\MonteCarlo\Application\mc infile=C:\MonteCarlo\Simulation\infile_database.txt outpath=C:\MonteCarlo\NewResults paramsweepdelta=mua1,0.01,0.04,0.01

Input File: C:\MonteCarlo\Simulation\infile_database.txt with OutputName="results" specified in infile_database.txt
Output Path: C:\MonteCarlo\NewResults
Results Folder Names:

  • results_mua1_0.01
  • results_mua1_0.02
  • results_mua1_0.03
  • results_mua1_0.04

Run the simulation specifying one of the txt input files and an output folder and an output tag

C:\MonteCarlo\Application\mc infile=C:\MonteCarlo\Simulation\infile_database.txt outpath=C:\MonteCarlo\NewResults outname=myResults paramsweepdelta=mua1,0.01,0.04,0.01

Input File: C:\MonteCarlo\Simulation\infile_database.txt
Output Path: C:\MonteCarlo\NewResults
Output tag: myResults
Results Folder Names:

  • myResults_mua1_0.01
  • myResults_mua1_0.02
  • myResults_mua1_0.03
  • myResults_mua1_0.04
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.