Skip to main content
Version: 12.1

Lookup Table

Purpose​

  • Create a pixel-wise lookup table for a single camera.

Usage​

metrical shape lut [OPTIONS] --camera <CAMERA> <PLEX_OR_RESULTS_PATH> <OUTPUT_DIR>

Concepts​

It's not always easy to adopt a new camera model. Sometimes, you just want to apply a correction and not have to worry about getting all of the math right. LUT mode gives you a shortcut: it describes the locations of the mapped pixel values required to apply a calibration to an entire image.

Note that a lookup table only describes the correction for an image of the same dimensions as the calibrated image. If you're trying to downsample or upsample an image, you'll need to derive a new lookup table for that image dimension.

These lookup tables can be used as-is using OpenCV's lookup table routines; see this open-source repo on applying lookup tables in OpenCV for an example.

Examples​

Create a correction lookup table for camera ir_one​

metrical shape lut --camera ir_one <PLEX_OR_RESULTS_PATH> <OUTPUT_DIR>

Arguments​

[PLEX_OR_RESULTS_PATH]​

The path to the input plex. This can be a MetriCal results JSON or a plex JSON.

[OUTPUT_DIR]​

The output directory for this shaping operation.

Options​

Universal Options​

As with every mode, all universal options are supported (though not all may be used).

-a, --camera [CAMERA]​

The camera to generate a LUT for. Must be a camera component reference such as a UUID or component p> name.