basic_neural_processing_modules

Personal library of functions used in analyzing neural data. If you find a bug or just want to reach out: RichHakim@gmail.com

Installation

Normal installation of bnpm does not install all possible dependencies; there are some specific functions that wrap libraries that may need to be installed separately on a case-by-case basis.

Install stable version:

pip install bnpm[core]

If installing on a server or any computer without graphics/display, install using core_cv2Headless. If you accidentally installed the normal version, simply please uninstall pip uninstall opencv-contrib-python and install pip install opencv-contrib-python-headless instead.

Functional extras are also available:

bnpm[ml] for modeling and optimization tools
bnpm[plot] for plotting and visualization utilities
bnpm[io] for file/data IO helpers
bnpm[sql] for SQL backends
bnpm[server] for remote/server helpers
bnpm[video] for video processing helpers
bnpm[gpu] for optional GPU ecosystem packages
bnpm[dev] for test/dev tooling
bnpm[all] for the full dependency set

Install development version:

pip install git+https://github.com/RichieHakim/basic_neural_processing_modules.git

import with:

import bnpm

Usage

My favorites:

automatic_regression module
- Allows for easy and fast hyperparameter optimization of regression models
- Any model with a fit and predict method can be used (e.g. sklearn and similar)
- Uses optuna for hyperparameter optimization

Other useful functions:

Signal Processing:
- timeSeries.rolling_percentile_rq_multicore
  - Fast rolling percentile calculation
- timeSeries.event_triggered_traces
  - Fast creation of a matrix of aligned traces relative to specified event times
Machine Learning:
- neural_networks module
  - Has nice RNN regression and classification classes
- decomposition.torch_PCA
  - Fast standard PCA using PyTorch
- similarity.orthogonalize
  - Orthogonalize a matrix relative to a set of vectors using OLS or Gram-Schmidt process
Miscellaneous
- path_helpers.find_paths
  - Find paths to files and/or folders in a directory. Searches recursively using regex.
- image_processing.play_video_cv2
  - Plays and/or saves a 3D array as a video using OpenCV
- h5_handling.simple_save and h5_handling.simple_load
  - Simple lazy loading and saving of dictionaries as nested h5 files

Metadata

Release files for bnpm 0.7.1

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

Source distribution (sdist)

Source distribution for bnpm 0.7.1
File	Size	Uploaded
bnpm-0.7.1.tar.gz	252.4 kB	Feb 27, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for bnpm 0.7.1
File	Interpreter	ABI	Platform	Reset
bnpm-0.7.1-py3-none-any.whl 264.5 kB Feb 27, 2026	Python 3	none	any	Details

Total release size: 517.0 kB

Release files / bnpm-0.7.1.tar.gz

Download URL	bnpm-0.7.1.tar.gz
Size	252.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`c33c87bc3c7c5bd173d7f3eb8654ded0b5fbf6b07b09f729974fff3a11183064`
BLAKE2b-256 checksum How to use checksums	`c8bfc9e7ef306e4ae541a3ffcb303cded4527deaa5f2058cbdc90cb8f5f894f3`
Upload date	Feb 27, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.7`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/RichieHakim/basic_neural_processing_modules
Publishing commit: github.com/RichieHakim/basic_neural_processing_modules/tree/62c5344afb3d5d77ac38ee23fd3f5c70a3e61aa2

Workflow

Publishing configuration: github.com/RichieHakim/basic_neural_processing_modules/blob/62c5344afb3d5d77ac38ee23fd3f5c70a3e61aa2/.github/workflows/pypi_release.yml
Publishing logs: github.com/RichieHakim/basic_neural_processing_modules/actions/runs/22493525576/attempts/1

Artifact

Subject: bnpm-0.7.1.tar.gz
SHA-256 checksum: c33c87bc3c7c5bd173d7f3eb8654ded0b5fbf6b07b09f729974fff3a11183064 Verifying attestations

Release files / bnpm-0.7.1-py3-none-any.whl

Download URL	bnpm-0.7.1-py3-none-any.whl
Size	264.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`d61853827febc0a99a031de6cc23c7d4ded1ca469b2fedebfda8e0e210ff7cff`
BLAKE2b-256 checksum How to use checksums	`843e08f707605b25e80052470107ac5ce7899285007767c4e1b531712d1b7e55`
Upload date	Feb 27, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.7`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/RichieHakim/basic_neural_processing_modules
Publishing commit: github.com/RichieHakim/basic_neural_processing_modules/tree/62c5344afb3d5d77ac38ee23fd3f5c70a3e61aa2

Workflow

Publishing configuration: github.com/RichieHakim/basic_neural_processing_modules/blob/62c5344afb3d5d77ac38ee23fd3f5c70a3e61aa2/.github/workflows/pypi_release.yml
Publishing logs: github.com/RichieHakim/basic_neural_processing_modules/actions/runs/22493525576/attempts/1

Artifact

Subject: bnpm-0.7.1-py3-none-any.whl
SHA-256 checksum: d61853827febc0a99a031de6cc23c7d4ded1ca469b2fedebfda8e0e210ff7cff Verifying attestations