FINDVIZ is a browser-based visualization tool for visual exploration of fMRI data with a focus on pattern discovery. It supports the visualization of NIFTI, GIFTI, and CIFTI file formats, and time series data. Visualizations are produced using PlotlyJS.
🔗 Check out the documentation here: https://tsb46.github.io/fmri-findviz/
FINDVIZ supports volume and surface visualizations
Volume Navigation: Explore volumetric data with orthogonal and montage views
Surface Navigation: Interact with GIFTI and CIFTI data in 3D surface views
Time Course Navigation: Visualize synchronized physiological, experimental design, and other time series data alongside fMRI data.
pip install findvizTo launch the application and upload an fMRI dataset through the web interface, run the following command in your terminal:
findvizThis will launch the application in your default browser. FINDVIZ was tested on Google Chrome (v134). We recommend using Chrome for the best experience.
FINDVIZ also supports uploading fMRI data from the command line:
# Launch with NIFTI files
findviz --nifti-func func.nii.gz --nifti-anat anat.nii.gz
# Launch with GIFTI files
findviz --gifti-left-func left.func.gii --gifti-right-func right.func.gii --gifti-left-mesh left.surf.gii --gifti-right-mesh right.surf.gii
# Launch with CIFTI files
findviz --cifti-dtseries data.dtseries.nii --cifti-left-mesh left.surf.gii --cifti-right-mesh right.surf.gii
# Add time series data
findviz --nifti-func func.nii.gz --timeseries timeseries1.csv timeseries2.csv- Multi-format Support: Visualize NIFTI, GIFTI, and CIFTI neuroimaging data
- Interactive Visualization: Explore nifti data with orthogonal and montage views, and GIFTI and CIFTI data with 3D surface views
- Time Series Visualization: Visualize synchronized physiological, experimental design, and other time series data.
- Preprocessing Tools: Apply time course normalization, filtering, detrending, and spatial smoothing.
- Analysis Tools: Analysis functions for facilitating fMRI exploration and discovery
- Customizable Display: Adjust colormaps, thresholds, and visualization parameters
- State Management: Save and load visualization states
FINDVIZ supports the following neuroimaging data formats:
- NIFTI (.nii, .nii.gz): 3D and 4D functional and anatomical brain images
- GIFTI (.gii): Surface-based brain data for left and right hemispheres
- CIFTI (.dtseries.nii): Combined surface and volume data. Note, only the left and right hemisphere data is displayed.
- Time Series (.csv, .txt): Custom time course data for visualization alongside fMRI data
- Task Design (.csv, .tsv): Experimental design matrices for visualization alongside fMRI data
FINDVIZ user documentation is available on GitHub Pages:
https://tsb46.github.io/fmri-findviz/
The documentation includes:
- General overview and features
- File upload guide
- Navigation guide
- Preprocessing guide
- Analysis tools guide
You can access the documentation source in the docs/ directory.
-
FINDVIZ displays fMRI data in voxel coordinates, and does not support the overlay of images with different spatial resolutions, even in the same coordinate space (e.g. MNI152). Thus, anatomical and/or functional images should be resampled to the same resolution before uploading.
-
FINDVIZ is not a preprocessing tool. Preprocessing options are limited to options that faciliate visualization, including normalization, detrending, smoothing, and temporal filtering. For end-to-end preprocessing, we recommend using more comprehensive tools such as FMRIPREP.
- Python 3.10+
- Flask 3.0.3+
- Matplotlib 3.9.2+
- Nilearn 0.10.4+
- Plotly 5.23.0+
Contributions are welcome! Please feel free to submit a Pull Request.
This project is licensed under the MIT License - see the LICENSE file for details.
If you use FINDVIZ in your research, please cite:
Bolt, T. (2025). FINDVIZ: FMRI Interactive Navigation and Discovery Viewer.
https://github.com/tsb46/fmri-findviz