skip to navigation
skip to content

pyradi 0.1.49

The PyRadi toolkit provides utilities for radiometry (flux flow) calculations, supporting electro-optical and infrared system design.

Latest Version: 1.1.2

The PyRadi toolkit provides utilities for radiometry (flux flow) calculations, supporting electro-optical and infrared system design.

The toolkit is an extendable, integrated and coherent collection of basic functions, code modules, documentation, example templates, unit tests and resources, that can be applied towards diverse calculations in the electro-optics domain. The toolkit covers:

  • Models of physical radiators (e.g., Planck’s Law) and conversion between values expressed in different units.
  • Mathematical operations (e.g., spectral integrals, spatial integrals, spectral convolution)
  • Data manipulation (e.g., file input/output, interpolation, spectral quantity conversions, reading Flir Inc PTW files)
  • Detector modelling from physical parameters
  • 3-D noise analysis of image sequences
  • Modtran tape7 read functions
  • Graphical visualization(2-D and 3-D graphs) in compact format, including cartesian, polar, image and mesh plots.
  • Spectral variables are expressed in Numpy arrays to ease spectral operations and integrals.

The individual scripts in the toolkit is supported by examples, test cases and documentation. These examples are included at the end of each script in the __main__ section. If you just run the script, the code will be executed and results will be available in graphs or text files.


This toolkit requires (current versions in brackets) Python (2.7.6), Numpy (1.7 or later), SciPy (0.13 or later), Matplotlib (1.3 or later). Mayavi (4.1) is required only for one file to do three-dimensional rendering, the rest of the toolkit works fine without Mayavi.


This project is very stable beta. Current content is tested, stable and usable. With time and active use the scope of the pyradi offering will grow and expand. The current version is already quite useful in our labs and university lectures.

The development is ongoing as and when new needs arise. We are open for feature requests as well.


Local API documentation in html and pdf format is available in the pradi installation directory, along the paths doc/_build/html/index.html and doc/_build/latex/pyradi.pdf.

Online API documentation in html format is available here.

Tutorial examples on the application of pyradi are available online in these notebooks.

For a detailed theoretical background and many more examples see the book by CJ Willers. See also SPIE8543Pyradi.

Example application

A typical radiometry toolkit requirement (very much simplified) is the calculation of the detector current of an electro-optical sensor viewing a target object through the atmosphere. The system can be conceptually modelled as comprising a radiating source with spectral radiance, an intervening medium (e.g. the atmosphere), a spectral filter, optics, a detector and an amplifier. The pyradi toolkit provides several classes and functions to implement this model with minimal code. An example solution is given in this script and is further explained with results in SPIE8543Pyradi.

[book]Electro-Optical System Analysis and Design: A Radiometry Perspective, C.J. Willers, Volume PM236, SPIE Press, 2013.
[SPIE8543Pyradi]Pyradi: an open-source toolkit for infrared calculation and data processing, SPIE Proceedings Vol 8543, Security+Defence 2011, Technologies for Optical Countermeasures, Edinburgh, 24-27 September, C.J. Willers, M. S. Willers, R.A.T. Santos, P.J. van der Merwe, J.J. Calitz, A de Waal and A.E. Mudau.
File Type Py Version Uploaded on Size
pyradi-0.1.49.win32.exe (md5) MS Windows installer any 2014-06-01 12MB (md5) Source 2014-06-01 10MB