|
|
# <img src = './images/fcsrunner_icon.png'> FcsRunner
|
|
|
# <img src = './images/fcsrunner_icon.png'> FCSRunner
|
|
|
|
|
|
<a name=back></a>
|
|
|
VBA tool to perform imaging and fluorescence (cross)correlation spectroscopy (F(C)CS) measurements and automatically save FCS positions to a *xml* file for later reuse. The tool can be used to create data for FCS-calibrated imaging. It requires Zeiss LSM microscopes running with ZEN black (version >= 2010).
|
... | ... | @@ -14,7 +14,7 @@ FCS measurements are performed at multiple stage positions, typically one stage |
|
|
|
|
|
|
|
|
> **Disclaimer:**
|
|
|
> FcsRunner has been tested on Zeiss LSM 780 microscopes with ZEN 2010, 2011 and 2012 as well as LSM880 microscopes with ZEN2.1 and ZEN2.3. We don’t guarantee that it will work on other configurations and we don’t take any responsibility for damage occurring during or after the use of FcsRunner.
|
|
|
> FCSRunner has been tested on Zeiss LSM 780 microscopes with ZEN 2010, 2011 and 2012 as well as LSM880 microscopes with ZEN2.1 and ZEN2.3. We don’t guarantee that it will work on other configurations and we don’t take any responsibility for damage occurring during or after the use of FCSRunner.
|
|
|
|
|
|
|
|
|
|
... | ... | @@ -34,22 +34,27 @@ FCS measurements are performed at multiple stage positions, typically one stage |
|
|
To compute bleach corrected correlation functions some programs require the photon counts raw data. In ZEN you need to specify this in the *Maintain* menu. A directory does not need to be specified. FCSRunner copies the **.raw* files in the current directory.
|
|
|
|
|
|
<p align = 'center'> <img src="./images/rawcounts.PNG" width = "300px"> </p>
|
|
|
### Trouble-shooting the installation
|
|
|
|
|
|
### Troubleshooting the installation
|
|
|
For any issues please contact one of the developers in the Ellenberg group at EMBL, Heidelberg; and provide the version of the software and the full version of your ZEN software (Help->About). If you have a ZEN version higher than 2010 and the macro complains that it does not find ```Zeiss.Micro.AIM.ApplicationInterface.dll```, you may need to register it manually.
|
|
|
|
|
|
You can try this to fix
|
|
|
You can try this to fix:
|
|
|
|
|
|
• Open a console window (cmd.exe)
|
|
|
* Open a console window (cmd.exe)
|
|
|
|
|
|
• Go to the ZEN path: ``cd ..\..\ZEN``
|
|
|
* Go to the ZEN path: `cd ..\..\ZEN`
|
|
|
|
|
|
• Register the ```Zeiss.Micro.AIM.ApplicationInterface.dll```
|
|
|
* Register the `Zeiss.Micro.AIM.ApplicationInterface.dll`
|
|
|
|
|
|
``` C:\Windows\Microsoft.NET\Framework\v4.0.30319\RegAsm.exe /tlb /codebase Zeiss.Micro.AIM.ApplicationInterface.dll ```
|
|
|
```
|
|
|
C:\Windows\Microsoft.NET\Framework\v4.0.30319\RegAsm.exe /tlb /codebase Zeiss.Micro.AIM.ApplicationInterface.dll
|
|
|
```
|
|
|
|
|
|
• When you uninstall ZEN, make sure to un-register
|
|
|
* When you uninstall ZEN, make sure to un-register
|
|
|
|
|
|
```C:\Windows\Microsoft.NET\Framework\v4.0.30319\RegAsm.exe/u /tlb /codebase Zeiss.Micro.AIM.ApplicationInterface.dll```
|
|
|
```
|
|
|
C:\Windows\Microsoft.NET\Framework\v4.0.30319\RegAsm.exe/u /tlb /codebase Zeiss.Micro.AIM.ApplicationInterface.dll
|
|
|
```
|
|
|
|
|
|
|
|
|
<a name="sectionTwo"></a>
|
... | ... | @@ -64,19 +69,19 @@ The user also needs to define to which location each measurement point belongs. |
|
|
The macro allows to acquire FCS measurements at different stage positions. For each stage position the microscope will acquire an image and perform the FCS measurements. The total number of FCS measurements per position must be a multiplier of the total number of FCS measurements per object.
|
|
|
|
|
|
* **FCS positions**: These are the scanner positions where the FCS measurements are acquired. They are relative to the current stage position.
|
|
|
* **Stage positions**: The XY stage and Z-focus position.
|
|
|
* **Stage positions**: The XY stage and Z focus position.
|
|
|
|
|
|
> Do not move the stage or focus position when placing FCS points for a cell. If you need to correct an imaging position, remove all FCS positions, change stage and focus positions and press `Update`. Then add new FCS positions.
|
|
|
|
|
|
<p align = 'center'><img src="./images/fcsRunner.PNG" width = "400px"></p>
|
|
|
|
|
|
1. Specify the number and location/type of `FCS points per object`.
|
|
|
2. In the **FCS Positions** frame the user can `Add` FCS points to the current stage position. The other buttons will `Remove` a highlighted point or `Remove All` FCS points.
|
|
|
3. In the **Stage Positions** frame the user can `Add` the current stage (X,Y) and focus (Z) position to the experiment. The user can `Remove` a highlighted position or `Remove All` positions. The `Update` button will update the highlighted entry to the current position. With a double click the stage moves to the highlighted entry. <br/>
|
|
|
4. If `One image per object` is checked, the number of FCS points at each position does not exceed the total number of points per object. A new stage position entry is automatically generated.
|
|
|
5. Specify output directory, file format and base file name (an optional prefix to the file name).
|
|
|
6. The 3 top buttons start a measurement, the last button stops a measurement. The difference between buttons is the order in which FCS and imaging are executed.
|
|
|
7. Total number of FCS measurements for all positions.
|
|
|
1. Specify the number and location/type of `FCS points per object`
|
|
|
2. In the **FCS Positions** frame the user can `Add` FCS points to the current stage position. The other buttons will `Remove` a highlighted point or `Remove All` FCS points
|
|
|
3. In the **Stage Positions** frame the user can `Add` the current stage (X,Y) and focus (Z) position to the experiment. The user can `Remove` a highlighted position or `Remove All` positions. The `Update` button will update the highlighted entry to the current position. With a double click the stage moves to the highlighted entry
|
|
|
4. If `One image per object` is checked, the number of FCS points at each position does not exceed the total number of points per object. A new stage position entry is automatically generated
|
|
|
5. Specify output directory, file format, and base file name (an optional prefix to the file name)
|
|
|
6. The 3 top buttons start a measurement, the last button stops a measurement. The difference between buttons is the order in which FCS and imaging are executed
|
|
|
7. Total number of FCS measurements for all positions
|
|
|
|
|
|
|
|
|
|
... | ... | |