Skip to content

MCCL Getting Started on Mac

Carole Hayakawa edited this page Sep 15, 2020 · 15 revisions

Getting the MCCL application

Download the application from GitHub:

  • Download latest version for your operating system from Releases
  • Once the zip file has been downloaded, extract or unzip contents
  • The downloaded files include:
    • mc - the MCCL executable
    • infile_* - several sample input files
    • *.m, jsonlab folder - MATLAB scripts to enable viewing the results using MATLAB

Running a sample input file

The sample input files are named infile_*, where * indicates the source, tissue and detector definitions designated within the file. Note that the default source definition is a point source perpendicular to the tissue surface and when the infile has this source definition, it is not part of the name. For example, the infile "infile_one_layer_all_detectors.txt" designates a point source, one layer tissue and all detectors currently available.

To run on OSX:

  • Requirements: dotnet runtime 2.1 - instructions here
  • Unzip or copy downloaded folder into a desired location
  • Change directory "cd foldername"
  • The file permissions get reset when zip is made, so to set them for all files type "chmod 644 *"
  • Make the MCCL an executable file "chmod 755 mc"
  • To run sample infile "./mc infile=infile_one_layer_all_detectors.txt"
  • Output to the screen will be similar to that shown in figure above will be displayed
  • Output will be in folder named by infile "OutputName"
  • To view plots of results using Matlab, see next section

Viewing the results using MATLAB

For linux, Mac and Windows:

  • Requirements: MATLAB R2011b and higher
  • After running a sample infile, a folder will be created in the current directory. For the infile described above, "infile_one_layer_all_detectors.txt", the folder will be named "one_layer_all_detectors"
  • Bring up MATLAB and edit the script file load_results_script.m. Set "datanames = { ' one_layer_all_detectors' };" (see figure below) and save changes
  • Execute this script by typing "load_results_script" at the MATLAB prompt
  • Plots of the all detector results specified in the infile will come to the screen

Load Results Script

Clone this wiki locally