Transcript
Index. Page 2 - 3. How to switch on and additional information Page 4. Opening desktop and starting Micro-Manager with config Page 5. Opening software explanation and Main window components Page 6. Initial scanning setup and acquisition Page 7- 8. Setting up to acquire (MDA) multiple channel images. Saving multi-channel settings Page 9 - 10. Acquiring multiple channels, saving, viewing individual channels Page 10 - 11. Adjusting the acquired image, setting scale bar, saving as 8Bit Page 12. AutoExposure and Acquire, Brightfield Page 13. RGB acquisition Page 14 - 15. Appendix, config instructions, tools options for MDA synchronisation Page 16. Fast launch setup. Switch light path from eyes to camera Page 17. Filter wheel Page 18 to Page 19. AutoStretch. Mapping a network drive to save your data Page 19 - 20. Creating a shortcut to your data area. Setting up autosave to this area Page 20 - 21. Setting scalebar Page 21 - 22. Alternative ways to save data. Splitting and merging composite data Page 23 - 24. Fast-Live mode (F6). Acquire-Focus Offset (F10)
1
Micro-Manager for BriteMac with motorised stage. Manual can be downloaded at http://www.igmm-imaging.com/equipment/Epifluorescence
Do not use the microscope unless you have been trained by a facility member If this is your first login on this machine, go to the Appendix at the back of this document to see initial, one-off changes you need to make to the software. (p14)
Please email if you have any questions;
[email protected]
Camera Shutter control
Piezo Z stage power supply
Fluorescence source
PC
Adjust transmitted light intensity
Microscope power switch
Internal shutters, LED’s green to show they are on. RL = Fluorescent light
2
TL = Transmitted light
Switch on the following; Turn on PC Camera – on top of the camera (If required) and the power supply in the box behind Fluorescence power source (If required) Filter wheel controller Piezo Z stage power supply Microscope (Switch on left side of microscope) RL (Fluorescent light) and TL (Transmitted light) internal shutter buttons (If required) on the right.
Motorised stage with slide holder insert
Stage controller, X and Y movement. Pressing button alters speed of stage movement
Slide holder needs to be used to mount slide, it needs to be lifted from the stage, once it had been lowered away from the lenses, the slides fitted in and then returned to the stage.
3
Log in with University of Edinburgh username.
Micro-Manager is already installed on the PC but it is faster to create a shortcut launcher on the Taskbar to start it. (Explanation in pictures, page 16) Now click on the Micro-Manager icon to open the software, the following windows will open. Make sure that the BriteMac config file has been loaded. (If not, go to p14 for instructions.) NB: A window may appear asking you to register, ignore this by clicking ‘Later’ and carry on.
No config file loaded. Must be BriteMac.cfg. Go to p14 for instructions
By clicking OK, Micro-Manager is fully launched and it will start communicating with all the peripherals; this means there will be some noise from the various filter wheels as the system registers. The resultant desktop will look like this, if it doesn’t then close the application and ensure that all the peripherals on page one of this document are SWITCHED ON.
4
This box is ImageJ, which can be used for postacquisition features Function keys controlling channels, acquisition and exposure
Main Micro-Manager window for acquiring images, lens setting and MDA Stage controller, movement in X, Y and Z directions
To view your slide, place your slide on the microscope stage (As shown on page 3), ensure that the light is going to the eyepieces (p16) , the correct filter wheel is selected (p17), select the objective required and then, using the function keys, select the channel you require, i.e. F3 for FITC in functions keys box (3 Colour) to check your slides. A Live window will be opened on the screen but will show nothing as there is no light going to the camera. Move the slide around using the joystick. Once you have found a something you wish to take an image of, move the light from the eyepieces to the camera (p16) and what you saw by eye will appear on the screen, assuming the exposure value is high enough. When not viewing the sample, press F1 to close the shutter (This will reduce the amount of bleaching of your sample as you setup on the desktop), The main window components are as labelled below.
Start/Stop live window
Multi-Dimensional Acquisition (MDA) Acquire more than one channel simultaneously
5
Exposure value for channel selected
Channel selected Gain – can be used to increase or decrease exposure time Set lens used to acquire – scalebar can be set
Initial scanning set up. Scanning timeline Mount slide Click Live or Click Channel i.e. FITC(F3) Live window opens Click AutoExpose (F9) to get exposure value Enter objective used into Main window Click Acquire to get image Click on Save icon, save as image stack 7. Click on Acquire (F11)
1. Click channel to see specimen on screen, i.e F3
4. Exposure value displayed. Can be manually changed
2. Live window opens
3. Click on AutoExpose to get non-saturated exposure value
8. Save 16bit, single channel image
6. Select lens used to acquire
5. After AutoExpose, window is no longer live. Click live to see changes/focus/etc
If happy with the image and focus, lens selected in main window, click Acquire (F11), a new image window is created which can be saved. Save the image as an Image Stack, a folder will be created with the name given and a 16Bit Tiff file within. Other save options are on p22. Very pale samples, with long exposures making focusing difficult, can be focused more easily using Fast Live Mode (F8). (Page 24)
6
For multiple channels, these need to be selected before scanning can proceed. This is done by clicking on Multi-D Acq in the MicroManager Main window. By clicking on this, a new window appears. In this new window, the channels required can be chosen to reflect your experiment needs. As can be seen, there are no channels in the window so to start this process, first click on the ‘Channels’ box and then click on the ‘New’ button to add channels. Do this as many times as required, in this case 3.
Multiple Channel Scans.
3. Click on New to add channels to acquire. 1. Multi-Dimensional Acquisition (MDA)
2. Click on Channels and Channel in Channel Group box. As can be seen in the Exposure column, any exposures set with AutoExposure, or manually, are displayed here as well (Synchronisation set up, p15). To remove a channel from the list of those to be scanned, highlight/click on the row of that particular one and click ‘Remove’.
Unwanted channels can be removed by clicking on that line and clicking Remove
Exposure selected before are displayed
Exposure synchronised with main window (See p.15) If, when focusing on each channel, there is difficulty in getting each channel on the same focal plane, then click on F10 (Acquire-Focus Offset). For an explanation, go to page 24 of the manual. If the correct channel does not appear, simply clicking on a non-required channel in the Configuration column, choosing the correct channel from the list will correct this. If the colour of the 7
chosen channel is wrong, or not there, simply click on the appropriate coloured box, choose the correct colour and click OK.
1. Select channel by clicking on box and selecting from the list
2. To change colour of final acquired image, click box and select from RGB tab in new window. Set those colours not required to 0 With the channels selected, the colours chosen, and the exposures set, these settings can be saved for re-using at a later date, especially if comparative image acquisition is being done. Simply click on Save as… in the Multi-Dimensional Acquisition window, choose somewhere in your data area to save it and click OK. When it comes to re-using these settings, simply click on Load… and open the saved file. Preset combinations of multiple channels can be loaded from \\igmm-smbhost\microscopeusers\Micro_Manager_Presets\
8
Acquiring multiple images and saving. With all the parameters now setup, click ‘Acquire!’ The system will now take 3 images, in this particular case, one for each channel selected and using the exposure values calculated before. Once the 3 images have been taken, they are merged into a single, composite image. Pressing F11 (Acquire) will do the same operation. If no channels were selected, pressing F11 would give a single image of the last channel selected or viewed.
Click on Acquire to capture multi-channel image.
Save images, can automatically save a scan to a pre-designated folder.
Composite 16Bit image of the 3 individual scans.
9
The images will be taken and saved in the folder selected in the Directory Root in the MultiDimensional Acquisition window, as pre-selected when ‘Save images’ was ticked in the MDA window. If the ‘Save images’ is left unticked, then the images can be saved as an image stack individually. If Save Image was not ticked in the MDA window, the original 16Bit image can be saved by clicking on the save icon in the image window. Select the image stack option, enter the name required and click OK. This will then create a folder with the given name and the 16Bit TIFF composite image within. Any other adjustments can be made as described above and saved using the save button in ImageJ.
Click on save icon, and save as Image Stack file. This saves the 16bit image and the metadata file in a folder
The individual images/channels can be viewed by simply removing those scans not required in the Micro-Manager window. This is done by clicking the box next to the channel, removing as many or as few as required. Adjustments can be made to the image by altering the dynamic range. Default output of multiple scans is Composite but this can be changed to Greyscale or Color after the scan to view individual channels.
1. Change from composite to Colour or Greyscale, ie. Color
3. Individual channel can now be seen.
10
2. Individual channels can be switched on/off by unticking
Adjustments to the image can be done, using the histogram next to that particular channel, by simply clicking and dragging the small triangles at the bottom and top of the graph. An automatic adjustment of the range of the graph can be done by clicking Auto, with further adjustment by the user or Full to get the full range from 0 to 16383 on the scale, which can again be adjusted by the user. Click Auto to automatically Or, adjust range manually by adjust image range dragging ‘triangles’.
Once adjusted, assuming the original unedited image was automatically saved to a folder, this image can be saved using the save macro in ImageJ. This will save it as a single file as seen on the screen but with no metadata attached. Also, the 16bit image can be changed to an 8bit image (Viewable in all default viewers on PC’s and Mac’s or in Powerpoint) by clicking on the RGB button in ImageJ. Or, a scale bar can added – assuming the lens used was entered in the main window before taking the image –which will allow a scale bar to be set AND change the image from 16bit to 8bit. (p21)
Change to 8Bit
Set scale bar and change to 8Bit
Save image as a single TIFF file in 8Bit. (no metadata)
11
AutoExposure and Acquire. (F10) Once the image has been found that you wish to acquire, and if no comparison to other images are required, then the F8 function key can be used to take images. This Function creates new exposure values for every scan it does, which can make all the images appear to be at their best but means that no comparison, in terms of fluorescent or colourimetric output, can be carried out as the exposure rates will be different in every case, potentially.
Brightfield. (Num Lock) Brightfield imaging is done in exactly the same way as Fluorescence, apart from the filter wheel on the microscope should be turned to ‘Brightfield’ (Position 1), the brightfield lamp turned on at the side and the appropriate Brightfield Function key (Num Lock) used to view by eye AND on the screen. Once the image has been seen down the eyepieces, pull out the rod to move the light to the camera. The image will now appear in the Live View window on the screen. Adjust the exposure by entering a value into the Exposure window or by using AutoExposure (F9).
Once happy, if only a single channel is required, then click on Live to switch it off, then click on the save icon an save as an image stack (no separate images). If the lens has been set, then a scalebar can be applied or the RGB macro button can be clicked to change this 16bit image to an 8bit, then using the imageJ save macro to save as an individual file.
12
RGB Acquisition
If the slide to be viewed with Brightfield requires colour camera image, for example an H&E stained slide, then the RGB function can be used for this. Once an area has been found to scan using Num Lock (View Brightfield), move the light path to the camera and open the Multi-Dimensional Acquisition window. NB: Increase the level of white light, as exposures can be longer than expected due to filters used. Now change the channel group to Colour Brightfield and then click New to create the required channels, i.e. Red, Green and Blue. Once done, click RGB AutoExpose and Acquire Space) and the three channels are first AutoExoposed and then 3 images are taken based on these values. If you wish to use your own manually entered exposure values, then once selected click Acquire.
1. Change to Colour Brightfield 3. Change colours to match channel
2. Click new 3 times for 3 channels
Acquire to use manually entered exposure values.
Manually entered exposure values
Ensure Autostretch is ticked
13
Appendix.
The following instructions are for first time users of Micro-Manager on this particular PC. They should only need to be done on the first use but if issues arise later, may need to be repeated. When you log in for the first time, there are a couple of settings which need changing. The initial launch window will look similar to this. The window should contain the microscope name, in this case Britemac, so to load the required configuration file, click on the box with 3 dots . You now have to follow a set path to load the Britemac.cfg file. The path for this is
Computer C Drive Program Files Micro-Manager-1.4 Configs Britemac.cfg Now close the software, restart Micro-Manager and click OK if Britemac.cfg is now showing.
14
Britemac.cfg config file should now be selected Double click on Britemac.cfg
You only need to do this the first time you open Micro-Manager.
Finally, a couple of settings need to be changed to allow the image to be of a usable size and to allow some exposure settings to be visible in different windows. To do both of these, with Micro-Manager open, go to Tools Options and then tick the ‘Sync exposure between Main and MDA windows’ and change the ‘Preferred Image Window Zoom’ to 50%.
Set Window Zoom to 50%. The tick box to Sync Exposure
Tools Options….
If a separate metadata file is required, as opposed to the one embedded within the 16Bit image, then tick the ‘Create metadata.txt file box’. The metadata file contains all the information about the image, the hardware and software used to capture the image and more. This information can be read and used by software, such as ImageJ or Imaris.
15
Fast launch setup for Micro-Manager
If you choose to ‘Pin’ the shortcut to the Taskbar, the Desktop will now look like this. Once ‘pinned’, Micro-Manager can now be opened by clicking once on the icon.
Direction of light from slide to eyepieces or camera.
Image to eyepiece
16
Image to camera
Filter wheel.
Ensure that the correct filter position has been selected on the microscope prior to selecting the channels. To do this, turn the filter wheel to Brightfield or Chroma 3 or 4 depending on sample and fluorochromes to be viewed. And, that the bar is pushed in fully on the microscope to direct the light to the eyepieces.
Position 1 / Chroma 3 – White light Position 2 / Chroma 4 – FITC, Texas Red, DAPI Position 3 / Brightfield – TRITC, Cy5, FITC, DAPI
17
Autostretch; When first scanning a sample, what can be seen down the eyepiece may not reflect, in terms of signal strength/output, what the camera will see and display on the desktop. As such, using the Autostretch function allows the software to ‘see’ the signal, compress the dynamic range and therefore make a weak signal appear stronger while using the exposure rate entered. This will then give the user a clue as to whether to increase the exposure rate, use the full dynamic range of the camera and get better results from the scan. Below is a standard scan with the Autostretch unticked , a low exposure rate maximum light level is 1,786. The image is hard to see as it is under-exposed.
and the
By clicking on the Autostretch , the scales and maximums are the same but the dynamic range has been ‘squashed’ up to only display that little region on the scale. The readings are roughly the same but the range is now MUCH smaller. And the image is now visible though ‘noisy’.
18
By adjusting the exposure rate manually, or using F9 to AutoExpose, we can now get a much greater dynamic range without having to resort to using the Autostretch, and a clear, less ‘noisy’ image.
The Autostretch will only adjust how the image looks on the screen, the saved image will be as the camera actually see’s it.
Creating a shortcut to your data area or other server. All images taken with Micro-Manager need to be saved, and this should be in a designated area in your Datastore area. It is easiest to map a network drive to this area beforehand as this will make any subsequent saving much easier. To do this, open up Windows Explorer and click on Computer. Then click on Map network drive, slect a spare letter of the alphabet and type in the folder address, in this case ‘\\cmvm.datastore.ed.ac.uk\igmm\ImagingStore’. 2. Click and assign a letter to the folder 1. Click on Map network drive 3. Type in the location of the folder area
19
When you open Windows Explorer again, the new network area has been save, Imaging Store in this case
Scale Bar.
NB: Lens used to scan must be entered into Micro-Manager BEFORE scanning or scalebar will be using incorrect pixel values.
If a scalebar is required, this can be done by going into ImageJ Analyse Tools Scale Bar
Once happy with the scalebar, if you want to save the image WITH the scalebar, then you must ‘flatten’ the image to keep it. Do this by going to ImageJ Image Overlay Flatten. Then save the image in the format required.
20
A macro has been written that allows the setting of a scalebar and changing to 8Bit, or changing to 8Bit alone.
Set scale bar and change image to 8Bit.
Alternative ways to save acquired images Images can be saved automatically, as described on page 7, and this data can be read in ImageJ along with the saved Metadata file (Metadata file contains all the information about that particular scan in terms of time, type, channels, exposures and subsequent comments). The raw data should always be saved and then any subsequent changes through adjustment saved as an additional file. The following are other methods of saving an image or stack. If saving as a stack, the metadata file is not a separate file but included with the saved stack. To read this info, open the Bio-Formats under Plugins Bioformats Import select OME-XML and this will open a separate window with the metadata in here.
Save icon
RGB icon
In the ImageJ window, there are additional tools which can be utilised. The SAVE icon in the ImageJ window can save your image or stack as a 16bit images in whatever folder you wish but by doing this you lose everything from the metadata file apart from the image calibration, which will allow the setting of a calibration bar (Assuming the correct lens was selected in the Micro-Manager window before scanning). To save your image as an 8bit file and then be readable in other viewers or Powerpoint, click on RGB to ‘flatten’ the image (This can be done after placing a scalebar on the image) and then click on the SAVE icon. To change previously scanned files, drag the Stack file into ImageJ, go to Image Colour Stack to RGB. This will create a new, composite file which can now be saved as a TIFF image and read elsewhere. This can also be done if you choose not to automatically save your data after every scan.
21
Once the series of channels has been scanned, instead of immediately saving the stack or series of channel images, the above can be done in ImageJ.
A composite scan, 2 or 3 together, can be split into it’s separate channels by going to ImageJ and Image Stack Stack to Images. This will give 3 individual channel images. Any images acquired can simply be saved by going into ImageJ File Save As Tiff . This would apply to any images acquired at any point, removing the additional Folder issues.
This process is repeated for all the channels required for the experiment being done, those exposure rates seen are automatically recorded and readable by other parts of the Micro-Manager software. If the scans are being done to record differences, with regards treatments, then the exposure rate should remain unchanged throughout. If the images are only a record of the sample seen, or if there is to be no measurements taken as a comparison, then autoexposure could be used each time an image is taken, for example F8 (AutoExposure & Acquire)
22
Fast-Live-Mode (F6) If your exposure time is very long, this makes focusing quite hard. So clicking the Fast_Live_Mode can make focusing easier by changing the Bin value and decreasing the exposure time. Once focused, exit the script and the lower exposure value used to focus will return to what it was previously Focus object, then click OK and repeat the for channels required
Acquire-Focus Offset (F10)
There are times when you are a scanning a slide which has multiple channels and when focusing the areas of interest, are in slightly different position within the depth of the sample. This can then make focusing on a single plane very difficult, given that perhaps a couple of channels are in focus while the third is not. To get around this, there is a script (F10) which allows each channel to be focused independently. It should be noted, this could give a false view of what is happening with the sample, giving the impression that all the signals are in the same depth position and are not.
Looking down at the sample with camera
Specimen with signal throughout at different depths within the sample, making focusing all channels difficult 23
Looking down at the sample with camera
Using Acquire-Focus Offset will give this ‘false’ impression of the signal being all in the same plane but will maintain all channels in focus.
The net result is a sample which looks in focus on all channels, but care should be taken when reporting that the signals are not all in the same plane throughout the depth of the sample as focal offset has been applied. To use this function, first set up the Multi-Dimensional Acquire window with the channels you want to acquire, and set the correct exposures for each channel. Once done, now click on F10 (AcquireFocus Offset). A dialogue window will popup telling you to focus that channel, once done click OK and then you are told to focus the next channel. Once you click OK, the acquire will finish and your focused image will be displayed.
End result is a multi-channel image with all channels in focus.
24
