NeuroPulse is a high-end, immersive web application designed for the visualization and analysis of complex neural activity. Combining cutting-edge 3D graphics with real-time data telemetry, it provides a "Research Workstation" environment for exploring cognitive propagation patterns.
- Full-Screen Neural Mesh: A high-fidelity 3D brain model powered by Three.js and GLSL shaders.
- Real-Time Heatmaps: Dynamic vertex-based activity projection using custom fragment shaders.
- Interactive Depth: Full camera control (Rotate/Zoom/Pan) with the ability to interact with the simulation layer.
- 3-Column Docked Layout: A professional, structured interface for mission-critical analysis.
- Persistent Sidebars: Quick access to simulation parameters and regional activity insights.
- Telemetry Console: A dedicated bottom console for high-precision signal amplitude monitoring.
- Scenario Tuning: Toggle between different cognitive states: Neural Focus, Alpha Waves, and Motor Output.
- Amplitude Gating: Real-time filtering of neural signals based on activity intensity (All/Moderate/High).
- Variable Clock Speed: Adjust the simulation temporal scale from 0.1x to 3.0x.
- Framework: React 18 + Vite
- 3D Engine: @react-three/fiber + Three.js
- Animations: Framer Motion
- Styling: Tailwind CSS
- Charts: Recharts
- Icons: Lucide React
- Node.js (v18 or higher)
- npm or yarn
- Clone the repository:
git clone https://github.com/your-username/neuropulse.git cd neuropulse - Install dependencies:
npm install
- Start the development server:
npm run dev
src/
├── components/ # Reusable UI & 3D components
│ ├── BrainScene.tsx # Core 3D Brain & R3F Logic
│ ├── ControlPanel.tsx# Simulation HUD Controls
│ └── ...
├── hooks/ # Custom React Hooks
│ └── useNeuralActivity.ts # State machine for simulation
├── utils/ # Math & Simulation Helpers
│ ├── activitySimulator.ts # Neural logic engine
│ └── roiPositions.ts # Anatomical ROI coordinates
└── pages/ # Main application views
├── Landing.tsx # Cinematic entry point
└── Simulator.tsx # Professional workstation
MIT License - Copyright (c) 2026 NeuroPulse Project.
3D Brain Model: This work is based on "Brain Areas" (https://sketchfab.com/3d-models/brain-areas-d64608a3978b47d8a39c5a15795ca8c4) by Versal (https://sketchfab.com/versal) licensed under CC-BY-4.0 (http://creativecommons.org/licenses/by/4.0/)
Designed for the future of neuro-analysis and educational purposes.