Computer Programs
NEA-1910 PENGUIN.
last modified: 31-MAR-2020 | catalog | categories | new | search |

NEA-1910 PENGUIN.

PENGUIN, graphical user interface for PENELOPE

top ]
1. NAME OR DESIGNATION OF PROGRAM

PenGUIn

top ]
2. COMPUTERS

To submit a request, click below on the link of the version you wish to order. Rules for end-users are available here.

Program name Package id Status Status date
PENGUIN NEA-1910/01 Tested 31-MAR-2020

Machines used:

Package ID Orig. computer Test computer
NEA-1910/01 PC Windows PC Windows
top ]
3. DESCRIPTION OF PROGRAM OR FUNCTION

PenGUIn is a Windows graphical user interface (GUI) for the Monte Carlo code system PENELOPE. It uses the generic main program PENMAIN to perform Monte Carlo simulation of coupled electron-photon transport in material structures consisting of homogeneous bodies limited by quadric surfaces. PENMAIN provides a detailed description of the transport process through a number of simulated distributions, which can be visualized by using the plotting software gnuplot (www.gnuplot.info) and the provided scripts. PenGUIn largely simplifies the use of PENELOPE-PENMAIN. The user can load input files or create them from scratch. The output files and plots of the results can be accessed directly from the interface. PenGUIn also has links to executables of the MATERIAL, TABLES, and SHOWER programs, as well as to the two- and three-dimensional geometry viewers.

top ]
4. METHODS

Program and tools for Monte Carlo simulation of electron-photon transport. Automatic generation and handling of input and output files, graphical visualization of simulation results, geometries, and energy-dependent macroscopic cross sections.

top ]
5. RESTRICTIONS ON THE COMPLEXITY OF THE PROBLEM

The program can track electrons, positrons, and photons with kinetic energies ranging from 50 eV to 1 GeV. However, the adopted interaction models are not expected to be accurate for energies below about 1 keV. X-rays and Auger electrons originating from vacancies in the outer (O, P …) subshells of heavy elements are not followed. Photo-nuclear reactions are disregarded.

top ]
6. TYPICAL RUNNING TIME

The running time largely depends on the number of histories to be simulated, the kind of incident particle, its initial energy and the considered geometry. The adopted simulation parameters (energy cut-offs, etc.) also influence the computing time. As an example, a broad-beam depth-dose distribution of 10 MeV electrons incident on a water phantom, resulting from 100.000 simulated histories, is obtained with a running time of some 180 s on an Intel Core i7/8550U CPU at 1.99 GHz with 16 GB RAM.

top ]
7. UNUSUAL FEATURES OF THE PROGRAM

The mixed simulation algorithm for electrons and positrons implemented in PENELOPE reproduces the actual transport process to a high degree of accuracy and is very stable even at high energies. This is partly due to the use of a sophisticated transport mechanics model for charged particles based on the so-called random hinge method. Other differentiating features of the simulation are a consistent description of angular deflections in inelastic collisions and of energy-loss straggling in soft stopping events. Binding effects and Doppler broadening in Compton scattering are also taken into account.

top ]
8. RELATED OR AUXILIARY PROGRAMS

The original PENELOPE code system (http://www.oecd-nea.org/tools/abstract/detail/nea-1525) and the graphical user interface PENGEOM (definition and debugging of quadric geometries) (http://www.oecd-nea.org/tools/abstract/detail/nea-1886/) are available separately.

top ]
9. STATUS
Package ID Status date Status
NEA-1910/01 31-MAR-2020 Tested at NEADB
top ]
10. REFERENCES
  • J. Sempau, E. Acosta, J. Baro, J.M. Fernandez-Varea and F.Salvat:
    An algorithm for Monte Carlo simulation of the coupled electron-photon transport. Nuclear Instruments and Methods B 132 (1997) 377-390.

  • J. Sempau, J.M. Fernandez-Varea, E. Acosta and F. Salvat:
    Experimental benchmarks of the Monte Carlo code PENELOPE. Nuclear Instruments and Methods B 207 (2003) 107-123.

  • Francesc Salvat:
    PENELOPE-2018 - A Code System for Monte Carlo Simulation of Electron and Photon Transport - Workshop Proceedings Barcelona, Spain 28 January – 1 February 2019 (NEA/MBDAV/R(2019)1 - ISSN 2707-2894 - July 2019)

NEA-1910/01, included references:
- Francesc Salvat and Randy Schwarz:
PenGUIn. A Windows graphical user interface for PENELOPE/PENMAIN
- Francesc Salvat and Randy Schwarz:
PenGUIn: Monte Carlo simulation of coupled electron-photon transport using
penelope with a GUI
- Francesc Salvat,
Joe M. Ferandez-Varea, Josep Sempau:
PENELOPE. A code system for Monte Carlo simulation of electron and photon
transport
top ]
11. HARDWARE REQUIREMENTS

1 GB RAM.

 

Tested at the NEA Data Bank on:

  • COMPUTER: Dell Precision M6800 with Intel(R) Core (TM) i7-4800MQ CPU at 2.70 GHz x 8, RAM: 16.0 GB

  • OPERATING SYSTEM: Windows 10

top ]
12. PROGRAMMING LANGUAGE(S) USED
Package ID Computer language
NEA-1910/01 FORTRAN, VISUAL STUDIO
top ]
13. SOFTWARE REQUIREMENTS

Microsoft Windows 7 and later.

top ]
15. NAME AND ESTABLISHMENT OF AUTHORS

Francesc Salvat

Facultat de Fisica (FQA), Universitat de Barcelona

Diagonal 645, 08028 Barcelona, Catalonia, Spain

 

Randy Schwarz

Schwarz Software and Consulting, LLC,

P.O. Box 1308,

Richland, WA 99352, USA

top ]
16. MATERIAL AVAILABLE
NEA-1910/01
readme.txt - The file you are reading.
copyright.txt - Copyright and permission notice.
PenGUIn.exe - The executable binary file of PenGUIn.
penmain.exe - The executable of PENMAIN.
gview2d.exe and gview3d.exe - Two- and three-dimensional viewers of geometries
defined by using the PENGEOM syntax.
2d-help.txt and 3d-help.txt - Text files used by the geometry viewers.
./docs - Documentation subdirectory. It contains pdf files of the PenGUIn manual

and two presentations.
./pendbase - PENELOPE database and auxiliary programs MATERIAL, TABLES, and
SHOWER
./gnuplot - Plotting software.
./gscripts - Gnuplot scripts that display results from PENMAIN.
./gtable - Gnuplot scripts that display results from TABLES.
./geometries - Examples of geometry definition files.
top ]
17. CATEGORIES
  • L. Data Preparation

Keywords: MCNP, graphical.