|
| 1 | +--- |
| 2 | +title: FIA |
| 3 | +categories: [Registration, Motion Correction, Analysis] |
| 4 | +icon: /media/icons/FIA.png |
| 5 | +source-url: "https://github.com/Epivitae/FIA-Fluorescence-Image-Aligner" |
| 6 | +update-site: "Biosensor Tools" |
| 7 | +release-version: v3.1.0 |
| 8 | +support-status: Active |
| 9 | +team-founders: ['@Epivitae'] |
| 10 | +team-maintainers: ['@Epivitae'] |
| 11 | +--- |
| 12 | +{%- assign github = page.github -%} |
| 13 | +{%- assign release-version = page.release-version -%} |
| 14 | +{%- assign release-date = page.release-date -%} |
| 15 | +{%- assign dev-status = page.dev-status -%} |
| 16 | +{%- unless team-maintainers -%} {%- assign team-maintainers = page.team-maintainer -%} {%- endunless -%} |
| 17 | + |
| 18 | +[](https://doi.org/10.5281/zenodo.18206931) |
| 19 | + |
| 20 | +**FIA (Fluorescence Image Aligner)** is a robust motion correction plugin designed to solve the full spectrum of motion artifacts in biological time-lapse microscopy. |
| 21 | + |
| 22 | +Developed by **Dr. Kui Wang** at the Center for Excellence in Brain Science and Intelligence Technology (CEBSIT), Chinese Academy of Sciences, FIA bridges the gap between high-precision rigid alignment and non-rigid deformation correction. It is specialized for Calcium Imaging (G/R-CaMP), Voltage Imaging, and long-term live cell monitoring. |
| 23 | + |
| 24 | +Author: [Kui Wang](people/Epivitae), CEBSIT, CAS. For questions please use the [GitHub Issues](https://github.com/Epivitae/FIA-Fluorescence-Image-Aligner/issues) or tag @Epivitae on image.sc. |
| 25 | + |
| 26 | +## Key Features |
| 27 | + |
| 28 | +* **Dual-Engine Core**: |
| 29 | + * **OpenCV ECC**: Best for high-precision, sub-pixel rigid alignment (Rotation/Translation). |
| 30 | + * **Dense Flow (New Standard)**: State-of-the-art local deformation correction using Farnebäck optical flow. Handles internal tissue warping and soft tissue deformation better than rigid methods. |
| 31 | +* **Scientific Integrity (Intensity Preservation)**: |
| 32 | + * FIA guarantees that your **ΔF/F** analysis remains valid. |
| 33 | + * *Navigation*: Motion vectors are calculated using noise-reduced (CLAHE), contrast-enhanced temporary frames. |
| 34 | + * *Transport*: These vectors are applied to your **original raw data** using cubic interpolation. No artificial contrast is written to your final image. |
| 35 | +* **Smart "Super Reference"**: |
| 36 | + * In **Dense Flow** mode, FIA creates a reference anchor by averaging `N` frames. This eliminates the "floating anchor" problem caused by shot noise in single-frame references. |
| 37 | + |
| 38 | +## Installation & Update |
| 39 | + |
| 40 | +FIA is distributed via the **Biosensor Tools** Fiji Update Site. |
| 41 | + |
| 42 | +1. Open **Fiji / ImageJ**. |
| 43 | +2. Navigate to **Help › Update...** |
| 44 | +3. Click **Manage update sites**. |
| 45 | +4. Check **Biosensor Tools** from the list. |
| 46 | +5. Click **Apply and Close**, then restart Fiji. |
| 47 | + |
| 48 | +{% include notice icon="info" content="If the site is missing from the list, you can add it manually:<br>**Name:** `Biosensor Tools`<br>**URL:** `https://sites.imagej.net/Biosensor-Tools/`" %} |
| 49 | + |
| 50 | +## Usage Guide |
| 51 | + |
| 52 | +### 1. Mode Selection |
| 53 | + |
| 54 | +FIA offers three operational modes tailored to different biological samples: |
| 55 | + |
| 56 | +| Mode | Type | Best Application | |
| 57 | +| :--- | :--- | :--- | |
| 58 | +| **Global** | Rigid / Affine | **General Drift Correction.** Corrects XY translation and rotation. Recommended for behaving animal tracking or whole-brain imaging. | |
| 59 | +| **Dense Flow** | Non-Rigid (Optical Flow) | **95% of Biological Samples.** Uses *Super Reference + CLAHE*. Best for noisy fluorescence, brain slices, and in vivo imaging where local deformation occurs. | |
| 60 | +| **Elastic** | Non-Rigid (Raw) | **High-SNR Data.** Uses raw optical flow without preprocessing. Best for binary masks, artificial beads, or clean data where contrast enhancement is unnecessary. | |
| 61 | + |
| 62 | +### 2. Parameter Tuning |
| 63 | + |
| 64 | +The **Smart UI** adapts based on your selected mode. |
| 65 | + |
| 66 | +#### For Dense Flow Mode: |
| 67 | +* **Flow WinSize**: The "field of view" for local alignment. |
| 68 | + * *Small (5)*: Captures fine jitter. |
| 69 | + * *Large (15+)*: Captures global tissue waves. |
| 70 | +* **Ref Depth**: Number of frames averaged to create the "Super Reference" (Default: 5). Higher values reduce noise in the reference anchor. |
| 71 | +* **Poly N**: Smoothing factor. *5* provides sharper motion borders, while *7* offers smoother flow fields but may blur distinct motion boundaries. |
| 72 | + |
| 73 | +#### For Global Mode: |
| 74 | +* **Max Iterations**: The loop limit for Rigid/Affine calculation. |
| 75 | +* **Precision**: Convergence threshold (epsilon). |
| 76 | + |
| 77 | +## Algorithms |
| 78 | + |
| 79 | +FIA is built upon established computer vision algorithms to ensure reliability: |
| 80 | + |
| 81 | +1. **Non-Rigid Registration**: Based on Farnebäck's polynomial expansion (2003) combined with CLAHE (Contrast Limited Adaptive Histogram Equalization) for robustness against uneven illumination. |
| 82 | +2. **Rigid Alignment**: Utilizes Parametric Image Alignment using Enhanced Correlation Coefficient (ECC) Maximization (Evangelidis & Psarakis, 2008). |
| 83 | +3. **Legacy Stabilization**: Includes a fallback engine based on the classic Lucas-Kanade optical flow. |
| 84 | + |
| 85 | +## Citation & DOI |
| 86 | + |
| 87 | +If you use FIA in your research, please cite the permanent Zenodo record: |
| 88 | + |
| 89 | +Wang, K. (2026). FIA: Fluorescence Image Aligner - Robust Motion Correction for ImageJ/Fiji (v3.1.0). Zenodo. https://doi.org/10.5281/zenodo.18206931 |
| 90 | + |
| 91 | +* **Repository**: [https://github.com/Epivitae/FIA-Fluorescence-Image-Aligner](https://github.com/Epivitae/FIA-Fluorescence-Image-Aligner) |
| 92 | +* **CNS Team**: [Chimeric Nano Sensor Team](https://www.cns.ac.cn/) |
| 93 | + |
| 94 | +--- |
| 95 | +*Developed by Kui Wang © 2026. Part of the **Biosensor Tools** suite.* |
0 commit comments