2 * Copyright (c) 2018-2020 NVIDIA CORPORATION. All rights reserved.
4 * NVIDIA Corporation and its licensors retain all intellectual property
5 * and proprietary rights in and to this software, related documentation
6 * and any modifications thereto. Any use, reproduction, disclosure or
7 * distribution of this software and related documentation without an express
8 * license agreement from NVIDIA Corporation is strictly prohibited.
11 @page dwx_calibration_ftheta_intrinsict Ftheta Intrinsics Calibration Tools
13 This application computes the coefficients for the FTheta model
14 projection polynomial given existing manufacturer look-up-table.
15 The tool extracts the intrinsics from the
16 manufacturers specifications and outputs the model to an existing `json`
17 rig configuration file, or alternatively to a new intrinsics file.
19 Note the tool does not estimate the f-theta model given april-tag or checkerboard images.
20 For that support refer to @ref dwx_intrinsics_constraints tool which is part of the calibration suite @ref dwx_camera_calibration.
22 @note SW Release Applicability: This tool is available in both <b>NVIDIA DriveWorks</b> and <b>NVIDIA DRIVE Software</b> releases.
24 @section dwx_calibration_ftheta_intrinsict_lut Look-up table
26 A tool expects a file with a look-up table for the lense defintion which has following format:
32 Where `<header_row>` is:
33 `Y Angle (deg) Tan Shift Sag Shift Real Height Ref. Height Distortion`
35 and each `<data_row_i>` is of the form:
36 `2.41642493 0.00008065 -0.00025752 0.27815842 0.27815015 0.00297360 %`,
37 with each float number to contain at least 2 digits after dot.
41 Expects the following arguments:
43 `--name` camera name, tool will output file named `name.json` unless
44 existing rig configuration (to be modified) is specified (see
47 `--lut` path to lens distortion lookup table
49 `--pitch` camera sensor pixel pitch (distance between pixels on sensor in um)
51 `--width` camera sensor image width (px)
53 `--height` camera sensor image height (px)
55 `--rigconfig` existing rig configuration file to modify (optional), tool
56 will update intrinsics of camera with corresponding name (see --name)
58 `--eepromFactoryConfig` path to eeprom factory file to update. If intrinsics are not present, it adds as new fields. The file is saved under the same name with _updated added
60 `--eepromWriteableConfig` path to eeprom writeable parameters file to generate