yu-lab-vt / AQuA2

Activity Quantification and Analysis for molecular spatiotemporal signals
GNU General Public License v2.0
13 stars 1 forks source link

AQuA2 Logo

AQuA2 (Activity Quantification and Analysis) is a tool for quantifying spatiotemporal signals across biosensors, cell types, organs, animal models and imaging modalities of biological fluorescent imaging data. AQuA can be pronounced as /ˈɑː.kwə/.

If you have any feedback or issue, you are welcome to either post issue in Issues section or send email to yug@tsinghua.edu.cn (Guoqiang Yu at Tsinghua University).

More about AQuA

AQuA2 pipeline

Potential Input Data

Detection Pipeline

Functional unit analysis

Output Features

Graphical User Interface for Event Detection

User interface

Graphical User Interface for CFU Module

User interface

Download and installation

MATLAB GUI

  1. Download latest version here.
  2. Unzip the downloaded file.
  3. Start MATLAB.
  4. Switch the current folder to AQuA2's folder.
  5. Double click aqua_gui.m, or type aqua_gui in MATLAB command line.

We recommend MATLAB versions later than 2022b. For 3D imaging data, we recommend to use MATLAB 2022b.

MATLAB Without GUI

Use aqua_batch.m file

  1. Double click aqua_batch.m file.
  2. Set the folder path 'pIn', and for each target dataset, set the parameters in AQuA2/cfg/parameters_for_batch.csv. Each dataset is corresponding to one parameter setting.
  3. Run the file.
  4. The output files will be saved in subfolders of 'pOut'.

Fiji plugin

Getting started

If you are using AQuA2 for the first time, please read the step by step user guide.

Or you can check the details on output files, extracted features, and parameter settings.

Example datasets

You can try these real data sets in AQuA2.

Ex-vivo GCaMP dataset

In-vivo GCaMP dataset

GluSnFr dataset

Reference

Xuelong Mi, Alex Bo-Yuan Chen, Daniela Duarte, Erin Carey, Charlotte R. Taylor, Philipp N. Braaker, Mark Bright, Rafael G. Almeida, Jing-Xuan Lim, Virginia M. Rutten, Wei Zheng, Mengfan Wang, Michael E. Reitman, Yizhi Wang, Kira E. Poskanzer, David A. Lyons, Axel Nimmerjahn, Misha B. Ahrens, Guoqiang Yu, Fast, Accurate, and Versatile Data Analysis Platform for the Quantification of Molecular Spatiotemporal Signals, BioRxiv 592259; doi: https://doi.org/10.1101/2024.05.02.592259. [Link to BioRxiv]

Updates

10/06/2024: Add scripts to registrate the FOV for AQuA2 results from multi-session datasets. Also add one script for comparing CFUs from two datasets with the same spatial size.

10/04/2024: Repair one bug about the feature output of global detections in batch script.

09/26/2024: Repair one bug about landmark features.

09/18/2024:

Modify aqua_cmd_batch.m to repair one bug about outputting feature table.

08/24/2024:

Fix one bug about outputting propagation features.

08/16/2024:

Reuse some landmark features used in AQuA for 2D time-lapse imaging data.

06/11/2024:

Add MEX files to enable spatial segmentation of AQuA2 in Mac system.

06/05/2024:

Enable aqua_cmd_batch.m to output more features.

05/22/2024:

Modify aqua_cmd_batch.m to enable the extraction of network features.

05/21/2024:

Add post_cfu_cmd_batch.m to enable the CFU identification and analysis based on the saved files of aqua_cmd_batch.m.