receptual 0.1.0

A simple tool for computing and visualising neuron receptive fields.

Receptual

Receptual is a lightweight, interactive tool for computing and visualizing neuron receptive fields and linear decoders.

Overview

Linear encoding and decoding methods are essential tools for:

• Systems neuroscience
• Computational neuroscience
• Deep learning interpretability

However, these methods often produce high-dimensional arrays, which are difficult to analyze and interpret. Additionally, despite the ubiquity of linear methods, implementing them can be challenging.

Receptual helps by providing standardized algorithm implementations for linear encoding and decoding methods. We also provide a visualization tool to help you explore the high-dimensional arrays that often result from these methods.

Key Features

• Interactive 3D Visualization
  OpenGL + Qt-based viewer for receptive fields, stimuli, activity traces, and decoders

• Efficient Algorithms
  Fast NumPy and SciPy implementations tailored for neuroscience use cases

Implemented Algorithms

Receptual provides the following out-of-the-box:

• Receptive field estimation
• Linear activity encoding

Installation

Receptual requires Python 3.13 or later and is available on PyPI:

# Using uv
uv venv $HOME/venvs/receptual --python 3.13 # or wherever you keep your environments
source $HOME/venvs/receptual/bin/activate
uv pip install receptual

# Using conda
conda create -n receptual python=3.13
conda activate receptual
pip install receptual

Quick Start

Launch the visualization tool with:

receptual

Or use the algorithms yourself:

import receptual
activity = receptual.encoder(stimulus, receptive_field)

Documentation

For detailed usage instructions, examples, and API reference, please visit our documentation.