ms_stim_analysis

This repository accompanies the manuscript Disruption of theta-timescale spiking impairs learning but spares hippocampal replay (Joshi A, Comrie AE, Bray S, Mankili A, Guidera JA, et al., 2025).

It provides:

Ready-to-use scripts to process wideband data into LFP and spikes, and to perform spike sorting, clusterless decoding, and LFP analysis using Spyglass.
Tools to examine stimulus-driven entrainment and suppression, changes in pairwise correlations, spatial fields, theta sequences, replay, and learning.
Figure notebooks that reproduce the main and supplementary results.

Results demonstrate the effects of rhythmic and theta-phase-specific closed-loop optogenetic activation of medial septum parvalbumin-expressing neurons on hippocampal LFPs, spatiotemporal coding, and task learning.

Demo: Theta-phase-specific stimulation of medial septum PV neurons suppresses the rhythmicity of hippocampal ahead-behind sweeps of location during track traversal.

Transfected animal

Installation

To install the package with custom analysis tables and run the associated notebooks (recommended), follow these steps:

Clone the repository to your local system.
Navigate to the cloned directory and run: pip install .

Todo:

PyPI release

Usage

New work

If you want to apply the analysis pipelines to new datasets, you can install the package and use the custom tables together with your existing database and the spyglass ecosystem.

Reuse and Replication

All raw data and derived results (e.g., spike sorting, LFP) will be made available through the DANDI archive (upcoming).

We also plan to release a Docker image that includes:

a pre-built conda environment
the notebooks from this repository, and
a populated SQL database with all information needed to query and retrieve results from the DANDI archive.

(Docker build in progress)

Associated repositories

non_local_detector: tools for clusterless decoding of hippocampal population activity.
spyglass: database framework for managing electrophysiology and behavioral data.
trodes: acquisition and stimulation software used in these experiments.
ndx-optogenetics: NWB extension for representing optogenetic stimulation protocols and metadata.
ndx-franklab-novela: Frank Lab–specific NWB extension for storing lab-specific data in NWB/DANDI.

Code Directory

Figure	Panel	Notebook
1	D	opto_stimResponse_analysis.ipynb
	E	opto_powerSpectrum_analysis.ipynb
	F	opto_powerSpectrum_analysis.ipynb
	G	opto_stimResponse_analysis.ipynb
	H	opto_powerSpectrum_closedLoop_analysis.ipynb
	I	opto_powerSpectrum_closedLoop_analysis.ipynb
2	B	opto_spiking_response.ipynb
	C	mua_response.ipynb
	D	peak_delay_timescales_lineartrack.ipynb
	E	Fig2E.ipynb
	F	place_field_table_plots.ipynb
	G	place_field_table_plots.ipynb
3	A	learning_curves.ipynb
	B	learning_curves.ipynb
	C	learning_curves.ipynb
	D	learning_curves.ipynb
	E	outbound_error_repeats.ipynb
	F	choice_point_occupancy.ipynb
	F	speed_distributions.ipynb
4	A	wtrack_examples_first_epoch.ipynb
	B	ahead_behind_spectrum.ipynb
	C	clusterless_decode_stim_response.ipynb
	D	clusterless_decode_stim_response.ipynb
	E	wtrack_examples_first_epoch.ipynb
	F	ahead_behind_spectrum.ipynb
	G	clusterless_decode_stim_response.ipynb
	H	clusterless_decode_stim_response.ipynb
	I	ahead_behind_spectrum.ipynb
5	A	continuous_traversals.ipynb
	A	continuous_traversals_first_epoch.ipynb
	B	opto_ripple_analysis_difference.ipynb
	C	ripple_decodes.ipynb
	D	replay_decode_speed.ipynb
S1	*	opto_powerSpectrum_analysis.ipynb
S2	A	supplement_rose_plot.ipynb
	B	stim_field_interaction.ipynb
S3	A	clusterless_decode_stim_response.ipynb
	B	peak_delay_timescales.ipynb
	C	peak_delay_timescales.ipynb
	D	peak_delay_timescales.ipynb
	E	peak_delay_timescales.ipynb
	F	place_field_table_plots.ipynb
	G	decoding_stim_max_ahead_behind_choice_point.ipynb
S4	*	ahead_behind_spectrum.ipynb

Rat alias table

Animal	Alias	Targeted
Winnie	V	1
Frodo	F	1
Totoro	T	1
Banner	B	1
Odins	O	1
Wallie	W	0
Olive	L	0
Yoshi	Y	0
Bilbo	I	0

License
- OSI Approved :: MIT License
Operating System
- OS Independent
Programming Language
- Python :: 3

Metadata

License
- OSI Approved :: MIT License
Operating System
- OS Independent
Programming Language
- Python :: 3

Release files for ms-stim-analysis 0.1.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ms-stim-analysis 0.1.6
File	Size	Uploaded
ms_stim_analysis-0.1.6.tar.gz	85.5 kB	Nov 25, 2025	Details

Built distribution (wheel)

Table of built distributions (wheels) for ms-stim-analysis 0.1.6
File	Interpreter	ABI	Platform	Reset
ms_stim_analysis-0.1.6-py3-none-any.whl 110.7 kB Nov 25, 2025	Python 3	none	any	Details

Total release size: 196.2 kB

Release files / ms_stim_analysis-0.1.6.tar.gz

Download URL	ms_stim_analysis-0.1.6.tar.gz
Size	85.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`757efa222524a7d74f7080fafb5e5fe2d1efcde7df2dd623babbf64168a54e8c`
BLAKE2b-256 checksum How to use checksums	`4fdd91b79a098a059c6d1df5cf8d4a39e0e5eca5069d0584bb9dc60fc843b14e`
Upload date	Nov 25, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.8.10`

Release files / ms_stim_analysis-0.1.6-py3-none-any.whl

Download URL	ms_stim_analysis-0.1.6-py3-none-any.whl
Size	110.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`884c94dcceddc80cad7f2669efbcdc33fb760ab4bf311daad8eee2bbaec24b78`
BLAKE2b-256 checksum How to use checksums	`4f4741aac14451e6725d6c8cdbc4f31d481dc19e06e083f6e2ef0f22967f75bb`
Upload date	Nov 25, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.8.10`