Medial Tractography Analysis (MeTA)
MeTA is a workflow implemented to minimize microstructural heterogeneity in diffusion MRI (dMRI) metrics by extracting and parcellating the core volume along the bundle length in the voxel-space directly while effectively preserving bundle shape and efficiently capturing the regional variation within and along white matter (WM) bundles.
Contact: Iyad Ba Gari iyad.bagari@usc.edu
If you use MeTA code, please cite the following publication:
- Ba Gari, I., et al.: Heritability and Genetic Correlations Along the Corticospinal Tract. International Workshop on Computational Diffusion MRI. Cham: Springer Nature Morocco, 2024
- Ba Gari, I., et al.: Along-tract parameterization of white matter microstructure using medial tractography analysis (MeTA). In: The 19th International Symposium on Medical Information Processing and Analysis (2023)
Installation
MeTA supports Python version >=3.11 and <3.14. Using pip:
pip install meta-neuro
Using Bioconda:
conda config --add channels bioconda
conda install bioconda::meta-neuro
Usage
## Using DSI Studio transforms:
# Compute density map and convert streamlines to a binary image:
density_map --tractogram subject_CST.tt.gz --reference subject_FA.nii.gz \
--output "output_dir/subjectID_CST.nii.gz"
# Medial Tractography Analysis (MeTA):
meta --subject "subjectID_12345" --bundle "CST" \
--mbundle "model_CST.tt.gz" --sbundle "subject_CST.tt.gz" \
--mask "output_dir/subjectID_CST.nii.gz" \
--warp "subjectID.1InverseWarp.nii.gz" --warp_source "dsi_studio" \
--seg_method "hyperplane" --num_segments 15 --output "output_dir"
# Extract Voxel-based Bundle Profile: Compute volumetric profile for DTI maps e.g., FA, MD, RD, AD, etc. Output two files: 1) *_segments_average.csv file with the average profile along the bundle length, and 2) *_segments_voxelwise.h5 (with option `--voxelwise `): the profile for each voxel in the bundle.
volumetric_profile --subject "subjectID_12345" --bundle "CST" --mask CST_local_all.nii.gz --map subject_FA.nii.gz --output "output_dir"
# Extract Streamline-based Profile: Compute streamline profile based on tractography and DTI maps e.g., FA, MD, RD, AD, etc. output two files: 1) *_streamlines_average.csv file with the average profile along the bundle length, and 2) *_streamlines_pointwise.h5 (with option `--pointwise `): the profile for each point of streamline.
streamlines_profile --subject "subjectID_12345" --bundle "CST" --tractogram "subject_CST.tt.gz" --mask CST_local_all.nii.gz --map subject_FA.nii.gz --output "output_dir"
# Extract Bundle Shape Features: Bundle shape features implemented based on Yeh et al., 2020. The following features are extracted: Total number of streamlines, Average streamlines length, Span, Curl, Volume, Surface area, Diameter, Elongation, Irregularity
shape_metrics --subject "subjectID_12345" --bundle "CST" --mask CST_local_all.nii.gz --tractogram "subject_CST.tt.gz" --output CST_streamlines_metrics.csv
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file meta_neuro-2.1.1.tar.gz.
File metadata
- Download URL: meta_neuro-2.1.1.tar.gz
- Upload date:
- Size: 28.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
fe73b09084f35a2ecf0214e63ed0833abc4d085850614d44a0563b2e66bfd402
|
|
| MD5 |
3c07e52a6d720a3c4cf544e849301c10
|
|
| BLAKE2b-256 |
a7cafbbe2138e70685b023a58edc0d2b3b2ae7dd1b26c3689dc5b896a97ead08
|
Provenance
The following attestation bundles were made for meta_neuro-2.1.1.tar.gz:
Publisher:
release.yml on bagari/meta
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
meta_neuro-2.1.1.tar.gz -
Subject digest:
fe73b09084f35a2ecf0214e63ed0833abc4d085850614d44a0563b2e66bfd402 - Sigstore transparency entry: 2208782531
- Sigstore integration time:
-
Permalink:
bagari/meta@e7bf80c4067d191e4a6f161860726b0e9a804e00 -
Branch / Tag:
refs/tags/v2.1.1 - Owner: https://github.com/bagari
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@e7bf80c4067d191e4a6f161860726b0e9a804e00 -
Trigger Event:
release
-
Statement type:
File details
Details for the file meta_neuro-2.1.1-py3-none-any.whl.
File metadata
- Download URL: meta_neuro-2.1.1-py3-none-any.whl
- Upload date:
- Size: 34.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
65b69c7305d36aa7147c40bf7251f0d17c1c8d0c06d8caa135158557ab62eb8b
|
|
| MD5 |
304cbdc299813876a996003324a023bb
|
|
| BLAKE2b-256 |
32c17d9e143f5e14fecaa11a5e54cf80b4f3046835ac5c27f358490a08b2e418
|
Provenance
The following attestation bundles were made for meta_neuro-2.1.1-py3-none-any.whl:
Publisher:
release.yml on bagari/meta
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
meta_neuro-2.1.1-py3-none-any.whl -
Subject digest:
65b69c7305d36aa7147c40bf7251f0d17c1c8d0c06d8caa135158557ab62eb8b - Sigstore transparency entry: 2208782560
- Sigstore integration time:
-
Permalink:
bagari/meta@e7bf80c4067d191e4a6f161860726b0e9a804e00 -
Branch / Tag:
refs/tags/v2.1.1 - Owner: https://github.com/bagari
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@e7bf80c4067d191e4a6f161860726b0e9a804e00 -
Trigger Event:
release
-
Statement type: