Online manual

1. Acquisition of image stacks of fluorescent beads

Important Considerations

In order to obtain optimum performance from your fluorescence microscope it is crucial to realize that microscopes or particular parts of it have been designed for a highly specific set of conditions including the refractive index of the immersion medium, cover slip thickness, operating temperature, as specified by the instructions from the manufacturer. Even slight deviations from the specified conditions can have substantial (deteriorating) effects on the performance of the system. It is thus pivotal to adhere to the conditions the microscope was designed for. Caution should thus be used when attributing a bad performance to the microscope because imaging might have just been done under conditions for which the microscope was not designed. First step in judging or dealing with an apparent under performance of a microscope should thus be to check if the used imaging conditions match the conditions the system was designed for. In this context it is of course of particular importance to use a properly prepared sample slide containing the fluorescent beads needed for testing the system.

1.1 Sample preparation

Glass slide and cover slips

Cover slip thickness needs to adhere tightly to the value specified for the objective (usually 170 µm thick– #1.5). In addition, beads should be attached to the cover slip and not to the glass slide since the latter will position the beads a few micrometer away from the cover slip glass surface when imaged through the cover slip (notable exception: water dipping lenses).

Fluorescent beads

For direct extraction of PSFs from an image stack of fluorescent beads (use multicolor beads if you intend to measure chromatic aberrations), the beads should ideally be as small as possible. However the smaller the beads the lower the signal-to-noise ratio (fora given exposure time) and the more difficult the quantification becomes. When using fluorescence microscopes with 20 – 100 x magnification lenses, we thus recommend using beads with a diameter around 200 nm. We achieved good results with 175 nm (green) single-color beads (PS-speck, Kit P-7220, Molecular Probes) for resolution and planarity measurements or 220 nm diameter multicolor beads (TetraSpeck, T-7280, Molecular Probes) for chromatic colocalization measurements. PSFj will consider the size of the used beads and correct the results. Also, check that your beads are essentially aggregate free. If necessary, try to disperse these aggregates using a water bath sonicator. The beads should also exhibit a narrow size distribution,i.e., a small coefficient of variation of their diameter (check the specification of the manufacturer). For preparation of the slide, follow the manufacturer’s protocol, which usually includes the following steps:

1. Dilute the original bead suspension to a suitable concentration (around 109 beads per ml). Bead density is critical: if the density is too high, this will cause that many beads will be discarded from the analysis. If the density is too low, only few beads are available for analysis and the statistics will not be good. Manually prepared bead slides show heterogeneous distributions of the beads, so that image stacks with higher or lower bead densities can be recorded and analyzed.

2. Sonicate the bead solution (using a water bath sonicator) in order to dissociate possible aggregates

3. Wash a #1.5 (170 µm thick) coverslip using 70% ethanol (please note: some objective lenses require coverslips of different thickness. In the case of water-dipping objectives, no coverslip is required; in this case the beads are adsorbed directly on the surface of the glass slide, as described in the next step.

4. Place a small amount (around 5-10 µl) of the bead solution on the coverslip and let it dry.

5. Place a small amount (depending on your coverslip size, around 10 µl for 24×24 mm coverslips) of mounting medium (e.g. the mounting medium included in the PS-speck Kit P-7220, Molecular Probes) on the coverslip and place the slide upside down onto a microscope slide.

6. Seal the gap between coverslip and microscope slide, e.g. using non-fluorescent nail polish.

Please note:

Dust/dirt particles, but also too much or too little mounting medium can cause that the coverslip is not aligned parallel to the surface of the glass slide. If this is the case, the coverslip surface with the beads may not be orthogonal to the optical axis of the microscope. Consequently a linear gradient (along the direction of the tilt) will appear in the heat map that visualizes the planarity of the system.

1.2 Image acquisition

For recording a z-stack of fluorescence images of the beads, the following has to be taken into consideration.

Number of planes and spacing

The stack should cover a range of about 6 to 10 times the expected FWHM, i.e.
≈ 2λn/(NA)2, centered on the plane of best focus, where λ is the wavelength of the fluorescence emission (center wavelength of the used emission filter), n is the refractive index of the used immersion medium (e.g. 1 for air, 1.33 for water, 1.52 for oil), and NA is the numerical aperture of the used objective lens. The spacing between planes should be about a third (or less) of the expected FWHM, i.e., (Nyquist sampling). E.g. a range of ~ 6 µm and steps of ~ 250 nm and ~ 300nm for a 1.4 NA oil and a 1.2 NA water immersion objective, respectively. Exposure times should be adjusted to yield a signal-to-noise-ratio (SNR) of at least 50. Note: PSFj assumes, that the camera pixel size is small enough to provide sufficient sampling (at least Nyquist) of the lateral extent of the PSF, i.e., that the pixel dimension is about a third (or less) than the expected lateral FWHM (0.61λM/NA/3) (where M is the overall magnification of the microscope. If this is not the case it might be possible to increase the magnification through the use of a different tube lens (e.g. by 1.5x) as is provided by most microscopes. For the analysis of the chromatic aberrations of the system, two stacks of multi-color beads (see Section 3.1) of the same FOV but at different excitation/emission wavelengths need to be acquired. Typically, these stacks are acquired sequentially, however, (e.g. in the case of imprecise mechanics of the stage) interleaved acquisition of images at both wavelengths on a given plane is preferred. (Please note: aberrations between different color channels are not necessarily caused by chromatic aberrations, since also mechanical or thermal drift will influence the results. In order to identify such artifacts and to estimate how much of the detected aberrations are of “chromatic” origin, it is possible to compare two independently recorded stacks of the same position in the sample using the same wavelength settings.

1.3 Image- and metadata import and export

Image file formats

PSFj requires image stacks of 16bit multipage tif format. Most proprietary microscope acquisition software packages are able to export the files in this format. In all other cases, ImageJ and the Bio-Formats plugin (http://www.openmicroscopy.org/site/support/bio-formats5/users/imagej/) can be used to convert file formats to tif.

Import of metadata

Due to the large heterogeneity in the metadata file formats PSFj does not import such data. Instead, the relevant data has to be entered by hand. However, once entered, this data is stored in the same folder with the images using the name of the image and the extension “.ini”. When opening an image stack in PSFj, any corresponding .ini file in the same folder will be loaded automatically. The parameters required to calibrate the analysis are:

  • The magnification (M) and the numerical aperture (NA) of the used objective lens (e.g. 60x, NA = 1.40 – usually specified on the body of the objective) Note: most microscopes provide options to increase the magnification e.g. by 1.5x. If such option is used the relevant magnification which has to be entered in PSFj is the total magnification e.g. 60x*1.5x=90x.
  • The refractive index (n) of the used immersion fluid (e.g. n = 1 for air, n = 1.33 for water, n = 1.52 for oil – check the oil container)
  • The diameter (e.g. 150 nm) of the fluorescent beads
  • The emission wavelength (center wavelength of the used emission filter)

The voxel size, i.e., the size of the volume elements. If this is not known, one can alternatively specify the size of the pixel on the camera chip (check the data sheet of your camera) and the spacing between the planes in the image stack. PSFj will then calculate the voxel size for you.

(Please note: it is easy to forget to note for example the position of the magnification knob (e.g. 1x or 1.5x) available with most microscopes. So, particular care should be taken to ensure proper documentation of all imaging parameter. If you get weird results, please check first all instrument settings and the parameters you entered.)

2. Image analysis

2.1 Image stack import

PSFj requires a multi-page tiff-file as input. Converting stacks of different formats or single images into a multi-page tiff-file can be done using ImageJ or Fiji (see also Section 1.3). For chromatic aberration analysis, two stacks of the same (multi-color) beads are required, recorded using the wavelengths/filter you want to analyze (see also Section 1.2). Currently, a maximum of two wavelengths can be compared. Hence, for comparison of 3 or more wavelengths, sequential analysis is required. Just click on “Add image stack”. You can also drag and drop your image stack(s) onto the PSFj window (see Fig. 2.1).­­

image020

Fig. 2.1 – Image-stack import for single-color analysis of a single image stack
For the analysis of one wavelength, multiple stacks acquired using the same settings but from different FOVs can be loaded and analyzed. This leads to improved statistics (see Fig.2.2): the stacks will be analyzed together and the results will be combined.

image022

Fig. 2.2 – Image-stack import for single-color analysis of multiple image stacks
You can add two image stacks acquired at different emission wavelengths for chromatic aberration (dual-color) analysis. In this case the center emission wavelength for each stack is required (see Fig. 2.3), and the performed analysis will automatically include chromatic aberrations.

image024

Fig. 2.3 – Image-stack import for dual-color analysis. Only one stack per color can be loaded. Please specify the wavelengths.
To continue to the next step (calibration of the images) please click on “Next” button.

2.2 Calibration

To calibrate the images (see Fig. 2.4) you need to provide the system specifications and the parameters for acquisition of the image stacks (see also Section 1.3.). Once entered, the information will be saved in a separate file with the ending “.ini” into the folder containing your image stack(s). Subsequent import of the image stack in PSFj will automatically import all relevant parameters from this file and no manual input is required. In the case of dual-color analysis, the information on the emission wavelengths of the two color image stacks has be entered in the previous (image-stack import) window or imported automatically from the “.ini” files.

image026

Fig. 2.4 – Image-stack calibration window
To start the analysis click on the “Next” button at the bottom right.

2.3 Analysis workflow

2.3.1 PSF detection and centroid estimate

In the first step of the analysis, the plane of best focus in the stack is determined by finding the plane (image) at which the image standard deviation attains a maximum. Next, approximate center positions of PSFs in that plane are determined by image segmentation using a simple threshold operation and a connected-component labeling algorithm provided by the library IJBlob whereby the threshold is set automatically to
IB +10 σB, where IB is the average intensity and σB is its standard deviation of the first image (at the bottom) of the stack, i.e., at the plane farthest away from the plane of best focus at the center of the stack. The automatic settings should provide good results for most stacks but of course can be adjusted (in the case of multiple channels, for each stack separately – select the stack in the left panel by clicking on it) by the user (results can be monitored in a preview window – release slide for review) by moving the focus and threshold slider (see Fig. 2.5 and below). The auto buttons bring the settings back to the automatic settings (see above). The mouse wheel can be used to zoom the image. Approximate selection of the best plane of focus is sufficient, as this will not influence the exact analysis of the individual beads. Don”t use too stringent threshold settings, as this may lead to the detection of only the brightest beads. These may consist of bead aggregates, and will therefore bias the results.

2.3.2 Sub-stack size

In the next step, sub-stacks with square cross-sections centered around the PSF centroids are extracted. Their width is automatically set to Round [ 10 λ · M / ANA / dpixel ] (about 10 times the expected FWHM), where is the magnification and is the camera pixel pitch, but can be adjusted using the sub-stack size slider(release slide for review). The sub-stack cross-sections are shown in the preview as green squares (see Fig. 2.5). The auto button brings the setting back to the automatic setting (see above). Image contrast and brightness can be adjusted using the double slider at the bottom of the image.

Note: at high bead densities, a single PSF may show up in multiple sub-stacks. In order to include multiple inclusion of such a PSF into the results, only the sub-stack containing the brightest (average over the segment) centrally located PSF is retained for further analysis. All sub-stacks are processed in the next step (clicking on the next button at the bottom right).

image040
Fig. 2.5 – focus, threshold, and sub-stack size preview window

2.3.3 PSF-analysis

During the sub-stack processing (see Fig. 2.6), individual PSFs are fitted using a generalized elliptic Gaussian 2D fitting routine provided by micromanager (Arthur Edelstein, Nenad Amodaj, Karl Hoover, Ron Vale, and Nico Stuurman (2010), Computer Control of Microscopes Using μManager.Current Protocols in Molecular Biology 14.20.1-14.20.17) based on Levenberg-Marquardt optimization. Estimates of the centroid required by the fitting routine are provided by intensity weighted BSF center positions (center of gravity) determined for each sub-stack using the 3D Object Counter ImageJ plugin (Wagner, T. & Lipinski, H.-G. IJBlob: An ImageJ Library for Connected Component Analysis and Shape Analysis. Journal of Open ResearchSoftware 1, e6 (2013).) with the input parameters “threshold” and “voxel-range” set to, and 1-10000, respectively. From the Gaussian fit, the principle (smallest) FWHM, the asymmetry (smallest over largest FWHM), the orientation (angle between the x-axis and the major axis (largest FWHM) of the Gaussian ellipse and the centroid position are determined. The axial FWHM is determined from a fit with Gaussian profile along the z axes through the determined centroid position using the fitting algorithmprovided by Metroloj (Cordelires, F. P. & Matthews, C. MetroloJ: an ImageJplugin to help monitor microscopes” health. imagejdocu.tudor.lu at<http://imagejdocu.tudor.lu/lib/exe/fetch.php?media=p lugin:analysis:metroloj:matthews_cordelieres_-_imagej_user_developer_conference_-_2010.pdf>). As a quality check, only BSFs fitted with regression coefficients R2>0.9 are retained. The determined FWHM are then corrected for bead size (see supplement of the paper).­

2013-12-20 09_54_57-PSFj 2.0, build 137

Fig. 2.6 – Sub-stack analysis screen (the green bar will entertain you while you are waiting to obtain the results)

2.3.4 Chromatic aberration analysis

Dual color image stacks are processed and analyzed individually as described above yielding resolution and planarity heat maps for each color channel separately. Second, a nearest neighbor analysis of BSFs between the two channels yielding the distance (shift) between corresponding BSFs (nearest neighbors) is performed and heat maps showing the lateral ( √Δρ(Δx(λ1, λ2)2 + Δy(λ1, λ2) ) and axial ( Δz(λ1, λ2) ) chromatic shifts as a function of BSF center position are generated. Heat maps are pseudo colored and scaled to display a range from (blue) to (red). In cases where a BSF is found to be nearest neighbor of two or more BSFs, only the closest neighborhood is retained. In addition, nearest neighbors further apart than two axial FWHM are excluded from the analysis.

3. Results

After the analysis has been finished, click the next button and the results will be displayed automatically and can be inspected on three panels:

– Overview panel

image058

Fig. 2.7 – Overview panel of the results and export window showing general image st­ack information as well as the number of detected and analyzed beads and provides an overview of the results, i.e., showing the different heatmaps and a table comparing the average full FOV median with the values expected from theory and export options via a drop down menu (see below).

– Heatmap panel

image060

Fig. 2.8 – Heatmap panel of the results and export window showing the different median heat-maps and their projected profiles (selected via drop down menu) as well as heat-map parameters. Heat maps are pseudo colored and automatically scaled to display a range from FWHM/2 (blue) to 2FWHM (red) or -FWHMz(blue) to +FWHMz(red) for the resolution and planarity heat maps, respectively. Units can be switched between relative or absolute by clicking the appropriate buttons on top of the heat map. Asymmetry maps are scaled from zero (red) to unity (green). Theta maps are scaled from -90deg(violet) to 90deg (violet) and color saturation is weighted by the asymmetry between zero for asymmetry 1 (theta is insignificant and the heat map will appear white) and unity for asymmetry ≤ 0.5.

– Bead inspection panel­

image071

Fig. 2.9 – Bead inspection panel of the results and export window showing outlines of all excluded (red) and used (white) sub-stacks. Single or multiple sub-stacks can be selected (by command-clicking or command-shift-clicking on single sub-stacks or by command-selection of the region of interest using the mouse). Selected sub-stacks can be exported as individual multipage .tif files, their bead reports can be displayed and an average image stack can be generated and saved as a multipage .tif file. In addition, sub-stack analysis results can be exported as a csv file.

3. Reporting and exporting

The following sections describe all reporting options, the output file formats and the purpose and possible applications of specific output files.

3.1 Summary report

The summary report provides a quick overview of the results and is intended for routine documentation of the daily microscope performance e.g. in a microscope facility. The report can be generated by simply clicking the “generate quick pdf report” button at the bottom of the overview panel (see Fig. 2.7) and will be exported into the folder that contains the image stack(s). For single channel analysis, it contains three pages showing the heat-maps and their projected profiles as well as the resolution table and imaging parameters (see Fig. 3.1a). In the case of dual-color analysis, the report contains a three-page summary report for each color channel as well as three additional pages reporting on the chromatic aberration performance showing lateral as well as axial chromatic shift heat-maps and exemplary overlay images from different representative areas of the FOV (see Fig.3.1b).

Screenshot 2014-09-02 17.09.55(2)
­­Fig. 3.1a – Summary report – single channel analysis
Screenshot 2014-09-02 17.09.28
Fig. 3.1b – Summary report – chromatic aberration analysis

3.2 Results

csv file

The results csv file provides the complete set of results for each individual substack (see Fig. 3.2) and could be used for further analysis and post-processing. It can be generated by selecting the “results csv file” option in the “export as” pull down menu at the bottom of the overview panel (see Fig. 2.7) and will be exported to a user selectable folder. The csv file contains information about each beads position (x0,y0,z0), measured FWHM, resolution asymmetry and orientation (theta) as well as the fit regression coefficients for each (detected) PSF (see table 3.2.1). In addition it contains all imaging parameters, the number of detected and analyzed beads, and the mean/stdev of all heat maps.

Heatmaps

image077

Heat maps are intended as a graphical representation of the results. They are generated using the median of a sliding window along the x and y axes. The size of the sliding window (square) is set to √s=20/η , where η is the bead density. The step size is set to s/20. Raw gray scale and pseudo colored versions of the heatmaps as provided in the PSFj report (see Fig. 3.1) are generated by selecting the “heatmap” option in the “export as” pull down menu at the bottom of the overview panel (see Fig. 2.7) and exported to a user selectable folder. Heat maps are pseudo colored and automatically scaled to display a range from FWHM / 2 (blue) to 2FWHM (red) or −FWHM z (blue) to −FWHMz (red) for the resolution and planarity heat maps, respectively. Units can be switched between relative or absolute by clicking the appropriate buttons on top of the heat map. Asymmetry maps are scaled from zero (red) to unity (green). Theta maps are scaled from -90° (violet) to 90° (violet) and color saturation is weighted by the asymmetry between zero for asymmetry 1 (theta is insignificant and the heatmap will appear white) and unity for asymmetry ≤0.5.

Landmark XLS

image101
Table 3.4 – Landmark file entry

The landmark xls file is an output option for dual channel analysis and contains the beads lateral center-of-mass positions x0 (λ1 ), y0 (λ1 ) (Target) and x0 (λ2 ), y0 (λ2 ) (Source) in the two channels (see Fig. 3.4). This list is intended to be used for image registration, i.e., correction of lateral chromatic shifts and is in a format accepted by bUnwarpJ a plugin for ImageJ (Ignacio Arganda-Carreras, Carlos O. S. Sorzano, Roberto Marabini, Jose M. Carazo, Carlos Ortiz de Solorzano, and Jan Kybic, “Consistent and Elastic Registration of Histological Sections using Vector-Spline Regularization”, Lecture Notes in Computer Science, Springer Berlin / Heidelberg, volume 4241/2006, CVAMIA: Computer Vision Approaches to Medical Image Analysis, pages 85-95, 2006. ; http://biocomp.cnb.csic.es/~iarganda/bUnwarpJ/), for image registration using elastic deformations. For further reading, please refer to the documentation of the bUnwarpJ Plug In.

Bead reports

image103

Bead reports provide results and fitting parameters for each individual substack/bead (see Fig. 3.5) and are intended as a visual and quantitative check of the fitting results. They can be generated (one PDF files for every 100 detected PSFs) by selecting the “bead reports PDF file” option in the “export as” pull down menu at the bottom of the overview panel (see Fig. 2.7) and will be exported to a user selectable folder.

Fig. 3.5 – Typical datasheets for individual beads in the Bead-reports pdf.

4. Interpretation of results and trouble shooting

When is the performance of my system in its technical optimum, and no further improvement is likely to be possible?

In general, the best performance can be expected when adhering to the imaging conditions it has been designed for. Particular care should be taken to use the correct immersion medium and cover slip thickness (if applicable) and work at the specified temperature. Nevertheless, the performance will likely vary between different days and instruments and generally be worse than can be expected from theory or marketing. Please also refer to the PSFj publication and the Supplement.
In our experience, the best objectives will provide a resolution in the xy-plane which is about 10-20% below that expected for a diffraction limited system but deviations up to 50% can be considered standard. The resolution along the z-axis is usually similar or even 10-30% better than the theoretical resolution. This is explained by the way the theoretical resolution is calculated, which leads to an underestimation of the true values. For this, please refer to the Publication and the Supplementary Results and Discussion, Paragraph‚ Quantification of the performance of different objective lenses’.
Furthermore, good objective lenses can be expected to provide a planarity substantially smaller (<10%) than the axial resolution and lateral and axial chromatic shifts substantially smaller (<20%) than their lateral and axial resolutions, respectively. This of course will depend on the level of correction but also on the imaged FOV and should be tested using PSFj.

It looks as if my microscope is not doing its job properly, and what now?

  1. Check that the proper parameter for your system and the proper imaging specifications were entered
  2. Check that all image stacks were recorded using the same parameters
  3. Open your image files in PSFj and check that the correct parameters are stored in the .ini files (.ini files are saved as soon as you process image stacks: if you accidentally opened a wrong image stack along with other stacks, an incorrect .ini file might have been generated)
  4. identify the parameter that exhibits low/bad performance: is it only one parameter, or all parameters?
    Parameters related to resolution can be affected by vibrations, drift of the stage during image acquisition etc.? Possible sources of such artifacts:

    • Temperature fluctuations due to air-conditioning
    • Vibrations from the ventilation of the camera (this is a frequent and super annoying
      problem with some older cameras). One way to detect significant vibrations is to simply touch the camera and check the output of the sensory nerves in your finger, alternatively the iPhone app ‘iSeismometer’ might be useful.
  5. Check the experimental conditions – correct immersion medium?, correct cover-slip thickness and/or adjustment of the objectives thickness correction collar?, correct
    temperature and/or adjustment of the objectives temperature correction collar?, correct bead size?, correct magnification, i.e., voxel size? – this can be easily tested by comparing the bead positions in two images, one taken before and one after moving the bead sample a given distance (say 50 μm) in x and/or y and/or z.

I get a stunning performance of my system, better than its theoretical values.

If this happens for the resolution in the xy-plane, you need to check your parameters.
However, for the resolution along the z-axis you could get a better result than the theoretical value in the report. This is OK. The reason for this is explained in the Supplementary Materials section of the paper: Supplementary Results and Discussion, Paragraph ‚Quantification of the performance of different objective lenses’.

Getting help

If you have any question or need any help, please contact us using this form.

For feedback or comments, please refer to this page.