- HTML 36.6%
- JavaScript 31.5%
- Python 25.4%
- CSS 6.2%
- Shell 0.3%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
|
Some checks failed
Deploy to Production / Deploying changes in production (push) Has been cancelled
|
||
| .github/workflows | ||
| api | ||
| hpc_integration | ||
| neural_circuit_visualizer | ||
| static | ||
| templates | ||
| .env.example | ||
| .gitignore | ||
| gunicorn.conf.py.example | ||
| log_cineca.sh | ||
| manage.py | ||
| README.md | ||
| requirements.txt | ||
| threejs_setup.sh | ||
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 folderstatic/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
runsslserverfor SSL support:python manage.py runsslserver -
Using
gunicornfor a production-like environment: First, ensuregunicornis installed withpip install gunicorn.To launch in a test environment with
gunicorn, run:gunicorn -c gunicorn.conf.py