https://github.com/ofgulban/iphigen
A command-line program for n-dimensional image enhancement and color balancing.
https://github.com/ofgulban/iphigen
color-balance image-processing mri nifti
Last synced: 3 months ago
JSON representation
A command-line program for n-dimensional image enhancement and color balancing.
- Host: GitHub
- URL: https://github.com/ofgulban/iphigen
- Owner: ofgulban
- License: bsd-3-clause
- Created: 2016-12-09T14:39:14.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2021-07-20T13:14:48.000Z (almost 5 years ago)
- Last Synced: 2025-12-03T13:47:43.244Z (7 months ago)
- Topics: color-balance, image-processing, mri, nifti
- Language: Python
- Homepage:
- Size: 3.69 MB
- Stars: 22
- Watchers: 3
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
[](https://zenodo.org/badge/latestdoi/76043117)
[](https://badge.fury.io/py/iphigen)
# Iphigen (work in progress)
A simple command-line interface for image enhancement and color balancing.
This application is being developed mainly to play with a few algorithms that I like. I am aiming at making the implementations work for 2D, 3D and 4D images. Currently implemented algorithms are:
- __Multi-scale retinex__ [1, 3]
- __Simplest color balance__ [2]
- __Simplex color balance__ (based on [3, 4], not published)
# Getting started
## Dependencies
**[Python 3](https://www.python.org/)** and the following packages:
| Package | Tested version |
|---------------------------------------|----------------|
| [OpenCV](https://opencv.org/) | 3.4.4 |
| [SciPy](https://www.scipy.org/) | 1.2.0 |
| [NiBabel](http://nipy.org/nibabel/) | 2.2.1 |
| [NumPy](http://www.numpy.org/) | 1.15.4 |
## Installation
Clone this repository or download the latest release. In your command line, change directory to folder of this package and run the following:
```
python setup.py install
```
If everything went fine, typing ```iphigen -h``` or ```iphigen_nifti -h``` in the command-line should show the help menu now.
## Usage
### Retinex with intensity balance
```
iphigen /path/to/image.png --retinex --intensity_balance
```
### Color balance
```
iphigen /path/to/image.png --simplest_color_balance
```
### Retinex with simplest color balance
```
iphigen /path/to/image.png --retinex --simplest_color_balance
```
## Use with Nifti files
```
iphigen_nifti /path/to/data.nii.gz --retinex
```
## Use within python scripts
See script examples [here](script_examples/).
# Support
Please use [github issues](https://github.com/ofgulban/iphigen/issues) to report bugs or make suggestions.
# License
The project is licensed under [BSD-3-Clause](https://opensource.org/licenses/BSD-3-Clause).
# References
This application is based on the following work:
1. Jobson, D. J., Rahman, Z. U., & Woodell, G. A. (1997). _A multiscale retinex for bridging the gap between color images and the human observation of scenes._ IEEE Transactions on Image Processing, 6(7), 965–976.
2. Limare, N., Lisani, J., Morel, J., Petro, A. B., & Sbert, C. (2011). _Simplest Color Balance_. Image Processing On Line, 1(1), 125–133.
3. Petro, A. B., Sbert, C., & Morel, J. (2014). _Multiscale Retinex_. Image Processing On Line, 4, 71–88.
4. Gulban, O. F. (2018). _The Relation between Color Spaces and Compositional Data Analysis Demonstrated with Magnetic Resonance Image Processing Applications._ Austrian Journal of Statistics, 47(5), 34–46.