Package: rrtools
OverviewThis module encapsulates algorithms for the restoration of images and it is
specialized in retinal images.RRtoolbox is a python package which contains source code designed to process images built
mainly using OpenCV.RRtoolFC is a development tool using sequential function charts (FC stands for Function Chart)Imrestore is an application to restore images in general but in this case is configured to
restore retinal images. Because it is still in development it is the alpha program for testing
and to let the users find out about its utilities. Do not hesitate to share it to the world,
let everyone know how awesome it is!! (be warned that it is for research purposes)Stable:Documentation:http://pythonhosted.org/rrtoolsDownload Page:https://pypi.python.org/pypi/rrtoolboxLatest:Documentation:http://rrtools.readthedocs.io/Project Homepage:https://github.com/davtoh/RRtoolsBSD license, (C) 2015-2017 David Toro <davsamirtor@gmail.com>DocumentationFor API documentation, usage and examples see files in the “documentation”
directory.  The “.rst” files can be read in any text editor or being converted to
HTML or PDF usingSphinx. A HTML version is online athttp://rrtools.readthedocs.io/en/latest/Read RRtoolbox (Retinal Restauration Toolbox)manualor thedissertationwhich made this project possible with all the concepts.Examples are found in the directoryexamplesand unit tests intests.Installationpip install rrtoolsshould work for most users.The usual setup.py forPythonlibraries are used for the source distribution.
But OpenCV must be installed separately usually compiled from source. However
RRtoolbox has a mock module for cv2 called cv2_mock to let the user use the
functions that do not need OpenCV. Notice that this imports RRtoolbox.cv2_mock
as cv2.To install OpenCV without much hassle I recommend installing the binaries from
theUnofficial Windows Binaries for Pythonand for Debian distributions I
provide the bashOpenCV linux installationso that the user can compile
openCV (it can take some time). Bear in mind that for Linux it downloads the
latest 2.9 version instead of the new OpenCV version 3 because it does not
consent to using non-free sources. So you must accept the terms for OpenCV 2.9.Once rrtools is successfully installed you can import the toolbox in python as:>>>> import RRtoolbox as rrReleasesAll releases follow semantic rules proposed inhttps://www.python.org/dev/peps/pep-0440/andhttp://semver.org/To create executable from source code:$ pyinstaller -p ./ -n imrestore -F ./imrestore.py/ --version-file=versionTesting and applicationTo test imrestore script:$ python imrestore.py tests/im1*To test imrestore executable:$./dist/imrestore tests/im1*To test imrestore executable if in dist folder:$ ./imrestore ../tests/im1*A basic usage would be typing./imrestore tests/im1*--lensin the terminal which species
to imrestore to load from the test path images that start with im1 specified by the wildcard
‘*’ and the option--lensadds, as its name implies, lens to the retinal area.So, it loads this image which presents some flares and noise:Retina photo 1The second image is from a different perspective of the same retinal area but has information
that the other does not have:Retina photo 2And Voilà they are merged into one! notice how the flares tend to disappear and the lens were
added too! Because it is in development it still is not that pretty…Rethina photo resultUsageFor help just type in./imrestore--help, it could not be easier than that! but ademois available using the jupyter notebook to generate the desired commands to learn or use
in the console while still running the program.Contributions and bug reports are appreciated.author: David Toroe-mail:davsamirtor@gmail.comproject:https://github.com/davtoh/RRtools