The purpose of computing is insight, not numbers.
-- Richard Hamming

Notes

Objective

The PyRadi toolkit is a Python toolkit to perform optical and infrared computational radiometry (flux flow) calculations.

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

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.

Prerequisites and Installation

The most recent version of pyradi was last tested in July 2019 using Python 3.7. Python 2.7 is no longer supported (the code may still work, but it is not actively supported).

Please see this link for installation procedures. It should take you to the online nbviewer to open a notebook (00-Installing-Python-pyradi.ipynb) in the companion repository https://github.com/NelisW/ComputationalRadiometry.

Learning Python

Keep calm and code Python

To use pyradi you would have to know Python and Numpy. Getting acquainted with a new tool or computer language takes time and practice. Invest your precious time in learning Python and its modules, you will not be disappointed!

There are many free books, classes, getting started blogs websites and tutorials videos,
more videos and conferences. Material for Numpy is less bountiful, but the numpy reference and StackOverflow are good sources. Just google some variation of 'learning python' and make your choice.

A comprehensive list of training material is given here

Status

This project has Production status. Current content is tested, stable and usable. The scope of the pyradi is continually growing as new functionality and examples are added.

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

Documentation

Get the code via Python pip or easy_install

Note that pyradi is no longer available on PyPi.

Get the code from GitHub

You can download the very latest version of pyradi from the pyradi repository on GitHub.

Note that the git checkout only installs pyradi and not any of its dependency packages matplotlib, numpy, scipy or scikit-image.

If you install the Anaconda distribution all the dependency packages should already be present.

Repositories associated with pyradi

In order to keep the size of the pyradi repository smaller, some pyradi information has been moved to separate repositories. If you require to work on regression testing and documentation, check out the tree repositories as follows:

..
+-pyradi  [https://github.com/NelisW/pyradi]
  +-.git
  |-setup.py (this file)
  | ...
  +-pyradi
    + ... all the pyradi files

+-pyradi-docs [https://github.com/NelisW/pyradi-data] (this is an optional clone) 
  +-.git
  +-_build

+-pyradi-data [https://github.com/NelisW/pyradi-docs] (this is an optional clone) 
  +-.git
  +-regression
  +-images

Related toolkits and resources

For image segmentation and analysis, please see <http://scikit-image.org/ scikit-image>.

For hyperspectral image processing see <http://spectralpython.sourceforge.net/ Spectral Python>.

Acknowledgement

The authors gratefully acknowledge the CSIR and Denel Dynamics for support in the development of the code.

Contact

You can contact the pyradi community by emailing the repository owner through github or at neliswillers at gmail.