ComfyUI Node
CV Calibrate Camera (ChArUco)
Camera intrinsics + lens distortion from a batch of ChArUco board photos - the robust alternative to 'CV Calibrate Camera (Chessboard)'. A plain chessboard view is thrown away unless EVERY inner corner is visible; a ChArUco view contributes whatever corners it can identify, so photos where the board runs off the frame or is partly occluded still count. That means fewer, easier shots for the same coverage - and coverage of the image CORNERS, which is exactly where distortion is estimated, is what a full-board requirement makes hardest. Views with too few corners are skipped. Failure-tolerant: fewer than 3 usable views returns found=false with an identity matrix and zero distortion.
CV Calibrate Camera (ChArUco)
- images
- camera_matrix
- dist_coeffs
- rms_error
- views_used
- corners_used
- found
◄dictionaryDICT_6X6_250►
◄cols5►
◄rows7►
◄cell_size0.040►
◄marker_ratio0.70►
◄min_corners6►
◄legacy_patternfalse►
Categoryimage/CV/features
Inputs (8)
| Name | Type | Default | Description |
|---|---|---|---|
| images | IMAGE | Batch of board photos from DIFFERENT angles and distances (>= 3 usable; ~15 gives a good fit). Tilt the board - views that are all fronto-parallel cannot separate focal length from distance. | |
| dictionary | COMBO | DICT_6X6_250 | Dictionary the board's markers were drawn from. |
| cols | INT | 52–50 | Chessboard squares across (as given to the board image node). |
| rows | INT | 72–50 | Chessboard squares down. |
| cell_size | FLOAT | 0.0400.0001–1000000 | Physical square size of the PRINTED board; it sets the world unit of the translation vectors. |
| marker_ratio | FLOAT | 0.700.05–0.95 | Marker edge as a fraction of the square - the value used to generate the board. |
| min_cornersopt | INT | 64–1000 | Skip a view that identifies fewer corners than this. Four is the theoretical minimum for a planar view; 6-10 keeps the fit stable. |
| legacy_patternopt | BOOLEAN | false | Set for boards generated by OpenCV before 4.6 (white top-left cell). |
Outputs (6)
| Name | Type | Description |
|---|---|---|
| camera_matrix | NPARRAY | 3x3 intrinsic matrix K (fx, fy, cx, cy). |
| dist_coeffs | NPARRAY | Distortion coefficients (k1, k2, p1, p2, k3). |
| rms_error | FLOAT | Mean reprojection error in pixels; lower is better (under ~1 is good). |
| views_used | INT | How many input views contributed corners - compare it with the batch size to see how many were skipped. |
| corners_used | INT | Total identified corners across all used views; this is the number that really drives the fit. |
| found | BOOLEAN | — |