From cd502a22c7b0b4612a0912a6b58d0f5927b0f7fb Mon Sep 17 00:00:00 2001
From: Charlotte <69423184+tqpcharlie@users.noreply.github.com>
Date: Thu, 30 Oct 2025 12:49:57 -0400
Subject: [PATCH] Add message discouraging chessboard usage (#2160)
---
docs/source/docs/calibration/calibration.md | 4 ++++
.../src/components/cameras/CameraCalibrationCard.vue | 10 ++++++++++
2 files changed, 14 insertions(+)
diff --git a/docs/source/docs/calibration/calibration.md b/docs/source/docs/calibration/calibration.md
index 874e701d9..86fca266d 100644
--- a/docs/source/docs/calibration/calibration.md
+++ b/docs/source/docs/calibration/calibration.md
@@ -16,6 +16,10 @@ The calibration data collected during calibration is specific to each physical c
## Calibration Tips
+:::{warning}
+The usage of chessboards can result in bad calibration results if multiple similar images are taken. We strongly recommend that teams use Charuco boards instead!
+:::
+
Accurate camera calibration is required in order to get accurate pose measurements when using AprilTags and 3D mode. The tips below should help ensure success:
01. Ensure the images you take have the target in different positions and angles, with as big of a difference between angles as possible. It is important to make sure the target overlay still lines up with the board while doing this. Tilt no more than 45 degrees.
diff --git a/photon-client/src/components/cameras/CameraCalibrationCard.vue b/photon-client/src/components/cameras/CameraCalibrationCard.vue
index c664357f8..147ae35aa 100644
--- a/photon-client/src/components/cameras/CameraCalibrationCard.vue
+++ b/photon-client/src/components/cameras/CameraCalibrationCard.vue
@@ -311,6 +311,16 @@ const setSelectedVideoFormat = (format: VideoFormat) => {
:items="['Chessboard', 'Charuco']"
:disabled="isCalibrating"
/>
+