Skip to content

radiantlab/HDRICalibrationTool

Repository files navigation

HDRI-Calibration-Tool


About

The HDRI Calibration Tool was designed to automate the process of merging multiple LDR images together and generating an HDR image. It is not a standalone app, and is meant to be used alongside the app Radiance. This is an entirely free,open-sourced application developed by a small group of computer science students.

To read more about the process of generating an HDR image from LDR image input, see the research paper by Clotilde Pierson here.


Other Documentation

If you have any difficulty using the application, please check out our github Wiki for more information.

Additionally, the GitHub Wiki includes OS-specific information regarding installation, troubleshooting, and setting up a development environment to make changes to the app.

A step-by-step guide on using the app is also on the wiki, with a formatting guide for the calibration and response function files.

It also includes information about the development of this project including libraries used, more info about the radiance_pipeline submodule, using Figma to prototype and test design on users, and documentation for functions in some of the files.


To Run

Prerequisite: HDRGen, Radiance.

Windows

This app has been tested on Windows 10. For Windows users, unzip the code, and in the root directory, run the executable "HDRICalibrationTool.exe". Please do not remove this file from this directory, else it will not run. Feel free to make a shortcut of the executable and move that to a more accessible location.

MacOS

Note that you will need an SSH key set up in Github to get the submodule. You may also need to install qt6-base or qt6 from your package manager software.

$ git clone https://github.com/XiangyuLijoey/HDRICalibrationTool.git
$ cd HDRICalibrationTool
$ git submodule update --init --recursive --remote
$ pip3 install -r requirements.txt
$ python3 main.py

Linux

See the wiki


Examples

For example input LDR images, camera lens settings, calibration files, response function files, and output HDR images, see the \examples directory in the root directory.


Credits

Project partner: Clotilde Pierson

Development team:

  • Nathaniel Klump
  • Liam Zimmermann
  • Xiangyu "Joey" Li

Licensing Info

For licensing, see LICENSE.txt in the root directory.

About

A free, open-source cross-platform interface to help Radiance automate the merging of multiple LDR images into an HDR image.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •