This is an old revision of the document!


CT-dSPIM Manual

The CT-dSPIM is a flexible and easy-to-use implementation of Selective Plane Illumination Microscopy (SPIM) that allows for dual views (d) of large samples such as cleared tissue (CT). Standardly, this SPIM configuration forgoes any standard microscope frame instead utilizing a Focusing Translation Platform (FTP)- two linear positioners mounted to an optical table as “stilts” for an XY stage. The SPIM head is installed over the stage and supported by solid stainless steel bars. This concept creates an extremely stable, versatile architecture that makes loading and viewing large samples easy.

Despite numerous differences, it shares many similarities with its older brother diSPIM and therefore this document will often reference the diSPIM and indicate similarities/differences as needed. Most users will benefit from controlling the CT-dSPIM with the free, open-source Micro-Manager diSPIM plugin for both alignment and acquisitions.

This document concentrates on the assembly, setup, and alignment of the CT-dSPIM.

Overview

Two objectives are placed at right angles to one another, each 45° from vertical, above a horizontally-mounted sample. A light sheet is created from one objective and then imaged through the other objective. A stack of images is collected by moving the light sheet through the sample or the sample through the light sheet. The advantage of being dual-sided is that the role of the two objectives can be reversed to collect a second stack from a perpendicular direction. The two optical paths are usually symmetric, and are designated Path A and Path B. (The two paths are described in detail in the diSPIM Plugin User Guide.) The two datasets can be computationally merged for improved resolution isotropy.

 Typical complete diSPIM system on RAMM frame showing major components. Figure 1: Typical diSPIM system on RAMM frame showing many major components in common with the CT-dSPIM: 3) SPIM arm mount (RAO-0046), 4) objective mounting assembly, 8) MIM-CUBE-II w/ mirror, 9) MIM-CUBE-II w/ fluorescence filters, 10) C60-TUBE_B imaging tube lens, 11) C60-TUBE_160 scanner tube lens, 12) 50 mm extension tube, 13) MM-SCAN_1M light sheet scanner, 14) MS-2500 XY stage.

Typical ct-dSPIM Figure 2: Typical ct-dSPIM system has the SPIM head supported by stainless steel posts over a FTP (an XY stage mounted to Z-axis stilts).

Assembly

The relevant sections of the diSPIM assembly video are embedded. (For now, there is not a CT-dSPIM specific assembly video.)

FTP (XYZ Stage)

Tools: 4 mm and 5 mm hex drivers

Individually, the stilts of the FTP are linear, or single axis, stages. In the firmware, one of them is designated the master axis and the other the slave.1) Any time [they are both plugged in and] the master is commanded to move, the slave will move as if given the same command.2)

Together, the stilts of the FTP produce movement in the Z-axis, raising and lowering the entire stage, insert/chamber, and sample.

Mount the stilts to the breadboard, align them if necessary, and mount the XY stage to the stilts. ASI has a detailed FTP setup guide on their documentation site.

SPIM Head

Tools: 6 hex driver from ct-spim document in Google Drive Post Mount Rods Mount the post mount rods, ~55 cm center to center, to the optic table with four M6 x 25 mm bolts. The retaining collars are already installed on your posts at the same height; they can be adjusted later. Place the black rod-to-rod 90° connector on top of the retaining collars on both posts as in Figure 1. Do not tighten them yet. Insert the shorter horizontal rod (attached to a black S-shaped arm with a split ring on the end) all the way into the black connector. Tighten the clamp so that the split rings are symmetrical: up ~45°, towards the center, and almost exactly 20 cm center to center (the distance between CUBE-IIIs, center to center). Leave the connection around the vertical post loose. SPIM Head Attach the camera and scanner tube lenses using a 1.5 mm hex driver, see Figure 3.

Figure 2: The camera and scanner tube lenses mount via three set screws in the CUBE-IIIs.

Lift the SPIM head and insert the tube lenses all the way, until the cubes are up against the split rings. You may need to loosen the clamps around the horizontal bars. Make sure you support the SPIM head any time the horizontal bars are not tightly clamped. Level the SPIM head; support its weight and loosen all 4 clamps. After it is level, engage the clamps on all 4 rod connection points. The two sides should be symmetric. Tighten the bolts on the split ring, alternately tightening one bolt a bit (less one turn) and then the other, otherwise the asymmetric tension can cause the split ring to bind up. If you need to move the SPIM head up or down, support the SPIM head, loosen the retaining collars on the vertical rods and move them along the posts, and finally re-lock onto the vertical rods.

Scanners

Tools: 2 mm hex driver
The video is cued up to show the process for mounting the scanners.

Locate the scanners (light sheet generators), C-mount adapters, scanner tube lenses, and spacers. Attach the scanners to the C-mount adapters, as in Figure 3. Attach the tube lens assembly to the lower CUBE-III adapter ring via three set screws requiring a 2 mm hex driver, Figure 4.

The scanners should be attached to the tube lenses so the fiber connectors are facing up and in toward the center at a 45° angle from vertical, as shown in Figure 6. Coarse rotation of the scanner is best done by loosening the set screws between the tube lens and C-mount adapter. Be sure all of the set screws on the tube lenses, spacers, and cubes are snug and the that scanners cannot wiggle around on the mount. Fine rotation can be done by grasping the tube lens firmly and turning it; the set screws will slip a bit, allowing the tube body to rotate relative to the spacer or C60-CUBE-III.

Scanner attached to C-mount adapter (left); tube lens and spacer (right) Figure 3: Scanner attached to C-mount adapter (left); 160 mm focal length tube lens and 10 mm spacer (right) ready to be mounted Tube lens assembly attaches to lower cubes on the microscope Figure 4: 160 mm F.L. tube lenses and spacers mount to the lower, or inner, CUBE-IIIs before the scannner / C-mount adapter are installed Scanner A poorly aligned Figure 5: Path A scanner with poor alignment Scanner A well aligned Figure 6: Path A scanner with good alignment

Cameras

Compatibility

Support for the SPIM cameras must be added to the plugin code on a case-by case basis.3) Please contact the plugin authors with requests to add support for other cameras. Currently the supported cameras are:

  • Andor sCMOS cameras
  • Hamamatsu Flash 4
  • PCO Edge
  • Photometrics Prime 95B

If your cameras use Camera Link, install the frame grabber cards and drivers in the host computer according to the manufacturer’s instructions. Connect each camera’s data cables and power cable. The camera trigger cables should be connected to the Tiger PLC. There are more details on each camera in the section on Hardware Configuration.

Orient & Connect

Tools: 2 mm hex driver
The video is cued up to show the process for mounting and orienting the cameras.

Depending on the accessibility of your system, it may be advantageous to connect all of the camera's cables (power, data, trigger) before mounting them to their tube lenses. As with the scanners, a C-mount-to-tube-lens adapter is used. Screw the adapter's C-mount onto the camera before orienting and mounting them.

For thin samples, having the beam enter the camera's field of view (FOV) from the top or bottom may be advantageous because the light sheet's intersection with the coverslip is a horizontal line and can be read out with fewer rows. However, the cameras are usually oriented so the beam enters the FOV from the side so the cameras’ light sheet mode, or rolling shutter, can be utilized. There are two common ways of orienting the cameras that differ by 180° for both cameras: the ASI convention and the Shroff lab convention. They both have the cameras tilted 45° from vertical (else the beam would appear diagonally in the field of view) and 90° from one another, with the beam entering from the side. Depending on the camera orientation, a constant rotation step may be necessary when beginning the registration step of the data analysis.

The convention the Shroff lab uses in their Nature protocols paper has the cameras rotated so that the beam enters from the same side of the field as the camera is on. On Path A, the beam from the left scanner appears to the right camera as entering from the right. The convention ASI uses has the beam cross the field of view in the same direction that it travels across (the front-view of) the microscope. On Path A, the beam from the left scanner appears to the right camera as entering from the left.

(After deciding how to orient the cameras, label the corner that goes “up” for future reference in case you have to remove and replace the camera.)

Camera orientation table Figure 7: Currently supported sCMOS cameras oriented in Shroff Lab and ASI conventions as seen from the back of the microscope; power switches highlighted in red

 Andor Zyla cameras according to ASI convention Figure 8: Andor Zyla cameras oriented according to ASI convention.

 PCO Edge cameras according to Shroff lab convention Figure 9: PCO Edge cameras oriented according to Shroff lab convention.

Objectives

Tools: 1.5 mm hex driver
The video is cued up to show the process for mounting the objectives (on a diSPIM) with a discussion of the two optical paths, Path A and Path B at the end.

The objective mounting assembly includes an objective lateral positioner assembly (OBLPA) for one side and a replacement spacer for the other, each with a bushing that the objective screws into. The assembly mounts to the right angle bracket via dovetail joint and is secured into position via set screw. Due to the long working distance of the objectives used by the ct-dSPIM, it is not necessary to remove the objective mounting assemblies in order to install the objectives; if you choose to do so, use a 1.5 mm hex driver to loosen the center set screw on the end of the right angle bracket, as in Figure 10, grip the assembly by the front and back, and pull towards you (while pushing on the right angle bracket). When you re-insert the assembly, it will “click” into position, and then the set screw must be re-tightened.

After the objectives are screwed into the bushings, use the OBLPA adjustment screw and the two objective bushings to move the objectives until they are visually symmetric from the front, as in Figure 11, and visually aligned when viewed from the side of the microscope.

 Set screw for loosening the objective mounting assembly from the SPIM arm Figure 10: Side view of SPIM head: set screw for securing the piezo assembly to the SPIM arm and on either side is a screw with ball-nose spring plunger that allows causes the assembly to "click" into place Nominal spacing between these objectives is ~12 mm Figure 11: Special Optics ~17x, 0.4 NA, 12 mm WD objectives co-focused with ~12 mm gap Cleared tissue objectives mounted to SPIM head Figure 12: Cleared tissue objectives in dipping media; the silver knob near the right objective is part of the OBLPA which produces lateral movement for the in the Y-axis to facilitate co-focusing the objectives

Cables

Tiger controller

The electrical components of the diSPIM are controlled by ASI’s modular TG-1000 which comes in an 8- or 16- variety. Set up the controller in a location where the indicator lights are visible. See the controller page for details on Tiger firmware; full documentation of the controller is on ASI's website. The Tiger controller’s power switch should always be switched to “off” when connecting or disconnecting cables. The Tiger controller uses a universal power cable (as for a computer) that plugs into the back of the unit.

TG-8 Figure 13: Tiger controller with 8 slots TG-16 Figure 14: Tiger controller with 16 slots

Connect each card’s cables:
(0) TIG/COM

  • USB 2.0 Type B to host computer USB 2.0 Type A
  • DE-15 to four-axis Joypod (joystick/knob) DE-15

1: X/Y

  • DB-25 to X-axis then Y-axis
  • Hirose 4 pin to dimmable LED illuminator SubMiniature v.B

2: Z/F

  • DB-25 to inverted microscope focus Z-axis then SPIM focus F-axis
  • Hirose 4 pin to dimmable LED illuminator SubMiniature v.B

3: MICROMIRROR

  • DE-09 (like VGA) to either Path A scanner (axes A/B4)) then Path B scanner (axes C/D), or scanner with anti-striping micromirrors

4: P

  • DE-09 to P-axis (right) POM

5: Q

  • DE-09 to Q-axis (left) POM
  • Check serial numbers on the POMs and controller faceplates to be sure to connect the cables to the correct controller module.

6: PLC5)

  1. BNC to Light Path A camera trigger
  2. BNC to Light Path B camera trigger
  3. N/A standardly; can be configured as global shutter or ongoing acquisition signal
  4. BNC to Laser side select
  5. BNC to Laser #1 on/off
  6. BNC to Laser #2 on/off
  7. BNC to Laser #3 on/off
  8. BNC to Laser #4 on/off

Other cables

Connect the power and/or data cables to the two cameras and two scanners if you have not already done so.

Specialty cables from ASI are labeled, but the two cameras and scanners are identical, so take special care to keep straight which cables go where so that the control software can work as intended. The POMs look identical but are labeled “P” and “Q”; take care to install them correctly as well.

Laser and Fiber Optics

Many possible laser configurations that are theoretically supported. A single fiber coupled laser with a splitter can serve both scanners. In this configuration both output fibers have light simultaneously, but the scanners can be steered to their blanking position6) to act as (imperfect) shutters with ~0.1% transmission. More commonly, a laser merge module is used to control multiple laser lines with dual outputs and a routing switch.

Whatever your setup, hook up your laser and run the fiber optics to the scanners if you have not already.

Filters and Mirrors

Tools: ASI ring tool, small Phillips head screwdriver, 2 mm hex driver
The video is cued up to show the process for installing an excitation filter, emission filter, and dichroic filter.

Install dichroics and filters in the Dichroic Cube, aka D-CUBE, according to manufacturer's instructions. It accommodates 25 mm diameter emission and excitation filters, and a 26 x 28 mm dichroic mirror; the standard D-CUBE accommodates 1 or 2 mm dichroics, but there is another version for 3 mm dichroics. If using a 1 mm dichroic, use the included bronze spacer. If excitation filters aren’t used, that half of the D-CUBE can be left out entirely. After the filters are installed in the D-CUBE, the D-CUBE is installed on the male dovetail on the removable faceplate of the CUBE-III.

Notice: It is easy to warp dichroic mirrors enough to induce aberrations; only lightly tighten the retaining clip of the D-CUBE.






The CUBE-III faceplates are removed from the CUBE-III body via the three spring-loaded shoulder bolts. Install the D-CUBE on a CUBE-III faceplate's male dovetail and secure it into position via the two screws in the front plate; one eccentric set screw, one nylon tipped. (Align the D-CUBE slot with the eccentric screw and tighten until the cam engages the slot. Get the D-CUBE into a neutral/central position and tighten the nylon-tipped set screw to hold the cube in place.) Reinstall the CUBE faceplates and dichroic filters into the appropriate C60-CUBE-IIIs.

Next, install the right angle mirror/s in the appropriate C60-CUBE-III (again on the faceplate's male dovetail) and reinstall the in order to complete the imaging path/s.

The video is cued up to show the process for installing filters and mirrors on a diSPIM; many of the principles apply to other SPIM configurations and scopes as well.

Internal dichroic/filter cube (D-CUBE) Figure 15: Disassembled dichroic/filter cube, D-CUBE; installed into CUBE-III

Cube installed on the C60-DOVE-II adjustable cube dovetail mount. There are two set screws on the dovetail mount. One has a small cam end that engages a slot in the internal cube. Align the filter cube slot with this screw and tighten until the cam engages the slot. The cam will allow the cube to be moved slightly up and down. Place in the neutral position and tighten the nylon-tipped set screw to hold the cube in place. Figure 16: D-CUBE installed on the dovetail mount (CUBE-II pictured), left, with a bottom view of the filter cube, right

 Right angle mirror on dovetail mount Figure 17: Right angle mirror installed on the dovetail mount

Alignment

The relevant sections of the diSPIM alignment video are embedded.

Getting started with Micro-Manager

Micro-Manager is a free and open-source GUI software package available at https://micro-manager.org/. It includes a plugin that facilitates alignment and use of the system. If you are not familiar with Micro-Manager, it is worth reading the User’s Guide and Hardware Configuration Guide before proceeding. Directions for getting started are presented below; find more details in the Micro-Manager diSPIM Plugin User Guide. The diSPIM plugin is fully functional but also continually being improved; accessing new features is as simple as installing the latest Micro-Manager version. Nightly builds are usually functional and include the latest improvements; a major release happens every quarter. If you discover problems with Micro-Manager, please report it to the developers under Help > Report Problem. If you encounter problems in the diSPIM plugin, or have feature requests, please contact the plugin authors.

Hardware Configuration

The video is cued up to show the process for configuring your hardware in Micro-Manager and creating the extremely useful configuration groups “Startup” and “Shutdown”.
Certain cameras, e.g. AndorSDK3 and PCO cameras, require drivers be copied into the Micro-Manager install directory; consult the Micro-Manager wiki regarding individual devices or manufacturer’s instructions for details.

Use Tools > Hardware Configuration Wizard to create a Micro-Manager hardware configuration with all the relevant devices.

  • Turn on the Tiger controller. Select ASITiger > TigerCommHub from the list of available devices. Click Add… then Scan to load all of its peripherals (with the possible exception of the LED shutter).
  • Add both cameras, i.e. two instances of the camera. Support for the SPIM cameras must be added to the plugin code on a case-by case basis.3) Please contact the plugin authors with requests to add support for other cameras. Currently, there are four supported cameras, each with special considerations:
    • Andor sCMOS: Use the AndorSDK3 adapter. The bit depth defaults to 12-bit but if you want different the best fix is to add an assignment in Micro-Manager’s “System” group “Startup” preset (see the Configuration Guide).
    • Hamamatsu Flash 4: Use the HamamatsuHam device adapter. Trigger polarity defaults to negative; the best fix is to add an assignment in Micro-Manager’s “System” group “Startup” preset (see the Configuration Guide).
    • PCO Edge: Use the PCO_Camera adapter. Property PixelRate defaults to slow, but for fast frame rates you probably want the fast scan; the best fix is to add an assignment in Micro-Manager’s “System” group “Startup” preset (see the Configuration Guide).
    • Photometrics Prime 95B: Use the PVCAM adapter. Timing calculations won't be accurate until a snap or live has been run after changing any camera setting.
  • Select Utilities > Multi Camera. Assign the properties “MultiCam-Physical Camera 1” and “MultiCam-Physical Camera 2” to the two cameras, ideally using the special “System” configuration group with preset name “Startup” as described in the Micro-manager wiki page.

Normally the laser on/off is controlled by Tiger PLC outputs. Lasers (on outputs 5-8) can be given a user-defined label in Micro-Manager. Define presets using the property “OutputChannel” of the PLogic device (a shutter). In Micro-Manager, the lasers should only get turned on and off via the Tiger controller and the PLogic shutter, with the correct laser selected by the OutputChannel property. You should not directly turn the laser on/off using the device adapter properties of the laser.

Plugin

The video is cued up to show a brief tour of the plugin (with attention to the Devices tab at 12:25).

Open the diSPIM plugin through the Micro-Manager window: Plugins > Device Control > ASI diSPIM. Keep the main Micro-Manager window accessible; the plugin generally does not duplicate functionality provided there. The GUI will preserve most of your settings, others are stored on the Tiger controller (e.g. sheet sizes). The Devices tab must be configured before most of the plugin’s features may be accessed.

Stage limits

Tools: 1.5 mm hex driver

Setting the limit magnets on the motorized stages prevents crashes that can break coverslips or otherwise damage equipment; hardware limits are the most foolproof way to prevent crashes.7) The limit magnets move with the stage plates; when a magnet approaches a Hall effect sensor affixed in the stage body, the firmware detects a limit condition and stops the stage. The polarity of limit magnets relative to the stage is essential to their function. When an axis is at a limit, the LED of the corresponding Tiger panel will flash rapidly. You can also query the limit condition over serial using the RS <axis>- or RS <axis>+ command. Programs such as Advanced Serial Port Monitor allow sending such a command repeatedly for easy monitoring. If the Devices tab of the diSPIM plugin has been configured, you can use the Navigation tab to control the stages. Alternatively, you can use the Joypod stand alone controller.

Single axis stages

Tools: 1.5 mm hex driver
The video is cued up to demonstrate setting the F-axis limit magnet.

Sometimes limit magnets in Z stages are not color coded; be cautious to insert the magnet with the same polarity it was removed.

Tip: Regardless of whether a stage moves up or down in real space, the sample is numerically down (negative) to ASI controllers.

F-axis (SPIM head)

In contrast to the upper limit, the lower limit of the upper single axis stage (Figure 1 part 7) is the most important limit to set, and also the most difficult. Nominal spacing between the typical Nikon 40x SPIM objectives and the coverslip is ~250 um, so the limit must be set with a fine accuracy to allow the needed range while preventing a crash. Additionally, the SPIM head must be mounted level with respect to the coverslip.

To set the lower limit of the F-axis:

  1. Prepare a coverslip with a feature on the upper surface, e.g. make a small dot with a permanent marker, and place it in the sample holder.
  2. Use the inverted objective on the lower Z stage: Z-axis, to focus on the coverslip feature. If focus cannot reach the coverslip’s top surface, the limit magnet is probably too low; move it upwards.
  3. Very carefully and gradually, lower the SPIM head to the coverslip watching carefully for the moment that the objectives touch the coverslip by noting the change in focus in the bottom camera.
  4. Reach under the stage and push up alternately on both sides of the sample chamber to verify that the SPIM head is level with respect to the coverslip. If it is not, raise the SPIM head up before adjusting it.
  5. While monitoring the Tiger Z/F LED for rapid flashing, use a 1.5 mm hex driver to move the top magnet of the Z stage: F-axis downward until the limit is found. There is a range of a few millimeters over which the limit will be reported; place the magnet at the top of that range so the Hall effect senses it unless the stage moves up slightly.
  6. Check that this hardware-limit stops the motion appropriately by moving a small distance up and then back down (e.g. by issuing the command R F=10000 followed by R F=-10000 or dialing back and forth with a control knob). The stage should stop short of the prior position, with the objectives nearly touching the bottom of the sample holder (get the position before and after movement by checking the navigation tab or issuing the WHERE command).

Z-axis (inverted scope)

These steps do not apply to SPIM systems mounted on non-ASI inverted microscopes.

Lower limit

This prevents the lower Z stage from crashing the objective mount into the attached cube. This limit magnet is usually set by ASI technicians during factory assembly. To set the lower limit8) of the Z stage: Z-axis:

  1. Gradually move the inverted objective away from the sample (e.g. using the joystick wheel) until there is a few millimeters of space between the cube mounted to the side of the lower stage and the lower objective holder.
  2. While continuously monitoring the Tiger Z/F LED, use a 1.5 mm hex driver to move the top magnet downward until the LED rapidly flashes. Adjust it so that the magnet is on the top end of the range. (If the magnet is in a housing, that housing may be rotated by 180° if needed.)
  3. Check that the limit stops the motion appropriately by moving a millimeter or so towards the sample and then away by the same amount. The Z stage: Z-axis should stop just short of the prior position, before a crash occurs.
Upper limit

This step is less critical because the lower Z stage is not likely to be moved around much, but hardware limits are still recommended to prevent crashing into the bottom of the sample chamber. The limit can be set anywhere between the focus position and where the inverted objective touches the sample chamber bottom. To set the upper limit9) of the Z stage: Z-axis:

  1. Raise the SPIM assembly up a few millimeters from the coverslip in the sample holder so the subsequent steps won’t break the coverslip.
  2. Gradually raise the lower objective (e.g. using the joystick wheel) until the sample holder is moved upward by the inverted objective. Watch the sample holder from the side to see its vertical movement. Lower the objective until the sample holder is stationary again.
  3. While monitoring the Tiger Z/F LED, use a 1.5 mm hex driver to move the bottom magnet upward until the LED rapidly flashes. Adjust so that the magnet is on the bottom end of the range. (If the magnet is in a housing, that housing may be rotated by 180° if needed.)
  4. Check that the limit stops the motion appropriately by moving a mm or so up and then back down the same amount (e.g. by issuing the R Z=10000 command followed by R Z=-10000). The objective should stop itself slightly short of the prior position, but still very close to the bottom of the sample holder.

XY-axes

Tools: 1.5 mm hex driver
The video is cued up to demonstrate setting the XY-axes limit magnets; note that we now recommend setting the X-axis magnets first.

Set the limits of the XY stage to prevent the objectives from crashing into the sample holder, which can cause many different problems the least of which is perturbing objective alignment. The magnets are in color coded housings that are positioned along a track, Figure 18, and secured by a set screw and 1.5 mm hex driver. If your sample holder is small, each magnet housing may need to be rotated 180° so that the magnets are positioned close enough to one another while still enabling the set screws to secure the housing in the track. However, the limits magnets cannot function properly if the housings swap sides; the magnet housing with a red dot limits axis-positive travel, with a white dot limits axis-negative travel.

XY limit magnets Figure 18: XY limit magnets are in housings that can be positioned along a track and secured by a set screw. Limit magnets in rotated housing Figure 19: Close-up of rotated (vs swapped) XY limit magnet housings

To set the limits of the X-axis:

  1. Start with the SPIM assembly lowered down to its Z-axis limit position as set in the prior sequence.
  2. Move the XY stage in the Y-axis until the X-axis limit magnet track is visible.
  3. Move the XY stage in the X-axis (left-right) until the objectives are just about to crash (or are barely crashing) into the side of the sample chamber.
  4. Monitor the Tiger X/Y LED for rapid flashing while moving the limit magnet until the limit condition is barely reached. (Rotate the magnet housing 180° if needed.)
  5. Repeat steps 3 and 4 above for the other side of the X-axis.
  6. Use the joystick first on the slow speed setting then on the fast speed setting to check that the hardware limits stop the motion before the objectives crash into the sides of the sample holder.

To set the limits of the Y-axis:

  1. Move the XY stage in the Y-axis (forward-back) until the objectives are just about to crash (or are barely crashing) into the sample chamber.
  2. Monitor the Tiger X/Y LED for rapid flashing while moving the limit magnet until the limit condition is barely reached. (Rotate the magnet housing 180° if needed.)
  3. Repeat steps 1 and 2 above for the other side of the Y-axis.
  4. Use the joystick first on the slow speed setting then on the fast speed setting to check that the hardware limits stop the motion before the objectives crash into the front or back of the sample holder.

Figure 18: The limit magnets are in housings that can be positioned along a track, secured by a set screw.

Figure 19: Small sample chambers may require the limit magnet housings be rotated 180° in order to get the magnets close enough together while still being able to secure the housings via their set screw.

The relevant sections of the diSPIM alignment videos are embedded.

Optical alignment

Goals: The qualities of final alignment, for both SPIM optical paths, include all of the following:

  • epi spot centered on epi camera
  • beam waist centered on imaging camera
  • beam/sheet plane coincident with imaging focus plane near the center of the piezo travel
  • beam perpendicular to imaging camera field of view
  • sheet centered in imaging camera field of view
  • sheets centered in bottom camera’s field of view (i.e. co-alignment of all three objectives)

Overview

Before acquiring data, the optical paths must be aligned. This is the trickiest thing for new diSPIM users to learn. If the system is not disturbed, the alignment can last for months. Crashing the equipment or changing objectives or filters usually requires at least partial realignment.

Do a coarse mechanical alignment by eye, then proceed to fine alignment. Think of the fine alignment process as a giant inward spiral; there are many adjustments to make, and working through them iteratively allows you to zero in on perfect alignment.

We are concerned with getting both the beam position and angle correct, along with getting both objectives “looking” at the same place. Fortunately, the adjustments to do so are mostly independent of each other. Table 1 can be derived by understanding the light path.

Adjustment Position? Angle? Comments
Tilt of dichroic mirror (Cube-III) Some Yes Position effect usually small 10)
Tilt of camera mirror (Cube-III) Yes No Set during scanner alignment and not after
Z position of SPIM head No No
Objective bushing (focus) Maybe minor Maybe minor If the bushing isn't perfectly concentric then slight movements can occur but this isn't usually a problem
Linear objective adjustment Yes Maybe minor
Tilt of adjustable mirror Some Yes Set during scanner alignment, not user-adjustable
Tilt of main micro-mirror Yes No Set during scanner alignment, not user-adjustable
Table 1: How alignment adjustments affect the beam position and angle.

Coarse alignment

Co-align objectives by eye
If you haven't already done so, use the OBLPA adjustment screw and the two objective bushings to move the objectives until they are visually symmetric from the front, as in Figure 11, and visually aligned when viewed from the side of the microscope.

Rotate cameras and scanners by eye
Adjust the angles of the cameras and scanners to be parallel/perpendicular to the SPIM arm cubes as well as possible by eye. With careful sighting along parallel surfaces you can align them to better than 1° of rotation.


Warning: Be very careful with exposed laser beams; wear appropriate eye protection else serious injury may occur.

Check micromirror
This step is not necessary; feel free to skip it. Remove the CUBE-III faceplate and attached filter cube assembly, Figure 16, place the square alignment target, Figure 20, over the opening. Turn the controller off to be sure that the scan mirror is not being deflected, power on the laser, and observe where the laser is hitting the target. If the laser spot is well within the first target ring, install the dichroic mirrors into the CUBE-IIIs and proceed with alignment.

 Square target for scanner alignment verification Figure 20: Square target; fits on CUBE-III in place of the face plate (after downloading and printing at full size)  Round target; trim to fit desired size after downloading and printing at full size. Figure 21: Round target; trim to fit desired size (after downloading and printing at full size)

Adjust dichroic tilt
Turn on the laser and use the kinematic adjusters on the CUBE-III to adjust the dichroic mirror tilt so that the laser beam comes out of the objective approximately straight.11) It may be helpful to use a 45° surface like a folded business card, as in Figure 22. This is a coarse adjustment only.

 Scanner mirror and iris diaphragm are imaged by the laser on a target in the far-field of the objective. The emerging beam is adjusted to be centered leaving the objective. Figure 22: Scanner mirror and iris diaphragm are imaged by the laser on a target in the far-field of the objective. The emerging beam is adjusted to be centered leaving the objective.

Tip: CUBE-III face plates should be positioned entirely by the kinematic adjusters, not at all resting on the body of the CUBE-III.

Scanner Beam
Check the centering of the scanners since it is easy to do at this point. You should be able to see the extent of the scanner mirror with the scanner iris fully open. The center of the Gaussian beam, iris aperture, and scan mirror should be nearly or completely together; in practice this is hard to perfect. If you are not satisfied, contact ASI for assistance.

Fine alignment

The video is cued up for an overview of the fine alignment.

The process detailed below uses Micro-Manager and its diSPIM plugin to provide a live view from the SPIM cameras. The principle is to spiral toward refinement; because most adjustments affect other adjustments, do not worry about perfection on the first iterations. After initial setup only Phase 1 steps are likely to need minor adjustments.

Before you begin:

  1. Launch Micro-Manager
  2. Load the hardware configuration
  3. Open the diSPIM plugin - in the Micro-Manager window, go to Plugins > Device Control > ASI diSPIM
  4. Go to the Devices tab In the ASI diSPIM plugin window and configure it to match your system
  5. Set a relatively long exposure time, e.g. 100 ms
  6. Use the Navigation or Setup Path X tabs
    1. control movement
    2. control cameras
    3. verify the piezos and scanners are in their neutral positions (at zero)

A uniform dye solution12) works well for Phase 1, but a solution or 2D sample of fluorescent beads13) is better for Phase 2.

Outline

  • Phase 0 (coarse alignment by eye as described above)
  • Phase 1 (iterative)
    • 1.1 Co-align SPIM objectives to focus and center beams.
    • 1.2 Tilt dichroic mirrors for horizontal beams uniformly in/out of focus.
    • 1.3 Tilt imaging mirrors to center epi spots.
    • 1.4 Adjust lateral position of objective.
    • 1.5 Go back to 1.1 and repeat until no adjustments needed
  • Phase 2 (may have to be repeated for initial alignment, and again when scanners or cameras are changed or disturbed)
    • 2.1 Focus collimators to center beam waists in FOV.
    • 2.2 Rotate scanners for uniform focus across the sheets.
    • 2.3 Rotate cameras for vertical sheets from epi view.
    • Go back to 1.1
  • Phase 3 (performed just once for initial alignment and again for objective change)
    • 3.1 Establish the coverslip location.
    • 3.2 Align the inverted scope with the SPIM objectives.
    • 3.3 Cross-calibrate the piezo and light sheet movement.
  • Phase 4 (performed for any new sample)
    • 4.1 Check that light sheet and detection plane are coincident; adjust offset in plugin if needed.

Phase 1

Repeat the steps of Phase 1 steps multiple times as you spiral in on alignment.

Cofocus SPIM objectives

Configure the Setup Path tabs:
select the checkboxes for 1) the “excitation beam” and 2) “Change settings on tab activate”, and
use the “On tab activate” drop down menu to select the Imaging camera.

Adjust:

  • both objective bushings, and
  • the knob on the OBLPA (Figure ##) to center the beams in the Live window 14)

The goal is to have both beams in focus (roughly at first, as in Figure 23, but better and better in subsequent iterations of Phase 1, as in Figure 24).
The video is cued up to demonstrate cofocusing the SPIM objectives using Micro-Manager.

This is best done by alternating between steering and focus adjustments, alternating sides, moving halfway to focus at a time until both beams are centered and focused. (See the troubleshooting page if you cannot focus for lack of bushing travel.) Keep in mind that the nominal spacing between the objective bushing and piezo is 1 mm as pictured in Figure ##.

Beams and epi-spots before alignment Figure 23: Multi camera, live mode: both beams and epi-spots, still largely unfocused and malaligned Beam waist and epi-spots nearing alignment Figure 24: Multi camera, live mode: as alignment improves, each beam waist nears the epi-spot

Dichroic tilt

Adjust: Dichroics' CUBE-III kinematic adjusters (Figure 25)
End goal: Both beams uniformly in/out focus15) and horizontal (in the Live mode window), as in Figure 27 The video is cued up to demonstrate adjusting the tilt of dichroic.

In the Navigation tab, verify that the the piezos and scanners are in their neutral positions (at zero). Use only the imaging camera, working on one beam at a time.

Check the uniformity of focus across the beam by adjusting the imaging piezo (e.g. using the joystick knob) or the slice position to see if the beam comes in and out of focus uniformly or with a horizontally rolling focus. Use CUBE-III kinematic adjuster A alone, or B and C in tandem, to get the beams properly positioned. It may be helpful to use a LUT (false-color heat map) on a single-camera view to aid in judging uniformity.

Next, adjust kinematics B or C (alone or in opposition) to get the beam horizontal. Confirm that this did not affect the uniformity of focus. The grid overlay in Micro-Manager (Plugins > Acquisition Tools > Pattern Overlay) can be helpful by providing reference lines.

Though not necessary, some may prefer to close the scanner iris to achieve a pencil beam as seen in Figure 27 so that the waist of the beam is not distracting.

Figure 25: CUBE-III kinematic adjuster A alone, or B and C in tandem, to get the beams uniformly in/out of focus; use adjusters B or C (alone or in opposition), to tip beam horizontally (in the Live mode window CUBE-III kinematics and objective bushings must both be used to get the beam uniformly focused Figure 26: The CUBE-III kinematics level the beam horizontally and affect the (left-right) uniformity of focus With correct dichroic tilt, the beam appears horizontal and in focus Figure 27: With correct dichroic tilt, the beam appears horizontal and in focus; this image was taken in Multi camera view so the epi-spot of the same beam is visible

After the first couple of times you complete this step, jump back to cofocusing the SPIM objectives again.

Imaging mirrors

Adjust: Right-angle mirrors' CUBE-III kinematic adjusters (Figure 25)
End goal: Epi-spots centered on the camera
The video is cued up to demonstrate cofocusing the SPIM objectives using Micro-Manager.

Eventually, in Multi camera mode the two images will overlap as in Figure 28. The crosshair in Micro Manager (Plugins > Acquisition Tools > Pattern Overlay) can be used to mark the center of the image.

Figure 28: The CUBE-III kinematic adjusters for the right-angle mirrors in front of the cameras are adjusted to bring the epi-spots to the center of the camera frame

Tip: Approximate in initial passes, but demand more perfection as the spiral tightens, keeping in mind that adjustments made in Phase 2 will have an effect. In Phase 1, look at beams not sheets.


Repeat Phase 1 until no adjustments are necessary, and again after Phase 2 if any adjustments were made. Proceed to Phase 2 when the beams and images are well focused and positioned.
The video is cued up to demonstrate a second iteration of Phase 1.

Phase 2

Use a solution or 2D sample of fluorescent beads16) for Phase 2. Phase 2 should only have to repeated once or twice for the initial alignment and revisited anytime the collimators, scanners, or cameras are changed or disturbed; it is callous to sample changes.

Collimator

Adjust: Collimator that connects the fiber optic to the scanner body
End goal: Beam waists centered
The video is cued up to demonstrate adjustment of the collimator.

If it is not already open, open the iris completely to see the beam waist (i.e. focus point). When the beam waist is centered horizontally, the epi-spot will appear at its smallest and maximum intensity.

To center the waist, insert the small black eccentric tool, seen in Figure 29, into the side of the collimator and engage the lip on the lens mount. Once engaged, turning the tool will move the focus point along the beam. If needed, slightly loosen the retaining set-screw on the opposite side of the collimator while still engaging the lens mount with the collimator adjuster tool as in Figure 30. (The lens assembly can slip out of the collimator housing entirely if you loosen the set screw without the tool engaged; if that happens, unscrew the fiber collimator from the scanner housing to put it back together.17)) Only small movements should be needed.

Collimator adjuster tools Figure 29: Collimator adjuster tools  Focus the collimator Figure 30: Adjust the focus of the collimator to center the beam waist

Scanner tilt

Adjust: Rotation of the scanner body
End goal: Uniform (vertical) focus of the sheet as seen by the imaging camera
The video is cued up to demonstrate adjustment of the scanner rotation.

In one of the Setup Path tabs, select the checkboxes for both beam and sheet, and click on Imaging and Live buttons. Adjust the “Sheet width” to fill most of the camera FOV. The optimal method uses a solution of freely diffusing beads (or Zebra highlighter pen). Take an autofocus stack and judge whether the sheet comes in and out of focus uniformly rather than with a vertically rolling focus. A secondary method uses a dye solution; both edges of the sheet should be well focused near the beam waist, see Figure 31 and Figure 32. A third method moves the stationary beam from one side of the FOV to the other (via the Navigation panel) and comparing focus at the two locations. Check both scanners.

Uneven vertical focus of the sheet Figure 31: Uneven vertical focus of the sheet indicates the scanner should be rotated Uniform vertical focus of the sheet Figure 32: Uniform vertical focus of the sheet indicates the scanner is in the correct orientation

If the focus is not (top-bottom) uniform, the scanner needs to be rotated. Usually you can grip the scanner tube lens and rotate it slightly (while watching the fiber collimator to judge movement). If you had to twist one or both scanners, return to the beginning of Fine Alignment Phase 1.

Camera tilt

Adjust: Rotation of the camera (and camera's tube lens)
End goal: Epi-view of the sheets produces a vertical line in the camera image
Tools: 2 mm hex driver The video is cued up to demonstrate adjustment of the camera's rotation.

If the epi-view of the sheet is not vertical, slightly loosen the set screws holding the camera's C-mount adapter to the tube lens, rotate the camera/adapter as needed, and retighten the screws. Because we already verified the scanner orientation, any remaining tilt must be in the camera. Check both cameras.

If you make any changes in Phase 2, return to the start of Phase 1.

Phase 3

Phase 3 should be performed just once for initial alignment and again selectively for objective or sample changes.

Establish coverslip location

Adjust: SPIM Head height (electronically), “SPIM Head height” coordinate value, SPIM Head rotation
End goal: Both sheets hitting the coverslip in the center of the cameras' FOVs
Tools: M5 hex driver
The first video is cued up to demonstrate how to find the coverslip with the SPIM objectives; the second video shows how to rotate the SPIM Head (in case that is necessary).

Turn on both sheets and Multi-camera Live mode.

Slowly lower the objective pair into the dye solution. As the objectives near the coverslip, reach under the sample chamber and delicately lift it to check how close the objectives are. Note if one objective is closer to the coverslip than the other; if it is, use the controller to raise the SPIM Head and slightly loosen the 4 bolts holding the SPIM Head with a 5 mm hex driver so you can level it. Repeat those steps until the objectives are equally close to the coverslip, and the coverslip becomes apparent where the fluorescent beam stops, Figure 33. The objectives will touch, or nearly touch, the bottom of the chamber. On the Navigation tab, click the Set 0 button for the SPIM Head Height coordinate value. (Zeroing the SPIM Head Height coordinate value at the coverslip or just above it can save a lot of time between samples.) When it’s time to change samples, click the Load sample button on the Navigation tab to raise the SPIM Head, swap samples, and click the Go To 0 button.

 Converging light sheets in dye striking the coverslip Figure 33: Multi camera, live mode: converging light sheets in dye cross each other just before disappearing when they encounter the coverslip; the sheets appear vertical in the camera image

Align bottom objective with SPIM objectives

Adjust: Inverted microscope objective position (manually for lateral motion, electronically for axial motion), “Lower Z Height” coordinate value
End goal: Light sheets hitting the coverslip in focus and centered in the inverted scope's camera's FOV
The video is cued up to demonstrate alignment of the inverted scope objective with the SPIM objectives.

Click on the Bottom camera and Live buttons on the Navigation tab and locate the light sheets intersecting the coverslip. Center the image by adjusting either the CDZ-1000 XY translator (item 6 in Figure 1), or on RAMM systems: the inverted microscope’s objective adjuster. For larger front to back adjustments, add shims between the SPIM mount and the CDZ; for side to side adjustments, shift the Z-Stage:Z-axis in the dovetail mount to the CDZ. Focus using the lower Z-stage:F axis. On the Navigation tab, click the Set 0 button for the Lower Z Height coordinate value. Sample spotting is much easier if you take note of the relative position of the light sheets to the bottom camera in XY and Z. Setting appropriate Z-references helps in this regard.

 Bottom camera aligned to the light sheets Figure 34: Inverted microscope's view of the light sheets shown in <imgref ConvergingSheets

Cross calibrate piezo and scanner movement

Adjust: Values in the Piezo/Slice Calibration section of the Setup Path tabs via the 2-point button
End goal: Light sheets hitting the coverslip in focus and centered in the inverted scope's camera's FOV
The video is cued up to demonstrate alignment of the inverted scope objective with the SPIM objectives.

Use either a focused beam in dye, or a sheet with a field of fluorescently labeled objects. When imaging real samples, you may wish to verify this calibration step fairly often, in which case you can use fluorescent objects in the sample as targets rather than the focused beam waist described here.

Use the Setup Path tabs. Establish a focused beam in the dye solution. Set the manual controls so that the left knob controls the imaging piezo and the right knob controls the Sheet Beam, Slice Position.

Detailed instructions can be found in the Micro-Manager diSPIM Plugin User Guide.

1)
Usually it is master-Z-axis and slave-F-axis, but it can vary depending on the system.
2)
The only reason to command the slave axis directly is for alignment purposes.
3)
SPIM cameras are TTL-triggered during acquisition, but triggered by Micro-Manager during alignment. Thus, the plugin has to know how to switch the cameras between internal and external trigger modes, and thus the relevant properties need to be hard-coded into the plugin. Hopefully in the future there will be a camera API call in Micro-Manager to change triggering modes.
4)
Before March 2014 other cables and scanner orientations were used. Contact ASI for new cables.
5)
If your system was delivered before 2015, refer to the document on the older style TTL Card.
6)
When scanners have been steered to their blanking position, they are at their physical movement limits. Therefore, the Tiger's MICROMIRROR card LED will flash rapidly as do all axes' control card LED when the axis is at a limit.
7)
Limits may also be defined in software. Software-defined limits persist when the controller is powered down, but are lost when the firmware is updated or reset.
8)
The sample is always numerically “down” for ASI controllers.
9)
Away from the sample is always numerically “up” for ASI controllers.
10)
The dichroic tilt affects the angle at which the beam enters the back focal plane as well as the beam position at the back focal plane. It is possible to compensate by adjusting the scan center but we usually adjust the camera mirrors to compensate instead.
11)
If your scanners are fixed to the SPIM frame rather than directly to the CUBEs, lower the objectives to the sample position before doing this step.
12)
Fluorescein in water is ideal because it is easily washed off, but a dip of standard highlighter pen also works to create a uniform dye solution.
13) , 16)
Certain highlighters, e.g. Zebra Mildliner and Zebra Eco Zebrite, create bead-like fluorescent droplets when briefly dipped in water
14)
This aligns the beams in the Y-axis.
15)
i.e. exactly parallel to its imaging objective's FOV and exactly perpendicular to the FOV of its illumination objective
17)
If you do this, make note of the rotational position of the collimator and screw it back the same way. In any case, factory alignment may be disturbed; contact ASI if this occurs.