The code was originally developed by Junxing Zheng (Sep. 2014), University of Michigan, Ann Arbor, junxing@umich.edu.

Please check the LICENSE.md file for the original license.

The original code was written in MATLAB by Junxing Zheng. This is a Python version. It is not a line by line conversion, however, most of the original logic has been preserved. This is a preliminary version, need some more work.

If you use this, you are on your own, I am not better than you in programming or in Python. If you make interesting changes or improve the code please let me know.

The code was developed using Python 3.6 with the Anaconda distribution.

The original work can be found at: https://www.mathworks.com/matlabcentral/fileexchange/60651-particle-roundness-and-sphericity-computation

The detailed description of the code can be found in the paper by Zheng and Hryciw (2015) given below:

Zheng, J., and Hryciw, R.D. (2015). “Traditional Soil Particle Sphericity, Roundness and Surface Roughness by Computational Geometry”, Géotechnique, Vol. 65, No. 6, 494-506, DOI:10.1680/geot./14-P-192.