Metadata-Version: 2.0
Name: rawpy
Version: 0.3.2
Summary: Python wrapper for the LibRaw library
Home-page: https://github.com/neothemachine/rawpy
Author: Maik Riechert
Author-email: maik.riechert@arcor.de
License: UNKNOWN
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Cython
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX
Classifier: Operating System :: Unix
Classifier: Topic :: Multimedia :: Graphics
Classifier: Topic :: Software Development :: Libraries
Requires-Dist: enum34

rawpy
=====

.. image:: https://travis-ci.org/neothemachine/rawpy.svg?branch=master
    :target: https://travis-ci.org/neothemachine/rawpy
    :alt: Linux Build Status

.. image:: https://travis-ci.org/neothemachine/rawpy.svg?branch=mac-wheels
    :target: https://travis-ci.org/neothemachine/rawpy
    :alt: Mac OS X Build Status

.. image:: https://ci.appveyor.com/api/projects/status/f8ibd8mejxs9xq5w/branch/master
    :target: https://ci.appveyor.com/project/neothemachine/rawpy/branch/master
    :alt: Windows Build Status

rawpy is an easy-to-use Python wrapper for the LibRaw_ library.
It also contains some extra functionality for finding and repairing hot/dead pixels.

Sample code
-----------

Load a RAW file and save the postprocessed image using default parameters:

.. code-block:: python

	import rawpy
	import imageio

	path = 'image.nef'
	raw = rawpy.imread(path)
	rgb = raw.postprocess()
	imageio.imsave('default.tiff', rgb)

Save as 16-bit linear image:

.. code-block:: python

	rgb = raw.postprocess(gamma=(1,1), no_auto_bright=True, output_bps=16)
	imageio.imsave('linear.tiff', rgb)

Find bad pixels using multiple RAW files and repair them:

.. code-block:: python

	import rawpy.enhance

	paths = ['image1.nef', 'image2.nef', 'image3.nef']
	bad_pixels = rawpy.enhance.find_bad_pixels(paths)

	for path in paths:
	    raw = rawpy.imread(path)
	    rawpy.enhance.repair_bad_pixels(raw, bad_pixels, method='median')
	    rgb = raw.postprocess()
	    imageio.imsave(path + '.tiff', rgb)

Installation on Linux
---------------------

You need to have the LibRaw_ library installed to use this wrapper.

On Ubuntu, you can get (an outdated) version with:

.. code-block:: sh

    sudo apt-get install libraw-dev

Or install the latest developer version from the SVN repository:

.. code-block:: sh

    git clone git://github.com/LibRaw/LibRaw.git libraw
    git clone git://github.com/LibRaw/LibRaw-cmake.git libraw-cmake
    cp -R libraw-cmake/* libraw ;
    cd libraw
    cmake .
    sudo make install

After that, it's the usual ``pip install rawpy``.

If you get the error "ImportError: libraw.so: cannot open shared object file: No such file or directory"
when trying to use rawpy, then do the following:

.. code-block:: sh

    echo "/usr/local/lib" | sudo tee /etc/ld.so.conf.d/99local.conf
    sudo ldconfig

The LibRaw library is installed in /usr/local/lib and apparently this folder is not searched
for libraries by default in some Linux distributions.

Installation on Windows and Mac OS X
------------------------------------

Binaries are provided for Python 2.7, 3.3 and 3.4 for both 32 and 64 bit.
These can be installed with a simple ``pip install --use-wheel rawpy`` 
(or just ``pip install rawpy`` if using pip >= 1.5).

Binaries for other Python versions are currently not produced but if there is a need
then this is possible as well. In that case, just contact me.

.. _LibRaw: http://www.libraw.org


