darktable article lede image
On Lens Detection and Correction

On Lens Detection and Correction

darktable (and some other projects, like for example ufraw) don’t do any real lens detection or correction by itself. We depend on two libraries which in most cases are provided by the Linux distribution you’re using.

Lens Detection

Many image files contain metadata about how the image was created. In case of digital camera images, a standard called Exif is used, this standard allows a camera to record many details about how an image was taken. However Exif is not a singular well defined specification, there is a common part that is well defined, and there are the so-called MakerNotes. The MakerNotes are parts of Exif that each vendors gets to do with whatever they like. They are typically completely undocumented, and have to be reverse-engineered to be able to handle them in any way. For most vendors this reverse engineering has been done to some degree and at least parts of the MakerNotes can be deciphered most of the time.

It’s in these undocumented MakerNotes that the camera vendors tend to encode a lens id, this lens id typically is just a number for which the camera vendors provide no reference. And without a reference lookup table such a number is quite useless. Open source tools end up having to crowd source it and collate lensid – lensname pairs to be able to identify lenses. darktable, like many others, in particular uses the Exiv2 library.

You can use Exiv2’s command line tool to search for lens related tags in your own raw files like so:

# exiv2 -pt IMG_1234.CR2 | grep -ai lens

And if you have a lens that’s already been reported to the Exiv2 project, you’ll see something along these lines:

Exif.CanonCs.LensType       Short       1  Canon EF-S 24mm f/2.8 STM

However if you have a fairly new lens, chances are it hasn’t been reported yet, and you’ll get something like this:

Exif.CanonCs.LensType       Short       1  (4154)

There are also cases, where Exiv2 might report the wrong lens, this happens because the vendors don’t preallocate numbers for third party lens manufacturers, so they end up having to occupy random lens ids, which can end up conflicting with new first party lenses later on. Exiv2 tries to resolve such conflicts on a best effort basis using some heuristics, like trying to match min/max focal lengths and min/max aperture.

The Exiv2 project, like many open source projects, isn’t particularly overstaffed, so they tend to release fairly infrequently, thus the difference between what’s available in their development tree and what’s available in released distributions can diverge significantly. Practically this means that any lens newly released in the last 6 – 12 months is not likely to be detected properly.

So if you have a lens that is not being properly reported, the best course of action is to check Exiv2’s development sources, to see if it’s already known (the line references may drift over time, so you might need to scroll around a bit):

If you can find your lens in one of the above source files, it means even though your current version of Exiv2 might not recognize the lens, the developers are already aware of it, and a future release of Exiv2 will likely be able to recognize that lens. We highly recommend against trying to update your Exiv2 library manually.

If you still can’t find your lens, please file a feature request with the Exiv2 project here (and yes, you’ll need to create an account):

Please include the following information:

  • Full output of:

      exiv2 -pt FILENAME | grep -ai lens
  • The proper full name of the lens (be mindful of capitalization)

  • Preferably include a link to the lens’ product page on the manufacturers website

  • Attach a sample low resolution JPEG (unmodified, most cameras allow you to shoot lower resolution JPEGs)

Lens Correction

Presuming Exiv2 (and thus darktable) detects your lens properly, it passes the lens name off to the Lensfun library, which searches its own lens correction database for that particular name. And if it finds a match, it applies that correction data to your image.

But for this to work the name Exiv2 supplies and the name in the Lensfun database need to be a fairly close match. As far as I’m aware Lensfun does ignore punctuation, but other than that, you need a proper match for the correction to be automatic.

Also keep in mind that the lens correction data isn’t provided by the vendors, so this is yet again something that needs to be crowd sourced. However in stark contrast to the Exiv2 situation, the process of generating decent correction data is quite a bit more involved.

So if you’re missing your particular lens in your particular version of Lensfun, you can check here to see if your lens might already have correction data in Lensfun’s development tree:

As you might notice, not all types of correction are available for all lenses.

If you want to generate correction data for your own lenses and submit it to the Lensfun project, please have a look here:

Filed under: Blog
These are comments from the old website, archived as static HTML
  1. To improve the situation with exiv2 I would propose:

    1. Moving the lens information out of the cpp files into external files. This could be XML, JSON or any thing else.
    This would allow to add new lenses without to recompile exiv2.

    2. Move this files into extra packages, that can be released independent from from exiv2.

    3. With this changes it would be possible to create a website where everyone can upload an image. The EXIV information is read and the user can enter the name of the lens. This information get saved into the lens information file and can be released in the next version of this file. The user could even directly download the file and save it in the right folder and benefit immediately.

    4. darktable could add a function to click on an unknown lens, enter the name and save it locally into the lens information file. It would be even possible to send this information e.g. via a web-service back to the main project.

    With this implemented everyone would benefit:
    1. The exiv2 developers, because:
    a) They don't need to change the code for new lenses.
    b) They don't need to make new releases for new lenses.
    c) More users will add new lenses.

    2. The users and all project using exiv2 because:
    a) It will be easier to add new lenses.
    b) Faster benefit from the crowd sourced information.
    c) the exiv2 developer have more time to improve exiv2 instead of caring about adding new lenses to it.

    I think this sounds like a nice GSoC project or a crowd funding project.
  2. And how does Darktable/Lensfun/Exiv2 handle the teleconverters? How can I check whether one is supported? How do I profile one? Do I need to profile it together with the lens, or (somehow) separately? Does it need profiling with every single lens I intend to use it, or is it enough to profile it with just one lens?
  3. Have you considered including an internal snapshot of exiv2 to fallback on when system version is not adequate? Since exiv2 is also cmake-based, this should be quite trivial...
  4. Having lens recognition is a convenience feature, absolutely nothing critical depends on it. At worst, users can still manually select a random lens correction model.

    Bundling libraries is something we only consider as a last resort, considering it comes with serious security implications, and for those reasons, bundling libraries is, rightly so, heavily frowned upon by distributions.
  5. As far as I'm aware that's 100% a Lensfun matter, so I'd suggest asking them.
  6. As I already mentioned the Exiv2 project is not overstaffed by any stretch of the imagination. Like many open source projects.

    So when it comes down to it, they have to prioritize, and lens recognition, justifiably isn't high on that list. In the end it's merely a convenience.

    Having a web service to add lens ids, is just a hugely time consuming effort to make something that's already fairly simple, slightly simpler.

    Too many people just take these infra-structurally relevant projects for granted. What really needs to happen is for more people to step up, and invest significant amounts of their time on these projects.

    And GSoC isn't a silver bullet, it's just temporary manpower, that often requires a significant investment from the project to coach along. Net benefit wildly varies.
  7. @pmjdebruijn
    You are right that the web service is only a nice to have, but the first two points are the imported ones. If the developers would invest into moving this informations out of the source code they would even save time in the future.

    At the moment I'm not able to add and test a new Lens in Exiv2. If it would be only a text file it would be easy for me to add a line and directly test it.

    If I compare the actual situation it looks like this:
    Now I have to:
    - download the latest source code
    - prepare my system to compile it (installing compiler, dependencies...)
    - make the change
    - compile it
    - test it
    - summit the change upstream
    - crate a package and install it in my system
    -> benefit for me
    - Write a bugreport with the necessary information
    - Hope the Developer will find the time to integrate it
    - Wait for the next release of Exiv2
    - Wait for the next release of my Distribution
    -> benefit for all users

    With moving this information out of the code it would be:
    - Change a text file
    -> benefit for me

    - Write a bugreport with the necessary information
    - Hope the Developer will find the time to integrate it
    - Wait for the next release of Exiv2-Data
    - Wait for the next release of my Distribution
    -> benefit for all users

    What do you think would more users motivate to contribute?

    And always remember, not everyone is a developer.
  8. It's all completely moot until someone actually does it.

    Arguing about what you think the Exiv2 developers should do in one of our blog posts is extremely non-helpful.
  9. Torsten Bronger on Mon Feb 23 15:05:12 2015:
    A lens+teleconverter combination is treated as a lens of its own. It needs its own calibration, and its own entry in the lens list. One can not combine two calibrations in any way.
  10. Paul Henegan on Tue Feb 24 06:06:15 2015:
    "Torsten Bronger
    on February 23, 2015 at 16:05 said:
    A lens+teleconverter combination is treated as a lens of its own. It needs its own calibration, and its own entry in the lens list. One can not combine two calibrations in any way."

    That's a very important point. Thank you for clarifying that.
  11. Two of my Olympus-lenses are listed in Exiv2 (link from above), but not in Lensfun. The lenslist of Lensfun shows exactly the same lenses in the same order than the lenscorrection module in Darktable. So I think, Darktable uses Lensfun. Can I change that to Exiv2?
  12. Exiv2 only detects lenses, it doesn't know anything about corrections, so your question doesn't make sense - darktable uses both exiv2 and lensfun to do the tasks they were designed for.