Skip to main content

Python interface to facilitate the use of the Monte Carlo code PENELOPE and its main programs

Project description

pyPENELOPEtools is an open-source software to facilitate the use of the Monte Carlo code PENELOPE and its main programs such as PENEPMA. It is a programming interface to setup, run and analyze Monte Carlo simulations. Most of the code was adapted from pyPENELOPE, but with the goal to facilitate the integration with pyMonteCarlo.


PENELOPE (Penetration and ENErgy LOss of Positrons and Electrons) is a a general-purpose Monte Carlo code system for the simulation of coupled electron-photon transport in arbitrary materials. PENELOPE covers the energy range from 1 GeV down to, nominally, 50 eV. The physical interaction models implemented in the code are based on the most reliable information available at present, limited only by the required generality of the code. These models combine results from first-principles calculations, semi-empirical models and evaluated data bases. It should be borne in mind that although PENELOPE can run particles down to 50 eV, the interaction cross sections for energies below 1 keV may be affected by sizeable uncertainties; the results for these energies should be considered as semi-quantitative.

PENELOPE incorporates a flexible geometry package called PENGEOM that permits automatic tracking of particles in complex geometries consisting of homogeneous bodies limited by quadratic surfaces. The PENELOPE code system is distributed by the OECD/NEA Data Bank.

PENELOPE is coded as a set of FORTRAN subroutines, which perform the random sampling of interactions and the tracking of particles (either electrons, positrons or photons). In principle, the user should provide a main steering program to follow the particle histories through the material structure and to keep score of quantities of interest.


The documentation contains the installation instructions, tutorials and API.

Release notes


  • Add enums for KPAR and ICOL
  • Add result from generated photon intensity


  • First release


License under Apache Software License 2.0.

Copyright (c) 2017-2018 Philippe Pinard

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for pyPENELOPEtools, version 1.1.1
Filename, size File type Python version Upload date Hashes
Filename, size pyPENELOPEtools-1.1.1-py3-none-any.whl (75.9 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size pyPENELOPEtools-1.1.1.tar.gz (69.3 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page