Sovereign 8s.is mirror of standardgalactic/NeuralCircuitVisualizer
  • HTML 36.6%
  • JavaScript 31.5%
  • Python 25.4%
  • CSS 6.2%
  • Shell 0.3%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
MaqsoodCNR 43a9c4dbe3
Some checks failed
Deploy to Production / Deploying changes in production (push) Has been cancelled
reduce text size of heading
2026-02-20 16:43:07 +01:00
.github/workflows General improvements: 2025-06-03 20:32:42 +02:00
api remove system library from backend 2026-02-20 16:06:27 +01:00
hpc_integration Revert "Disabled JUSUF" 2025-10-08 22:10:06 +02:00
neural_circuit_visualizer Added console logging for debugging mode 2025-09-26 10:48:32 +02:00
static Update code 2026-02-20 15:56:13 +01:00
templates reduce text size of heading 2026-02-20 16:43:07 +01:00
.env.example Added OIDC urls 2025-05-08 13:06:57 +02:00
.gitignore General improvements: 2025-06-03 20:32:42 +02:00
gunicorn.conf.py.example General improvements: 2025-06-03 20:32:42 +02:00
log_cineca.sh Update log_cineca.sh 2025-05-27 21:56:04 +02:00
manage.py first commit 2025-04-23 15:46:26 +02:00
README.md test change 2025-10-23 23:06:18 +02:00
requirements.txt Genera improvements: 2025-07-03 18:55:36 +02:00
threejs_setup.sh Threejs setup script improved 2025-04-23 16:04:31 +02:00

Neural Circuit Visualizer

Overview

The Neural Circuit Visualizer (NCV) is a web-based application that enables users to interactively upload, visualize, and analyze large-scale hippocampal neuron circuits. The platform supports a streamlined workflow from network and activity file upload to dynamic 3D circuit visualization and spike playback.

  • Data Upload : Upload neural network and spike activity data in supported formats (CSV or HDF5).
  • 3D Visualization : Explore neuron distributions and network structure with anatomical orientation.
  • Playback and Analysis : Animate spike activity over time and examine firing statistics across simulation chunks.

Setup

Create virtual environment

python -m venv venv

Activate the environment

  • For Windows:
    venv\Scripts\activate
    
  • For macOS and Linux:
    source venv/bin/activate
    

Install requirements

  • Install python libraries

    pip install -r requirements.txt
    
  • Install three.js

    To install the library you can run the automatic script threejs_setup.sh (for macOS and Linux) or download the zip from github or from the official page and extract the contents under the folder static/js/threejs

Migrate the database

python manage.py makemigrations api hpc_integration
python manage.py migrate

Configuration

The application requires a .env file with some environment variables defined.

An example file .env.example is provided.

The application also uses gunicorn as WSGI server. The configuration file gunicorn.conf.py.example is an example of how to configure it.

Please, copy the example file and update it according to your needs renaming the .env.example and gunicorn.conf.py.example files to .env and gunicorn.conf.py respectively.

Run application

There are multiple methods to launch the application:

  • Using the Django development server:

    python manage.py runserver
    
  • Using runsslserver for SSL support:

    python manage.py runsslserver
    
  • Using gunicorn for a production-like environment: First, ensure gunicorn is installed with pip install gunicorn.

    To launch in a test environment with gunicorn, run:

    gunicorn -c gunicorn.conf.py