Home.md

@@ -4,21 +4,21 @@ Here we explain how to install and use Fluorescence Correlation Spectroscopy (FC
 #### 1.  [Installation](installation)
 #### 2.  [Structure of workflow](#structure-of-workflow)
 #### 3.  [Procedure](#procedure)
-#### 4.  [Interactive Visualisation](#interactive-visualisation-of-calibration-plot)
 #### 5.  [Output files](#output-files)
 #### Structure of workflow
 > The main nodes users work with are typed in bold.
 -  User input:
-   -  **main user input** (general parameters)
-   -  **plot parameters input** (customizing your plot and setting the Quality Check (QC) parameters)
-   -  WT user input (calculating the background offset for correction step in Fluctuation Analyzer (FA))
+   -  **main user input** (where users specify general parameters)
+   -  **plot parameters input** (users customize the calibration plot and setting the Quality Check (QC) parameters)
+   -  WT user input (for calculating the background offset for correction step in Fluctuation Analyzer (FA))
 -  Loading the data:
    -  FP&POI, dye metanodes (collecting fluctuation data)
    -  FP&POI&WT images metanode (loading images and coordinates)
 -  Data processing + Quality Check:
    -  Python Script (2=>1) (calculating confocal volume and concentrations)
-   -  intensity calculation metanode (calculating intensities in ROI-s, background substraction)
+   -  intensity calculation metanode (extracting intensities in ROI-s, background substraction)
    -  joiner metanode with Quality Check (data collection for calibration plot + Quality Check)
+   -  concentration map metanode (building concentration maps from row images using calibration parameters)
 -  Visualisation of data
    - Python Source (POI&FP CPM distribution)
    - **Python View** (calibration plot)
@@ -28,8 +28,9 @@ Here we explain how to install and use Fluorescence Correlation Spectroscopy (FC
 ![eeffe](uploads/66713426afc1b365482a12d55d6bc87e/eeffe.png)
 
 #### Procedure 
-1.  This step can be omitted. Process a WT data with FA to obtain WT.res. Only loading and saving data steps are needed. Fill a WT user input and execute Python Source node. Use returned offset value for correction steps in further FA sessions for FP and POI. 
-2.  Perform three separate sessions of FA analysis: for FP, for POI, and for dye. Do all intermediate FA steps (correlations calculation, correction, fitting of correlations with ACF) to obtain mFP.res, POI.res, and dye.res. A detailed explanation of FA analysis procedure can be found [here](https://git.embl.de/grp-ellenberg/FCSAnalyze/-/wikis/home).
+1.  Process a WT data with FA to obtain WT.res.  A detailed explanation of FA analysis procedure can be found [here](https://git.embl.de/grp-ellenberg/FCSAnalyze/-/wikis/home). Only import, correction, and export steps of FA session are needed. Fill a WT user input and execute Python Source node. Use returned offset value for correction steps in further FA sessions for FP and POI. 
+> Remember to switch on background indicator in correction steps and then fill offset calculated in step 1
+2.  Perform three separate sessions of FA analysis: for FP, for POI, and for dye. Do all intermediate FA steps (correlations calculation, correction, fitting of correlations with ACF) to obtain mFP.res, POI.res, and dye.res.
   **Important:** do not forget to save fluctuation traces with ACF fitting curves (Export all traces button) as .cof, .itr files. 
 3.  Prepare the following [structure of files](structure of files).
 4.  Specify parameters in the main user input
@@ -42,20 +43,27 @@ Here we explain how to install and use Fluorescence Correlation Spectroscopy (FC
 
 ![input6](uploads/9722c2ef7708c222886222c7f15ad864/input6.png)
 
-6. The default channel used for extracting intensities from images is the first one. If you want to change the channel, go to intensity data metanode, then open Image Reader (Table) node, go to Subset Selection and exclude all channels except the channel you need to process. 
+6. Specify the channels used for collecting images. The default channel used for extracting intensities from images is the first one. If you want to change the channel, go to intensity data metanode, then open Image Reader (Table) node, go to Subset Selection and exclude all channels except the channel you need to process.
  
-7.  Execute all nodes or execute different parts of pipeline sequentially
-> For the execution of all nodes at one time, click on the green bottom (Execute all executable nodes) at the top of the KNIME window or just press a shortcut: Shift+F7.
+![ccc](uploads/470c6f96fb202dda186885deea5cfbe9/ccc.png)
 
-#### Interactive Visualisation
-1.  Pick the point of interest in the calibration plot window to see fluctuation and correlation data from the respective FCS position.
-2.  Check the statistics parameters and level of bleaching at the headings of plots. 
-3.  Delete points that you consider have "bad" fluctuations or quality of fitting (list points to delete in plot parameter input).
-4.  The menu of the plot windows can be used to:
-*  Save the image of the plot
+7.  Execute all nodes or particular visualization nodes.
+> For the execution of all nodes at one time, press a shortcut: Shift+F7.
+
+In Python View node of calibration plot users have an opportunity to:
+*  Pick the point of interest in the calibration plot window to see fluctuation and correlation data from the respective FCS position. The line can be influenced by outliers (see step 8 in the Procedure section)
+*  Check the statistics parameters and level of bleaching at the headings of plots. 
 *  Move and zoom a working space 
-*  Adjust spacing and export values from the plot
-*  Adjust the view of axes and curves
+*  Adjust spacing and the view of axes and curves
+*  Save the image of the plot
+
+8.  Delete points that haven't passed Quality Check (the points with "bad" fluctuations or poor quality of fitting. 
+*  List the points to delete in plot parameters input. <br>
+**Important note**: The Standart Quality check does **not guarantee** to remove all "bad" fluctuations. Thus we recommend going through calibration points and remove all "bad" fluctuations manually. To delete the points in calibration plot, fill the numbers from the annotations of corresponding points into plot parameter input (points to delete). Reexecute the Python View node with calibration plot
+> This step could also help to get rid of outliers that can influence the liner parameters of the calibration line.
+
+#### Interactive Visualisation
+
 
 > Sensitivity of picking event can be adjusted in the plot parameters input.
 
@@ -64,7 +72,6 @@ Here we explain how to install and use Fluorescence Correlation Spectroscopy (FC
 > All outputs are saved in the main directory.
 1.  **info.csv**
 info.csv is generated inside the main user input. This is the main output with all final and intermediate parameters. It includes:    
-
 *  diffusion coefficient of dye and confocal volume
 *  the names of directories and files that are used in FCSpipeline
 *  path to the main directory