教程1：ASA GUI 端到端分析教程¶

本教程介绍 ASA GUI（Attractor Structure Analyzer）如何将 ASA pipeline 的数据预处理、 TDA、解码与可视化整合为图形化工作流。你将学会用窗口界面完成分析并在结果目录中管理输出。

Note

若想深入了解分析原理与参数选择，请参阅教程1：ASA Pipeline：实验数据解码全流程。

教程目标¶

Note

ASA GUI 当前仅支持 ASA .npz 输入。 “Neuron + Trajectory” 相关控件仍处于预留状态。

在项目环境中执行：

canns-gui
# 或
python -m canns.pipeline.asa_gui

启动后会显示主窗口，默认尺寸约 1200×800，可根据屏幕调整大小。

主窗口顶部包含：

Preprocess 页：输入配置、预处理参数与日志。 Analysis 页：分析参数、结果预览与文件输出。

Input / Mode	固定为 `ASA (.npz)`；当前 GUI 仅支持 ASA 输入。
Preset	预设模板：`grid` / `hd` / ``none``（影响分析页默认值）。
ASA file	拖拽或点击 Browse 选择 `.npz` 文件。
Preprocess / Method	选择 `None` 或 `Embed spike trains`。
Embedding 参数	`res` / `dt` / `sigma` / `smooth` / `speed_filter` / `min_speed`。
Pre-classification	预留选项（`none` / `grid` / `hd`），当前仅记录，不影响分析。
Run / Stop / Progress	启动或终止预处理，并显示进度条。
Logs	显示预处理过程日志。

Analysis Parameters	选择分析模块并设置参数。
Analysis module	支持 `TDA` / `CohoMap` / `PathCompare` / `CohoSpace` / `FR` / `FRM` / `GridScore`。
Preprocess (Standardization)	`StandardScaler` 标准化选项。
Help	打开快速帮助与常见提示。
Language	在中文 / English 之间切换界面语言。
Run Analysis / Stop / Progress	运行分析并显示进度。
结果标签页	`Barcode` / `CohoMap` / `Path Compare` / `CohoSpace` / `FR` / `FRM` / `GridScore` / `Files`。
Files	列出输出文件并可 Open Folder 打开结果目录。

在 ASA file 区域拖拽或点击 Browse 选择 .npz 文件。界面会提示期望的字段：spike / x / y / t。

至少包含 spike 与 t：

import numpy as np
np.savez(
    "session_asa.npz",
    spike=spike,
    t=t,
    x=x,
    y=y,
)

在 Preprocess 区域选择预处理方法：

如需嵌入，设置 res / dt / sigma / smooth / speed_filter / min_speed 等参数，然后点击 Run Preprocess。

切换到 Analysis 页面，选择分析模块并配置参数：

点击 Run Analysis 开始运行。

运行完成后，在右侧标签页查看结果：

Results/<dataset>_<hash>/

其中 <dataset> 由输入文件名生成，<hash> 为输入哈希前缀。目录中会包含分析结果与缓存（.asa_cache），以加速重复运行。