Skip to content

Mircus/NeuroScan

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

4 Commits
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🧠 NeuroScan

Visualizing the hidden structure of deep neural networks through activation maps.

πŸ“– Related article: NeuroScan: Your Model, I – Visualizing Activation Maps


πŸ“Œ What is NeuroScan?

NeuroScan is an interpretability tool for neural networks. It generates layer-wise activation visualizations from a given model and dataset. With a focus on transparency, it aims to help researchers and practitioners see how internal representations evolve across depth, especially in convolutional or transformer-based architectures.


πŸ” Features

  • βœ… Layer-by-layer activation maps for image models
  • βœ… Works with PyTorch models (CNNs, ResNets, Vision Transformers)
  • βœ… Heatmap overlays and channel-wise visualizations
  • βœ… Simple hooks for grabbing activations during inference
  • βœ… Easy-to-use Jupyter interface

πŸš€ Getting Started

1. Clone the repo

git clone https://github.com/Mircus/NeuroScan.git
cd NeuroScan

2. Install dependencies

pip install -r requirements.txt

3. Run the notebook

jupyter notebook NeuroScan_Demo.ipynb

πŸ–Ό Example Output

NeuroScan generates intuitive visualizations like these:

  • Feature maps from intermediate convolution layers
  • Overlayed activation heatmaps on input images
  • Comparative view across multiple layers or architectures

(Insert sample image or animated gif if available)


🧩 How It Works

  1. Hooks are registered on the layers of interest
  2. During a forward pass, activations are captured and stored
  3. Post-processing (e.g. normalization, colormapping)
  4. Display as overlays or tiled maps

You can customize which layers to hook, how to aggregate activations, and how to display them.


πŸ›  Tech Stack

  • PyTorch
  • Matplotlib & Seaborn
  • Torchvision models
  • Jupyter Notebook (or Colab)

πŸ“„ License

MIT License β€” see LICENSE file for details.


πŸ™‹β€β™€οΈ Contributions

Issues and pull requests are welcome. If you use NeuroScan in your research or writing, please consider citing or linking the Medium article.

This is part of the Holomathics open research ecosystem.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published