Token导航 LogoToken导航

Agent Skill · 研究检索

neural-population-analysis-guide(神经群体分析指南)

neural-population-analysis-guide 用于查找、检索和筛选相关信息,适合在 Codex、Claude、Cursor、Gemini CLI 中需要根据关键词、任务场景或来源线索快速定位候选结果时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态,以及是否会触发联网、命令执行或文件读写。

neural-population-analysis-guide 是研究检索类 Agent Skill,可用宿主为 Codex、Claude、Cursor、Gemini CLI,通过GitHub 仓库获取,权限为只读;许可证信息还不明确,第三方扫描已通过,按安装量在研究检索类的 73,675 个 Skill 里排第 26,905。

总安装 3,482周安装 107GitHub Stars 18下载 1,329核验 2026-05-01

安装说明

本站只整理中文说明,不托管安装包,也不代用户安装。
GitHub
许可证
unknown

安装方式

通过对话安装

复制提示词发给支持本地命令或 Skills 的 AI 助手,先确认命令和权限,再让它执行。

请帮我安装这个 Agent Skill:neural-population-analysis-guide(神经群体分析指南)
来源仓库:https://github.com/haoxuanlithuai/awesome_cognitive_and_neuroscience_skills
仓库路径:skills/neural-population-analysis-guide
安装命令:
npx skills add https://github.com/haoxuanlithuai/awesome_cognitive_and_neuroscience_skills --skill 'Neural Population Analysis Guide'
安装前请先检查当前环境是否支持对应 CLI,并向我确认将要执行的命令、安装目录、联网范围和文件读写权限;确认后再执行。

命令行安装

复制命令到本机终端执行。该命令会通过 npx skills 从第三方来源获取 Skill;本站只展示命令,不托管安装包,也不自动执行。

skills.shnpx skills
npx skills add https://github.com/haoxuanlithuai/awesome_cognitive_and_neuroscience_skills --skill 'Neural Population Analysis Guide'

这个 Skill 是做什么的

研究检索类 Skill 主要解决「找资料、核对事实、把来源整理清楚」的问题,通常会让助手先检索再总结。

指导大规模神经元群体数据的整理与分析流程设计。涵盖实验范式制定、信号预处理与统计建模方法选择。推荐开源工具链如 BIDS 标准与 MNE-Python 库用法。具体实施需遵循伦理审查要求,保护受试者隐私信息。

neural-population-analysis-guide 属于研究检索类 Skill,可作为该场景下的辅助能力补充。

来源仓库内路径:skills/neural-population-analysis-guide

上手步骤

4 步
  1. 1

    确认自己的宿主工具

    公开资料标注支持 Codex、Claude、Cursor、Gemini CLI;先确认自己用的是其中之一,再按对应工具的 Skills 目录放置。

  2. 2

    拿到安装命令

    可以直接复制的命令是 npx skills add https://github.com/haoxuanlithuai/awesome_cognitive_and_neuroscie…;命令里的占位符换成自己的路径或密钥再执行。

  3. 3

    安装后重启宿主

    命令执行完要完全退出宿主工具再打开,让新装的 Skill 被重新扫描到,否则列表里可能看不到。

  4. 4

    按最小权限试用

    它标注为只读,先用只读任务试一次,确认行为符合预期再扩大使用范围。

常见问题

6 条

neural-population-analysis-guide 怎么安装?

在终端执行 npx skills add https://github.com/haoxuanlithuai/awesome_cognitive_and_neuroscience_skills…。装完完全退出宿主工具再打开,让它重新扫描本地 Skill。

neural-population-analysis-guide 支持哪些 AI 工具?

公开资料标注支持 Codex、Claude、Cursor、Gemini CLI。其他工具只要能读取本地 Skill 目录,一般也能手动放进去,但要自己确认触发方式是否一致。

neural-population-analysis-guide 需要什么权限?

权限级别是只读。该 Skill 主要提供规则、说明或参考内容,本身偏只读;真正读写文件、联网或执行命令仍取决于宿主 Agent 的任务。

neural-population-analysis-guide 是免费的吗?

公开资料没有标注明确许可证,收费和商用限制都无法确认。正式使用前请到来源仓库核对授权说明。

neural-population-analysis-guide 用的人多吗?

公开数据是累计安装 3,482 次,近一周安装 107 次,下载 1,329 次,GitHub 18 星。这些数字来自第三方目录统计,只能当作热度参考,不代表质量或安全性。

neural-population-analysis-guide 安全吗?

第三方扫描结果为通过,但这只覆盖已知的静态检查项,不能替代自己读一遍源码和安装命令。

值得选的地方和要先想清楚的地方

值得选的地方

  • 同时适配 4 种工具,换客户端不用重新找替代品。
  • 第三方扫描已通过,常见的高风险行为没有命中。
  • 标注为只读权限,试用阶段不容易误改本地文件。

先想清楚的地方

  • 许可证没有明确标注,能不能商用、能不能再分发都不确定。
  • 第三方目录整理,版本更新和行为细节以来源仓库为准。

适不适合你

更适合

  • 已经在用 Codex,想直接扩展它能力的人。
  • 需要处理研究检索类任务、又不想每次都手写提示词的人。
  • 只想先试试效果、不希望它改动本地文件的人。

不太适合

  • 需要明确授权才能用到公司项目里的场景。
  • 需要厂商级技术支持和 SLA 的生产系统。

研究检索类 Skill 对比

6 个同类
Skill总安装GitHub 星权限许可证扫描
find-skills

寻找技能 · Codex、Claude

31,199,81316,486操作浏览器MIT有提醒
self-improving-agent

自我改进 Agent · OpenClaw

16,464,0023,396接触敏感数据MIT-0通过
soultrace

灵魂追踪 · Codex、Claude

7,588,94412需要联网未明确有提醒
self-improving

自我完善 · OpenClaw

6,829,2841,046需要联网MIT-0通过
microsoft-foundry

微软代工厂 · Codex、Claude

6,614,144764调用外部服务未明确有提醒
neural-population-analysis-guide

神经群体分析指南 · 本页

3,48218只读未明确通过

按安装量取同分类前几名;数字来自第三方目录统计,只作热度参考,不代表质量结论。

SKILL.md 原文

Neural Population Analysis Guide

Purpose

This skill encodes expert methodological knowledge for dimensionality reduction and latent-variable analysis of neural population recordings. A competent programmer without computational neuroscience training will get this wrong because:

  • Not all dimensionality reduction is the same. PCA, Factor Analysis, GPFA, and dPCA answer fundamentally different questions about neural data. PCA finds axes of maximum variance; dPCA demixes variance by task parameter; GPFA extracts smooth single-trial trajectories. Choosing the wrong method answers the wrong question (Cunningham & Yu, 2014).
  • Standard data science preprocessing destroys neural signal. Naive z-scoring or standard scaling of neural firing rates removes important information about rate differences across neurons. Soft normalization is required (Churchland et al., 2012).
  • Visualization methods are not analysis methods. t-SNE and UMAP produce visually compelling low-dimensional embeddings but their distances are not interpretable, axes are not meaningful, and results are sensitive to hyperparameters. They must never be used for quantitative inference (Cunningham & Yu, 2014).
  • Dimensionality is not determined by "percent variance explained." There is no universal threshold (e.g., 90%) for choosing the number of PCs. Parallel analysis or cross-validation is required to determine true dimensionality (Humphries, 2021).

When to Use This Skill

  • Analyzing simultaneously recorded neural populations (multi-electrode arrays, Neuropixels, calcium imaging)
  • Choosing between PCA, Factor Analysis, GPFA, dPCA, jPCA, or nonlinear methods
  • Extracting low-dimensional neural trajectories from spike trains
  • Demixing neural variance by task parameters (stimulus, decision, time)
  • Setting up population decoding analyses with temporal generalization
  • Determining data requirements (neuron counts, trial counts) for population analyses

Do NOT use this skill for:

  • Single-neuron tuning curve analysis (this is a different analytical framework)
  • Spike sorting or preprocessing of raw electrophysiology (upstream of this skill)
  • fMRI multivariate pattern analysis (see neural-decoding-analysis skill instead)

Research Planning Protocol

Before executing the domain-specific steps below, you MUST:

  1. State the research question -- What specific question is this analysis/paradigm addressing?
  2. Justify the method choice -- Why is this approach appropriate? What alternatives were considered?
  3. Declare expected outcomes -- What results would support vs. refute the hypothesis?
  4. Note assumptions and limitations -- What does this method assume? Where could it mislead?
  5. Present the plan to the user and WAIT for confirmation before proceeding.

For detailed methodology guidance, see the research-literacy skill.


⚠️ Verification Notice

This skill was generated by AI from academic literature. All parameters, thresholds, and citations require independent verification before use in research. If you find errors, please open an issue.

When to Use Population Analysis vs. Single-Neuron Analysis

Single-neuron analysis characterizes individual tuning curves and response properties. Population analysis characterizes the collective, low-dimensional structure of neural activity. Use population analysis when (Cunningham & Yu, 2014):

  • Neural responses are distributed across many neurons with no single neuron carrying the full signal
  • You want to characterize the *geometry* of neural representations (e.g., are stimulus and decision signals orthogonal?)
  • You want to track *trajectories* of population activity over time during behavior
  • Single-neuron tuning is mixed or complex, making classical tuning curve approaches uninformative
  • You have simultaneous recordings from tens to hundreds of neurons
Domain judgment: Population analysis does NOT require that individual neurons be untuned. Even populations of well-tuned neurons have emergent low-dimensional structure that single-neuron analyses miss. The question is whether the research question is about individual neuron properties or collective population geometry (Cunningham & Yu, 2014).

Method Selection Decision Tree

What is your research question?
|
+-- "What are the dominant patterns of co-variation across the population?"
| --> PCA (linear, static)
| Simplest method; start here
| Output: principal components, variance explained, projections
|
+-- "What are the smooth latent trajectories on single trials?"
| --> GPFA (Yu et al., 2009) or Factor Analysis
| For temporal structure; extracts trial-by-trial dynamics
| Output: latent trajectories per trial, dimensionality estimate
|
+-- "How is variance distributed across task parameters?"
| --> dPCA (Kobak et al., 2016)
| Demixes stimulus, decision, time, and interaction variance
| Output: demixed components, marginalization pie chart
|
+-- "Are there rotational dynamics in the population?"
| --> jPCA (Churchland et al., 2012)
| Finds rotational structure in neural trajectories
| Output: rotational plane projections, R^2 of rotational fit
|
+-- "I want to visualize population structure in 2-3D"
 --> t-SNE or UMAP -- VISUALIZATION ONLY
 NOT for quantitative analysis or distance comparisons
 Output: 2D/3D embedding (qualitative only)

PCA for Neural Data

Preprocessing Before PCA

  1. Trial averaging vs. single-trial: Trial-averaged PCA smooths out single-trial variability and is appropriate when the question is about condition-mean trajectories. Single-trial PCA preserves trial-to-trial variability but requires more data (Cunningham & Yu, 2014).
  2. Soft normalization (CRITICAL): Do NOT use standard z-scoring (subtract mean, divide by SD). This eliminates firing rate differences that carry information. Instead, use soft normalization (Churchland et al., 2012):
normalized_rate = (rate - mean) / (range + constant)

where constant is typically 5 spikes/s (Churchland et al., 2012). This prevents low-firing neurons from dominating due to noise amplification while preserving rate differences.

  1. Square-root transform: An alternative normalization for Poisson-like spike counts: sqrt(mean firing rate + constant) (Churchland et al., 2012). Stabilizes variance across neurons with different firing rates.
  2. Mean subtraction: Subtract the condition-averaged PSTH across all conditions from each condition. This removes the shared temporal modulation and focuses PCA on condition-discriminating variance (Kobak et al., 2016).

Determining Dimensionality

MethodDescriptionWhen to UseSource
Parallel analysisCompare eigenvalues to those from shuffled dataRecommended default; principled thresholdHumphries, 2021
Cross-validated PCAHold out neurons or time bins; test reconstructionAvoids overfitting; gold standardCunningham & Yu, 2014
Scree plot elbowSubjective visual inspectionQuick but unreliable; avoid for publicationExpert consensus
Percent variance thresholde.g., "keep PCs explaining 90%"NOT recommended; arbitrary thresholdHumphries, 2021
Domain judgment: There is no fixed variance-explained threshold for choosing the number of PCs. The "90% rule" from data science is meaningless for neural data because it confounds signal dimensionality with noise. Use parallel analysis (compare eigenvalues to those expected from random data with matched statistics) or cross-validation (Humphries, 2021).

Cross-Validated PCA

To avoid overfitting dimensionality estimates:

  1. Split neurons into two halves (or use leave-one-neuron-out)
  2. Fit PCA on one half
  3. Project the other half onto the PCs
  4. Measure reconstruction error as a function of the number of PCs
  5. Choose dimensionality where held-out reconstruction stops improving

This is especially critical with small neuron counts (<50 neurons) where noise dimensions can mimic signal dimensions (Cunningham & Yu, 2014).


GPFA -- Gaussian Process Factor Analysis

GPFA extracts smooth, low-dimensional latent trajectories from single-trial spike trains by combining factor analysis with Gaussian process temporal smoothing (Yu et al., 2009).

When to Use GPFA

  • You need single-trial latent trajectories (not just condition averages)
  • The research question involves trial-to-trial variability in population dynamics
  • You want an estimate of dimensionality that accounts for temporal smoothness

Key Parameters

ParameterRecommended ValueRationaleSource
Bin size20--50 msSmaller bins preserve temporal resolution but increase noise; 20 ms is standard for motor cortexYu et al., 2009
Latent dimensionsCross-validateFit models with 2--15 dimensions; select by leave-one-neuron-out cross-validation log-likelihoodYu et al., 2009
GP timescale (tau)Learned from dataEach latent dimension has its own timescale; inspect for biologically plausible values (10--500 ms)Yu et al., 2009

Data Requirements

  • Minimum simultaneously recorded neurons: ~50--100 for stable latent trajectories; below 30, estimates become unreliable (Yu et al., 2009; Cunningham & Yu, 2014)
  • Trial count: 50+ trials per condition for reliable single-trial extraction (Yu et al., 2009)
  • Stationarity assumption: GPFA assumes the mapping from latent variables to neurons is fixed across all trials in the dataset. Non-stationarities (e.g., learning, drift) violate this assumption
Domain judgment: GPFA is NOT simply "smoothed PCA." Factor analysis and PCA make different assumptions about noise structure. PCA treats all variance as signal; factor analysis separates shared (signal) variance from private (noise) variance per neuron. GPFA adds temporal smoothness to the shared component. This distinction matters when neurons have heterogeneous noise levels (Yu et al., 2009).

dPCA -- Demixed Principal Component Analysis

dPCA finds linear projections that capture maximum variance attributable to specific task parameters (e.g., stimulus identity, decision, time, and their interactions), rather than maximum total variance like PCA (Kobak et al., 2016).

When to Use dPCA

  • You have a factorial experimental design with multiple task parameters
  • You want to know how much population variance is explained by each parameter
  • You want to visualize how stimulus, decision, and temporal signals are mixed or separated in the population

Key Procedures

  1. Marginalization: Partition the data tensor by task parameter (e.g., average over all decisions to isolate stimulus variance). dPCA finds components that maximize variance within each marginalization (Kobak et al., 2016).
  2. Regularization: The regularization parameter lambda controls the tradeoff between demixing (fidelity to marginalization) and reconstruction (total variance captured). Select lambda by cross-validation (Kobak et al., 2016):
  • Hold out a subset of trials
  • Fit dPCA on remaining trials for a range of lambda values
  • Choose lambda that minimizes reconstruction error on held-out trials
  1. Significance testing: Use a shuffle test to determine whether each component captures significantly more marginalized variance than expected by chance:
  • Shuffle condition labels for the parameter of interest (1000+ iterations)
  • Recompute dPCA on shuffled data
  • Compare observed marginalized variance to the null distribution (Kobak et al., 2016)
  1. Marginalization pie chart: Report the proportion of total variance explained by each marginalization (stimulus, decision, time, interaction). This provides a concise summary of how the population mixes task variables (Kobak et al., 2016).

Data Requirements

  • Trial counts: 20+ trials per condition minimum; more for stable interaction terms (Kobak et al., 2016)
  • Neuron counts: Works with as few as 20--30 neurons but more reliable with 50+ (Kobak et al., 2016)
  • Factorial design: dPCA requires a balanced factorial design; missing conditions or severely unbalanced cell sizes degrade performance

Population Decoding

Classifier Selection for Neural Populations

ClassifierWhen to UseSource
Linear SVMDefault; robust for high-dimensional population dataCunningham & Yu, 2014
LDAWhen number of neurons << number of trialsCunningham & Yu, 2014
Logistic RegressionWhen probability estimates are neededCunningham & Yu, 2014

Cross-Validation for Neural Data

StrategyWhen to UseSource
Leave-one-trial-outSmall trial counts; maximizes training dataCunningham & Yu, 2014
Stratified k-fold (k=5--10)Sufficient trials; balances bias/varianceCunningham & Yu, 2014

Temporal Generalization Matrix

Train a classifier at time t, test at all times t'. The resulting matrix reveals dynamics of neural coding (King & Dehaene, 2014):

  • Diagonal pattern: Transient coding; neural representation changes over time
  • Block pattern: Stable, sustained representation
  • Off-diagonal: Reactivation of earlier representations

See the neural-decoding-analysis skill for detailed guidance on temporal generalization.


Common Pitfalls

1. Using Standard Z-Scoring Instead of Soft Normalization

Standard z-scoring (subtract mean, divide by SD) amplifies noise from low-firing neurons and eliminates informative rate differences. Always use soft normalization or square-root transform for neural population data (Churchland et al., 2012).

2. Interpreting t-SNE/UMAP Distances as Meaningful

t-SNE and UMAP distort distances, create spurious clusters, and are sensitive to hyperparameters (perplexity, n_neighbors). They are useful for visualization but must NEVER be used for quantitative claims about distance, clustering, or dimensionality (Cunningham & Yu, 2014).

3. Using Percent Variance Explained to Choose Dimensionality

There is no universal threshold. The correct approach is parallel analysis (compare to null eigenvalue distribution) or cross-validated reconstruction (Humphries, 2021).

4. Applying GPFA to Condition-Averaged Data

GPFA is designed for single-trial data. Applying it to trial-averaged PSTHs defeats its purpose (separating shared latent signal from private noise) and provides no advantage over PCA (Yu et al., 2009).

5. Ignoring Neuron Count Requirements

Population analyses have minimum neuron requirements for reliable estimates. Below ~30 simultaneously recorded neurons, dimensionality estimates from PCA are dominated by noise; GPFA latent trajectories become unstable below ~50 neurons (Cunningham & Yu, 2014; Yu et al., 2009).

6. Not Cross-Validating dPCA Regularization

Using default or arbitrary regularization parameters in dPCA can either over-demix (fitting noise) or under-demix (missing true task-related structure). Always cross-validate lambda (Kobak et al., 2016).


Minimum Reporting Checklist

Based on Cunningham & Yu (2014), Kobak et al. (2016), and Yu et al. (2009):

  • Number of simultaneously recorded neurons and recording method
  • Neuron inclusion criteria (e.g., minimum firing rate, signal quality)
  • Normalization method (soft normalization constant, or square-root transform)
  • Method used and justification (PCA, GPFA, dPCA, jPCA)
  • Dimensionality selection method (parallel analysis, cross-validation) and chosen dimensionality
  • For GPFA: bin size, number of latent dimensions, learned GP timescales
  • For dPCA: regularization parameter, cross-validation procedure, shuffle test results
  • Trial counts per condition
  • Variance explained (total and per component/marginalization)
  • Software and version used (e.g., GPFA code from Yu et al., dPCA Python/MATLAB toolbox)

Key References

  • Churchland, M. M., Cunningham, J. P., Kaufman, M. T., Foster, J. D., Nuyujukian, P., Ryu, S. I., & Shenoy, K. V. (2012). Neural population dynamics during reaching. *Nature*, 487(7405), 51--56.
  • Cunningham, J. P., & Yu, B. M. (2014). Dimensionality reduction for large-scale neural recordings. *Nature Neuroscience*, 17(11), 1500--1509.
  • Humphries, M. D. (2021). Strong and weak principles of neural dimension reduction. *Neuron*, 109(8), 1230--1234.
  • King, J.-R., & Dehaene, S. (2014). Characterizing the dynamics of mental representations: The temporal generalization method. *Trends in Cognitive Sciences*, 18(4), 203--210.
  • Kobak, D., Brendel, W., Constantinidis, C., Feierstein, C. E., Kepecs, A., Mainen, Z. F., Qi, X.-L., Romo, R., Uchida, N., & Machens, C. K. (2016). Demixed principal component analysis of neural population data. *eLife*, 5, e10989.
  • Yu, B. M., Cunningham, J. P., Santhanam, G., Ryu, S. I., Shenoy, K. V., & Sahani, M. (2009). Gaussian-process factor analysis for low-dimensional single-trial analysis of neural population activity. *Journal of Neurophysiology*, 102(1), 614--635.

See references/method-comparison.md for detailed parameter tables and software recommendations. See references/data-requirements.md for minimum neuron and trial count guidelines by method.

平台分布

Codex

34.86%
按下载量换算463

Claude

31.25%
按下载量换算415

Cursor

21.1%
按下载量换算280

Gemini CLI

9.57%
按下载量换算127

安全审计

Gen Agent Trust Hub

通过

Socket

通过

Snyk

通过

权限和风险

只读

该 Skill 主要提供规则、说明或参考内容,本身偏只读;真正读写文件、联网或执行命令仍取决于宿主 Agent 的任务。

安装前确认

本站仅展示第三方公开信息,不托管安装包,不提供自动安装或运行环境。安装前应自行审查源码、依赖和命令行为。目前只有一个公开来源,建议同时核对源仓库。

继续浏览同类 Skills