Skip to main content

Devices & Data Formats

Supported Devices

Neurosity Crown

The Neurosity Crown is an 8-channel consumer EEG headset. Channel locations map to the standard 10-05 montage:
  • Frontal: F5, F6 (lateral frontal)
  • Central: C3, C4 (motor cortex, left/right)
  • Parietal: CP3, CP4 (centro-parietal)
  • Occipital: PO3, PO4 (parieto-occipital)

Muse (Muse 2, Muse S)

The Muse headbands are 4-channel consumer EEG devices. Channel locations:
  • Temporal: TP9, TP10 (behind ears)
  • Frontal: AF7, AF8 (forehead, above eyebrows)

Data Formats

Input: Device CSV

The API accepts raw CSV data as a string. The CSV should contain:
  • A header row with channel names (and optionally a timestamp column)
  • Data rows with values in microvolts (µV)
The timestamp column is optional. If present, it’s ignored during processing — ZUNA uses the sample rate to reconstruct timing. But it’s useful for aligning with other data sources.

Output: JSON Channel Data

When output_format: "json", the response includes a channel_data object with per-channel arrays:
Each array contains output.n_samples values in microvolts (µV).

Output: CSV

When output_format: "csv", the response includes output.csv_content:
The timestamp_s column contains time in seconds from the start of the recording.

ZUNA Processing Details

What ZUNA Does

ZUNA (by Zyphra) is a foundation model for EEG signal processing. It was trained on large-scale EEG datasets to understand the structure of brain signals. Denoising removes:
  • Eye blink artifacts (frontal channels)
  • Muscle artifacts (jaw clenching, head movement)
  • Environmental noise (50/60 Hz line noise)
  • Electrode contact noise
While preserving:
  • Neural oscillations (alpha, beta, theta, gamma, delta)
  • Event-related potentials
  • Frequency-specific power patterns

Processing Pipeline

  1. CSV → FIF: Convert CSV to MNE RawArray with standard 10-05 montage
  2. Preprocessing: Resample to 256 Hz, bandpass filter, epoch into 5-second segments, normalize (std = 0.1)
  3. Inference: Run ZUNA model on GPU (diffusion-based denoising)
  4. Post-processing: Convert output tensors back to FIF, then to CSV/JSON

Key Constraints

Example: Duration Math