Metadata-Version: 2.1
Name: pyPENELOPEtools
Version: 1.2.0
Summary: Python interface to facilitate the use of the Monte Carlo code PENELOPE and its main programs
Home-page: https://github.com/pymontecarlo/pypenelopetools
Author: Philippe T. Pinard
Author-email: philippe.pinard@gmail.com
License: Apache License, Version 2.0
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Operating System :: OS Independent
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: Physics
Description-Content-Type: text/markdown
License-File: LICENSE

# pyPENELOPEtools

[![CI](https://github.com/pymontecarlo/pypenelopetools/actions/workflows/ci.yml/badge.svg)](https://github.com/pymontecarlo/pypenelopetools/actions/workflows/ci.yml)
[![Codecov](https://img.shields.io/codecov/c/github/pymontecarlo/pypenelopetools)](https://codecov.io/gh/pymontecarlo/pypenelopetools)
[![PyPI](https://img.shields.io/pypi/v/pypenelopetools)](https://pypi.org/project/pypenelopetools)

**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](http://pypenelope.sourceforge.net), but
with the goal to facilitate the integration with
[pyMonteCarlo](https://github.com/pymontecarlo/pymontecarlo).

## What is PENELOPE?

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](http://www.nea.fr).

PENELOPE is coded as a set of [FORTRAN](http://en.wikipedia.org/wiki/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.

## Documentation

The [documentation](http://pypenelopetools.readthedocs.io) contains the
installation instructions, tutorials and API.

## Release notes

### 1.2.0

* Move tests to pytest
* Add result class for PENCYL

### 1.1.1

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

### 1.0.0

* First release

## Authors

* [Philippe T. Pinard](https://github.com/ppinard)
* [Hendrix Demers](https://github.com/drix00)

## License

License under Apache Software License 2.0.

Copyright (c) 2017- , Philippe Pinard


