From 8fa0217ec9876d29ba3b72cce5c37ec3f17258b7 Mon Sep 17 00:00:00 2001
From: jaknapper <jaknapper@hotmail.com>
Date: Mon, 16 Mar 2026 15:49:51 +0000
Subject: [PATCH 1/5] Update camera cal instructions to look through empty area
 if possible

---
 .../cameraCalibrationSteps/camCalibrationExplanation.vue      | 4 +++-
 .../cameraCalibrationSteps/cameraMainCalibrationStep.vue      | 2 +-
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/webapp/src/components/modalComponents/calibrationWizardComponents/cameraCalibrationSteps/camCalibrationExplanation.vue b/webapp/src/components/modalComponents/calibrationWizardComponents/cameraCalibrationSteps/camCalibrationExplanation.vue
index 28243aa3..5b0918c1 100644
--- a/webapp/src/components/modalComponents/calibrationWizardComponents/cameraCalibrationSteps/camCalibrationExplanation.vue
+++ b/webapp/src/components/modalComponents/calibrationWizardComponents/cameraCalibrationSteps/camCalibrationExplanation.vue
@@ -4,7 +4,9 @@
       <b> Before starting camera calibration: </b>
     </p>
     <ul class="uk-list uk-list-bullet">
-      <li>Remove any samples from your microscope</li>
+      <li>Insert a slide.</li>
+      <li>Move your slide to an empty area, ideally looking through the coverslip.</li>
+      <li>If your slide has no empty areas, remove it and instead calibrate on no sample.</li>
       <li>Ensure your illumination is on, well focused, and centred.</li>
     </ul>
   </div>
diff --git a/webapp/src/components/modalComponents/calibrationWizardComponents/cameraCalibrationSteps/cameraMainCalibrationStep.vue b/webapp/src/components/modalComponents/calibrationWizardComponents/cameraCalibrationSteps/cameraMainCalibrationStep.vue
index ed0709e4..400ada49 100644
--- a/webapp/src/components/modalComponents/calibrationWizardComponents/cameraCalibrationSteps/cameraMainCalibrationStep.vue
+++ b/webapp/src/components/modalComponents/calibrationWizardComponents/cameraCalibrationSteps/cameraMainCalibrationStep.vue
@@ -1,7 +1,7 @@
 <template>
   <stepTemplateWithStream>
     <p>
-      <b>Once your field of view is empty and well illuminated, click Full Auto-Calibrate.</b>
+      <b>Once your field of view appears empty and well illuminated, click Full Auto-Calibrate.</b>
     </p>
 
     <template #below-stream>

From d693cb9bdd56f6b812b3efd5a0325efd154c43a6 Mon Sep 17 00:00:00 2001
From: Joe Knapper <jaknapper@hotmail.com>
Date: Mon, 16 Mar 2026 16:47:48 +0000
Subject: [PATCH 2/5] Added explicit wording for having no coverslip

---
 .../cameraCalibrationSteps/camCalibrationExplanation.vue      | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/webapp/src/components/modalComponents/calibrationWizardComponents/cameraCalibrationSteps/camCalibrationExplanation.vue b/webapp/src/components/modalComponents/calibrationWizardComponents/cameraCalibrationSteps/camCalibrationExplanation.vue
index 5b0918c1..f0e9f690 100644
--- a/webapp/src/components/modalComponents/calibrationWizardComponents/cameraCalibrationSteps/camCalibrationExplanation.vue
+++ b/webapp/src/components/modalComponents/calibrationWizardComponents/cameraCalibrationSteps/camCalibrationExplanation.vue
@@ -5,8 +5,8 @@
     </p>
     <ul class="uk-list uk-list-bullet">
       <li>Insert a slide.</li>
-      <li>Move your slide to an empty area, ideally looking through the coverslip.</li>
-      <li>If your slide has no empty areas, remove it and instead calibrate on no sample.</li>
+      <li>Move your slide to an empty area, ideally looking through the coverslip if your slide has one.</li>
+      <li>If your slide has no empty areas, remove it and instead calibrate with no sample.</li>
       <li>Ensure your illumination is on, well focused, and centred.</li>
     </ul>
   </div>

From 9db509de0950dac1b29d55c14371f189c3ea26c1 Mon Sep 17 00:00:00 2001
From: Joe Knapper <jaknapper@hotmail.com>
Date: Tue, 17 Mar 2026 11:56:21 +0000
Subject: [PATCH 3/5] Extra cam alignment step with stream

---
 .../camCalibrationExplanation.vue             | 30 ++++++++++-------
 .../cameraFocusStep.vue                       | 32 +++++++++++++++++++
 .../cameraCalibrationTask.vue                 |  2 ++
 .../csmSteps/focusStep.vue                    |  2 +-
 .../csmSteps/runCsmStep.vue                   |  2 +-
 5 files changed, 54 insertions(+), 14 deletions(-)
 create mode 100644 webapp/src/components/modalComponents/calibrationWizardComponents/cameraCalibrationSteps/cameraFocusStep.vue

diff --git a/webapp/src/components/modalComponents/calibrationWizardComponents/cameraCalibrationSteps/camCalibrationExplanation.vue b/webapp/src/components/modalComponents/calibrationWizardComponents/cameraCalibrationSteps/camCalibrationExplanation.vue
index f0e9f690..81b90632 100644
--- a/webapp/src/components/modalComponents/calibrationWizardComponents/cameraCalibrationSteps/camCalibrationExplanation.vue
+++ b/webapp/src/components/modalComponents/calibrationWizardComponents/cameraCalibrationSteps/camCalibrationExplanation.vue
@@ -1,19 +1,25 @@
 <template>
-  <div>
-    <p>
-      <b> Before starting camera calibration: </b>
-    </p>
-    <ul class="uk-list uk-list-bullet">
-      <li>Insert a slide.</li>
-      <li>Move your slide to an empty area, ideally looking through the coverslip if your slide has one.</li>
-      <li>If your slide has no empty areas, remove it and instead calibrate with no sample.</li>
-      <li>Ensure your illumination is on, well focused, and centred.</li>
-    </ul>
-  </div>
+  <stepTemplateWithStream>
+    <div>
+      <p>
+        <b> Before starting camera calibration: </b>
+      </p>
+      <ul class="uk-list uk-list-bullet">
+        <li>Ensure your illumination is on, well focused, and centred.</li>
+        <li>Insert a slide with some empty regions.</li>
+      </ul>
+    </div>
+  </stepTemplateWithStream>
 </template>
 
 <script>
+import stepTemplateWithStream from "../stepTemplateWithStream.vue";
 export default {
-  name: "CamCalibrationExplanation",
+  name: "CamExplanationStep",
+
+  components: {
+    stepTemplateWithStream,
+  },
 };
 </script>
+<style scoped></style>
diff --git a/webapp/src/components/modalComponents/calibrationWizardComponents/cameraCalibrationSteps/cameraFocusStep.vue b/webapp/src/components/modalComponents/calibrationWizardComponents/cameraCalibrationSteps/cameraFocusStep.vue
new file mode 100644
index 00000000..85ef8c35
--- /dev/null
+++ b/webapp/src/components/modalComponents/calibrationWizardComponents/cameraCalibrationSteps/cameraFocusStep.vue
@@ -0,0 +1,32 @@
+<template>
+  <stepTemplateWithStream>
+    <ul>
+      <li>
+        Move your slide to an empty area, ideally looking through the coverslip if your slide has
+        one.
+      </li>
+      <li>
+        Use the buttons below or Page Up/Down to defocus slightly, to make sure no features are
+        visible.
+      </li>
+      <li>If your slide has no empty areas, remove it and instead calibrate with no sample.</li>
+    </ul>
+    <template #below-stream>
+      <stageControlButtons :show-dpad="false" />
+    </template>
+  </stepTemplateWithStream>
+</template>
+
+<script>
+import stepTemplateWithStream from "../stepTemplateWithStream.vue";
+import stageControlButtons from "@/components/tabContentComponents/controlComponents/stageControlButtons.vue";
+export default {
+  name: "CameraFocusStep",
+
+  components: {
+    stepTemplateWithStream,
+    stageControlButtons,
+  },
+};
+</script>
+<style scoped></style>
diff --git a/webapp/src/components/modalComponents/calibrationWizardComponents/cameraCalibrationTask.vue b/webapp/src/components/modalComponents/calibrationWizardComponents/cameraCalibrationTask.vue
index 28c785a3..12e6e383 100644
--- a/webapp/src/components/modalComponents/calibrationWizardComponents/cameraCalibrationTask.vue
+++ b/webapp/src/components/modalComponents/calibrationWizardComponents/cameraCalibrationTask.vue
@@ -15,6 +15,7 @@ import calibrationWizardTask from "./calibrationWizardTask.vue";
 import camCalibrationExplanation from "./cameraCalibrationSteps/camCalibrationExplanation.vue";
 import cameraMainCalibrationStep from "./cameraCalibrationSteps/cameraMainCalibrationStep.vue";
 import { markRaw } from "vue";
+import CameraFocusStep from "./cameraCalibrationSteps/cameraFocusStep.vue";
 
 export default {
   name: "CameraCalibrationTask",
@@ -38,6 +39,7 @@ export default {
     return {
       steps: [
         { component: markRaw(camCalibrationExplanation) },
+        { component: markRaw(CameraFocusStep) },
         { component: markRaw(cameraMainCalibrationStep) },
       ],
     };
diff --git a/webapp/src/components/modalComponents/calibrationWizardComponents/csmSteps/focusStep.vue b/webapp/src/components/modalComponents/calibrationWizardComponents/csmSteps/focusStep.vue
index 847a4a2b..d1132822 100644
--- a/webapp/src/components/modalComponents/calibrationWizardComponents/csmSteps/focusStep.vue
+++ b/webapp/src/components/modalComponents/calibrationWizardComponents/csmSteps/focusStep.vue
@@ -12,7 +12,7 @@
 import stepTemplateWithStream from "../stepTemplateWithStream.vue";
 import stageControlButtons from "@/components/tabContentComponents/controlComponents/stageControlButtons.vue";
 export default {
-  name: "CameraMainCalibrationStep",
+  name: "CSMFocusStep",
 
   components: {
     stepTemplateWithStream,
diff --git a/webapp/src/components/modalComponents/calibrationWizardComponents/csmSteps/runCsmStep.vue b/webapp/src/components/modalComponents/calibrationWizardComponents/csmSteps/runCsmStep.vue
index 41eee4fd..cb32bd7f 100644
--- a/webapp/src/components/modalComponents/calibrationWizardComponents/csmSteps/runCsmStep.vue
+++ b/webapp/src/components/modalComponents/calibrationWizardComponents/csmSteps/runCsmStep.vue
@@ -20,7 +20,7 @@ import stepTemplateWithStream from "../stepTemplateWithStream.vue";
 import CSMCalibrationSettings from "../../../tabContentComponents/settingsComponents/CSMSettingsComponents/CSMCalibrationSettings.vue";
 
 export default {
-  name: "CameraMainCalibrationStep",
+  name: "CSMMainCalibrationStep",
 
   components: {
     stepTemplateWithStream,

From 87f5e1d1f8b470b0de20e9381ce38ebca240c99e Mon Sep 17 00:00:00 2001
From: Joe Knapper <jaknapper@hotmail.com>
Date: Tue, 17 Mar 2026 12:10:51 +0000
Subject: [PATCH 4/5] Reword illumination

---
 .../cameraCalibrationSteps/camCalibrationExplanation.vue     | 1 +
 .../cameraCalibrationSteps/cameraFocusStep.vue               | 1 -
 .../cameraCalibrationSteps/cameraMainCalibrationStep.vue     | 5 ++++-
 3 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/webapp/src/components/modalComponents/calibrationWizardComponents/cameraCalibrationSteps/camCalibrationExplanation.vue b/webapp/src/components/modalComponents/calibrationWizardComponents/cameraCalibrationSteps/camCalibrationExplanation.vue
index 81b90632..2fc38cfe 100644
--- a/webapp/src/components/modalComponents/calibrationWizardComponents/cameraCalibrationSteps/camCalibrationExplanation.vue
+++ b/webapp/src/components/modalComponents/calibrationWizardComponents/cameraCalibrationSteps/camCalibrationExplanation.vue
@@ -7,6 +7,7 @@
       <ul class="uk-list uk-list-bullet">
         <li>Ensure your illumination is on, well focused, and centred.</li>
         <li>Insert a slide with some empty regions.</li>
+        <li>If your slide has no empty areas, remove it and instead calibrate with no sample.</li>
       </ul>
     </div>
   </stepTemplateWithStream>
diff --git a/webapp/src/components/modalComponents/calibrationWizardComponents/cameraCalibrationSteps/cameraFocusStep.vue b/webapp/src/components/modalComponents/calibrationWizardComponents/cameraCalibrationSteps/cameraFocusStep.vue
index 85ef8c35..dd1653b8 100644
--- a/webapp/src/components/modalComponents/calibrationWizardComponents/cameraCalibrationSteps/cameraFocusStep.vue
+++ b/webapp/src/components/modalComponents/calibrationWizardComponents/cameraCalibrationSteps/cameraFocusStep.vue
@@ -9,7 +9,6 @@
         Use the buttons below or Page Up/Down to defocus slightly, to make sure no features are
         visible.
       </li>
-      <li>If your slide has no empty areas, remove it and instead calibrate with no sample.</li>
     </ul>
     <template #below-stream>
       <stageControlButtons :show-dpad="false" />
diff --git a/webapp/src/components/modalComponents/calibrationWizardComponents/cameraCalibrationSteps/cameraMainCalibrationStep.vue b/webapp/src/components/modalComponents/calibrationWizardComponents/cameraCalibrationSteps/cameraMainCalibrationStep.vue
index 400ada49..54243f77 100644
--- a/webapp/src/components/modalComponents/calibrationWizardComponents/cameraCalibrationSteps/cameraMainCalibrationStep.vue
+++ b/webapp/src/components/modalComponents/calibrationWizardComponents/cameraCalibrationSteps/cameraMainCalibrationStep.vue
@@ -1,7 +1,10 @@
 <template>
   <stepTemplateWithStream>
     <p>
-      <b>Once your field of view appears empty and well illuminated, click Full Auto-Calibrate.</b>
+      <b
+        >Once your field of view appears empty, and the illumination looks centred, click Full
+        Auto-Calibrate.</b
+      >
     </p>
 
     <template #below-stream>

From d7872186c53d8de9c0dc030de3ade23c723a3c60 Mon Sep 17 00:00:00 2001
From: Joe Knapper <joe.knapper@glasgow.ac.uk>
Date: Tue, 17 Mar 2026 13:38:17 +0000
Subject: [PATCH 5/5] Apply suggestions from code review of branch empty-cal

Co-authored-by: Beth Probert <beth_probert@outlook.com>
---
 .../cameraCalibrationSteps/camCalibrationExplanation.vue        | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/webapp/src/components/modalComponents/calibrationWizardComponents/cameraCalibrationSteps/camCalibrationExplanation.vue b/webapp/src/components/modalComponents/calibrationWizardComponents/cameraCalibrationSteps/camCalibrationExplanation.vue
index 2fc38cfe..4bb20f78 100644
--- a/webapp/src/components/modalComponents/calibrationWizardComponents/cameraCalibrationSteps/camCalibrationExplanation.vue
+++ b/webapp/src/components/modalComponents/calibrationWizardComponents/cameraCalibrationSteps/camCalibrationExplanation.vue
@@ -6,7 +6,7 @@
       </p>
       <ul class="uk-list uk-list-bullet">
         <li>Ensure your illumination is on, well focused, and centred.</li>
-        <li>Insert a slide with some empty regions.</li>
+        <li>Insert a slide with some empty areas.</li>
         <li>If your slide has no empty areas, remove it and instead calibrate with no sample.</li>
       </ul>
     </div>