image-hdr 0.6.0

An implementation of HDR Radiance Estimation using Poisson Photon Noise Estimator for creating HDR image from a set of images
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59

# image-hdr ![](https://github.com/anshap1719/image-hdr/actions/workflows/rust.yml/badge.svg)

This is a rust library which implements the HDR merging algorithm for camera images taken with different exposure
times (or with bracketing). It uses the algorithms described
in https://www.cl.cam.ac.uk/research/rainbow/projects/noise-aware-merging/2020-ppne-mle.pdf, and uses "Poisson Photon
Noise Estimator" equations to estimate final radiances at each pixel position.

## Current State

The library is still in early stages of development, but aims to provide a crate that can handle all HDR merging needs.
Towards that end, the following todos are the top priority:

- Tone mapping algorithm implementations.
- Improve performance.

## Dependencies

- image-rs: Uses DynamicImage as the output format and storage format between calculations.
- rawloader: For supporting RAW image formats.
- rayon: For doing point calculations in parallel.
- kamadak-exif: For getting image's metadata, specifically exposure time and gain (ISO).

## Usage

```
let paths = vec!["src/image1.tif", "src/image2.tif", "src/image3.tif"];
let hdr_merge = image_hdr::hdr_merge_images(paths);
let stretched = apply_histogram_stretch(&fusion);

stretched
    .to_rgba16()
    .save(format!("src/hdr_merged.tiff"))
    .unwrap();
```

## Samples

### Given the following 3 exposures:

![alt "1/640s"](https://image-hdr-assets.s3.ap-south-1.amazonaws.com/DSC00001+Large.jpeg)
![alt "1/4000s"](https://image-hdr-assets.s3.ap-south-1.amazonaws.com/DSC00002+Large.jpeg)
![alt "1/80s"](https://image-hdr-assets.s3.ap-south-1.amazonaws.com/DSC00003+Large.jpeg)

### Resulting unprocessed image:

![alt "Merged image"](https://image-hdr-assets.s3.ap-south-1.amazonaws.com/hdr_merged+Large.jpeg)

### After basic processing (Levels and Contrast):

![alt "Processed image"](https://image-hdr-assets.s3.ap-south-1.amazonaws.com/Processed+Large.jpeg)

## Contributing

Bug reports and pull requests welcome at https://github.com/anshap1719/image-hdr

## Citations

- Noise-Aware Merging of High Dynamic Range Image Stacks without Camera Calibration by Param Hanji, Fangcheng Zhong, and
  Rafa l K. Mantiuk (https://www.cl.cam.ac.uk/~rkm38/pdfs/hanji2020_noise_aware_HDR_merging.pdf)