canns 0.14.1__py3-none-any.whl → 0.14.3__py3-none-any.whl

canns/pipeline/asa_gui/analysis_modes/base.py

@@ -29,6 +29,10 @@ class AbstractAnalysisMode(ABC):
         """Apply neuron/time ranges based on loaded data."""
         return None
 
+    def apply_language(self, lang: str) -> None:
+        """Apply localized tooltips/text."""
+        return None
+
 
 def configure_form_layout(form: QFormLayout) -> None:
     """Apply consistent spacing/alignment for analysis parameter forms."""

canns/pipeline/asa_gui/analysis_modes/cohomap_mode.py

@@ -54,3 +54,14 @@ class CohoMapMode(AbstractAnalysisMode):
             self.num_circ.setValue(2)
         elif preset == "hd":
             self.num_circ.setValue(1)
+
+    def apply_language(self, lang: str) -> None:
+        is_zh = str(lang).lower().startswith("zh")
+        if is_zh:
+            self.decode_version.setToolTip("解码版本（推荐 v2）。")
+            self.num_circ.setToolTip("解码圆数（grid 常用 2，hd 常用 1）。")
+            self.subsample.setToolTip("CohoMap 绘制下采样步长。")
+        else:
+            self.decode_version.setToolTip("Decode version (recommend v2).")
+            self.num_circ.setToolTip("Number of circles to decode (grid=2, hd=1).")
+            self.subsample.setToolTip("Subsample step for CohoMap plotting.")

canns/pipeline/asa_gui/analysis_modes/cohospace_mode.py

@@ -192,3 +192,40 @@ class CohoSpaceMode(AbstractAnalysisMode):
         val = self.neuron_id.value() + int(delta)
         val = max(self.neuron_id.minimum(), min(self.neuron_id.maximum(), val))
         self.neuron_id.setValue(val)
+
+    def apply_language(self, lang: str) -> None:
+        is_zh = str(lang).lower().startswith("zh")
+        if is_zh:
+            self.dim_mode.setToolTip("解码维度模式（1D/2D）。")
+            self.dim.setToolTip("1D 解码维度索引。")
+            self.dim1.setToolTip("2D 解码维度 1。")
+            self.dim2.setToolTip("2D 解码维度 2。")
+            self.mode.setToolTip("spike 或 fr 模式。")
+            self.top_percent.setToolTip("活跃点百分比阈值。")
+            self.view.setToolTip("显示单神经元或群体。")
+            self.subsample.setToolTip("轨迹下采样步长。")
+            self.unfold.setToolTip("展开方式（square / skew）。")
+            self.skew_show_grid.setToolTip("skew 模式下显示网格。")
+            self.skew_tiles.setToolTip("skew 平铺次数。")
+            self.enable_score.setToolTip("计算 CohoScore 并选 top-K。")
+            self.top_k.setToolTip("Top-K 神经元数量。")
+            self.neuron_id.setToolTip("单神经元编号。")
+            self.use_best.setToolTip("使用 CohoScore 最小的神经元。")
+            self.btn_show.setToolTip("显示当前 neuron 结果。")
+        else:
+            self.dim_mode.setToolTip("Decode dimension mode (1D/2D).")
+            self.dim.setToolTip("1D decoded dimension index.")
+            self.dim1.setToolTip("2D decoded dimension 1.")
+            self.dim2.setToolTip("2D decoded dimension 2.")
+            self.mode.setToolTip("spike or fr mode.")
+            self.top_percent.setToolTip("Active percentile threshold.")
+            self.view.setToolTip("Show single neuron or population.")
+            self.subsample.setToolTip("Trajectory subsample step.")
+            self.unfold.setToolTip("Unfold mode (square / skew).")
+            self.skew_show_grid.setToolTip("Show grid in skew mode.")
+            self.skew_tiles.setToolTip("Skew tiling count.")
+            self.enable_score.setToolTip("Compute CohoScore and top-K.")
+            self.top_k.setToolTip("Top-K neuron count.")
+            self.neuron_id.setToolTip("Single neuron id.")
+            self.use_best.setToolTip("Use neuron with lowest CohoScore.")
+            self.btn_show.setToolTip("Show current neuron result.")

canns/pipeline/asa_gui/analysis_modes/decode_mode.py

@@ -50,3 +50,16 @@ class DecodeMode(AbstractAnalysisMode):
             self.num_circ.setValue(2)
         elif preset == "hd":
             self.num_circ.setValue(1)
+
+    def apply_language(self, lang: str) -> None:
+        is_zh = str(lang).lower().startswith("zh")
+        if is_zh:
+            self.decode_version.setToolTip("解码版本（推荐 v2）。")
+            self.num_circ.setToolTip("解码圆数（grid=2，hd=1）。")
+            self.real_ground.setToolTip("是否使用 real_ground。")
+            self.real_of.setToolTip("是否使用 real_of。")
+        else:
+            self.decode_version.setToolTip("Decode version (recommend v2).")
+            self.num_circ.setToolTip("Number of circles to decode (grid=2, hd=1).")
+            self.real_ground.setToolTip("Use real_ground if available.")
+            self.real_of.setToolTip("Use real_of if available.")

canns/pipeline/asa_gui/analysis_modes/fr_mode.py

@@ -79,3 +79,20 @@ class FRMode(AbstractAnalysisMode):
             self.time_end.setRange(0, total_steps)
             if self.time_end.value() == 0:
                 self.time_end.setValue(total_steps)
+
+    def apply_language(self, lang: str) -> None:
+        is_zh = str(lang).lower().startswith("zh")
+        if is_zh:
+            self.normalize.setToolTip("归一化方式；none 表示不归一化。")
+            self.mode.setToolTip("fr 需要预处理；spike 直接用事件。")
+            self.neuron_start.setToolTip("神经元起始索引。")
+            self.neuron_end.setToolTip("神经元结束索引（不包含）。")
+            self.time_start.setToolTip("时间起始索引。")
+            self.time_end.setToolTip("时间结束索引（不包含）。")
+        else:
+            self.normalize.setToolTip("Normalization method; none = no normalization.")
+            self.mode.setToolTip("fr requires preprocess; spike uses events directly.")
+            self.neuron_start.setToolTip("Start neuron index.")
+            self.neuron_end.setToolTip("End neuron index (exclusive).")
+            self.time_start.setToolTip("Start time index.")
+            self.time_end.setToolTip("End time index (exclusive).")

canns/pipeline/asa_gui/analysis_modes/frm_mode.py

@@ -86,6 +86,23 @@ class FRMMode(AbstractAnalysisMode):
             return
         self.neuron_id.setRange(0, max(0, neuron_count - 1))
 
+    def apply_language(self, lang: str) -> None:
+        is_zh = str(lang).lower().startswith("zh")
+        if is_zh:
+            self.neuron_id.setToolTip("要查看的神经元编号。")
+            self.bin_size.setToolTip("空间分箱大小。")
+            self.min_occupancy.setToolTip("最小占据数。")
+            self.smoothing.setToolTip("是否启用平滑。")
+            self.smooth_sigma.setToolTip("平滑强度（sigma）。")
+            self.mode.setToolTip("fr 需要预处理；spike 直接用事件。")
+        else:
+            self.neuron_id.setToolTip("Neuron index to inspect.")
+            self.bin_size.setToolTip("Spatial bin size.")
+            self.min_occupancy.setToolTip("Minimum occupancy.")
+            self.smoothing.setToolTip("Enable smoothing.")
+            self.smooth_sigma.setToolTip("Smoothing strength (sigma).")
+            self.mode.setToolTip("fr requires preprocess; spike uses events directly.")
+
     def _shift(self, delta: int) -> None:
         val = self.neuron_id.value() + int(delta)
         val = max(self.neuron_id.minimum(), min(self.neuron_id.maximum(), val))

canns/pipeline/asa_gui/analysis_modes/gridscore_mode.py

@@ -117,6 +117,29 @@ class GridScoreMode(AbstractAnalysisMode):
         if "neuron_id" in meta:
             self.neuron_id.setValue(int(meta["neuron_id"]))
 
+    def apply_language(self, lang: str) -> None:
+        is_zh = str(lang).lower().startswith("zh")
+        if is_zh:
+            self.neuron_start.setToolTip("神经元起始索引。")
+            self.neuron_end.setToolTip("神经元结束索引（不包含）。")
+            self.bins.setToolTip("空间分箱数。")
+            self.min_occupancy.setToolTip("最小占据数。")
+            self.smoothing.setToolTip("是否启用平滑（需 scipy）。")
+            self.sigma.setToolTip("平滑强度（sigma）。")
+            self.overlap.setToolTip("自相关重叠比例。")
+            self.mode.setToolTip("fr 需要预处理；spike 直接用事件。")
+            self.score_thr.setToolTip("可视化阈值（仅显示）。")
+        else:
+            self.neuron_start.setToolTip("Start neuron index.")
+            self.neuron_end.setToolTip("End neuron index (exclusive).")
+            self.bins.setToolTip("Spatial bin count.")
+            self.min_occupancy.setToolTip("Minimum occupancy.")
+            self.smoothing.setToolTip("Enable smoothing (requires scipy).")
+            self.sigma.setToolTip("Smoothing strength (sigma).")
+            self.overlap.setToolTip("Autocorrelation overlap ratio.")
+            self.mode.setToolTip("fr requires preprocess; spike uses events directly.")
+            self.score_thr.setToolTip("Visualization threshold only.")
+
 
 class GridScoreInspectMode(GridScoreMode):
     name = "gridscore_inspect"

canns/pipeline/asa_gui/analysis_modes/pathcompare_mode.py

@@ -10,6 +10,7 @@ from PySide6.QtWidgets import (
     QHBoxLayout,
     QLabel,
     QLineEdit,
+    QPushButton,
     QSpinBox,
     QWidget,
 )
@@ -49,7 +50,7 @@ class PathCompareMode(AbstractAnalysisMode):
         self.dim2.setValue(2)
 
         self.use_box = QCheckBox("Use coordsbox / times_box")
-        self.use_box.setChecked(False)
+        self.use_box.setChecked(True)
 
         self.interp_full = QCheckBox("Interpolate to full trajectory")
         self.interp_full.setChecked(True)
@@ -57,8 +58,13 @@ class PathCompareMode(AbstractAnalysisMode):
 
         self.coords_key = QLineEdit()
         self.coords_key.setPlaceholderText("coords / coordsbox (optional)")
+        self.btn_coordsbox = QPushButton("coordsbox")
+        self.btn_coordsbox.clicked.connect(lambda: self.coords_key.setText("coordsbox"))
+
         self.times_key = QLineEdit()
         self.times_key.setPlaceholderText("times_box (optional)")
+        self.btn_times_box = QPushButton("times_box")
+        self.btn_times_box.clicked.connect(lambda: self.times_key.setText("times_box"))
 
         self.slice_mode = PopupComboBox()
         self.slice_mode.addItem("Time (tmin/tmax)", userData="time")
@@ -125,8 +131,20 @@ class PathCompareMode(AbstractAnalysisMode):
         form.addRow(self._dims2d_label, dims_2d)
         form.addRow(self.use_box)
         form.addRow(self.interp_full)
-        form.addRow("coords key", self.coords_key)
-        form.addRow("times key", self.times_key)
+        coords_row = QWidget()
+        coords_layout = QHBoxLayout(coords_row)
+        coords_layout.setContentsMargins(0, 0, 0, 0)
+        coords_layout.addWidget(self.coords_key, 1)
+        coords_layout.addWidget(self.btn_coordsbox)
+
+        times_row = QWidget()
+        times_layout = QHBoxLayout(times_row)
+        times_layout.setContentsMargins(0, 0, 0, 0)
+        times_layout.addWidget(self.times_key, 1)
+        times_layout.addWidget(self.btn_times_box)
+
+        form.addRow("coords key", coords_row)
+        form.addRow("times key", times_row)
         form.addRow("Slice mode", self.slice_mode)
         form.addRow("tmin (sec, -1=auto)", self.tmin)
         form.addRow("tmax (sec, -1=auto)", self.tmax)
@@ -150,6 +168,10 @@ class PathCompareMode(AbstractAnalysisMode):
         def _refresh_enabled() -> None:
             use_box = bool(self.use_box.isChecked())
             self.interp_full.setEnabled(use_box)
+            self.coords_key.setEnabled(use_box)
+            self.times_key.setEnabled(use_box)
+            self.btn_coordsbox.setEnabled(use_box)
+            self.btn_times_box.setEnabled(use_box)
 
         def _refresh_slice_mode() -> None:
             is_time = self.slice_mode.currentData() == "time"
@@ -197,3 +219,50 @@ class PathCompareMode(AbstractAnalysisMode):
             "no_wrap": bool(self.no_wrap.isChecked()),
             "animation_format": "gif" if self.save_gif.isChecked() else "none",
         }
+
+    def apply_language(self, lang: str) -> None:
+        is_zh = str(lang).lower().startswith("zh")
+        if is_zh:
+            self.angle_scale.setToolTip("角度尺度：auto / rad / deg / unit。")
+            self.dim_mode.setToolTip("解码维度模式（1D/2D）。")
+            self.dim.setToolTip("1D 解码维度索引。")
+            self.dim1.setToolTip("2D 解码维度 1。")
+            self.dim2.setToolTip("2D 解码维度 2。")
+            self.use_box.setToolTip("使用 coordsbox / times_box 对齐（推荐速度过滤后开启）。")
+            self.interp_full.setToolTip("插值回完整轨迹。")
+            self.coords_key.setToolTip("可选：解码坐标键（默认 coords/coordsbox）。")
+            self.times_key.setToolTip("可选：times_box 键名。")
+            self.btn_coordsbox.setToolTip("填入 coordsbox。")
+            self.btn_times_box.setToolTip("填入 times_box。")
+            self.slice_mode.setToolTip("按时间或索引裁剪。")
+            self.tmin.setToolTip("起始时间（秒），-1 自动。")
+            self.tmax.setToolTip("结束时间（秒），-1 自动。")
+            self.imin.setToolTip("起始索引，-1 自动。")
+            self.imax.setToolTip("结束索引，-1 自动。")
+            self.stride.setToolTip("采样步长。")
+            self.tail.setToolTip("尾迹长度（帧）。")
+            self.fps.setToolTip("动画帧率。")
+            self.no_wrap.setToolTip("禁用角度环绕。")
+            self.save_gif.setToolTip("保存 GIF 动画。")
+        else:
+            self.angle_scale.setToolTip("Angle scale: auto / rad / deg / unit.")
+            self.dim_mode.setToolTip("Decode dimension mode (1D/2D).")
+            self.dim.setToolTip("1D decoded dimension index.")
+            self.dim1.setToolTip("2D decoded dimension 1.")
+            self.dim2.setToolTip("2D decoded dimension 2.")
+            self.use_box.setToolTip("Use coordsbox/times_box alignment (recommended with speed_filter).")
+            self.interp_full.setToolTip("Interpolate back to full trajectory.")
+            self.coords_key.setToolTip("Optional decode coords key (default coords/coordsbox).")
+            self.times_key.setToolTip("Optional times_box key.")
+            self.btn_coordsbox.setToolTip("Fill coordsbox.")
+            self.btn_times_box.setToolTip("Fill times_box.")
+            self.slice_mode.setToolTip("Slice by time or index.")
+            self.tmin.setToolTip("Start time (sec), -1 = auto.")
+            self.tmax.setToolTip("End time (sec), -1 = auto.")
+            self.imin.setToolTip("Start index, -1 = auto.")
+            self.imax.setToolTip("End index, -1 = auto.")
+            self.stride.setToolTip("Sampling stride.")
+            self.tail.setToolTip("Trail length (frames).")
+            self.fps.setToolTip("Animation FPS.")
+            self.no_wrap.setToolTip("Disable angle wrap.")
+            self.save_gif.setToolTip("Save GIF animation.")

canns/pipeline/asa_gui/analysis_modes/tda_mode.py

@@ -110,3 +110,30 @@ class TDAMode(AbstractAnalysisMode):
             self.maxdim.setValue(2)
         elif preset == "hd":
             self.maxdim.setValue(1)
+
+    def apply_language(self, lang: str) -> None:
+        is_zh = str(lang).lower().startswith("zh")
+        if is_zh:
+            self.dim.setToolTip("PCA 维度（常见起点 6–12）。")
+            self.num_times.setToolTip("时间下采样步长；越大越快但可能丢细节。")
+            self.active_times.setToolTip("选取最活跃时间点数；过小不稳，过大更慢。")
+            self.k.setToolTip("采样/去噪相关参数，影响速度与稳定性。")
+            self.n_points.setToolTip("点云代表点数量，越大越慢。")
+            self.metric.setToolTip("距离度量；推荐 cosine。")
+            self.nbs.setToolTip("邻域规模参数，影响稳定性与速度。")
+            self.maxdim.setToolTip("最大同调维度；先 1 再 2。")
+            self.coeff.setToolTip("有限域系数（默认 47）。")
+            self.do_shuffle.setToolTip("显著性检验；代价高，建议少量。")
+            self.num_shuffles.setToolTip("Shuffle 次数（越多越慢）。")
+        else:
+            self.dim.setToolTip("PCA dimension (typical 6–12).")
+            self.num_times.setToolTip("Time downsampling step; larger is faster but less detail.")
+            self.active_times.setToolTip("Number of most active points; too small is unstable.")
+            self.k.setToolTip("Sampling/denoising parameter; affects speed/stability.")
+            self.n_points.setToolTip("Number of representative points; larger is slower.")
+            self.metric.setToolTip("Distance metric; recommend cosine.")
+            self.nbs.setToolTip("Neighborhood parameter; affects stability and speed.")
+            self.maxdim.setToolTip("Max homology dimension; start with 1, then 2.")
+            self.coeff.setToolTip("Finite field coefficient (default 47).")
+            self.do_shuffle.setToolTip("Significance test; expensive, keep small.")
+            self.num_shuffles.setToolTip("Number of shuffles (more is slower).")

canns/pipeline/asa_gui/resources/dark.qss

@@ -14,6 +14,14 @@ QLabel#muted {
     color: #9ca3af;
 }
 
+QToolTip {
+    color: #e5e7eb;
+    background-color: #111827;
+    border: 1px solid #4b5563;
+    border-radius: 4px;
+    padding: 4px 8px;
+}
+
 QFrame#card, QGroupBox#card {
     background-color: #1f2937;
     border: 1px solid #374151;

canns/pipeline/asa_gui/resources/light.qss

@@ -14,6 +14,14 @@ QLabel#muted {
     color: #6b7280;
 }
 
+QToolTip {
+    color: #111827;
+    background-color: #fef3c7;
+    border: 1px solid #f59e0b;
+    border-radius: 4px;
+    padding: 4px 8px;
+}
+
 QFrame#card, QGroupBox#card {
     background-color: #ffffff;
     border: 1px solid #e5e7eb;

canns/pipeline/asa_gui/views/pages/analysis_page.py

@@ -206,6 +206,9 @@ class AnalysisPage(QWidget):
         self.run_btn.setText("运行分析" if is_zh else "Run Analysis")
         self.stop_btn.setText("停止" if is_zh else "Stop")
         self.logs_label.setText("日志" if is_zh else "Logs")
+        self.analysis_mode.setToolTip(
+            "选择分析模块" if is_zh else "Select an analysis mode to run."
+        )
 
         if self._last_state is not None:
             self._update_info(self._last_state)
@@ -216,6 +219,10 @@ class AnalysisPage(QWidget):
                 else "Mode=— | preset=— | preprocess=— | spike_main_shape=—"
             )
 
+        for mode in self._modes.values():
+            if hasattr(mode, "apply_language"):
+                mode.apply_language(self._lang)
+
     def load_state(self, state) -> None:
         self._last_state = state
         self._update_info(state)

canns/pipeline/asa_gui/views/pages/preprocess_page.py

@@ -4,6 +4,8 @@ from __future__ import annotations
 
 from pathlib import Path
 
+import numpy as np
+
 from PySide6.QtCore import QSettings, Qt, Signal
 from PySide6.QtGui import QColor
 from PySide6.QtWidgets import (
@@ -15,6 +17,7 @@ from PySide6.QtWidgets import (
     QGroupBox,
     QHBoxLayout,
     QLabel,
+    QLineEdit,
     QProgressBar,
     QPushButton,
     QSpinBox,
@@ -86,6 +89,12 @@ class PreprocessPage(QWidget):
         self.preset.addItems(["grid", "hd", "none"])
         self.preset.setToolTip("Preset hints apply to analysis mode defaults.")
 
+        self.input_source = PopupComboBox()
+        self.input_source.addItem("Local file", userData="local")
+        self.input_source.addItem("CANNs dataset", userData="dataset")
+        self.input_source.addItem("URL", userData="url")
+        self.input_source.currentIndexChanged.connect(self._toggle_input_source)
+
         self.label_mode = QLabel("Mode")
         top_row.addWidget(self.label_mode)
         top_row.addWidget(self.input_mode)
@@ -93,6 +102,10 @@ class PreprocessPage(QWidget):
         self.label_preset = QLabel("Preset")
         top_row.addWidget(self.label_preset)
         top_row.addWidget(self.preset)
+        top_row.addSpacing(16)
+        self.label_source = QLabel("Source")
+        top_row.addWidget(self.label_source)
+        top_row.addWidget(self.input_source)
         top_row.addStretch(1)
         input_layout.addLayout(top_row)
 
@@ -126,6 +139,46 @@ class PreprocessPage(QWidget):
         input_layout.addLayout(neuron_row)
         input_layout.addLayout(traj_row)
 
+        self.dataset_group = QGroupBox("Dataset")
+        self.dataset_group.setObjectName("card")
+        dataset_form = QFormLayout(self.dataset_group)
+
+        self.dataset_key = PopupComboBox()
+        self.dataset_key.addItem("grid_1", userData="grid_1")
+        self.dataset_key.addItem("grid_2", userData="grid_2")
+        self.dataset_key.addItem("roi_data", userData="roi_data")
+        self.dataset_key.addItem("left_right_data_of", userData="left_right_data_of")
+        self.dataset_key.currentIndexChanged.connect(self._update_dataset_hint)
+
+        self.dataset_session = QLineEdit()
+        self.dataset_session.setPlaceholderText("e.g. 26034_3")
+
+        self.dataset_filename = QLineEdit()
+        self.dataset_filename.setPlaceholderText("e.g. 26034_3_ASA_full.npz")
+
+        self.dataset_url = QLineEdit()
+        self.dataset_url.setPlaceholderText("https://.../data.npz")
+
+        self.dataset_hint = QLabel("")
+        self.dataset_hint.setObjectName("muted")
+        self.dataset_hint.setWordWrap(True)
+
+        dataset_form.addRow("Dataset", self.dataset_key)
+        self.label_dataset = dataset_form.labelForField(self.dataset_key)
+        dataset_form.addRow("Session id", self.dataset_session)
+        self.label_session = dataset_form.labelForField(self.dataset_session)
+        dataset_form.addRow("Filename", self.dataset_filename)
+        self.label_filename = dataset_form.labelForField(self.dataset_filename)
+        url_row = QWidget()
+        url_layout = QHBoxLayout(url_row)
+        url_layout.setContentsMargins(0, 0, 0, 0)
+        url_layout.addWidget(self.dataset_url, 1)
+        dataset_form.addRow("URL", url_row)
+        self.label_url = dataset_form.labelForField(self.dataset_url)
+        dataset_form.addRow(self.dataset_hint)
+
+        input_layout.addWidget(self.dataset_group)
+
         top_layout.addWidget(input_group)
 
         # Preprocess group
@@ -244,6 +297,8 @@ class PreprocessPage(QWidget):
         self.asa_browse.clicked.connect(self._update_run_enabled)
 
         self._toggle_input_mode()
+        self._toggle_input_source()
+        self._update_dataset_hint()
         self._toggle_embed_params()
         self._update_run_enabled()
         self._apply_card_effects([input_group, preprocess_group, preclass_group])
@@ -270,6 +325,7 @@ class PreprocessPage(QWidget):
 
         self.label_mode.setText("模式" if is_zh else "Mode")
         self.label_preset.setText("预设" if is_zh else "Preset")
+        self.label_source.setText("来源" if is_zh else "Source")
         if self.label_method is not None:
             self.label_method.setText("方法" if is_zh else "Method")
         if self.label_preclass is not None:
@@ -317,6 +373,72 @@ class PreprocessPage(QWidget):
         self.stop_btn.setText("停止" if is_zh else "Stop")
         self.logs_label.setText("日志" if is_zh else "Logs")
 
+        self.dataset_group.setTitle("数据集" if is_zh else "Dataset")
+        if self.label_dataset is not None:
+            self.label_dataset.setText("数据集" if is_zh else "Dataset")
+        if self.label_session is not None:
+            self.label_session.setText("Session id" if not is_zh else "会话 id")
+        if self.label_filename is not None:
+            self.label_filename.setText("Filename" if not is_zh else "文件名")
+        if self.label_url is not None:
+            self.label_url.setText("URL")
+
+        self.input_source.setToolTip(
+            "选择本地文件、内置数据集或 URL"
+            if is_zh
+            else "Choose local file, built-in dataset, or URL."
+        )
+        self.dataset_key.setToolTip(
+            "选择内置数据集" if is_zh else "Select a built-in dataset."
+        )
+        self.dataset_session.setToolTip(
+            "Left-Right 数据集的会话 id。" if is_zh else "Session id for Left-Right dataset."
+        )
+        self.dataset_filename.setToolTip(
+            "Left-Right 数据集文件名。" if is_zh else "Filename within Left-Right dataset."
+        )
+        self.dataset_url.setToolTip(
+            "直接加载 .npz 链接。" if is_zh else "Load a .npz URL directly."
+        )
+
+        self.input_mode.setToolTip(
+            "仅支持 ASA .npz 输入" if is_zh else "Only ASA .npz input is supported in this GUI."
+        )
+        self.preprocess_method.setToolTip(
+            "嵌入会生成稠密矩阵供 TDA/FR 使用"
+            if is_zh
+            else "Embedding builds a dense spike matrix for TDA/FR."
+        )
+        self.embed_res.setToolTip(
+            "时间分箱分辨率（与 t 单位一致）。" if is_zh else "Time bin resolution (same unit as t)."
+        )
+        self.embed_dt.setToolTip(
+            "时间步长（与 t 单位一致）。" if is_zh else "Time step (same unit as t)."
+        )
+        self.embed_sigma.setToolTip(
+            "高斯平滑尺度，越大越平滑。" if is_zh else "Gaussian smoothing scale."
+        )
+        self.embed_smooth.setToolTip("是否启用平滑。" if is_zh else "Enable smoothing.")
+        self.embed_speed_filter.setToolTip(
+            "过滤低速时间点（常见于 grid 数据）。"
+            if is_zh
+            else "Remove low-speed samples (common for grid data)."
+        )
+        self.embed_min_speed.setToolTip(
+            "速度阈值（与 t/x/y 单位一致）。"
+            if is_zh
+            else "Speed threshold (same unit as t/x/y)."
+        )
+
+        self.dataset_session.setPlaceholderText("例如 26034_3" if is_zh else "e.g. 26034_3")
+        self.dataset_filename.setPlaceholderText(
+            "例如 26034_3_ASA_full.npz" if is_zh else "e.g. 26034_3_ASA_full.npz"
+        )
+        self.dataset_url.setPlaceholderText(
+            "https://.../data.npz" if not is_zh else "https://.../data.npz"
+        )
+        self._update_dataset_hint()
+
     def _show_help(self) -> None:
         lang = str(QSettings("canns", "asa_gui").value("lang", "en"))
         title = (
@@ -357,6 +479,63 @@ class PreprocessPage(QWidget):
         self.traj_zone.setVisible(not use_asa)
         self.traj_browse.setVisible(not use_asa)
 
+    def _toggle_input_source(self) -> None:
+        source = self.input_source.currentData() or "local"
+        use_local = source == "local"
+        self.asa_zone.setVisible(use_local)
+        self.asa_browse.setVisible(use_local)
+        self.asa_hint.setVisible(use_local)
+        self.dataset_group.setVisible(not use_local)
+        self._update_dataset_hint()
+        self._update_run_enabled()
+
+    def _update_dataset_hint(self) -> None:
+        source = self.input_source.currentData() or "local"
+        key = self.dataset_key.currentData() or self.dataset_key.currentText()
+        is_left_right = key == "left_right_data_of"
+        is_zh = str(self._lang).lower().startswith("zh")
+        show_dataset = source == "dataset"
+        if self.label_session is not None:
+            self.label_session.setVisible(is_left_right and show_dataset)
+        self.dataset_session.setVisible(is_left_right and show_dataset)
+        if self.label_filename is not None:
+            self.label_filename.setVisible(is_left_right and show_dataset)
+        self.dataset_filename.setVisible(is_left_right and show_dataset)
+        if self.label_dataset is not None:
+            self.label_dataset.setVisible(show_dataset)
+        self.dataset_key.setVisible(show_dataset)
+        if self.label_url is not None:
+            self.label_url.setVisible(source == "url")
+        self.dataset_url.setVisible(source == "url")
+
+        hint = ""
+        if source == "url":
+            hint = (
+                "加载包含 spike/x/y/t 的 .npz 链接。"
+                if is_zh
+                else "Load a .npz URL that contains spike/x/y/t."
+            )
+        elif source == "dataset":
+            try:
+                from canns.data import datasets as _datasets
+
+                info = _datasets.DATASETS.get(str(key))
+                if info:
+                    size = info.get("size_mb", "?")
+                    desc = info.get("description", "")
+                    hint = f"{desc} (size ~{size} MB)" if not is_zh else f"{desc} (约 {size} MB)"
+            except Exception:
+                hint = ""
+            if is_left_right:
+                hint = (
+                    (hint + "\n") if hint else ""
+                ) + (
+                    "左/右数据集需要 session id 和文件名。"
+                    if is_zh
+                    else "Left-right dataset requires session id + filename."
+                )
+        self.dataset_hint.setText(hint)
+
     def _toggle_embed_params(self) -> None:
         method = self.preprocess_method.currentData() or "none"
         self.embed_params.setVisible(method == "embed_spike_trains")
@@ -391,6 +570,96 @@ class PreprocessPage(QWidget):
             }
         return params
 
+    def _slugify(self, text: str) -> str:
+        out = []
+        for ch in text:
+            if ch.isalnum() or ch in ("-", "_"):
+                out.append(ch)
+            else:
+                out.append("_")
+        return "".join(out).strip("_") or "dataset"
+
+    def _normalize_npz_payload(self, data: dict) -> dict:
+        payload: dict = {}
+        for key, value in data.items():
+            if isinstance(value, dict):
+                payload[key] = np.array(value, dtype=object)
+            else:
+                payload[key] = value
+        return payload
+
+    def _prepare_dataset_asa(self) -> str | None:
+        source = self.input_source.currentData() or "local"
+        if source == "local":
+            return self.asa_zone.path()
+
+        data = None
+        label = ""
+        if source == "url":
+            url = self.dataset_url.text().strip()
+            if not url:
+                self.log_box.log("Please provide a dataset URL.")
+                return None
+            label = self._slugify(Path(url).stem or "dataset_url")
+            try:
+                from canns.data import datasets as _datasets
+
+                data = _datasets.load(url, file_type="numpy")
+            except Exception as exc:
+                self.log_box.log(f"Failed to load URL dataset: {exc}")
+                return None
+        elif source == "dataset":
+            key = self.dataset_key.currentData() or self.dataset_key.currentText()
+            label = self._slugify(str(key))
+            try:
+                from canns.data import loaders as _loaders
+                from canns.data import datasets as _datasets
+
+                if key == "roi_data":
+                    data = _loaders.load_roi_data()
+                elif key == "left_right_data_of":
+                    session_id = self.dataset_session.text().strip()
+                    filename = self.dataset_filename.text().strip()
+                    if not session_id or not filename:
+                        self.log_box.log("Left-Right dataset requires session id + filename.")
+                        return None
+                    data = _loaders.load_left_right_npz(session_id=session_id, filename=filename)
+                    label = self._slugify(f"{session_id}_{filename}")
+                elif str(key).startswith("grid_"):
+                    data = _loaders.load_grid_data(dataset_key=str(key))
+                else:
+                    path = _datasets.download_dataset(str(key))
+                    if path is not None and path.exists():
+                        data = dict(np.load(path, allow_pickle=True))
+            except Exception as exc:
+                self.log_box.log(f"Failed to load dataset '{key}': {exc}")
+                return None
+
+        if data is None:
+            self.log_box.log("Dataset load failed or returned empty data.")
+            return None
+
+        if not isinstance(data, dict):
+            self.log_box.log("Dataset is not an ASA .npz dict (missing spike/x/y/t).")
+            return None
+
+        payload = self._normalize_npz_payload(data)
+        if "spike" not in payload or "t" not in payload:
+            self.log_box.log("Dataset does not contain required keys: spike, t.")
+            return None
+
+        out_dir = Path.cwd() / "Results" / "asa_gui_datasets"
+        out_dir.mkdir(parents=True, exist_ok=True)
+        out_path = out_dir / f"{label}.npz"
+        try:
+            np.savez_compressed(out_path, **payload)
+        except Exception as exc:
+            self.log_box.log(f"Failed to save dataset as npz: {exc}")
+            return None
+
+        self.asa_zone.set_path(str(out_path))
+        return str(out_path)
+
     def _run_preprocess(self) -> None:
         if self._workers.is_running():
             self.log_box.log("A task is already running.")
@@ -404,6 +673,9 @@ class PreprocessPage(QWidget):
         neuron_file = self.neuron_zone.path() if input_mode != "asa" else None
         traj_file = self.traj_zone.path() if input_mode != "asa" else None
 
+        if input_mode == "asa":
+            asa_file = self._prepare_dataset_asa()
+
         if not self._validate_inputs(asa_file):
             return
 
@@ -480,13 +752,17 @@ class PreprocessPage(QWidget):
         return True
 
     def _update_run_enabled(self) -> None:
+        source = self.input_source.currentData() or "local"
         asa_file = self.asa_zone.path()
         valid = False
-        if asa_file:
+        if source == "local" and asa_file:
             path = Path(asa_file)
             valid = path.exists() and path.suffix.lower() == ".npz"
         self.run_btn.setEnabled(True)
-        if valid:
-            self.run_btn.setToolTip("")
+        if source == "local":
+            if valid:
+                self.run_btn.setToolTip("")
+            else:
+                self.run_btn.setToolTip("Select a valid ASA .npz file to run preprocessing.")
         else:
-            self.run_btn.setToolTip("Select a valid ASA .npz file to run preprocessing.")
+            self.run_btn.setToolTip("Dataset/URL will be loaded on Run.")

{canns-0.14.1.dist-info → canns-0.14.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: canns
-Version: 0.14.1
+Version: 0.14.3
 Summary: A Python Library for Continuous Attractor Neural Networks
 Project-URL: Repository, https://github.com/routhleck/canns
 Author-email: Sichao He <sichaohe@outlook.com>
@@ -44,6 +44,7 @@ Requires-Dist: imageio; extra == 'gui'
 Requires-Dist: pillow; extra == 'gui'
 Requires-Dist: pyside6>=6.6.0; extra == 'gui'
 Requires-Dist: qtawesome; extra == 'gui'
+Requires-Dist: requests>=2.31.0; extra == 'gui'
 Provides-Extra: tpu
 Requires-Dist: brainpy[tpu]; (platform_system == 'Linux') and extra == 'tpu'
 Description-Content-Type: text/markdown

{canns-0.14.1.dist-info → canns-0.14.3.dist-info}/RECORD

@@ -86,16 +86,16 @@ canns/pipeline/asa_gui/__main__.py,sha256=2UOQtIE5oXkcq9HcuY13M3Jk6-uaDu8A0VJfvr
 canns/pipeline/asa_gui/app.py,sha256=Wd-tVGNPE1mQ0S9bET-cyjfj5UWsTIFFHOQRu0lngBs,833
 canns/pipeline/asa_gui/main_window.py,sha256=kQp8DTmp7SuYVCglh5lVja7DyQ7hAOxPgCEUmjKHgbk,7019
 canns/pipeline/asa_gui/analysis_modes/__init__.py,sha256=m5tra-3lOcKi09HV3WxvTnDuF5lgV92C_fHH_4V87zw,990
-canns/pipeline/asa_gui/analysis_modes/base.py,sha256=-xuzrr5-XItZldl7DUYfeLLvvXi-i7wpzk1IkTaPAzQ,1220
+canns/pipeline/asa_gui/analysis_modes/base.py,sha256=SqZhsD6umV0ecHGca5FcCx7G2eeskE8HZToRBc3Y5AA,1335
 canns/pipeline/asa_gui/analysis_modes/batch_mode.py,sha256=sua3cD6G4vTGT7fUSrdvYNwldA3KZ1O4MCCsSOX4knc,531
-canns/pipeline/asa_gui/analysis_modes/cohomap_mode.py,sha256=RCZv2TZ7_BmaQZFFradsLlumB7MgfiMENxWjxGFZB8Q,1748
-canns/pipeline/asa_gui/analysis_modes/cohospace_mode.py,sha256=HBb7nrdfKz8hY5QkY8YhKVWxtvRyyneFo6fN7dumVSw,7115
-canns/pipeline/asa_gui/analysis_modes/decode_mode.py,sha256=wPuuoXA2eQt_tv4Nh57cBNvzrW87cqRlKS6ckVgt280,1586
-canns/pipeline/asa_gui/analysis_modes/fr_mode.py,sha256=mS6FpLBwJB-ugYKgPBsVP6X4cKMlw6S0gsT5Q8qTNls,2928
-canns/pipeline/asa_gui/analysis_modes/frm_mode.py,sha256=OYl0CkUjqy2azu_T7mFWJ58lSTaFCsFFfBhmg1nRebE,3038
-canns/pipeline/asa_gui/analysis_modes/gridscore_mode.py,sha256=xcq-HLJxqYFu5Nck9cLN6Rp2g8eUDjSGI8_3AkEXNYg,4321
-canns/pipeline/asa_gui/analysis_modes/pathcompare_mode.py,sha256=5aZpClyO813tXQsbUuBchR2uNHyjQXQeNEINNaZyfrM,6877
-canns/pipeline/asa_gui/analysis_modes/tda_mode.py,sha256=jNlRwpzsYIKUKFqRyjDVChoJib7h_5iz2te-mK7Qf1I,4119
+canns/pipeline/asa_gui/analysis_modes/cohomap_mode.py,sha256=kIB9zzh_hmhxSXFrv8FLabFLkOp_FhBOs1t_2gPass4,2360
+canns/pipeline/asa_gui/analysis_modes/cohospace_mode.py,sha256=yfLpw0-Q9oMiCIJg-ca_v93__OgXfrGeEFd9DsOc0a4,9368
+canns/pipeline/asa_gui/analysis_modes/decode_mode.py,sha256=uEe3lfWAA0pqmCXzNpaA3A1nrDedTN43_f1R_ssg_A8,2304
+canns/pipeline/asa_gui/analysis_modes/fr_mode.py,sha256=xzx1RhGVDbx6huEtEHGfUqWgRN_C6Sf-Ycj9BzIgTRY,3961
+canns/pipeline/asa_gui/analysis_modes/frm_mode.py,sha256=8rgh_P7dxYJfx2TxrhD00Ja6tK0q6NboqwZ7n0Sw_2U,3992
+canns/pipeline/asa_gui/analysis_modes/gridscore_mode.py,sha256=XC-O2lMx3NPxUkSoZo_69g7B_yFAYUnKIPKLj9-gKM4,5712
+canns/pipeline/asa_gui/analysis_modes/pathcompare_mode.py,sha256=oRZPB8y7ORDFDPk99joRNQRj_e5qmR-GuJHrGnSynS4,10808
+canns/pipeline/asa_gui/analysis_modes/tda_mode.py,sha256=xnsWv_zfstzYPf_nLbQkCNHxxhYRznz4m-73ClaBQKs,6094
 canns/pipeline/asa_gui/controllers/__init__.py,sha256=RuQz960T4kEuQsBI_cjS0cQgFyqAdblLXy_dDoLPbTE,198
 canns/pipeline/asa_gui/controllers/analysis_controller.py,sha256=8cKs-RYHh_NflP7xeS0u0_y9WsZ268H1Wyp-wHZC97I,1769
 canns/pipeline/asa_gui/controllers/preprocess_controller.py,sha256=uNZifNGadYPxAVyWnfonOs5pwCgxwB1nrBGqvv8Y3hU,2825
@@ -109,8 +109,8 @@ canns/pipeline/asa_gui/models/config.py,sha256=oDAeNlReKJEITc8B5AT9xxQl3Ug1yaGs6
 canns/pipeline/asa_gui/models/job.py,sha256=_HdhJIzdH9OSKrRpcl3WCS4O04Bvur5uT9yb9oOWBuE,852
 canns/pipeline/asa_gui/models/presets.py,sha256=zEtR1_35ovSuGa3xMOvZoVDJJUK0rSi8OOlfkQWFvFE,519
 canns/pipeline/asa_gui/resources/__init__.py,sha256=xaC4dS2THCTTKOF6MDHMOGGPni9Nnjmeqj7fCaoxzwI,575
-canns/pipeline/asa_gui/resources/dark.qss,sha256=s9Uhyod7aLwIC5QqYOVIKN7NofcXbV1ESZk-j98YMY4,2990
-canns/pipeline/asa_gui/resources/light.qss,sha256=B8rU85VrYMKf8QasvRiR-tCypov7pzIOFr7lcL81mcw,2883
+canns/pipeline/asa_gui/resources/dark.qss,sha256=xqlPIFtnKKfBJbcL-kZ-qwFKTl9ADEU2mN7PDJiT7SE,3132
+canns/pipeline/asa_gui/resources/light.qss,sha256=PuFpiWoU3qfGczTWlSjkHGDpMr3Jh0x6SZ0hdCvg_b4,3025
 canns/pipeline/asa_gui/resources/logo.ico,sha256=V54_QvIzs6TK1K28zX915taioAM1gPESAKRCRPAjR4U,125806
 canns/pipeline/asa_gui/resources/logo.svg,sha256=UQqbGRtnROO2BdN3XMkovdBqWew69Z9Sr7SUof2_n3o,48323
 canns/pipeline/asa_gui/resources/styles.qss,sha256=MaWWGn3f9yvOYpgdgy8VyITWk5vGGPut2H_rnQM4-EU,2188
@@ -121,8 +121,8 @@ canns/pipeline/asa_gui/utils/validators.py,sha256=x5Tw2Pk434vlfQKBYgUOJPL6MLw0Oh
 canns/pipeline/asa_gui/views/__init__.py,sha256=ThoLlMw7bKxA7lkv_AvIR1mbpaoM0vkIxVP1p7mlzQM,28
 canns/pipeline/asa_gui/views/help_content.py,sha256=kL7MSwc9v3gHLz86Apiy64xbwymt9r7sPEjz5ka6EB0,8452
 canns/pipeline/asa_gui/views/pages/__init__.py,sha256=xB7VTY_hKfoCNMGeWZbV3gHG9ErrzmwqW30UlUkbqgE,161
-canns/pipeline/asa_gui/views/pages/analysis_page.py,sha256=CNt-ZXaWuHa1gOkTgBpZYYsrklW0L8WS74PL_9NnlZ4,22538
-canns/pipeline/asa_gui/views/pages/preprocess_page.py,sha256=N7IwQCNtqd30cV81S2AgejWJKIJ2aD9IVHVWSFa26dA,19472
+canns/pipeline/asa_gui/views/pages/analysis_page.py,sha256=X6PGW_cgvAiNFqUpsS2TuVWl258Q6Q90C9NEQT1TetQ,22807
+canns/pipeline/asa_gui/views/pages/preprocess_page.py,sha256=AHWidQqNKF0TBx8i2dDmPfxjT4Qy45_FjBYh-O1zB8E,31364
 canns/pipeline/asa_gui/views/panels/__init__.py,sha256=Spqmc0Sjh38cgr42gszmiogZQFFOLN1yL7ekSpVJCrE,36
 canns/pipeline/asa_gui/views/widgets/__init__.py,sha256=xaTYXw99OL8ye1cpfoKgSwqC7c2B6lrLLsYHRB16m64,481
 canns/pipeline/asa_gui/views/widgets/artifacts_tab.py,sha256=U_fuOCfSmkDhx3G97aod-8UPSIFVz_MrsU4b_ik_5qE,1431
@@ -158,8 +158,8 @@ canns/trainer/utils.py,sha256=ZdoLiRqFLfKXsWi0KX3wGUp0OqFikwiou8dPf3xvFhE,2847
 canns/typing/__init__.py,sha256=mXySdfmD8fA56WqZTb1Nj-ZovcejwLzNjuk6PRfTwmA,156
 canns/utils/__init__.py,sha256=OMyZ5jqZAIUS2Jr0qcnvvrx6YM-BZ1EJy5uZYeA3HC0,366
 canns/utils/benchmark.py,sha256=oJ7nvbvnQMh4_MZh7z160NPLp-197X0rEnmnLHYlev4,1361
-canns-0.14.1.dist-info/METADATA,sha256=CQzDKQODTTCPR2zdw9q6mEzfhGdvuA8xOhIg0maVhTc,9751
-canns-0.14.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-canns-0.14.1.dist-info/entry_points.txt,sha256=57YF2HZp_BG3GeGB8L0m3wR1sSfNyMXF1q4CKEjce6U,164
-canns-0.14.1.dist-info/licenses/LICENSE,sha256=u6NJ1N-QSnf5yTwSk5UvFAdU2yKD0jxG0Xa91n1cPO4,11306
-canns-0.14.1.dist-info/RECORD,,
+canns-0.14.3.dist-info/METADATA,sha256=UMyUaYFYtHoS60udBftAohcR0mIxJygdyUXyVdxfK18,9799
+canns-0.14.3.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+canns-0.14.3.dist-info/entry_points.txt,sha256=57YF2HZp_BG3GeGB8L0m3wR1sSfNyMXF1q4CKEjce6U,164
+canns-0.14.3.dist-info/licenses/LICENSE,sha256=u6NJ1N-QSnf5yTwSk5UvFAdU2yKD0jxG0Xa91n1cPO4,11306
+canns-0.14.3.dist-info/RECORD,,