What are the basic low level steps involved in raw file conversion? In this article I will discuss what happens under the hood of digital camera raw converters in order to turn raw file data into a viewable image, a process sometimes referred to as ‘rendering’. We will use the following raw capture by a Nikon D610 to show how image information is transformed at every step along the way:
Rendering = Raw Conversion + Editing
The rendering process can be divided into two major components, Raw Conversion and Editing. Raw conversion is necessary to turn raw image data into a standard format that downstream software like Editors, Viewers and hardware output devices understand – usually a colorimetric RGB color space like Adobe or sRGB.
Editors on the other hand take image information in a standard color space and apply adjustments to it, to make the displayed image more ‘appropriate’ and/or ‘pleasing’ to the photographer.
An example of a pure raw converter is dcraw by David Coffin; an example of a pure editor is Photoshop by Adobe. Most Raw Converters actually combine raw conversion with some or a lot of Editing functionality (e.g. Capture NX, LR, C1 etc.).
The 7 Steps of Basic Raw Conversion
Where raw conversion ends and editing begins is somewhat of a fuzzy line but, depending on how one decides to segment them, there are only 7 steps involved in the basic conversion of a raw file into a standard (colorimetric) color space like sRGB. They don’t need to necessarily be applied in this sequence though this is a logical way to do it:
- Load linear data from the raw file and subtract Black Levels
- White Balance the data
- Correct linear brightness
- Properly Clip image data
- Demosaic it
- Apply Color Transforms and Corrections
- Apply Gamma
In basic raw conversion the process is linear until the very end. The gamma curve in the last step is ideally undone by the display device so the end-to-end imaging system – from light hitting sensor to light hitting eyes – is also approximately linear. If one is after a ‘faithful’ rendering of the image as captured from the sensing plane this is all one needs from a raw converter.
+ Tone Mapping: Adapting to Output Device DR
As we will see, however, basic linear raw conversion of files from current digital cameras is almost never satisfactory as-is because the vast majority of output devices (photo paper, monitors) have lower contrast ratios than that captured by a good quality digital camera these days. Therefore a correction is also pretty well mandatory in order to actively guide the tones present in the latter’s larger Dynamic Range into the formers’ smaller one. It can be just a simple contrast curve – or more sophisticated tone mapping coupled with separate local and global controls for shadows, highlights, clarity etc. (standard sliders in commercial raw converters and editors). It is normally performed in the editing portion of rendering – but if one is after ‘accurate’ color, tone mapping should ideally be part of Color Correction step 6 above, during raw conversion[1].
After the seven basic raw conversion steps an editor may then be used to objectively correct imperfections in the specific capture and display process – and/or to make the image subjectively more pleasing to the artist’s eye. For instance correct lens distortion and lateral chromatic aberration; or apply noise reduction; or apply capture/output sharpening. Some of these functions could arguably benefit from being performed in linear space before certain raw conversion steps above but for most purposes they are optional and they can be done just as well in an Editor after rendering in a gamma space.
In this article we will concentrate on the basic raw conversion portion of the rendering equation but leave tone mapping and editing for another time.
1. Load Raw Data and Subtract Blacks
This first step in raw conversion is simply to load linear image data from the raw file into memory as-is. Since raw file formats tend to be different and proprietary to camera manufacturers most raw converters use variations on open source LibRaw/dcraw to perform this task[2]. The following LibRaw or dcraw command line will repackage ‘raw’ raw image data into a linear 16-bit TIF file so that it can be read by the image processing application of choice (Matlab, ImageJ, PS etc.). There is no need for installation, just have the relative executable in the path or in the same directory as the raw file and take it from there.
unprocessed_raw -T yourRawFile
or
dcraw -d -4 -T yourRawFile
If your sensor is well designed and in-spec the recorded raw values are linear with incoming light intensity but they are typically stored with camera and channel specific positive offsets. These so-called Black Levels often have values in the few hundred to few thousand DN and need to be subtracted from the original raw data so that pixels show zero intensity with zero light. dcraw will do this for you (albeit somewhat generically) with the command line above. With unprocessed_raw you have to know the Black Level of your camera and perform the subtraction yourself (alternatively use the -B switch, which however does not seem to be supported in current LibRaw implementations).
As it turns out Nikon subtracts the Black Level of each channel before writing data to D610 raw files so either command works equally well for our reference capture. I loaded it with dcraw -d -4 -T which also scales the data to the 16 bit range (see step 3 on brightness correction below).
The loaded data at this stage simply represents the ‘grayscale’ intensity of the image – but it does have one to one correspondence to a position on the sensing plane associated to the specific color filter that it is sitting under. In Bayer sensors the layout is in rows of alternating red and green – and green and blue – filters as shown below. The exact layout is specified according to the order of the first quartet of the active area on the sensor, in this case RGGB as shown below but three other orders are possible[3].
The D610’s Bayer color filter array is laid out as RGGB quartets. The raw data looks as follows at this stage, an apparently underexposed grayscale image:
If it looks pitch black to you then your browser does not know how to display properly tagged linear data. Interestingly WordPress’s editor seems to show it fine while editing but, once published, Chrome itself does not (EDIT: it finally does now, in late 2019). For those of us in this predicament this is what the cfa grayscale image should look like instead[4]:
This is what linear cfa data looks like straight out of the file. It looks a bit dark because I Exposed this image To The Right in order not to clip the highlights of the waterfall – we’ll fix that later in the linear brightness correction step.
It looks like a fully formed grayscale image because of its small size but it’s not: even in uniformly illuminated areas pixelation caused by the different color information collected under adjacent color filters of differing spectral sensitivity can easily be seen by zooming in. This is what the portion of the image just below the left WhiBal gray card’s hole looks like at 600%:
2. White Balance Image Data
Because of the illuminant’s spectral energy distribution (in this case a partly overcast sky through the foliage) and the spectral sensitivity of the filters in the Color Filter Array sitting on the sensor, different color pixels record proportionately lower or higher counts even under the same light. This is especially obvious in neutral parts of the image which we expect to show the same mean count in each color plane when displayed. In this case the values on the neutral gray card show that red and blue pixels recorded on average 48.8% and 75.4% of the count of green pixels respectively so they appear darker when displayed.
The next step is therefore to apply White Balance to linear CFA image data by multiplying every red pixel by 2.0493 (1/48.8%) and every blue pixel by 1.3256 (1/75.4%)- to obtain a Camera Neutral grayscale image (in Adobe speak). This will ensure that, ignoring noise, pixels will all show similar linear values in neutral portions of the image:
Note how pixelation at the top of the image – the neutral gray card that was used as a reference for the multipliers – is gone but of course not in the colored portions of the image: intensity differences in the three channels there contain color information.
3. Correct Linear Brightness
Most current interchangeable lens digital cameras produce raw data of 12 or 14 linear bits . Standard integer file bit depth (jpeg, TIFF, PNG) however tend to come in multiples of 8, with 16-bit being the sweet spot for many editors today. We can’t simply save our black-subtracted, say, 14-bit data in a 16-bit format as-is otherwise it will all show up in the bottom 25% of the linear range and appear too dark. Ideally we would want clipping in the white-balanced, black-subtracted data from Step 2 to correspond to clipping in the 16-bit file and scale accordingly (see Step 4 below). A ballpark shortcut is to simply multiply the 14-bit data by four – effectively scaling it to 16 bits – and that’s what was done after subtracting blacks in step 1 above (dcraw -d -4 -T does that for you automatically while with unprocessed_raw you have to do it yourself after black subtraction).
While we are on the subject of scaling we may wish to adjust brightness to taste. This is somewhat of a subjective step and arguably should not be performed if one is after a ‘faithful’ rendering of the image projected on the sensing plane as captured in the raw file. However nobody always nails Exposure and different cameras often meter middle gray at different percentages of full scale in the raw data so it is useful to be able to correct rendered brightness. That’s why many raw converters call the relative slider Exposure Correction or Compensation (EC). Adobe also has a related DNG tag for normalizing Exposure metered by different cameras called BaselineExposure, which for the D610 happens to be 0.35 stops.
The image looks a bit dark for my taste and in fact the WhiBal gray card, which is designed to have about 50% reflectivity, measures out at only 17% of full scale as-is. Linear brightness correction simply means multiplying every pixel in the data by a constant factor. If we trusted that there were no highlights worth keeping above 100% diffuse white that constant in this example would be 50/17, equal to about a 1.5 stops correction. In this case I chose to apply a subjectively conservative +1.1 stops of linear brightening by multiplying all file data by a factor of 2.14, with this result:
That’s better. But as you can see the price to pay in order to keep the brightness correction linear are blown highlights in the waterfall. That’s where the advanced nonlinear highlight compression and shadow recovery sliders found in most real raw converters come in handy.
4. Ensure Even Clipping of the White Balanced Data
If the green channel was originally clipped in the raw data the other two may need to be clipped to full scale after application of the white balance multipliers in order to deal with the created non-linearity. Full scale is shown in the histograms below as normalized value 1.0 and it’s clear that the green channel in the original raw data of our capture was clipped (because of all the values piled up there) while the other two were not.
The reason for clipping at full scale is that when color information is not available from all three channels the rendered color will most likely be wrong. In the final image it could show as, for instance, a pinkish tinge in the highlights near saturation, below right. Very annoying in snowy mountain landscapes for instance. So clipping is an all-or-nothing solution to this problem.
The alternative to clipping would be to make some assumptions about the missing color and fill the relative data in: in advanced raw converters this is typically controlled by algorithms or sliders with names like highlight ‘reconstruction’. There are many ways to accomplish this feat. For instance if only one channel is missing, as is the case of green between 1.0 and 1.2 in Figure 8, the simplest is to assume that the highlight is near neutral/white and image raw data is properly white balanced – and therefore guess that in a given quartet if the green channel is clipped but the other two are not , the green channel could have a value equal to the average of the other two. You can also see that in this capture that strategy would at most be able to reconstruct only about 1/4 stop of highlights (log2(1.2)). Highlight compression and/or normalization of the new full scale back to 1.0 would then be needed to bring that 1/4 stop back into the fold.
5. Demosaic CFA Data
The CFA image was until this point on a single ‘grayscale’ plane therefore areas of color appeared pixelated as shown in Figure 6. The time has come to demosaic it, separating the red, green and blue pixels shown in Figure 2 onto their own individual, full-sized color planes by guesstimating the missing data (shown as white squares in the image below).
Any number of advanced demosaicing algorithms can be used for this step, most these days are mature and very good although some are better than others depending on the subject. Some raw converters like open source RawTherapee and dcraw offer the user the choice of a number of different algorithms. The majority of raw converters however do not offer that option, adopt/adapt one demosaicer and use it under the hood. Do you know what demosaicing algorithm your raw converter of choice uses?
For this test I decided to cheat and simply collapse every RGGB quartet into a single RGB pixel, keeping the R and B values for each quartet as they were in the raw data after white balancing – and averaging the two G’s (equivalent to dcraw -h mode). This is effectively 2×2 nearest neighbor demosaicing/resizing and results in a more manageable, smaller, half sized image (half linearly on each side, one quarter the area):
Figure 11 shows that our raw capture data is now in RGB format with three fully populated color planes. The colors are those recorded by the camera (can we say ‘camera space’?) as shown by your browser through your video path and monitor. They seem a bit bland but not too far off. The tones are not in a standard RGB color space, so imaging software and hardware down the line do not necessarily know what to make of them. The next step is therefore to convert these colors to a generally understood, colorimetric, standard color space.
6. Color Transformation and Correction
This is one of the less intuitive but more critical steps needed in order to produce a rendered image of pleasing color. Every manufacturer guards the recipes of the color filters in the CFA of their sensors closely but with the right equipment the relative spectral sensitivity functions are not too difficult to reverse engineer. In fact you can take an approximate peek at those of your camera with a cheap spectrometer[5].
With those in hand – and many assumptions about typical illuminants, scenes and viewers – a compromise color matrix can be generated to transform color obtained through a camera’s CFA image (like that shown in figure 11 above) to standard color understood by software like editors or browsers and devices like monitors or printers.
Luckily for us some excellent laboratories measure and calculate these linear color matrices – and make them freely available online. DXOmark.com for instance produces matrices to convert data from white balanced raw data to sRGB for two illuminants for every camera in their database (see the ‘Color Response’ tab). This is the one for the Nikon D610 under illuminant D50:
The best compromise matrix depends on the subject and the spectral power distribution of the illuminant at the time of capture so the actual matrix used is typically interpolated from a couple of references. In Adobe’s world today these are standard illuminants A and D65, which represent the extremes of typical illumination in day-to-day photography, from tungsten lighting to daylight shade/indoor. The converted data is then adapted to the illuminant expected by the final color space, D65 for sRGB for instance. The combined result is a matrix such as the one shown in Figure 12. It is then a simple matter of multiplying it by the RGB value of each demosaiced pixel after step 5 above, as shown in the next post.
Adobe suggests a more flexible process outlined in its DNG Converter specification[6]. Instead of going straight from camera CFA to colorimetric color space, it takes a spoke and hub approach, converting first into a Profile Connection color Space (XYZ D50) through multiplication of the white balanced and demosaiced data by an interpolated linear Forward Matrix; and then from there into a final color space like sRGB through standard matrices. Sometimes it also applies additional non linear color corrections according to custom profiles while in XYZ (HSV corrections via ProPhoto RGB, HueSatMap and LookTable in DNG speak).
Forward Matrices of the camera that took it are written into every DNG converted raw file, bless Adobe’s soul[7]. I lifted the ones for the D610 from there and Bradford-adapted XYZD50 -> sRGBD65 matrices from Bruce Lindbloom’s site in order to produce the final raw-converted image[8]:
The colors are now what they should be for display by software or devices that expect data in the sRGB color space. Just in case you were wondering this image looks virtually identical to one produced by Nikon’s Capture NX-D raw converter with the ‘Flat’ profile. However it does not look very incisive because of the poor contrast ratio of our monitors (see the Tone Mapping step below).
7. Apply Gamma
This last step depends on the chosen output color space, in this case sRGB’s approximately 2.2 gamma[9]. I mention it separately only to indicate the point at which the rendering process becomes necessarily non-linear. From this point on the image is in a colorimetric, gamma color space and can be properly handled by your Editor of choice or displayed as-is. In theory all previous steps were instead known and linear, hence easily reversible.
+ Tone Mapping
In 2016 a further tone correction is pretty well always needed before display in order to proactively choose how to squeeze the camera’s larger Dynamic Range into the output device’s smaller one. For instance, depending on your tolerance for noise, the D610 has a DR of 12+stops while my more than decent monitor has a contrast ratio of about 500:1 (or about 9 stops) when calibrated and profiled. This means that the bottom three+ stops of usable tones from the camera would never get displayed because they would not make it past the monitor’s backlight.
An RGB curve will subjectively redistribute tones throughout the range so that some shadow gradations will be more visible at the expense of some highlights’ (that’s why this is referred to as a ‘Tone Curve’). At the time of this writing this is a typical default one that Adobe applies in ACR/LR under the hood during rendering before the image is shown for the first time:
I didn’t use it in this case. I simply applied the ‘Increase Contrast’ curve and a touch of sharpening in Photoshop CS5 to the data in Figure 13 to produce the final rendered image:
Of course applying a contrast curve at such a late stage does cause some changes in chromaticity and saturation but that’s what happens when you implement these adjustments in a gamma RGB space after rendering. In any case this is typically how it has historically been done in-camera and by widely used raw converters therefore it is the procedure and look that we have become accustomed to over the years. The alternative for best perceptual ‘accuracy’ would instead be to use one of Torger’s excellent color profiles with built-in neutral tone reproduction operator during color correction step 6 – and never touch the tones again[PS].
Summarizing
So to recap the only steps needed for basic, linear luminosity and color, raw conversion are
- Get linear image data from the raw file and subtract Black Levels
- White Balance it
- Correct its Brightness
- Make sure it is properly clipped
- Demosaic it
- Apply Color Transforms and Corrections
- Apply Gamma
And you are done. Basic raw conversion demystified, not so complex after all.
Technical note: the call used in Matlab to produce the images in this article is shown below, with the 7 basic steps in the yellow section[10]:
s = raw2RGB(‘DSC_4022’ , ‘ROI’ , 1.1)
If you use this script, save the file as a TIFF once it has run, load it into a color managed editor and ‘Apply’ the chosen color space in order to see its colors properly.
Notes and References
1. See Anders Torger’s excellent site on the subject of color profiles.
2. Click on the relative link to download executables of LibRaw’s unprocessed_raw (found in the bin directory of the zip file) or deprecated dcraw (scroll down in page).
3. See here for a description of Bayer CFA quartets.
4. sRGB gamma applied for deficient browsers to all images except figures 2 and 3.
5. See here for an article on how to roughly measure the spectral distribution of your CFA + illuminant with an inexpensive spectrometer designed by a Harvard team.
6. Adobe’s Digital Negative specification version 1.4.0.0 corresponding to ‘Process 2012’ can be found here.
7. Reverse Matrices as used by dcraw are also there but the DNG spec says that “The use of the forward matrix tags is recommended for two reasons. First, it allows the camera profile creator to control the chromatic adaptation algorithm used to convert between the calibration illuminant and D50. Second, it causes the white balance adjustment [..] to be done by scaling the camera coordinates rather than by adapting the resulting XYZ values, which has been found to work better in extreme cases.”
8. You can read the detail of how the relative color matrices were applied here.
9. See section 8 here for how sRGB’s gamma is defined.
10. The Matlab scripts used to generate some of the figures in this post can be downloaded from here.
Hi Jack,
Thanks for the article, good work!
Kind regards
Erik
My pleasure Erik.
Hi Jack,
Thanks for this aproche! Yes, indeed. It is a time that AdobeCameraRaw gives the posibility to choise demosaicing-code, as RawTherapee give us. Or better, that Adobe works on better demosaicing-(workflow) at the beginning.
You are on the right way, to look for a better way to demosaice to each digicam properly! OK, but I think that could do all actual software, don’t it?!
Why they donnot?
Kind regards,
Jean Pierre
Hi Jean Pierre, it seems that advances in demosaicing algorithms have plateaued during the last few years and there are now several good ones. Perhaps it is easier to fine tune the raw conversion process to one demosaicing algorithm?
Jack
Thanks Jack,
Well, First of all – demosacing has to be correct -. Nowaday no Raw-Converter Software works really 100% correct. They use older algorith, which was developped at the time of CDD and the beginning of CMOS sensor, which has only 12 MP!
This year, I made a long serious tests about demosaicing with actual software, as ACR, C1, Silkypix, DXO optics Pro, Iridient, RawTherapee, darktable, Afinity Photo, PhotoNinja and other.
All of them not demosaice the details correct.
If you want to see a very good algorithm, then you can try RAW-Hide software: http://external.informer.com/my-spot.com/rhc%2F
But it works only for Windows!
The workflow after demosaicing is easy and it is not a problem with all image-software.
Thanks for the pointer Jean Pierre, I’ll look it up.
> Perhaps it is easier to fine tune the raw conversion process to one demosaicing algorithm?
I think it is easier just to buy /few/ better lens (and even pay LensRentals to align elements) and get a camera with EFCS
Jack, Thank you very much for an excellent post. While your straight forward and concise approach was a major strength of your post, I (for one) would be interested in followup with more details.
Hi Bill, thanks – and noted. What part(s) would you be interested in seeing more detail in?
Hi Jack,
I would say the two sections below are the ones I would like more information on.
5. Demosaic
6. Color transforms and corrections
Thanks,
Bill
Dear Sir,
I want a simple matlab code that can give the focal plane intensity distribution of a lens of given focal length and the aperture size. I tried many many times but the size of focal spot does not match with the theoretical calculations by formula. Some time sampling is an important issue. I was searching here and there and I come across your blog. I am reading and trying to understand the basics which no one teaches even in the best universities. I am struggling with the writing code of PSF. Please share your code with us.
Thank you very much.
regards
tilkesh
Hi Tilkesh, here is a numerical approach in 6 lines of matlab:
https://www.strollswithmydog.com/wavefront-to-psf-to-mtf-physical-units/
Hi Jack,
this is a really nice work! Could I ask what if I have one DNG file and would like to replace the cfa with my own data. Do you have any clue or ideas about this?
Thanks a lot!
Best,
Zhenzhang
Hi, thanks Zhenzhang.
The proper way to do what you suggest is using the DNG SDK, though the learning curve is what it is. I have a quick and dirty hack that works for my purposes in Matlab, I’ll send you an email.
Great article! Would you please fix the links to some of the images? some of them have “i0.wp.com” in them and they shouldn’t. Others seem fine.
Sure Eyal, thanks for the heads up. I changed them all to be https vs the old http and found a different source for dcraw.exe since Dave Coffin’s page has been down now for a while. Let me know if you have any additional issues.
Hello. Thank you for all your great articles.
Instead of tone mapping in this old method, how about adopting a system like OpenDRT?
I think the old method is less likely to cause problems with natural objects, but I don’t think that is the case with man-made objects that we see everyday.
Hello Takoyaki.
Ah, yes, the ever elusive search for the ultimate Tone Reproduction Operator (TMO/TRO). I didn’t know that OpenDRT had adopted Kim + Kautz’s empirical approach, interestingly it is the one that I use in my home brew routines. Imho it gives decent results but no better – or perhaps I am not using it properly. As mentioned in the article, in photographic practice with my hardware setup I have liked results from the one implemented by Anders Torger in DcamProf/Lumariver, though I am not sure what it is based on.
Jack
Thanks for getting back to me, Jack sensei!
OpenDRT is not a good option for fine art photography, but I could read the Nuke File and DCTL implementation and it was easy for me as a layman to understand. And of course, thanks to dcamprof and Anders Torger’s WEB site.
I know there are still significant hardware limitations, but I hope we can get a more natural looking image.