{"id":25006702,"url":"https://github.com/agdamsbo/normalisation-pipeline","last_synced_at":"2026-02-02T15:04:24.828Z","repository":{"id":192915042,"uuid":"687180387","full_name":"agdamsbo/normalisation-pipeline","owner":"agdamsbo","description":"Normalising T1 weighted brain scans and lesions.","archived":false,"fork":false,"pushed_at":"2024-01-08T11:40:48.000Z","size":2968,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-05T01:51:17.587Z","etag":null,"topics":["fsl","mri-segmentation","stroke"],"latest_commit_sha":null,"homepage":"https://agdamsbo.github.io/normalisation-pipeline/","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/agdamsbo.png","metadata":{"files":{"readme":"README.md","changelog":"NEWS.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-09-04T20:03:21.000Z","updated_at":"2024-01-08T10:35:04.000Z","dependencies_parsed_at":null,"dependency_job_id":"60e834f7-0a08-49c0-ba89-c1f81645972d","html_url":"https://github.com/agdamsbo/normalisation-pipeline","commit_stats":null,"previous_names":["agdamsbo/normalisation-pipeline"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agdamsbo%2Fnormalisation-pipeline","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agdamsbo%2Fnormalisation-pipeline/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agdamsbo%2Fnormalisation-pipeline/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/agdamsbo%2Fnormalisation-pipeline/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/agdamsbo","download_url":"https://codeload.github.com/agdamsbo/normalisation-pipeline/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246258868,"owners_count":20748573,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["fsl","mri-segmentation","stroke"],"created_at":"2025-02-05T01:50:48.764Z","updated_at":"2026-02-02T15:04:19.796Z","avatar_url":"https://github.com/agdamsbo.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![DOI](https://zenodo.org/badge/687180387.svg)](https://zenodo.org/doi/10.5281/zenodo.10469422)\n\n\n# Data processing for brain and lesion normalisation\n\nThis pipeline was comprised as part of my exchange stay at the Brain Behavior Lab at UBC, Vancouver, Canada. It is my hope that the notes and script may be of help to others, myself being a new learner to FSL and everything around it.\n\nThe reason for creating this tool is to use 1mm MNI normalised lesion masks for the [NeMo tool](https://kuceyeski-wcm-web.s3.us-east-1.amazonaws.com/upload.html).\n\nMost of the hard working scripts in this pipeline are based on the work by [Dr. Dianne Patterson, PhD](https://neuroimaging-core-docs.readthedocs.io/en/latest/index.html). I have tried my best at modifying the original scripts as little as possible for clarity, and instead created a few new scripts to work as wrappers.\n\nThe pipeline provides a set of handy tools listed below, which I will also go through:\n\n-   R-script to organise files into subject-folders\n\n-   Shell pipeline to process all subject folders to extract brain mask, and normalise lesion mask to 1 mm MNI space (this is the primary content)\n\n-   Shell-script to normalise lesion mask after manual correction of brain mask (no, even using optiBET is not perfect)\n\n-   R-script to package lesion masks to supply to the NeMo tool.\n\n# Requirements\n\nYou need to have [fsl](https://fsl.fmrib.ox.ac.uk/fsl/fslwiki/FSL) as well as [*R*](https://www.r-project.org/) and [RStudio (or similar)](https://posit.co/downloads/) installed. I also highly recommend the package [ITK-SNAP](http://itksnap.org/pmwiki/pmwiki.php?n=Main.HomePage), which can be used for some (semi-)manual mask modifications.\n\n## Files required for each subject\n\nThe scripts needs a T1 weighted scan and lesion mask in Nifti format. Naming should be as follows.\n\n-   subjID_T1w.nii.gz\n-   subjID_LesionMask.nii.gz\n\n# Instructions\n\nStep-by-step documentation and notes are [provided here](https://agdamsbo.github.io/normalisation-pipeline/).\n\n# Source and acknowledgements\n\nScripts for normalization: [link](https://neuroimaging-core-docs.readthedocs.io/en/latest/pages/lesion_normalization.html)\n\nNeMo tool upload: [link](https://kuceyeski-wcm-web.s3.us-east-1.amazonaws.com/upload.html)\n\n## Notes on changes from the originals\n\n**fsl_anat_alt_bbl.sh**: It took me some time to figure out, I have to say. During the script, the working directory is changed. This makes referencing the optiBET_bbl.sh script a little tricky. I ended up going back a step with \"cd -\" and forward again after running optiBET_bbl.sh.\n\n# Licensing\n\nIf nothing else is explicitly stated en the relevant files, everything in the repository is licensed under the [AGPL-v3](https://www.gnu.org/licenses/agpl-3.0.en.html).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fagdamsbo%2Fnormalisation-pipeline","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fagdamsbo%2Fnormalisation-pipeline","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fagdamsbo%2Fnormalisation-pipeline/lists"}