Updated readme; pushing v0.9

README.md

@@ -58,11 +58,16 @@ HDRutils.imwrite('merged.exr', HDR_img)
 ```
 
 ### Alignment
-While merging, some ghosting artifacts an be removed by setting `HDRutils(..., align=True)`. This attempts homography alignment and corrects camera motion for still scenes.
+While merging, some ghosting artifacts an be removed by setting `HDRutils.merge(..., align=True)`. This attempts homography alignment and corrects camera motion for still scenes.
 
 ### Estimate exposure times
 The exposure times reported in EXIF camera metadata may be inaccurate. The merge function solves a linear least squares problem to estimate most suitable exposure times. This setting can be disabled by `HDRutils.merge(..., estimate_exp=False)`. The default behaviour is to use the brightest 10% of the pixels for estimation.
 
+### Exposure estimation
+Exposure metadata from EXIF may be inaccurate. The default behaviour is to estimate relative exposures directly from the image stack. If you are confident that metadata is correct, disable exposure estimation by specifying `HDRutils.merge(..., estimate_exp=None)`.
+
+For robustness, the estimation includes an iterative outlier removal procedure which may take a couple of minutes to converge especially for large images and deep stacks. You can override this by `HDRutils.merge(..., outlier=None)`. For best results, supply the exact camera (instance of `HDRutils.NormalNoise`). Otherwise a default camera that works reasonably well for tested images will be used.
+
 ## Citation
 If you find this package useful, please cite
 

setup.py

@@ -6,14 +6,14 @@
   name = 'HDRutils',
   packages = find_packages(),
   include_package_data=True,
-  version = '0.8',
+  version = '0.9',
   license='MIT',
   description = 'Utility functions for performing basic operations on HDR images, including ' \
                 'merging and deghosting',
   author = 'Param Hanji',
   author_email = 'param.hanji@gmail.com',
   url = 'https://github.com/gfxdisp/HDRutils',
-  download_url = 'https://github.com/gfxdisp/HDRutils/archive/v0.8.tar.gz',
+  download_url = 'https://github.com/gfxdisp/HDRutils/archive/v0.9.tar.gz',
   keywords = ['HDR', 'Merging', 'Deghosting', 'simulation'],
   install_requires=[
           'numpy',
@@ -38,4 +38,4 @@
     'Programming Language :: Python :: 3.8',
     'Programming Language :: Python :: 3.9',
   ],
-)
+)