Formatting Calibration Files - radiantlab/HDRICalibrationTool GitHub Wiki

See the ~\HDRICalibrationTool\examples directory for example inputs of LDR images and parameters (.cal and .rsp files, camera lens settings), provided by Clotilde Pierson's own research.

Below is a brief explanation of the example parameter formatting that the application's basic file validation looks for. The pipeline process will be blocked until all inputs are valid and formatted correctly.

[NOTICE] As of version 1.0.0, all calibration files must not contain any variables that are not defined


Calibration Files

All app validation removes whitespace before checking for file validity, so don't worry about spaces/tabs being the cause of an invalid file.

Vignetting

A valid Vignetting calibration file has the following variable definitions:

  • r
  • sf
  • ro
  • go
  • bo

Fisheye Correction

A valid Fisheye Correction calibration file has the following variable definitions:

  • map_inverse
  • inp_r
  • mapped_r
  • rmult
  • xoff
  • yoff
  • ro
  • go
  • bo
  • rad(r)

Calibration Factor

A valid Camera Factor calibration file has the following variable definitions:

  • ro
  • go
  • bo

Neutral Density Filter

A valid Neutral Density calibration file has the following variable definitions:

  • ro
  • go
  • bo

Response Function

A valid response function is formatted with the following criteria:

  • A function definition per R,G,B value (where the function is defined below)

  • Starts with a single integer with value 'n', whose value represents the order of the response function

  • n + 1 numeric values per R,G,B function, representing the factor of each term in the function, decreasing

    • Example: Input file:

    4 2.48363666666666 -2.57911666666665 1.00832766666665 0.0852399666666787 0.00191103299999811

    4 2.60823999999999 -2.7528533333333 1.0657643333333 0.0769006000000161 0.0019504099999977

    4 3.17448333333332 -3.61331666666663 1.40380333333329 0.0321496266666864 0.00287970333333048

    • Example: This first line translates to the function: Red f(x)= 2.48x^4 - 2.57x^3 + 1x^2 + 0.08x^1 + 0x^0