Skip to main content

Module to radioactively decay radioactive elements using the ICRP-107 and Bateman Equation

Project description

decaychain

This package decays single or multiple radionuclides and computes the daughter radionuclides and their concentrations at a user defined time.

Currently this package has only been tested on Python 3.6 running on Linux OS.

Installation

$ pip install decaychain

Syntax for Use

Example

>>> import decaychain.BatemanMulti as decay
>>> decay.bateman_multi({"U-238":1e7, "235U":1e7}, 3e9, "yr")
{'U-235': 0.3735948863819144, 'Th-231': 0.3735948863834592, 'Pa-231': 0.37361227209089354, 'Ac-227': 0.3736122836452778, 'Th-227': 0.3684561382285081, 'Ra-223': 0.37361198361845205, 'Rn-219': 0.37361198361845205, 'Po-215': 0.3736122836886527, 'Pb-211': 0.3736122836886891, 'Bi-211': 0.37361228368869126, 'Tl-207': 0.37258111378571535, 'Po-211': 0.0010311699029807882, 'Fr-223': 0.0051561454435370985, 'At-219': 3.000702007281776e-07, 'Bi-215': 3.0007020072818374e-07}

This decays both U-238 and U-235 at a concentration of 1e7 Bq for 3e9 years.

Syntax

>>> decay.bateman_multi({dictionaryinput}, time, "time units")

dicitonaryinput = dictionary with key nuclide as string and values as nuclide concentration_

time = a number (float or integer)

time units = string e.g. ("years", "yr", "minutes", "m", "hours", "hr" etc)

The output is a dictionary in the same format at the input

The Pint module(https://pint.readthedocs.io/en/0.12/) is used to handle time units so a variety of time units can be used.

The nuclide input is tolerant of a variety of radionuclide formats i.e. U-235, U-238, 235U etc

How it works

radioactivedecay uses decay data from ICRP Publication 107 (2008) combined with a Bateman Decay solution to calculate the final concentrations of nuclides https://journals.sagepub.com/doi/pdf/10.1177/ANIB_38_3

Limitations

The following processes are not modelled by radioactivedecay:

  • ingrowth of progeny from spontaneous fission decays
  • neutronics, so no modelling of induced radioactivity or fission

Data

Thanks

With particular thanks to @bjodah for use of the batemaneq module (https://github.com/bjodah/batemaneq) and Alex Malins for leading the way (https://github.com/alexmalins/radioactivedecay)

Project details


Download files

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

Source Distribution

decaychain-0.7.1.tar.gz (73.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

decaychain-0.7.1-py3-none-any.whl (78.0 kB view details)

Uploaded Python 3

File details

Details for the file decaychain-0.7.1.tar.gz.

File metadata

  • Download URL: decaychain-0.7.1.tar.gz
  • Upload date:
  • Size: 73.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.0 pkginfo/1.5.0.1 requests/2.23.0 setuptools/47.1.1 requests-toolbelt/0.9.1 tqdm/4.46.1 CPython/3.6.9

File hashes

Hashes for decaychain-0.7.1.tar.gz
Algorithm Hash digest
SHA256 e3206a2b9bf4bed8c35f30cab67ee0382b8baf43a1fa47ed06859ec86ce434a8
MD5 29ca22f51385dbdaf8797b5db4719664
BLAKE2b-256 fecf9d03a0dab3b451a2dda642e752f54582864457bdfa80db57503d39490650

See more details on using hashes here.

File details

Details for the file decaychain-0.7.1-py3-none-any.whl.

File metadata

  • Download URL: decaychain-0.7.1-py3-none-any.whl
  • Upload date:
  • Size: 78.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.0 pkginfo/1.5.0.1 requests/2.23.0 setuptools/47.1.1 requests-toolbelt/0.9.1 tqdm/4.46.1 CPython/3.6.9

File hashes

Hashes for decaychain-0.7.1-py3-none-any.whl
Algorithm Hash digest
SHA256 7236af64093d0225318734e6c1464292fe5b52d4fbbbc4aa591efe61fdef33e4
MD5 8dfbff920f1fbe1259bef5ab017de906
BLAKE2b-256 5746e57764885800de889e6c2598ff8f80b00fef33e68aa6fa80684412ec621a

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page