Skip to main content
Help us improve Python packaging – donate today!

wrapper for Lourakis' sparse bundle adjustment C library

Project Description

Enjoy! The most recent version can be obtained from bitbucket via:

hg clone ssh://

As prerequisites, you will also need to install the sba library as a shared object ( (Makefile with shared object target included here) and the sba projections library (

See HOWTO.txt for details.

Typical usage

The main way to use this is as follows:

import sba

cameras = sba.Cameras.fromTxt('cams.txt')
points = sba.Points.fromTxt('pts.txt',cameras.ncameras)
newcams, newpts, info = sba.SparseBundleAdjust(cameras,points)

If you wish to alter the default and autodetected options, you can create an Options object and change it, and then pass it to sba:

options = sba.Options.fromInputs(points,cameras)
# can also update options.XXX to appropriate values
newcams,newpts,info = sba.SparseBundleAdjust(cameras,points,options)

Hopefully this is cleaner than the original way to call it in C.


The original sba C library was written by Manolis Lourakis and is described in Lourakis, Manolis I A and Antonis A Argyros (2004), “The design and implementation of a generic sparse bundle adjustment software package based on the Levenberg-Marquardt algorithm”, FOURTH_ICS TR-340.

If using this package in research work, we would appreciate you citing it: D Theriault, N Fuller, B Jackson, E Bluhm, D Evangelista, Z Wu, M Betke, and T Hedrick (2014). A method for accurate multi-camera field videography. J exp Biol 217:1843-1848. The BibTeX entry is:

  author = {Theriault, D and Fuller, N and Jackson, B and Bluhm, E and Evangelista, D and Wu, Z and Betke, M and Hedrick, T},
  title = {A method for accurate multi-camera field videography},
  journal = {J exp Biol},
  year = {2014},
  volume = {217},
  pages = {1843--1848}

Thanks also to

Manolis Lourakis and Antonis Argyros, Ty Hedrick, Evan Bluhm, my mom and the academy

Release history Release notifications

History Node


History Node


History Node


History Node

History Node


History Node


This version
History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
sba-1.6.3.tar.gz (34.5 kB) Copy SHA256 hash SHA256 Source None May 29, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page