From a534a19e2b112555889ce8f8b1e4f9a763b36164 Mon Sep 17 00:00:00 2001 From: Nico Stuurman Date: Sun, 8 Dec 2024 18:29:42 -0800 Subject: [PATCH] Added LIghtSheetControl plugin documentation. --- _pages/LightSheetControl.md | 69 ++++++++++++++++++++++++++++++++++ _pages/Utilities.md | 11 +++++- _pages/Version_2.0_Plugins.md | 1 + media/LightSheetControl.png | Bin 0 -> 35725 bytes 4 files changed, 80 insertions(+), 1 deletion(-) create mode 100644 _pages/LightSheetControl.md create mode 100644 media/LightSheetControl.png diff --git a/_pages/LightSheetControl.md b/_pages/LightSheetControl.md new file mode 100644 index 000000000..384609e29 --- /dev/null +++ b/_pages/LightSheetControl.md @@ -0,0 +1,69 @@ +--- +autogenerated: false +title: LightSheetControl - Automated stage synchronization +layout: page +--- + + + + + + + + + + + + + + + + + + + + +
+ +**Summary:** + + +This plugin was developed to facilitate synchronization of two stages in +a lightsheet microscope (fixed sheet illumination from the side, main stage moves the sample through the sheet, second stage moves the objective to keep the +sheet in focus). It can be used for all uses of the [Utilities-MultiStage](Utilities) +adapter to calibrate movement of the two stages. +
+ +**Authors:** + + +Kurt Thorn, refresh by Nico Stuurman +
+ +**License:** + + + +BSD + +
+ +**Platforms:** + + + +All supported platforms + +
+ + +### Operation + + +![](/media/LightSheetControl.png) + + +The following assumes that you have two stages, set as physical stages in the [Utilities-MultiStage device](Utilities). Move the first stage, for instance to the bottom of the sample, then move the second stage to get the sample in focus. Press "Add Reference Point". Move the sample up, refocus the second stage, add as a reference point, etc.. As you add points, the locations will be added to the graph in the bottom of the plugin and the the linear fit will be shown. You probably do not gain much by adding more than ~5 or so reference points, but the graph should help you judge. + +Control points can be saved to disk and re-loaded. This may be useful, for instance, when using multiple objective lenses, each of which may have its own +Multi-stage calibration. diff --git a/_pages/Utilities.md b/_pages/Utilities.md index cbfd5775f..c4eb09399 100644 --- a/_pages/Utilities.md +++ b/_pages/Utilities.md @@ -89,9 +89,18 @@ Improvements to the core have fixed this issue. Combines two physical 1D stages into a single logical 1D stage. The scale factor and offset for both physical stages are specified as -properties. Make sure to specify the properties "PhysicalStage-1" and +properties. When setting a position, all know stages will be moved +using the formula: + + +physicalPos = stageScalings_[i] * position + stageTranslations_[i]; +stage->SetPositionUm(physicalPos); + + +Make sure to specify the properties "PhysicalStage-1" and "PhysicalStage-2" (e.g. in System->Startup group preset). + ## Combo XY Stage Combines two physical 1D stages into a single logical 2D stage. The diff --git a/_pages/Version_2.0_Plugins.md b/_pages/Version_2.0_Plugins.md index 076595bb9..804d5791b 100644 --- a/_pages/Version_2.0_Plugins.md +++ b/_pages/Version_2.0_Plugins.md @@ -20,6 +20,7 @@ applications in microscopy: - [HCS Site Generator](HCS_Site_Generator) - [Intelligent Acquisition](Intelligent_Acquisition) - [Image Flipper](Image_Flipper) +- [LightSheetControl](LightSheetControl) - [Live Replay](Live_Replay) - [Localization Microscopy](Localization_Microscopy) - [MicroMagellan](MicroMagellan) diff --git a/media/LightSheetControl.png b/media/LightSheetControl.png new file mode 100644 index 0000000000000000000000000000000000000000..608e17785ab4bfc602dd9b39ffab8fa91dff15de GIT binary patch literal 35725 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 P_~$R>vr5?tCVu}9W6>PJ literal 0 HcmV?d00001