Skip to content

Commit 7b73811

Browse files
authored
Merge branch 'master' into patch-3
2 parents 2ae5768 + d3884cd commit 7b73811

19 files changed

Lines changed: 3694 additions & 169 deletions

Calibration.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
---
2+
title: Calibration
3+
layout: page
4+
description: Light-sheet calibration (alignment)
5+
---
6+
7+
{% include image src="1I_1D_OpenSPIM.png" width="70%" caption="OpenSPIM rendering with laser on" %}
8+
9+
Before using the OpenSPIM the light sheet needs to be [**aligned**](Light-sheet_Calibration).
10+
This means that the light sheet needs to be shaped by the optics of the system to be parallel to the imaging plane of the camera, perpendicular to the detection axis, as thin as possible, uniform across the field of view and, most importantly, in focus with the detection objective. Since the procedure is rather involved, we provide a series of detailed videos that illustrate the process. Innovations are welcome.
11+
12+
Although the light sheet is rather stable once aligned, it should be [**aligned**](Light-sheet_Calibration) at regular intervals or whenever the image quality or point spread function (PSF) of the beads looks suboptimal.
13+
14+
We also recommend examining the signal in the imaged specimen and tweaking the light sheet using the bottom knob on the lower left corner mirror of the set-up to optimize the image quality. The knob moves the light sheet roughly parallel to the focal plane of the detection lens, and thus moving it back and forth focuses the lens into the middle of the light sheet.
15+
16+
- **gel for bead scans and Matlab script to evaluate them**. Using this you can estimate the size of the PSF of your microscope
17+
18+
It is also possible to measure the [light-sheet thickness](Light_sheet_characterization) using a small mirror mounted in the sample chamber.

OpenSPIM_for_brains_setup.md

Lines changed: 66 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,66 @@
1+
---
2+
title: OpenSPIM for brains setup
3+
layout: page
4+
description: Additional setup tweaks
5+
---
6+
7+
The table below lists the parts used by the OpenSPIM for brains setup built by Monika Pawłowska (Nencki Institute of Experimental Biology, Warsaw).
8+
9+
<table>
10+
<tr class="header">
11+
<th>Manufacturer</th>
12+
<th>Accessibility</th>
13+
<th>Description</th>
14+
<th>File or Link/Model #</th>
15+
<th>Image</th>
16+
<th>Quantity</th>
17+
<th>Price (EUR)</th>
18+
</tr>
19+
<tr class="odd">
20+
<td>Nikon</td>
21+
<td align="center" bgcolor="pink">purchase</td>
22+
<td>4X Nikon Plan Fluorite Imaging Objective, 0.13 NA, 17.2 mm WD, dry</td>
23+
<td><a href="https://www.thorlabs.de/thorproduct.cfm?partnumber=N4X-PF">N4X-PF</a></td>
24+
<td align="center"><img src="images/Thorlabs_N4X-PF_objective.jpg" width="50%"></td>
25+
<td align="center">2 (or 3 for double illumination)</td>
26+
<td align-"center">410</td>
27+
</tr>
28+
<tr class="even">
29+
<td>Thorlabs</td>
30+
<td align="center" bgcolor="pink">purchase</td>
31+
<td>Translating Lens Mount for Ø1" Optics (for the objectives)</td>
32+
<td><a href="https://www.thorlabs.de/thorproduct.cfm?partnumber=LM1XY/M">LM1XY/M</a></td>
33+
<td align="center"><img src="images/Thorlabs_LM1XY_mount.jpg" width="50%">
34+
<td align="center">2 or 3</td>
35+
<td align="center">125</td>
36+
</tr>
37+
<tr class="odd">
38+
<td>Nikon</td>
39+
<td align="center" bgcolor="pink">purchase</td>
40+
<td>Infinity-Corrected Tube Lens for Plan Fluorite Objectives</td>
41+
<td><a href="https://www.thorlabs.de/thorproduct.cfm?partnumber=ITL200">ITL200</a></td>
42+
<td align="center"><img src="images/Thorlabs_ITL200_lens.jpg" width=50%"></td>
43+
<td align="center">1</td>
44+
<td align="center">405</td>
45+
</tr>
46+
<tr class="even">
47+
<td>Monika</td>
48+
<td align="center" bgcolor="green">self made</td>
49+
<td>This chamber can be 3D printed. For windows use 24x24 mm microscopy cover glasses and glue (eg. two component epoxy)</td>
50+
<td><a href="https://github.com/openspim/openspim-parts/blob/master/Chambers/Dry_Objectives_Chamber_and_Holder/Chamber.stl">Chamber.stl</a></td>
51+
<td align="center"><img src="images/Large_samples_chamber_3D.PNG" width="50%"></td>
52+
<td align="center">1</td>
53+
<td></td>
54+
</tr>
55+
<tr class="odd">
56+
<td>Monika</td>
57+
<td align="center" bgcolor="green">self made</td>
58+
<td>This holder includes two threaded holes so it's easiest to make from metal (eg aluminum). Holder is mounted on the 4D stage arm with M6 screw. Glass slide with 1 mm thickness can be held with nylon or nylon-tipped screw</td>
59+
<td>
60+
<a href="https://github.com/openspim/openspim-parts/blob/master/Chambers/Dry_Objectives_Chamber_and_Holder/Metal_Holder.pdf">Metal_Holder.pdf</a><br/>
61+
<a href="https://github.com/openspim/openspim-parts/blob/master/Chambers/Dry_Objectives_Chamber_and_Holder/Metal_Holder.step">Metal_Holder.step</a></td>
62+
<td align="center"><img src="images/Holder.PNG" width=40%></td>
63+
<td align="center">1</td>
64+
<td></td>
65+
</tr>
66+
</table>

Operation.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,8 @@ description: Operating the OpenSPIM microscope
55
---
66
Now that we have assembled the OpenSPIM microscope it is time to start using it. We will need to prepare a sample, align the light sheet (Calibration), set-up the acquisition and process the data.
77

8+
But first, what's the magic behind OpenSPIM? For some it might be a good idea to first undertsand some [fundamental principles of optics](https://openspim.org/SPIM_Optics_101) before proceeding.
9+
810
# Sample Preparation
911

1012
{% include video id="G6P52G06oPw" width="400" height="243" caption="Pulling Drosophila embryos in agarose inside a glass capillary (*with some priceless random audio*)" %}
@@ -19,17 +21,15 @@ Follow the link to check our resources for [**sample preparation**](Sample_Prepa
1921

2022
{% include image src="1I_1D_OpenSPIM.png" width="70%" caption="OpenSPIM rendering with laser on" %}
2123

22-
Before using the OpenSPIM the light sheet needs to be [**aligned**](Light-sheet_Calibration).
24+
Before using the OpenSPIM the light sheet needs to be [**aligned**](xopenspim/alignment_welcome).
2325
This means that the light sheet needs to be shaped by the optics of the system to be parallel to the imaging plane of the camera, perpendicular to the detection axis, as thin as possible, uniform across the field of view and, most importantly, in focus with the detection objective. Since the procedure is rather involved, we provide a series of detailed videos that illustrate the process. Innovations are welcome.
2426

25-
Although the light sheet is rather stable once aligned, it should be [**aligned**](Light-sheet_Calibration) at regular intervals or whenever the image quality or point spread function (PSF) of the beads looks suboptimal.
26-
27-
We also recommend examining the signal in the imaged specimen and tweaking the light sheet using the bottom knob on the lower left corner mirror of the set-up to optimize the image quality. The knob moves the light sheet roughly parallel to the focal plane of the detection lens, and thus moving it back and forth focuses the lens into the middle of the light sheet.
28-
29-
- **gel for bead scans and Matlab script to evaluate them**. Using this you can estimate the size of the PSF of your microscope
27+
Although the light sheet is rather stable once aligned, it should be [**aligned**](xopenspim/alignment_welcome) at regular intervals or whenever the image quality or point spread function (PSF) of the beads looks suboptimal.
3028

3129
It is also possible to measure the [light-sheet thickness](Light_sheet_characterization) using a small mirror mounted in the sample chamber.
3230

31+
Click [here](xopenspim/alignment_welcome) to follow the most recent OpenSPIM alignmetn guide (2021) and [here](Light-sheet_Calibration) for the original light-sheet calibration site (2013).
32+
3333
# Software
3434

3535
A new [µManager](https://micro-manager.org/) based OpenSPIM plugin called [μOpenSPIM](https://openspim.org/micro-openspim) has been developed. We recommend using [μOpenSPIM](https://openspim.org/micro-openspim) for any current OpenSPIM system that uses [µManager](https://micro-manager.org/).
@@ -45,7 +45,7 @@ The raw multi-view OpenSPIM data need to be processed in order to achieve *in to
4545
- [**Registration**](Registration) of multi-view OpenSPIM acquisition using bead based registration plugin in Fiji.
4646
- [**Fusion**](Fusion) of registered multi-view OpenSPIM data into s a single output image using content based fusion or multi-view deconvolution.
4747
- [**Time lapse registration**](Timelapse_Registration) of long-term time lapse data.
48-
- [**Browsing**](https://fiji.sc/BigDataViewer) of OpenSPIM data with Fiji's BigDataViewer (coming soon).
48+
- [**Browsing**](https://fiji.sc/BigDataViewer) of OpenSPIM data with Fiji's BigDataViewer.
4949
- **3D rendering** of fused OpenSPIM data (TBD).
5050

5151
If you have a cluster available, you could imitate the way the Tomancak group executes [SPIM Registration on their cluster](https://fiji.sc/SPIM_Registration_on_cluster).

People.md

Lines changed: 12 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -9,12 +9,20 @@ description: OpenSPIM people
99
<td><a href="https://www.mpi-cbg.de/research/research-groups/pavel-tomancak.html">Research Group Leader</a> at the MPI-CBG in Dresden. Provides ideas, concepts, research questions and funding.</td>
1010
</tr>
1111
<tr>
12-
<td align="center">{% include image src="Jan.jpg" width="40%" caption="Jan Huisken" %}</td>
13-
<td><a href="https://www.mpi-cbg.de/huisken">Research Group Leader</a> at the MPI-CBG in Dresden.</td>
12+
<td align="center">{% include image src="PeterGPitrone.png" width="40%" caption="Peter Gabriela Pitrone" %}</td>
13+
<td>Light Microscopist for Andor Technology. Designed and built the OpenSPIM.</td>
1414
</tr>
1515
<tr>
16-
<td align="center">{% include image src="PeterGPitrone.png" width="40%" caption="Peter Gabriela Pitrone" %}</td>
17-
<td>Microscopy technician in the <a href="https://www.mpi-cbg.de/research/research-groups/pavel-tomancak.html">Tomancak Lab</a>. Designed and built the OpenSPIM.</td>
16+
<td align="center">{% include image src="Johannes_Girstmair.jpg" width="40%" caption="Johannes Girstmair" %}</td>
17+
<td><a href="https://www.mpi-cbg.de/research/researchgroups/currentgroups/pavel-tomancak/group-members">Postdoc</a> at the MPI-CBG in Dresden. Dedicated to the developmental biology research of flatworms by using and further enhancing OpenSPIM.</td>
18+
</tr>
19+
<tr>
20+
<td align="center">{% include image src="HongKee_Moon.png" width="40%" caption="HongKee Moon" %}</td>
21+
<td><a href="https://www.mpi-cbg.de/research/research-groups/pavel-tomancak.html">Scientific Software Engineer</a> at the MPI-CBG in Dresden. Programmed and creates features for µOpenSPIM (the current graphical user interface for OpenSPIM users).</td>
22+
</tr>
23+
<tr>
24+
<td align="center">{% include image src="Jan.jpg" width="40%" caption="Jan Huisken" %}</td>
25+
<td><a href="https://www.mpi-cbg.de/huisken">Humboldt Professor of Multiscale Biology</a> at the University of Göttingen.</td>
1826
</tr>
1927
<tr>
2028
<td align="center">{% include image src="Kevin_eliceiri.jpg" width="40%" caption="Kevin Eliceiri" %}</td>

Setup_Extensions_and_Modifications.md

Lines changed: 10 additions & 77 deletions
Original file line numberDiff line numberDiff line change
@@ -3,32 +3,20 @@ title: Setup Extensions and Modifications
33
layout: page
44
description: Additional setup tweaks
55
---
6-
# Bright-field illumination
6+
## Bright-field illumination
77

88
Michael Redd from the Cell Imaging Core Facility at the University of Utah put together an Arduino-based solution to get proper bright-field illumination in an OpenSPIM setup: [Brightfield](Brightfield).
99

10-
# Shutter
10+
## Shutter
1111

1212
Instructions to make an Arduino-controlled shutter compatible with uManager: [paper by Todd P. Meyrath](http://george.ph.utexas.edu/~meyrath/informal/shutter.pdf) and [tutorial on the uManager page](https://micro-manager.org/wiki/Control_laser_shutters_with_Arduino).
1313

14-
# Stepper Motor Upgrade
14+
## Stepper Motor Upgrade
1515

16-
If you would like to swap out one of the Picard stepper motors you can do so with a bit of effort.
16+
[If you would like to swap out one of the Picard stepper motors you can do so with a bit of effort.](https://openspim.org/Stepper_Motor_Upgrade)
1717

18-
Instructions about how to go about this for a Thorlabs DRV001 connected via a Thorlabs BSC201 controller on a 64bit OpenSPIM setup are detailed below (by Jerome Boulanger and Ben Sutcliffe):
1918

20-
1. Download the micro-manager source code as instructed [here](https://micro-manager.org/wiki/Micro-Manager_Source_Code).
21-
2. Install all the relevant programs for building micro-manager as instructed [here](https://micro-manager.org/wiki/Building_MM_on_Windows).
22-
3. Setup up Visual C++ 2010 Express as [here](https://micro-manager.org/wiki/Visual_Studio_project_settings_for_device_adapters).
23-
4. Install the 64bit APT software from [Thorlabs](https://www.thorlabs.com/software_pages/ViewSoftwarePage.cfm?Code=Motion_Control&viewtab=1).
24-
5. Download and unzip the APTx64 form [here](https://micro-manager.org/wiki/File:APT_x64.zip).
25-
6. Then build the ThorlabsAPTStage Device Adapter in 64bit on a 64bit Windows 7 machine, using the 'APT.lib' downloaded in point 5.
26-
7. Rename the resulting .dll file to 'mmgr_dal_ThorlabAPTStage.dll' then place it into the OpenSPIM.app folder along with the 'APT.dll' downloaded in 5).
27-
8. The OpenSPIM Fiji/MM bundle can then restarted and a ThorlabAPTStage could be configured as described for a 32bit system [here](https://micro-manager.org/wiki/ThorlabsAPTStage).
28-
29-
More details to follow about incorporating this into the SPIMAcquisition plugin.
30-
31-
# OpenSPIM for large samples
19+
## OpenSPIM for large samples
3220

3321
## Field of view
3422

@@ -38,65 +26,10 @@ The original OpenSPIM uses a 2X expander to enlarge the laser beam to 2 mm. For
3826

3927
Immersion objectives with long working distance are hard to find. However, at low NA and moderate magnification, a dry objective will also work; the higher NA, the more spherical aberrations will be present. Keep in mind that when using a dry objective in immersion, the WD will increase (approximately by a factor equal to the RI of the new medium, eg. 17 mm in air will increase to 22.6 mm in water).
4028

41-
## Example parts list
29+
## OpenSPIM for brains setup
30+
31+
[Click here for a table that lists the parts used by the OpenSPIM for brains setup built by Monika Pawłowska (Nencki Institute of Experimental Biology, Warsaw).](https://openspim.org/OpenSPIM_for_brains_setup)
4232

43-
The table below lists the parts used by the OpenSPIM for brains setup built by Monika Pawłowska (Nencki Institute of Experimental Biology, Warsaw).
33+
## X-OpenSPIM example equipped with two laser lines and a cooling chamber
4434

45-
<table>
46-
<tr class="header">
47-
<th>Manufacturer</th>
48-
<th>Accessibility</th>
49-
<th>Description</th>
50-
<th>File or Link/Model #</th>
51-
<th>Image</th>
52-
<th>Quantity</th>
53-
<th>Price (EUR)</th>
54-
</tr>
55-
<tr class="odd">
56-
<td>Nikon</td>
57-
<td align="center" bgcolor="pink">purchase</td>
58-
<td>4X Nikon Plan Fluorite Imaging Objective, 0.13 NA, 17.2 mm WD, dry</td>
59-
<td><a href="https://www.thorlabs.de/thorproduct.cfm?partnumber=N4X-PF">N4X-PF</a></td>
60-
<td align="center"><img src="images/Thorlabs_N4X-PF_objective.jpg" width="50%"></td>
61-
<td align="center">2 (or 3 for double illumination)</td>
62-
<td align-"center">410</td>
63-
</tr>
64-
<tr class="even">
65-
<td>Thorlabs</td>
66-
<td align="center" bgcolor="pink">purchase</td>
67-
<td>Translating Lens Mount for Ø1" Optics (for the objectives)</td>
68-
<td><a href="https://www.thorlabs.de/thorproduct.cfm?partnumber=LM1XY/M">LM1XY/M</a></td>
69-
<td align="center"><img src="images/Thorlabs_LM1XY_mount.jpg" width="50%">
70-
<td align="center">2 or 3</td>
71-
<td align="center">125</td>
72-
</tr>
73-
<tr class="odd">
74-
<td>Nikon</td>
75-
<td align="center" bgcolor="pink">purchase</td>
76-
<td>Infinity-Corrected Tube Lens for Plan Fluorite Objectives</td>
77-
<td><a href="https://www.thorlabs.de/thorproduct.cfm?partnumber=ITL200">ITL200</a></td>
78-
<td align="center"><img src="images/Thorlabs_ITL200_lens.jpg" width=50%"></td>
79-
<td align="center">1</td>
80-
<td align="center">405</td>
81-
</tr>
82-
<tr class="even">
83-
<td>Monika</td>
84-
<td align="center" bgcolor="green">self made</td>
85-
<td>This chamber can be 3D printed. For windows use 24x24 mm microscopy cover glasses and glue (eg. two component epoxy)</td>
86-
<td><a href="https://github.com/openspim/openspim-parts/blob/master/Chambers/Dry_Objectives_Chamber_and_Holder/Chamber.stl">Chamber.stl</a></td>
87-
<td align="center"><img src="images/Large_samples_chamber_3D.PNG" width="50%"></td>
88-
<td align="center">1</td>
89-
<td></td>
90-
</tr>
91-
<tr class="odd">
92-
<td>Monika</td>
93-
<td align="center" bgcolor="green">self made</td>
94-
<td>This holder includes two threaded holes so it's easiest to make from metal (eg aluminum). Holder is mounted on the 4D stage arm with M6 screw. Glass slide with 1 mm thickness can be held with nylon or nylon-tipped screw</td>
95-
<td>
96-
<a href="https://github.com/openspim/openspim-parts/blob/master/Chambers/Dry_Objectives_Chamber_and_Holder/Metal_Holder.pdf">Metal_Holder.pdf</a><br/>
97-
<a href="https://github.com/openspim/openspim-parts/blob/master/Chambers/Dry_Objectives_Chamber_and_Holder/Metal_Holder.step">Metal_Holder.step</a></td>
98-
<td align="center"><img src="images/Holder.PNG" width=40%></td>
99-
<td align="center">1</td>
100-
<td></td>
101-
</tr>
102-
</table>
35+
A [detailed description of how an OpenSPIM can be upgraded](https://openspim.org/x-openspim_welcome) to contain a second illumination axis with two cameras and multiple laser lines under the control of an Arduino board. The system also features a cooling chamber.

Stepper_Motor_Upgrade.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
---
2+
title: Stepper Motor Upgrade
3+
layout: page
4+
description: Additional setup tweaks
5+
---
6+
7+
Instructions about how to go about this for a Thorlabs DRV001 connected via a Thorlabs BSC201 controller on a 64bit OpenSPIM setup are detailed below (by Jerome Boulanger and Ben Sutcliffe):
8+
9+
1. Download the micro-manager source code as instructed [here](https://micro-manager.org/wiki/Micro-Manager_Source_Code).
10+
2. Install all the relevant programs for building micro-manager as instructed [here](https://micro-manager.org/wiki/Building_MM_on_Windows).
11+
3. Setup up Visual C++ 2010 Express as [here](https://micro-manager.org/wiki/Visual_Studio_project_settings_for_device_adapters).
12+
4. Install the 64bit APT software from [Thorlabs](https://www.thorlabs.com/software_pages/ViewSoftwarePage.cfm?Code=Motion_Control&viewtab=1).
13+
5. Download and unzip the APTx64 form [here](https://micro-manager.org/wiki/File:APT_x64.zip).
14+
6. Then build the ThorlabsAPTStage Device Adapter in 64bit on a 64bit Windows 7 machine, using the 'APT.lib' downloaded in point 5.
15+
7. Rename the resulting .dll file to 'mmgr_dal_ThorlabAPTStage.dll' then place it into the OpenSPIM.app folder along with the 'APT.dll' downloaded in 5).
16+
8. The OpenSPIM Fiji/MM bundle can then restarted and a ThorlabAPTStage could be configured as described for a 32bit system [here](https://micro-manager.org/wiki/ThorlabsAPTStage).

0 commit comments

Comments
 (0)