GuPPy can be run on Windows, Mac or Linux. It requires Python 3.10 or greater.
We recommend installing GuPPy inside a conda virtual environment to avoid conflicts with other Python packages on your system.
-
Download the Miniconda installer for your operating system from the official Miniconda page.
- Windows: Download the
.exeinstaller and run it, following the on-screen prompts. - macOS: Download the
.pkginstaller (or the.shscript) and follow the on-screen prompts. Alternatively, run the shell script in a terminal:bash Miniconda3-latest-MacOSX-x86_64.sh
- Linux: Download the
.shinstaller and run it in a terminal:bash Miniconda3-latest-Linux-x86_64.sh
- Windows: Download the
-
After installation, open a new terminal (or Command Prompt / Anaconda Prompt on Windows) and verify conda is available:
conda --version
-
Create a new conda environment named
guppy_envwith Python 3.12:conda create -n guppy_env python=3.12
-
Activate the environment:
conda activate guppy_env
Your terminal prompt should now show
(guppy_env)to indicate the environment is active. You will need to activate this environment each time you open a new terminal before using GuPPy.
With the guppy_env environment active, install GuPPy using one of the two methods below.
Install the latest stable release directly from PyPI:
pip install guppy-neuroThis option gives you access to the latest features and bug fixes that may not yet be in the stable release.
You will need git installed (installation instructions).
-
Clone the repository:
git clone https://github.com/LernerLab/GuPPy.git
-
Navigate into the cloned directory:
cd GuPPy -
Install the package in editable mode:
pip install -e .
In a terminal or command prompt, you can start using GuPPy by running the following command:
guppyThis will launch the GuPPy user interface, where you can begin analyzing your fiber photometry data.
Note: The Wiki and video tutorials below refer to GuPPy v1.3.0 and earlier. Updated documentation for v2.0 is coming soon.
- The full instructions along with detailed descriptions of each step to run the GuPPy tool is on Github Wiki Page.
- Installation steps
- Explaining Input Parameters GUI
- Individual Analysis steps
- Artifacts Removal
- Group Analysis steps
- Use of csv file as an input
- Use of Neurophotometrics data as an input
- Sample data for the user to go through the tool in the start. This folder of sample data has two types of sample data recorded with a TDT system : 1) Clean Data 2) Data with artifacts (to practice removing them) 3) Neurophotometrics data 4) Doric system data. Finally, it has a control channel, signal channel and event timestamps file in a 'csv' format to get an idea of how to structure other data in the 'csv' file format accepted by GuPPy.
- GuPPy was initially developed keeping our data (FP data recorded using TDT systems) in mind. GuPPy now supports data collected using Neurophotometrics, Doric system and also other data types/formats using 'csv' files as input, but these are less extensively tested because of lack of sample data. If you have any issues, please get in touch on the chat room or by raising an issue, so that we can continue to improve this tool.
- If you use GuPPy for your research, please cite Venus N. Sherathiya, Michael D. Schaid, Jillian L. Seiler, Gabriela C. Lopez, and Talia N. Lerner GuPPy, a Python toolbox for the analysis of fiber photometry data
Venus N. Sherathiya, Michael D. Schaid, Jillian L. Seiler, Gabriela C. Lopez, and Talia N. Lerner GuPPy, a Python toolbox for the analysis of fiber photometry data. Sci Rep 11, 24212 (2021). https://doi.org/10.1038/s41598-021-03626-9
- Venus Sherathiya
- Michael Schaid
- Jillian Seiler
- Gabriela Lopez
- Talia Lerner
- Paul Adkisson-Floro