skip to navigation
skip to content

lensfunpy 1.3.0

Python wrapper for the lensfun library

Package Documentation

lensfunpy is an easy-to-use Python wrapper for the lensfun library.

API Documentation

Sample code

How to find cameras and lenses:

import lensfunpy

cam_model = 'NIKON D3S'
lens_maker = 'Nikon'
lens_model = 'Nikkor 28mm f/2.8D AF'

db = lensfunpy.Database()
cam = db.find_cameras(cam_maker, cam_model)[0]
lens = db.find_lenses(cam, lens_maker, lens_model)[0]

print cam
# Camera(Maker: NIKON CORPORATION; Model: NIKON D3S; Variant: ;
#        Mount: Nikon F AF; Crop Factor: 1.0; Score: 0)

print lens
# Lens(Maker: Nikon; Model: Nikkor 28mm f/2.8D AF; Type: RECTILINEAR;
#      Focal: 28.0-28.0; Aperture: 2.79999995232-2.79999995232;
#      Crop factor: 1.0; Score: 110)

How to correct lens distortion:

import cv2 # OpenCV library

focal_length = 28.0
aperture = 1.4
distance = 10
image_path = '/path/to/image.tiff'
undistorted_image_path = '/path/to/image_undist.tiff'

im = cv2.imread(image_path)
height, width = im.shape[0], im.shape[1]

mod = lensfunpy.Modifier(lens, cam.crop_factor, width, height)
mod.initialize(focal_length, aperture, distance)

undist_coords = mod.apply_geometry_distortion()
im_undistorted = cv2.remap(im, undist_coords, None, cv2.INTER_LANCZOS4)
cv2.imwrite(undistorted_image_path, im_undistorted)

Installation on Linux

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

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

sudo apt-get install liblensfun0 liblensfun-dev

Or install the latest developer version from the GIT repository:

git clone git:// lensfun
cd lensfun
cmake .
sudo make install

After that, it’s the usual pip install lensfunpy.

If you get the error “ImportError: cannot open shared object file: No such file or directory” when trying to use lensfunpy, then do the following:

echo "/usr/local/lib" | sudo tee /etc/
sudo ldconfig

The lensfun 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 lensfunpy (or just pip install lensfunpy 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.

File Type Py Version Uploaded on Size
lensfunpy-1.3.0-cp27-none-macosx_10_6_intel.macosx_10_9_intel.macosx_10_9_x86_64.macosx_10_10_intel.macosx_10_10_x86_64.whl (md5) Python Wheel cp27 2015-05-17 1MB
lensfunpy-1.3.0-cp27-none-win32.whl (md5) Python Wheel 2.7 2015-05-17 1MB
lensfunpy-1.3.0-cp27-none-win_amd64.whl (md5) Python Wheel 2.7 2015-05-17 1MB
lensfunpy-1.3.0-cp33-cp33m-macosx_10_6_intel.macosx_10_9_intel.macosx_10_9_x86_64.macosx_10_10_intel.macosx_10_10_x86_64.whl (md5) Python Wheel cp33 2015-05-17 1MB
lensfunpy-1.3.0-cp33-none-win32.whl (md5) Python Wheel 3.3 2015-05-17 1MB
lensfunpy-1.3.0-cp33-none-win_amd64.whl (md5) Python Wheel 3.3 2015-05-17 1MB
lensfunpy-1.3.0-cp34-cp34m-macosx_10_6_intel.macosx_10_9_intel.macosx_10_9_x86_64.macosx_10_10_intel.macosx_10_10_x86_64.whl (md5) Python Wheel cp34 2015-05-17 1MB
lensfunpy-1.3.0-cp34-none-win32.whl (md5) Python Wheel 3.4 2015-05-17 1MB
lensfunpy-1.3.0-cp34-none-win_amd64.whl (md5) Python Wheel 3.4 2015-05-17 1MB
lensfunpy-1.3.0.tar.gz (md5) Source 2015-05-17 92KB
  • Downloads (All Versions):
  • 161 downloads in the last day
  • 893 downloads in the last week
  • 4875 downloads in the last month