NeuroMorph-Assessment README

The project's README from github.com/ruoyuw22-byte/NeuroMorph-Assessment. As one markdown file: README.md.

NeuroMorph Assessment (NMA)

Screenshot

NeuroMorph Assessment Overview

Overview

NeuroMorph Assessment (NMA) is an automated structural MRI morphometry and CAT12-based brain volume analysis system.

The software integrates MRI data organization, CAT12 processing, quantitative brain tissue measurement, visualization, and automated report generation into a unified workflow.

Key Features

Automated MRI Workflow

Quantitative Morphometry

NMA extracts structural measurements including:

The system includes quantitative consistency validation during result extraction.

Visualization and Reporting

Features include:

Workflow

MRI Data
   |
   v
Data Import
   |
   v
T1 Image Detection
   |
   v
CAT12 Processing
   |
   v
Tissue Segmentation
   |
   v
Volume Quantification
   |
   v
Visualization and Report

Project Structure

NeuroMorph-Assessment/

├── src/
│   ├── app.py
│   ├── ui.html
│   ├── NMAWebView.m
│   ├── launcher.sh
│   └── Info.plist
│
├── resources/
├── scripts/
├── examples/
├── docs/
├── requirements.txt
└── README.md

Software Requirements

NeuroMorph Assessment requires MATLAB together with SPM12 and CAT12 for structural MRI processing.

The software was developed and tested under the following environment:

Software Version


MATLAB R2022b SPM12 SPM12 CAT12 CAT12.8


MATLAB

MATLAB is required for running SPM12 and CAT12 neuroimaging pipelines.

Recommended version:

MATLAB R2022b

Official website:

https://www.mathworks.com/products/matlab.html


SPM12

SPM12 (Statistical Parametric Mapping) is a MATLAB-based neuroimaging analysis toolbox required by NeuroMorph Assessment.

SPM12 is used for:

Official download:

https://www.fil.ion.ucl.ac.uk/spm/software/spm12/

After installation, add the SPM12 directory to MATLAB:

addpath('/path/to/spm12')

spm('Defaults','fMRI')
spm_jobman('initcfg')

CAT12

CAT12 (Computational Anatomy Toolbox 12) is an extension toolbox for SPM12.

NeuroMorph Assessment uses CAT12 for:

Official website:

https://neuro-jena.github.io/cat/

Recommended installation structure:

spm12/
│
└── toolbox/
    │
    └── cat12/

Add CAT12 path in MATLAB:

addpath('/path/to/spm12')
addpath('/path/to/spm12/toolbox/cat12')

Configuration

Before running NeuroMorph Assessment, please ensure:

  1. MATLAB is correctly installed.
  2. SPM12 is available in MATLAB path.
  3. CAT12 is installed under the SPM12 toolbox directory.
  4. Required paths are correctly configured in the application.

Installation

Requirements:

Python dependencies are provided in:

requirements.txt

Usage

  1. Import MRI data.
  2. Configure analysis environment.
  3. Run the processing workflow.
  4. Review quantitative results.
  5. Generate reports.

Documentation

Additional documentation is available in:

docs/

Version

Current version:

v0.11.1

Citation

Citation information will be updated with the final publication or software registration information.

License

License information will be added after dependency review.

Acknowledgements

This project uses open-source neuroimaging tools including SPM12 and CAT12.

NeuroMorph-Assessment (ruoyuw22-byte/NeuroMorph-Assessment)

Searching Database…

这是什么?NeuroMorph Assessment(NMA)是一套自动化的结构 MRI 形态测量系统,把 CAT12 处理、脑组织定量、可视化和自动报告生成整合到同一个工作流中。
它是独立应用,还是要依赖其他软件才能真正工作?它是一个 Python 桌面应用,充当 MATLAB、SPM12 和 CAT12 的封装器和编排器——它本身不做 MRI 处理,而是驱动这些外部工具,然后负责可视化和报告。
怎么把它跑起来?安装 Python 3.x、带 SPM12 和 CAT12 的 MATLAB 以及 dcm2niix,然后导入 MRI 数据、配置分析环境、运行处理工作流、查看定量结果并生成报告。
要让它能工作,具体需要装好什么?需要 macOS、Python 3.x、MATLAB(SPM12 已加入 MATLAB 路径)、安装在 SPM12 之下的 CAT12 工具箱,以及用于 DICOM 转 NIfTI 的 dcm2niix。
它的安装轻便省事吗?不——它需要付费的 MATLAB 许可证,而且在应用能运行之前,还要手动安装并配置好路径的两个独立神经影像工具箱(SPM12 和 CAT12),所以安装过程繁重且技术性强。
它是为谁打造的?做结构脑 MRI 形态测量、已经在使用 SPM12/CAT12 流程、希望把整个工作流端到端自动化的研究人员和临床医生。
它只能在 macOS 上运行吗?是的,列出的要求中指定 macOS 为运行平台。
许可证定下来了吗?还没有——仓库的 GitHub 元数据目前标注的是 MIT,但 README 本身说许可条款仍在等待依赖审查。
它实际从 MRI 中提取哪些测量指标?它提取颅内总体积(TIV)、灰质体积、白质体积和脑脊液体积,并在提取过程中内置了一致性校验。
它能生成可分享的报告吗?能,它包含三平面 MRI 可视化、定量结果预览、处理进度监控,并在最后自动生成 PDF 报告。
我现在能在论文里引用它吗?还不行——README 说明,等正式发表或软件注册完成后会补充引用信息。
Size
1.5 MB
Stars
251
Age
1mo
Commits · 90 Days