鱼皮AI导航
鱼皮AI导航
  • 主页
  • 社区
  • AI工具
  • AI知识库
  • AI提示词
  • MCP
  • Skills
  • AI学习资源
  • AI资讯
  • GitHub开源
登录/注册

neuropixels-analysis

处理 Neuropixels 高密度神经电生理数据,实现从原始信号采集到单元聚类的全流程分析,涵盖数据预处理、运动伪影校正、自动去噪与 spike 分类,并结合质量评估与 AI 辅助判读生成可靠神经元活动结果。

研究
访问 GitHub
文档Skills.MD
name
neuropixels-analysis
description
Neuropixels neural recording analysis. Load SpikeGLX/OpenEphys data, preprocess, motion correction, Kilosort4 spike sorting, quality metrics, Allen/IBL curation, AI-assisted visual analysis, for Neuropixels 1.0/2.0 extracellular electrophysiology. Use when working with neural recordings, spike sorting, extracellular electrophysiology, or when the user mentions Neuropixels, SpikeGLX, Open Ephys, Kilosort, quality metrics, or unit curation.

Neuropixels Data Analysis

Overview

Comprehensive toolkit for analyzing Neuropixels high-density neural recordings using current best practices from SpikeInterface, Allen Institute, and International Brain Laboratory (IBL). Supports the full workflow from raw data to publication-ready curated units.

When to Use This Skill

This skill should be used when:

  • Working with Neuropixels recordings (.ap.bin, .lf.bin, .meta files)
  • Loading data from SpikeGLX, Open Ephys, or NWB formats
  • Preprocessing neural recordings (filtering, CAR, bad channel detection)
  • Detecting and correcting motion/drift in recordings
  • Running spike sorting (Kilosort4, SpykingCircus2, Mountainsort5)
  • Computing quality metrics (SNR, ISI violations, presence ratio)
  • Curating units using Allen/IBL criteria
  • Creating visualizations of neural data
  • Exporting results to Phy or NWB

Supported Hardware & Formats

ProbeElectrodesChannelsNotes
Neuropixels 1.0960384Requires phase_shift correction
Neuropixels 2.0 (single)1280384Denser geometry
Neuropixels 2.0 (4-shank)5120384Multi-region recording
FormatExtensionReader
SpikeGLX.ap.bin, .lf.bin, .metasi.read_spikeglx()
Open Ephys.continuous, .oebinsi.read_openephys()
NWB.nwbsi.read_nwb()

Quick Start

Basic Import and Setup

▼
python
复制代码
import spikeinterface.full as si import neuropixels_analysis as npa # Configure parallel processing job_kwargs = dict(n_jobs=-1, chunk_duration='1s', progress_bar=True)

Loading Data

▼
python
复制代码
# SpikeGLX (most common) recording = si.read_spikeglx('/path/to/data', stream_id='imec0.ap') # Open Ephys (common for many labs) recording = si.read_openephys('/path/to/Record_Node_101/') # Check available streams streams, ids = si.get_neo_streams('spikeglx', '/path/to/data') print(streams) # ['imec0.ap', 'imec0.lf', 'nidq'] # For testing with subset of data recording = recording.frame_slice(0, int(60 * recording.get_sampling_frequency()))

Complete Pipeline (One Command)

▼
python
复制代码
# Run full analysis pipeline results = npa.run_pipeline( recording, output_dir='output/', sorter='kilosort4', curation_method='allen', ) # Access results sorting = results['sorting'] metrics = results['metrics'] labels = results['labels']

Standard Analysis Workflow

1. Preprocessing

▼
python
复制代码
# Recommended preprocessing chain rec = si.highpass_filter(recording, freq_min=400) rec = si.phase_shift(rec) # Required for Neuropixels 1.0 bad_ids, _ = si.detect_bad_channels(rec) rec = rec.remove_channels(bad_ids) rec = si.common_reference(rec, operator='median') # Or use our wrapper rec = npa.preprocess(recording)

2. Check and Correct Drift

▼
python
复制代码
# Check for drift (always do this!) motion_info = npa.estimate_motion(rec, preset='kilosort_like') npa.plot_drift(rec, motion_info, output='drift_map.png') # Apply correction if needed if motion_info['motion'].max() > 10: # microns rec = npa.correct_motion(rec, preset='nonrigid_accurate')

3. Spike Sorting

▼
python
复制代码
# Kilosort4 (recommended, requires GPU) sorting = si.run_sorter('kilosort4', rec, folder='ks4_output') # CPU alternatives sorting = si.run_sorter('tridesclous2', rec, folder='tdc2_output') sorting = si.run_sorter('spykingcircus2', rec, folder='sc2_output') sorting = si.run_sorter('mountainsort5', rec, folder='ms5_output') # Check available sorters print(si.installed_sorters())

4. Postprocessing

▼
python
复制代码
# Create analyzer and compute all extensions analyzer = si.create_sorting_analyzer(sorting, rec, sparse=True) analyzer.compute('random_spikes', max_spikes_per_unit=500) analyzer.compute('waveforms', ms_before=1.0, ms_after=2.0) analyzer.compute('templates', operators=['average', 'std']) analyzer.compute('spike_amplitudes') analyzer.compute('correlograms', window_ms=50.0, bin_ms=1.0) analyzer.compute('unit_locations', method='monopolar_triangulation') analyzer.compute('quality_metrics') metrics = analyzer.get_extension('quality_metrics').get_data()

5. Curation

▼
python
复制代码
# Allen Institute criteria (conservative) good_units = metrics.query(""" presence_ratio > 0.9 and isi_violations_ratio < 0.5 and amplitude_cutoff < 0.1 """).index.tolist() # Or use automated curation labels = npa.curate(metrics, method='allen') # 'allen', 'ibl', 'strict'

6. AI-Assisted Curation (For Uncertain Units)

When using this skill with Claude Code, Claude can directly analyze waveform plots and provide expert curation decisions. For programmatic API access:

▼
python
复制代码
from anthropic import Anthropic # Setup API client client = Anthropic() # Analyze uncertain units visually uncertain = metrics.query('snr > 3 and snr < 8').index.tolist() for unit_id in uncertain: result = npa.analyze_unit_visually(analyzer, unit_id, api_client=client) print(f"Unit {unit_id}: {result['classification']}") print(f" Reasoning: {result['reasoning'][:100]}...")

Claude Code Integration: When running within Claude Code, ask Claude to examine waveform/correlogram plots directly - no API setup required.

7. Generate Analysis Report

▼
python
复制代码
# Generate comprehensive HTML report with visualizations report_dir = npa.generate_analysis_report(results, 'output/') # Opens report.html with summary stats, figures, and unit table # Print formatted summary to console npa.print_analysis_summary(results)

8. Export Results

▼
python
复制代码
# Export to Phy for manual review si.export_to_phy(analyzer, output_folder='phy_export/', compute_pc_features=True, compute_amplitudes=True) # Export to NWB from spikeinterface.exporters import export_to_nwb export_to_nwb(rec, sorting, 'output.nwb') # Save quality metrics metrics.to_csv('quality_metrics.csv')

Common Pitfalls and Best Practices

  1. Always check drift before spike sorting - drift > 10μm significantly impacts quality
  2. Use phase_shift for Neuropixels 1.0 probes (not needed for 2.0)
  3. Save preprocessed data to avoid recomputing - use rec.save(folder='preprocessed/')
  4. Use GPU for Kilosort4 - it's 10-50x faster than CPU alternatives
  5. Review uncertain units manually - automated curation is a starting point
  6. Combine metrics with AI - use metrics for clear cases, AI for borderline units
  7. Document your thresholds - different analyses may need different criteria
  8. Export to Phy for critical experiments - human oversight is valuable

Key Parameters to Adjust

Preprocessing

  • freq_min: Highpass cutoff (300-400 Hz typical)
  • detect_threshold: Bad channel detection sensitivity

Motion Correction

  • preset: 'kilosort_like' (fast) or 'nonrigid_accurate' (better for severe drift)

Spike Sorting (Kilosort4)

  • batch_size: Samples per batch (30000 default)
  • nblocks: Number of drift blocks (increase for long recordings)
  • Th_learned: Detection threshold (lower = more spikes)

Quality Metrics

  • snr_threshold: Signal-to-noise cutoff (3-5 typical)
  • isi_violations_ratio: Refractory violations (0.01-0.5)
  • presence_ratio: Recording coverage (0.5-0.95)

Bundled Resources

scripts/preprocess_recording.py

Automated preprocessing script:

▼
bash
复制代码
python scripts/preprocess_recording.py /path/to/data --output preprocessed/

scripts/run_sorting.py

Run spike sorting:

▼
bash
复制代码
python scripts/run_sorting.py preprocessed/ --sorter kilosort4 --output sorting/

scripts/compute_metrics.py

Compute quality metrics and apply curation:

▼
bash
复制代码
python scripts/compute_metrics.py sorting/ preprocessed/ --output metrics/ --curation allen

scripts/export_to_phy.py

Export to Phy for manual curation:

▼
bash
复制代码
python scripts/export_to_phy.py metrics/analyzer --output phy_export/

assets/analysis_template.py

Complete analysis template. Copy and customize:

▼
bash
复制代码
cp assets/analysis_template.py my_analysis.py # Edit parameters and run python my_analysis.py

reference/standard_workflow.md

Detailed step-by-step workflow with explanations for each stage.

reference/api_reference.md

Quick function reference organized by module.

reference/plotting_guide.md

Comprehensive visualization guide for publication-quality figures.

Detailed Reference Guides

TopicReference
Full workflowreference/standard_workflow.md
API referencereference/api_reference.md
Plotting guidereference/plotting_guide.md
PreprocessingPREPROCESSING.md
Spike sortingSPIKE_SORTING.md
Motion correctionMOTION_CORRECTION.md
Quality metricsQUALITY_METRICS.md
Automated curationAUTOMATED_CURATION.md
AI-assisted curationAI_CURATION.md
Waveform analysisANALYSIS.md

Installation

▼
bash
复制代码
# Core packages pip install spikeinterface[full] probeinterface neo # Spike sorters pip install kilosort # Kilosort4 (GPU required) pip install spykingcircus # SpykingCircus2 (CPU) pip install mountainsort5 # Mountainsort5 (CPU) # Our toolkit pip install neuropixels-analysis # Optional: AI curation pip install anthropic # Optional: IBL tools pip install ibl-neuropixel ibllib

Project Structure

▼
text
复制代码
project/ ├── raw_data/ │ └── recording_g0/ │ └── recording_g0_imec0/ │ ├── recording_g0_t0.imec0.ap.bin │ └── recording_g0_t0.imec0.ap.meta ├── preprocessed/ # Saved preprocessed recording ├── motion/ # Motion estimation results ├── sorting_output/ # Spike sorter output ├── analyzer/ # SortingAnalyzer (waveforms, metrics) ├── phy_export/ # For manual curation ├── ai_curation/ # AI analysis reports └── results/ ├── quality_metrics.csv ├── curation_labels.json └── output.nwb

Additional Resources

  • SpikeInterface Docs: https://spikeinterface.readthedocs.io/
  • Neuropixels Tutorial: https://spikeinterface.readthedocs.io/en/stable/how_to/analyze_neuropixels.html
  • Kilosort4 GitHub: https://github.com/MouseLand/Kilosort
  • IBL Neuropixel Tools: https://github.com/int-brain-lab/ibl-neuropixel
  • Allen Institute ecephys: https://github.com/AllenInstitute/ecephys_spike_sorting
  • Bombcell (Automated QC): https://github.com/Julie-Fabre/bombcell
  • SpikeAgent (AI Curation): https://github.com/SpikeAgent/SpikeAgent
研究

快捷安装

复制到终端去安装 Skill

npxskillsadddavila7/claude-code-templates--skill"neuropixels-analysis"
站长:程序员鱼皮 老鱼简历 商务合作 增值电信业务经营许可证
2026 鱼皮AI导航 | 沪ICP备19026706号-6
站长:程序员鱼皮 老鱼简历 商务合作 增值电信业务经营许可证
2026 鱼皮AI导航 | 沪ICP备19026706号-6
🔥热门工具
朱雀AI检测朱雀AI检测
朱雀AI检测助手朱雀AI检测助手
LovartLovart
老鱼简历老鱼简历
WritePass官网WritePass官网
面多多面多多
CursorCursor
星月写作星月写作
朱雀AI检测助手朱雀AI检测助手
零感AI零感AI
Skills 推荐
prime-numbers
面向图论中的素数问题求解,提供素性判定、整数分解、素数分布分析及模运算定理验证等核心能力,支持从基础试除到概率化与确定性算法的多层次策略选择,适用于理论推导与计算验证相结合的研究场景。
research
面向技术方案的深度调研能力,通过网络搜索、GitHub 仓库分析和多源证据采集,支持在实施前全面评估技术选型,确保每个推荐方案均基于官方文档、活跃代码库及真实应用案例等至少两项可靠依据。
rank-tracker
持续监控关键词在传统搜索结果与AI生成内容中的排名变化,分析趋势波动并识别显著升降,支持多维度对比竞争格局与SERP特征占有情况,输出可视化报告及可执行优化建议,适用于搜索引擎营销策略的动态调整。
research-grants
面向 NSF、NIH、DOE 和 DARPA 等联邦机构的科研基金申请,提供从选题定位、立项依据、技术路线设计、创新性阐述、可行性论证到预算编制与合规性审查的全流程支持,强调科学严谨性、跨学科整合能力及社会价值转化路径。
gsea-enrichment
执行基因集富集分析时,需先将通路数据库文件加载为字典格式,再进行富集计算,确保使用正确的数据结构与物种参数,支持多类功能注释数据库的整合分析与可视化。