https://github.com/marcelinohermida/MUSIMAN

MUltiple SImulations MANagement for the PENELOPE 2014 Monte Carlo code for the simulation of radiation transport
https://github.com/marcelinohermida/MUSIMAN

Last synced: 12 days ago
JSON representation

MUltiple SImulations MANagement for the PENELOPE 2014 Monte Carlo code for the simulation of radiation transport

• Host: GitHub
• URL: https://github.com/marcelinohermida/MUSIMAN
• Owner: marcelinohermida
• Created: 2016-03-17T09:45:46.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2017-01-24T19:42:05.000Z (over 7 years ago)
• Last Synced: 2024-03-02T13:32:48.135Z (4 months ago)
• Language: Matlab
• Homepage:
• Size: 1.14 MB
• Stars: 3
• Watchers: 3
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Lists

• awesome-medphys - MUSIMAN - MUltiple SImulations MANagement. The Monte Carlo code for radiation transport PENELOPE 2014. (Applications)

README

        
# MUSIMAN

MUltiple SImulations MANagement v. 1.0

The Monte Carlo code for radiation transport PENELOPE 2014 [1] includes an auxiliary program named penmain-sum to combine the results of independent runs of the same simulation problem allowing to use multiple computing cores simultaneously. Thus, the simulation efficiency increases linearly with the available number of cores. Each independent run produces a dump file with the partial results of the simulation with accumulated statistics. The tool penmain-sum combines all dump files to get the final results of the simulation.

The process of manually generating the simulation files needed for multiple independent runs is tedious and error-prone. The MATLAB scripts from the MUSIMAN package automate this process. Briefly, the scripts take care of:

1. Creating the files needed for an arbitrary number of independent runs of the same simulation problem. A different pair of seeds for the random number generator is assigned to each run, taken from the list in the rita.f source file included in PENELOPE 2014, which was obtained with the algorithms from the work of Badal and Sempau [2]. Each consecutive pair of seeds in the list is separated from the following pair by 10^14 positions. In this way, we ensure that each simulation run uses independent sequences of pseudo-random numbers.

2. Launching simultaneously a number of parallel independent simulation runs.

3. Preparing the dump files to be combined with penmain-sum to obtain the final results of the simulation.

In summary, the MUSIMAN package is a software tool to ease the parallelization of simulations run with the Monte Carlo code PENELOPE 2014 that use penmain as steering main program. Detailed instructions are included in the file Instructions.pdf.

MUSIMAN was developed to speed-up some of the simulations from the doctoral dissertation of the author. If you find this tool useful for your research, please use this citation:

M. Hermida-López, Improvements to the dosimetry of 106Ru/106Rh ophthalmic plaques: Monte Carlo simulations and radiochromic film measurements. Doctoral dissertation (Universität Duisburg-Essen, 2016). Available at http://duepublico.uni-duisburg-essen.de/servlets/DocumentServlet?id=43110&lang=en

Enjoy your simulations!

References:

[1] Salvat, F. PENELOPE–2014: A code system for Monte Carlo simulation of electron and photon transport. 2015. OECD/NEA Data Bank, Issy-les-Moulineaux, France.

[2] A. Badal and J. Sempau. A package of Linux scripts for the parallelization of Monte Carlo simulations. Comput. Phys. Commun., 175(6):440–450, 2006.