Tone Mapping Studio (TMS)

2004 - 2024, Martin Cadik (cadikm@centrum.cz, http://cadik.posvete.cz/)

developers: Ondrej Hajdok, Martin Cadik, Michal Augustyn, Ondrej Fialka, Antonin Lejsek, Petr Bilek, Ondrej Pecina, Pavel Fryz, Martin Molek, Vladimir Vlkovic, Jan Brida, Petr Pospisil, Tomas Chlubna, Filip Brezna, Tomas Hudziec, Vaclav Chvila, Jan Kohut, Jan Jedlicka, Michal Vlnas, Matej Valek, Lucie Smiskova, David Chocholaty, Matus Bicanovsky, Filip Sapak, Branislav Dubec, Peter Zdravecky, Jakub Krystufek, Boris Strbak

About

Tone Mapping Studio is a plugin-based framework for image processing operations, in particular HDR tone mapping and color-to-grayscale conversions.

If you use TMS for your research work, please cite at least one of the following papers:

@article{cadik08evaluation,
  title =      "Evaluation of HDR Tone Mapping Methods Using Essential Perceptual Attributes",
  author =     "Martin {\v{C}}ad\'{i}k and Michael Wimmer and Laszlo Neumann and Alessandro Artusi",
  year =       "2008",
  volume =     "32",
  issue =      "3",
  pages =      "330-349",
  issn =       "0097-8493",
  journal =    "Computers \& Graphics",
  keywords =   "tone mapping operators, tone mapping evaluation, image attributes, high dynamic range",
  URL =        "http://cadik.posvete.cz/tmo/cadik08cag.pdf",
}

@article{ cadik08perceptual,
  author    = {Martin {\v{C}}ad\'{i}k},
  title     = {Perceptual Evaluation of Color-to-Grayscale Image Conversions},
  journal   = {Comput. Graph. Forum},
  volume    = {27},
  number    = {7},
  year      = {2008},
  pages     = {1745-1754},
}

@PhdThesis{cadik08phd,
 author = "Martin {\v{C}}ad\'{i}k",
 title  = "Perceptually Based Image Quality Assessment and Image Transformations",
 school = "Department of Computer Science and Engineering, Faculty of Electrical Engineering, Czech Technical University in Prague",
 type   = "Ph.D. Thesis",
 year   = "2008",
 month  = "January",
 url    = "http://cadik.posvete.cz/diss",
}

The TMS package consists of

• tmolib - a library for loading, writing and processing of LDR and HDR files in various formats
• tmocmd - a command line tool, which loads an image, runs a specific plugin, and writes the final output
• tmogui - an application, which uses the same plugins as tmocmd, to enable visual inspection of the results, interactive setting of parameters, and other operations
• TMOYourOperatorName/TMOYourOperatorNameLinux - templates for your own plugins
• TMOWard94 - an example plugin implementing a simple tone mapping method [Ward 1994]
• TMOLinux/TMOW32 - linux/Windows specific plugin code

Compiling

To compile run cmake and make as follows:

mkdir build; cd build
cmake .. 
make 

Use cmake version 2.4.8 and higher.

You need at least these libraries:

• OpenExr http://www.openexr.com/
• LibTIFF http://www.libtiff.org/
• libjpeg http://www.ijg.org/
• FFTW http://www.fftw.org/
• Boost.MultiArray http://www.boost.org/doc/libs/1_56_0/libs/multi_array/doc/index.html
• CGAL http://www.cgal.org/
• OpenCV https://opencv.org/
• NLopt https://nlopt.readthedocs.io/
• Eigen https://eigen.tuxfamily.org/index.php?title=Main_Page
• TensorFlow https://www.tensorflow.org/

and for GUI:

• Qt5 https://www.qt.io/offline-installers

On Debian/Ubuntu these are provided by packages:

• libopenexr-dev
• libtiff4-dev
• libjpeg-dev
• qt5-default
• qt5-doc
• qttools5-dev-tools
• libfftw3-3
• libboost-all-dev
• libopencv-dev
• libeigen3-dev

On Fedora, you should install the following packages as follows:

sudo dnf install OpenEXR OpenEXR-libs OpenEXR-devel \
        libtiff libtiff-devel \
        libjpeg-turbo libjpeg-turbo-devel libjpeg-turbo-utils \
        fftw fftw-devel fftw-libs \
        boost boost-devel \
        CGAL-devel \
        opencv opencv-devel \
        nlopt nlopt-devel \
        eigen3-devel \
        qt5-qtbase-devel

Install

After compiling run:

make install

If you want to specify directory to install, you have to run cmake like this:

cmake -D CMAKE_INSTALL_PREFIX='/where/to/install/tms/' ..