Metadata-Version: 2.1
Name: HDRutils
Version: 0.1
Summary: Utility functions for perfming basic operations on HDR images, including merging and deghosting
Home-page: https://github.com/catchchaos/HDRutils-pip
Author: Param Hanji
Author-email: param.hanji@gmail.com
License: MIT
Download-URL: https://github.com/catchchaos/HDRutils-pip/archive/v0.1-beta.tar.gz
Description: # HDRutils-pip
        
        Some utility functions to generate HDR images from a sequence of exposure time or gain modulated images.
        
        ## Installation
        TODO: Not uploaded to pip yet.
        
        To download HDRUtils, either fork this github repo or simply use Pypi via pip:
        
            pip install HDRutils
        
        If you forked this repository, install the dependencies using pip:
            
            pip install -r requirements.txt
        
        ## Additional dependency
        You will need the [FreeImage plugin](https://imageio.readthedocs.io/en/stable/format_exr-fi.html) for reading and writing OpenEXR images:
        
            imageio_download_bin freeimage
        
        ## Usage
        Just import HDRutils and call the required functions
        
        ### Reading and writing
        Simple wrapper functions for [imageio's](https://imageio.github.io/) `imread` and `imwrite` are provided to set appropriate flags for HDR data. You can even call `imread` on RAW file formats:
        
        ```python
        import HDRutils
        
        raw_file = 'example_raw.arw'
        img_RGB = HDRutils.imread(raw_file)
        
        hdr_file = 'example.exr'
        img = HDRutils.imread(raw_file)
        
        HDRutils.imwrite('rgb.png', img_RGB)
        HDRutils.imwrite('output_filename.exr', img)
        ```
        
        ### Merge input images
        The [rawpy](https://github.com/letmaik/rawpy) wrapper is used to read RAW images. [Noise-aware merging](https://www.cl.cam.ac.uk/research/rainbow/projects/noise_aware_merging/) is performed using the Poisson-noise optimal estimator. The generated HDR image is linearly related to the scene radiance
        
        ```python
        files = ['file1.dng', 'file2.dng', 'file3.dng']		# RAW input files
        HDR_img = HDRutils.merge(files)
        HDRutils.imwrite('merged.exr', HDR_img)
        ```
        
        The default function processes each image individually using [libraw](https://www.libraw.org/) and then merges the RGB images. This behaviour can be overriden to merge RAW bayer image by setting the flag `demosaic_first=False`.
        
        ### Deghosting
        TODO
        
        ## Citation
        If you find this package useful, please cite
        
            @inproceedings{hanji2020noise,
              title={Noise-Aware Merging of High Dynamic Range Image Stacks Without Camera Calibration},
              author={Param Hanji and Fangcheng Zhong and Rafal K. Mantiuk},
              year={2020},
              booktitle={Computer Vision - {ECCV} 2020 Workshops - Glasgow, UK, August 23-28, 2020, Proceedings, Part {III}},
              url={https://doi.org/10.1007/978-3-030-67070-2\_23}
            }
Keywords: HDR,Merging,Deghosting
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Build Tools
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Description-Content-Type: text/markdown
