Skip to main content

Assistive tool to improve the quality control workflow of neuroimaging data.

Project description

VisualQC

VisualQC : assistive tool to ease the quality control workflow of neuroimaging data.

https://zenodo.org/badge/105958496.svg https://img.shields.io/pypi/v/visualqc.svg https://api.codacy.com/project/badge/Grade/2da8c2b4dbcd433eb4943eb52f0b00d6 docs/vqc_logo_small.png

Assessing and assuring the quality of imaging data, be it an raw acquisition (fMRI run or T1w MRI) or an automatic segmentation (be it gray or white surfaces for cortical thickness, or a subcortical segmentation) requires visual inspection manually. Not just one slice. Or one view. But many slices in all the views to ensure the 3d segmentation is accurate at the voxel-level. Often, looking at raw data is not sufficient to spot subtle errors, wherein statistical measurements (across space or time) assist greatly in rating the quality of image or severity of artefacts spotted.

This manual process, in its simplest form, is quite cumbersome and time-consuming. Without any assistive tool, it requires opening both the MRI and segmentation for one subject in an editor that can overlay and color them properly, and manually reviewing one slice at a time, navigate through many many slices, and record your rating in a spreadsheet. And repeat this process for multiple subjects. In some even more demanding tasks (such as assessing the accuracy of cortical thickness e.g. generated by Freesurfer, or in reviewing an EPI sequence), you may need to review multiple types of visualizations (such as surface-redering of pial surface or carpet plots with specific temporal stats in fMRI), in addition to voxel-wise data. Without an automatic tool, this logistics process allows too many human mistakes, esp. as you flip through 100s of subjects over many weeks jumping through multiple visualization software and spreadsheets. Moreover, with careful use of outlier detection technique on dataset-wide statistics (across all the subjects in a dataset) can help us identify subtle errors (such as a small ROI with unrealiastic thickness value) that would otherwise go undetected.

VisualQC, purpose-built for rigorous quality control, aims to reduce this laborious process to a single command to seamlessly present relevant composite visualizations while alerting user of any outliers, offer an easy way to record the ratings, and quickly navigate through 100s of subjects with ease. All you need to do is sit back, focus your expert eye on data and VisualQC takes care of the flow and bookkeeping.

Use-cases

VisualQC supports the following use cases:

  • Functional MRI scans (focused visual review, with rich and custom-built visualizations)

  • Freesurfer cortical parcellations (accuracy of pial/white surfaces on T1w mri)

  • Structural T1w MRI scans (artefact rating)

  • Accuracy of volumetric segmentation (ROI) against their anatomical/structural scan (T1w, T2w MRI)

  • Registration quality (spatial alignment) within a single modality or across multiple modalities

  • For your own important use case, feel free to contact me

  • Some others are being discussed - might be coming soon.

Features

Each use case aims to offer the following features:

  • Ability to zoom-in slices displayed to to ensure you won’t miss any detail (down to the voxel-level), so you can rate its quality with confidence.

  • Automatically detect and flag outliers during review (multivariate high-dimensional outlier detection)

  • Display multiple slices in multiple views, and easily navigate all subjects in a dataset

  • Keyboard shortcuts to speed up the process, no need to lift your fingers!

  • Allows to make arbitrary notes on the current review session

  • Allows you to customize the visualizations to your expert preference (such as removing certain overlays, control the transparency, change how two images blended together).

Galleries

Contributions are welcome.

Citation details

History

0.3 (2018-04-02)

  • Major update with multiple new use cases:

0.1 (2018-02-08)

  • Early access release on PyPI/github.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

visualqc-0.3.3-py3-none-any.whl (88.8 kB view details)

Uploaded Python 3

File details

Details for the file visualqc-0.3.3-py3-none-any.whl.

File metadata

File hashes

Hashes for visualqc-0.3.3-py3-none-any.whl
Algorithm Hash digest
SHA256 27489aaf4ee0bf1accbca6eda2d6e95f1d753ad4625cb52c67e373df54ba92a1
MD5 81193136898840cf8090a261990cc726
BLAKE2b-256 bb6516846a51faa40191050dcf4da22e4eeda80832950a5c5bd8f1fe460ba809

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page