File formats
Connectivity matrices
CSV
Square n×n numeric matrix, comma-separated. No header row required. Values are edge weights (correlation, partial correlation, or binary adjacency).
Example (5×5 binary):
0,1,1,0,1
1,0,1,1,0
1,1,0,1,0
0,1,1,0,1
1,0,0,1,0
NPZ / NumPy
- NPZ: array stored under key
matrix,conn, orW, or as the sole array in the archive - NPY: single 2D array file
MATLAB .mat
Variable named matrix, conn, or W containing a square numeric array.
EEG / MEG
EDF (.edf)
European Data Format multi-channel recording. Channel count and sampling rate detected on import.
BrainVision (.vhdr)
Upload the header file; companion .eeg and .vmrk files should be in the same directory on the server after upload.
EEGLab (.set)
MATLAB structure exported from EEGLab.
fMRI
NIfTI (.nii, .nii.gz)
Preprocessed BOLD timeseries in standard neuroimaging format. Used by functional connectivity and dynamic FC pipelines.
BIDS ZIP
ZIP archive of a BIDS-compliant dataset. Must include dataset_description.json and subject/session folder structure. Run Validate BIDS before FC analysis.
Subject metadata CSV
| Column | Required | Purpose |
|---|---|---|
external_id | Yes | Subject identifier (S001, …) |
age, sex, diagnosis, group_label | No | Standard cohort fields |
| Any other columns | No | Stored as flexible metadata |
Task events (BIDS .tsv)
Uploaded in the Task GLM panel on an fMRI dataset.
| Column | Required | Purpose |
|---|---|---|
onset | Yes | Event onset (seconds) |
duration | Yes | Event duration (seconds) |
trial_type | Yes | Condition label |
Registry CSV (atlas / montage)
Uploaded on the Atlas & montage registry page (/areas/neurology/registry); validated on upload.
Custom atlas CSV:
| Column | Required | Purpose |
|---|---|---|
label | Yes | Region name (unique) |
x, y, z | Yes | MNI centroid (mm) |
hemisphere, network | No | Region grouping metadata |
Custom montage CSV:
| Column | Required | Purpose |
|---|---|---|
name | Yes | Channel name (unique) |
x, y | Yes | Sensor position |
z | No | 3D position component |
Artifact outputs
Pipeline results are JSON files under data/neuro/artifacts/{run_id}/:
| Artifact | Contents |
|---|---|
metrics.json | Global and per-node graph metrics |
connectivity_matrix.json | Processed matrix for visualization |
eeg_features.json | Band power and connectivity summaries |
nbs_report.json | NBS significant components |
interpretation.json | AI interpret output |
Size guidance
| Data type | Approx. size |
|---|---|
| 200×200 connectivity matrix CSV | ~1 MB |
| Resting-state fMRI NIfTI (preprocessed) | 50–500 MB |
| High-density EEG (1 h @ 256 Hz) | 50–200 MB |
Large uploads are processed on the server; the frontend renders downsampled previews and summary statistics only.