An “(invalid)” CCT label in darktable’s Color Calibration does not by itself mean chromatic adaptation failed. It means the current illuminant color is too far from the ideal daylight and black-body spectra for the displayed correlated color temperature to describe it reliably. Read the illuminant type and color patch, then choose the matching control; don’t treat an invalid number as a trustworthy temperature.
Read the label, then choose a control
The CCT sits beside a patch showing the calculated illuminant color projected into sRGB. Use the type label, not the patch’s appearance alone, to decide what the number means. darktable defines three relevant cases: daylight, black body, and invalid. The manual says daylight or black body is reported when the illuminant is within ±0.5% of the corresponding ideal spectrum. Its Color Calibration documentation recommends the D (daylight) illuminant for the first case, the Planckian (black body) illuminant for the second, and custom for invalid.
- In the CAT tab, note the CCT label and inspect the illuminant patch. Record how the illuminant was set, such as from camera metadata or an image picker.
- If the label says (daylight), use the D (daylight) model when you want to express that illuminant. If it says (black body), use Planckian. In either case, the displayed temperature has a meaningful relationship to the identified spectrum.
- If it says (invalid), don’t use that CCT as a reliable daylight or Planckian temperature. Select custom and set the illuminant color using hue and chroma, or use the picker when a suitable neutral patch is available.
- Compare the image with adaptation enabled and disabled as an editorial check. The patch represents the calculated illuminant; the manual says the adaptation aims to turn that color white. This comparison is a suggested visual check, not a guaranteed accuracy test.
Record an illuminant decision
Use this worksheet for a repeatable edit. The entries below are a hypothetical example, not darktable output or a measured result. “Warm amber” describes an observation of the patch; it is not a color measurement. The document describes hue and chroma controls in perceptual color space but does not prescribe a numeric target for this scene.
| CAT label | Patch and picker source | Control decision | Hypothetical note after switching |
|---|---|---|---|
| daylight | Pale yellow; camera metadata | D (daylight), retain displayed CCT as a meaningful daylight match | Record whether the patch and chosen temperature still match the intended scene description |
| black body | Warm orange; sampled neutral reference | Planckian; record the displayed temperature | Check the resulting image visually; the label identifies a close black-body match, not a quality score |
| invalid | Warm amber; whole-image average | Custom; record chosen hue and chroma | Note whether the custom settings changed on switching; the manual says switching to custom preserves prior settings, while other switches may not preserve them precisely |
Limits and next steps
An invalid label is about the relationship between the illuminant color and the temperature models; it does not automatically signal a broken adaptation algorithm. The manual states that the calculated illuminant color is still honored. Temperature is not a general description for every colored light, which is why custom hue and chroma are available. Use the actual type label: patch color alone cannot establish whether daylight or Planckian is the suitable model.
If the picker or whole-image estimate produced an implausible illuminant, reconsider the source before tuning custom controls. The documentation notes that averaging an image relies on the gray-world assumption and may fail for artificial scenes, including painted surfaces. Try a known neutral patch under the light being corrected, if one exists, or choose a custom color deliberately and record that it is a judgment rather than a measured value. Switching modes can also introduce rounding differences, so recheck the label, patch, and settings after changing modes.
Common questions
Does “invalid” mean the image cannot be white-balanced?
No. It says the displayed CCT is not a reliable match to daylight or black-body spectra. The manual says the adaptation still honors the illuminant color.
Should I enter the invalid CCT into a temperature control?
No. Treat it as an unreliable approximation, not a dependable temperature for either model. Use custom hue and chroma for this illuminant.
Will switching to custom keep the current illuminant color?
The manual says switching from any illuminant to custom preserves settings entirely. Switching between other modes, or from custom to another mode, may not preserve them precisely; check the resulting controls and patch.
Sources and next step
This guide interprets public documentation and uses explicitly hypothetical acceptance examples, not application tests. Controls and availability can change; verify the cited manual against your installed version.
For work created in Imagild, carry the input requirements and acceptance checklist into the photo editor. The external software controls discussed above belong to their respective products.