MAZE2D: A Monte Carlo usercode for EGS4

Download here: http://members.lycos.co.uk/hugtenburg/maze2d.zip

Richard Hugtenburg

School of Physics and Astronomy

University of Birmingham

This code has been built using the Monte Carlo library of codes, EGS4, and is generally used in conjunction with this code. A FORTRAN-77 listing has been provided for Solaris f77 and Linux/CYGWIN g77 compilers which may need some modification to compile for other platforms. The correct usage is to compile the maze2d.mortran listing with the tools provided in the EGS4 distribution which is available for a wide range of operating systems. Obtainable from:

http://www.irs.inms.nrc.ca/inms/irs/EGS4/get_egs4.html

http://www.slac.stanford.edu/egs/

MAZE2D is a user-code designed to calculate 3D transport in a simple closed 2D topology defining the walls of an enclosure where the floor and ceiling are assumed to be single levelled. As such the format is ideal for use in combination with a CAD package for the rapid optimisation of the construction of radiation enclosures.

The ZIP compressed format file contains the following:

README.html - distro readme
maze2d.mortran - usercode
maze2d.configuration - required for Mortran compilation in EGS4
maze2d.environment ""
maze2d_sparc.f - Sparc f77 listing
maze2d_Linux.f - Linux and CYGWIN g77 listing
hugtenburg_chapter4.pdf - main documentation
maze1.egs4inp - example input file dicussed in documentation
maze1.egs4out_testcase - expected results
maze1.egs4geom - geometrical data used to displayed enclosure in EGS4Windows
maze1.egs4gph - radiation history data
maze1.jpg - graphical output from EGS_Windows

700c.pegs4dat - example physical data file
p4imixt.pegs4inp - example input file for the creation of new physical data via PEGS4
mohan10.spectrum - Example 10 MV therapeutic linac spectrum

To compile from the Mortran listing under EGS4_Unix3.0

mf maze2d a opt4

To run the example maze1:

ex maze2d maze1 700c

The output can be piped to a file, e.g.:

ex maze2d maze1 700c > maze2d.egs4out (hit return twice!)

Which should give the same results as the example output file given.

The code outputs its data to the screen and needs to be captured or piped into a file if the results are to be stored. A highly useful debugging tool exists in the automated generation of geometry (input_file.geom) and radiation transport (input_file.gph) data files. These can be read by the graphical display package EGS4Windows2.0 which is also downloadable from the following site running under Linux or CYGWIN.

http://www.irs.inms.nrc.ca/inms/irs/EGS_Windows/distribution.html

Figure 1. Output from EGS_Windows for the example file maze1.egs4inp

700c.pegs4lst, p4imixt.pegs4inp and mohan10.spectra have been extracted from the EGS4Unix3.0 distro. 700c.pegs4lst is a set of cross-sections for a variety of common materials (with a 700 keV total energy cutoff for electrons, 189 keV cutoff for photons). Mohan10.spectra is a published linear accelerator spectra included in the EGS4 distro. See A. Kosunen and D.W.O. Rogers, Beam Quality Specification for Photon Beam Dosimetry, Med. Phys. 20 (1993) 1181-8 for further details.

If you use this code please cite the following reference in your publications as follows:

R P Hugtenburg, 1997, Computational methods in radiation oncology, Ph.D. Thesis, University of Canterbury (New Zealand)

Available here in pdf format:

http://members.lycos.co.uk/hugtenburg/hugtenburg_thesis.pdf