Skip to content

Activity Quantification and Analysis for molecular spatiotemporal signals

License

Notifications You must be signed in to change notification settings

yu-lab-vt/AQuA2

Repository files navigation

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

  • In vivo and ex vivo
  • Neuron, astrocyte, oligodendrocyte
  • Calcium, ATP, NE, GABA, dopamine
  • 2D and 3D
  • Single-color and dual-color
  • And more

Detection Pipeline

  • Preprocessing - dF
  • Statistical test - Active region
  • Temporal segmentation - Super events
  • Spatial segmentation - Events

Functional unit analysis

  • Consensus Functional Unit (CFU) definition:
    • If one spatial region generates repeated signal events, it is more likely to be a functional unit, and we refer to such a region as a CFU. This concept offers greater flexibility compared to ROIs, allowing each occurrence of signals to have different sizes, shapes, and propagation patterns while maintaining consistent spatial foundations. The derived CFU could be single cell, cell group, tissue, or organ.
  • CFU identification
  • Interaction analysis between CFUs
  • CFU grouping

Output Features

  • Event-level features
    • Location of events
    • Basic features of individual events, including voxel set, duration, area size, average curve of event's spatial footprint, average dF curve of spatial footprint, rising time, peak p-value, area under the curve (AUC), and others.
    • Propagation-related features, including propagation speed, propagation map, and propagation trend in various directions.
    • Network features, which involve the distances between events and user-defined regions (e.g., cell regions or landmarks), as well as assessing the co-occurrence of events in spatial or temporal dimensions.
  • CFU-level features
    • Individual CFU information, including the spatial map, event sequence, average curve, and average dF curve.
    • The dependency between every pair of CFUs, as well as the relative delay between two CFUs.
    • The information of CFU groups, including CFU indexes and the relative delay of each CFU.

Graphical User Interface for Event Detection

  • Similar GUI as AQuA
  • Step by step guide
  • Event viewer
  • Feature visualizer
  • Proofreading and filtering
  • Side by side view
  • Region and landmark tool
  • And more

User interface

Graphical User Interface for CFU Module

  • Step by step guide
  • Event viewer
  • Feature visualizer
  • Proofreading and filtering
  • Side by side view
  • Region and landmark tool
  • And more

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

  • Fiji plugin version of AQuA can be found here.

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.

About

Activity Quantification and Analysis for molecular spatiotemporal signals

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published