Calibration Formats¶
When saving a new calibration, the NxLib generally tries to preserve the current format on the camera. When this is not possible (e.g. because the new format uses features that cannot be represented in the old one), NxView will ask whether you want to upgrade the format. This can break compatibility with older versions of the NxLib, which will not be able to open the camera anymore. If you want to open such a camera with an older version of the NxLib, you will need to recompute its calibration data using this older version. See the guide on restoring factory calibrations for more information.
Forward and Backward Compatibility
All NxLib versions are fully backward compatible and can handle all older EEPROM formats. Forward compatibility is guaranteed from version 1.1.0 onwards. If you want to open a camera with a newer calibration with an older version of the NxLib, you can recompute the factory calibration from the raw calibration data.
Stereo Camera Calibration Formats¶
Calibration Format |
Supported in NxLib |
Changes to Previous Revision |
---|---|---|
2 |
all |
|
3 |
≥ 1.1.0 |
New distortion coefficient k3 |
4 |
≥ 1.2.0 |
Same as revision 3, but for the N20/N3x series |
5 / 6 |
≥ 1.3.146 |
Add support for dynamic calibration offsets |
7 / 8 |
≥ 2.1.126 |
Add support for the distortion coefficients rx and ry, which model sensor tilts |
9 / 10 |
≥ 2.3 |
Add support for a dynamic offset of the optical axis rotation |
11 / 12 |
≥ 3.2 |
Add support for skew parameters in the camera matrix |
Mono Camera Calibration Formats¶
Revision |
Full Revision Number 1 |
Supported in NxLib |
Changes to Previous Revision |
---|---|---|---|
2 |
2 |
all |
|
3 |
-2147483645 |
≥ 2.0.79 |
Supports more distortion coefficients |
4 |
-2147483644 |
≥ 2.3.19 |
Add support for the distortion coefficients rx and ry, which model sensor tilts |
- 1
From Revision 3 on, the monocular calibration get saved in the same area of the EEPROM as the stereo calibrations. To distinguish them, the monocular calibration versions have their highest bit set. The resulting full revision number is negative and will be displayed e.g. by the LoadCalibration command.