Waveform is a browser-based GUI for working with extra-neuronal tetrode waveform data. Drop in a folder of LTX files (.set, .pos, tetrode and cut files) to see every cell's waveforms, feature-space projections, rate maps, tuning and temporal/spatial autocorrelograms, then merge, split, paint and relabel cells and export the cut.
Open Waveform, or try it with the simulated data on its start screen.
The cluster pane's feature-space buttons switch between peak-to-trough amplitudes (waveform/height icon) and the first four principal components of the combined four-channel waveform (point-cloud/axes icon), showing all six pairings. PCA uses a bounded sample for fitting and projects every spike; its sample size is configurable in Settings. Brush, lasso and source picking work in either feature space.
Press Q to switch amplitudes/principal components, and L to switch brush/lasso. The shared colour control selects fixed cell colours, density, or drift for both waveforms and cluster plots; P cycles forwards and Shift+P backwards. Density uses the same colour ramp in both views.
The palette button at the left of the cluster toolbar locks those plots to fixed cell colours. Turn it off to follow the main colour control again.
Waveform density uses v1's shared tetrode-wide scale, so colours can be compared across cells.
The Waveform icon opens a file menu: Add folder…, Add files…, and Clear files. Adding files preserves the current workspace; clearing returns straight to the start screen.
Warning
This version (October 2026) was rebuilt with AI under human oversight. It likely still has bugs and feature gaps that are being ironed out. The previous version is on the waveform-v1 branch.
The engine is Rust compiled to WebAssembly (core/), running in a Web Worker; the interface is React and TypeScript, built with Vite and drawn with WebGL2. See docs/ARCHITECTURE.md for how the pieces fit together.
With Node 24 and stable Rust:
rustup target add wasm32-unknown-unknown
npm ci
npm run build:wasm
npm run dev # http://localhost:5173Checks:
npm run lint
npm run test:rust
npm test # unit tests (Vitest)
npm run build
npx playwright install chromium
npm run test:e2e # browser tests (Playwright)The default browser stress test uses 1M spikes. To opt into the 9M case, run WAVEFORM_STRESS_9M=1 npm run test:e2e -- e2e/synthetic.spec.ts; it is skipped in ordinary runs and CI.
GitHub Actions runs these checks on pull requests and pushes to main, and deploys main to GitHub Pages. Manual workflow runs are also available.
MIT licence.