Skip to content

Commit f57c8e4

Browse files
authored
Fixed previous front matter (#406)
1 parent 0706d2f commit f57c8e4

File tree

2 files changed

+94
-0
lines changed

2 files changed

+94
-0
lines changed
205 KB
Loading
Lines changed: 94 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,94 @@
1+
---
2+
type: "project" # DON'T TOUCH THIS ! :)
3+
date: "2025-06-19" # Date you first upload your project.
4+
# Title of your project (we like creative title)
5+
title: "Increasing Accessibility of BrainAGE Open Access Calculators"
6+
7+
# List the names of the collaborators within the [ ]. If alone, simple put your name within []
8+
names: [Jiya Shah, Eleanor Pak Wai Lam, Isabella Monaghan Chow, Khubaib Choudry]
9+
10+
# Your project GitHub repository URL
11+
github_repo: https://github.com/shahjiya/brainhack_brainage_project
12+
13+
# If you are working on a project that has website, indicate the full url including "https://" below or leave it empty.
14+
website:
15+
16+
# List +- 4 keywords that best describe your project within []. Note that the project summary also involves a number of key words. Those are listed on top of the [github repository](https://github.com/PSY6983-2021/project_template), click `manage topics`.
17+
# Please only lowercase letters
18+
tags: [BrainAGE, Calculator, Reproducibility, sMRI, R-tools]
19+
20+
# Summarize your project in < ~75 words. This description will appear at the top of your page and on the list page with other projects..
21+
22+
summary: "This project aims to increase the accessibility and reproducibility of open-access BrainAGE calculators. We developed RMarkdown documents designed to help standardize diverse structural MRI outputs into the specific formats required by different BrainAGE calculators. By simplifying these complex input requirements and centralizing these tools in a public GitHub repository, our work helps reduce technical barriers, enabling more researchers to easily leverage BrainAGE models in their neuroimaging studies and promote broader scientific use."
23+
24+
# If you want to add a cover image (listpage and image in the right), add it to your directory and indicate the name
25+
# below with the extension.
26+
image: "Normative brain age.png"
27+
---
28+
29+
## Project definition
30+
31+
### Background
32+
33+
#### Our group
34+
We are a group of MSc students from the Institute of Medical Science at the University of Toronto, conducting our thesis research in collaboration with the Centre for Addiction and Mental Health (CAMH). Although our individual projects examine diverse aspects of mental health through various methodologies, we share a strong collective interest in advancing research in this field.
35+
36+
#### Project background
37+
Normative brain age modelling is a technique that uses structural MRI (sMRI) data to estimate an individual’s brain age by comparing it to a normative reference group. The difference between predicted brain age and chronological age, known as the Brain Age Gap Estimate (BrainAGE),can provide insights into atypical brain aging or neurodegenerative risk. A number of open-access BrainAGE calculators have been developed, but they often differ in required input features, preprocessing steps, and anatomical atlases, making them difficult to use without specialized technical knowledge. This lack of standardization and unclear input requirements pose barriers to accessibility and reproducibility across studies.
38+
39+
### Tools
40+
41+
The project utilizes a range of tools and platforms to support development, reproducibility, and open dissemination:
42+
- R Programming Language: Core environment for data processing and script development.
43+
- RMarkdown: Integrates code, analysis, and narrative into reproducible documents.
44+
- Git & GitHub: Enables version control, collaborative development, and public access to project materials.
45+
- Visual Studio Code (VS Code): Integrated development environment for managing project files and workflows.
46+
- Targeted BrainAGE Models: Input standardization tools were developed for a variety of open-access calculators, including:
47+
Whole-brain models: NAPR, Developmental BrainAGE, Kauffman BrainAGE, and BrainAGE
48+
Region-/tissue-specific models: CentileBrain, Network-BrainAGE, and BrainChart.io
49+
50+
### Data
51+
This project uses normative neuroimaging data from the Reproducible Brain Charts initiative, specifically the Healthy Brain Network (HBN) subset. The HBN provides openly available, preprocessed structural MRI features from a large developmental cohort (ages 5–21).
52+
53+
### Deliverables
54+
55+
Our main deliverable is a publicly accessible GitHub repository housing all RMarkdown tools and documentation for standardizing BrainAGE calculator inputs.
56+
57+
## Results
58+
59+
### Progress overview
60+
61+
The final presentation of this project was delivered on May 30, 2025. All planned deliverables were completed and are available in the project’s GitHub repository. All scripts have been tested with the HBN dataset and are running successfully. Initial issues related to column matching and output formatting have been resolved.
62+
63+
### Tools we learned during this project
64+
65+
* Git & GitHub: Collaborating on RMarkdown scripts and resolving issues highlighted the critical role of Git. We gained hands-on experience using Git for version control and GitHub for team collaboration, particularly in troubleshooting and merging code.
66+
* Bash/Terminal: We developed proficiency in fundamental command-line operations (e.g., cd, ls, mkdir) for navigating directories, managing files, and organizing project outputs, which are skills essential for handling data and executing scripts efficiently.
67+
* R Programming: SFor some team members, this project was their first opportunity to use R extensively. It enabled us to learn and build skills in data wrangling, scripting, and applying R for more complex data manipulation and analysis within the project’s scope.
68+
69+
### Results
70+
71+
#### Deliverable: A GitHub Repository
72+
73+
We developed a suite of RMarkdown scripts to standardize and streamline data preparation for open-access BrainAGE calculators. These tools are publicly available in a centralized GitHub repository (github.com/shahjiya/brainhack_brainage_project), providing researchers with easy access to reproducible workflows and comprehensive documentation.
74+
75+
Key contributions include:
76+
77+
HBN RBC Data Preparation Guide: An RMarkdown document (HBN_data.Rmd) that presents a reproducible pipeline for downloading structural MRI data from the Healthy Brain Network Reproducible Brain Charts (HBN RBC) dataset, aggregating files into CSV format, and reformatting regional surface statistics to ensure compatibility with multiple brain atlases and BrainAGE models.
78+
79+
Calculator-Specific Data Wrangling Scripts: Seven RMarkdown scripts designed to transform demographic and MRI data into the precise input formats required by various BrainAGE calculators. These scripts automate column mapping, renaming, type conversions, and output generation to facilitate seamless integration. The scripts are: BrainAGE_regular.Rmd, Developmental_brain_age.Rmd, NAPR_analysis.Rmd, Network_BrainAGE.Rmd, brainchart.io.Rmd, centilebrain_template.Rmd, kauffman_brainage.Rmd
80+
81+
82+
## Conclusion
83+
This project lays the foundation for improving the accessibility and reproducibility of open-access BrainAGE calculators by standardizing input formats and simplifying data preparation. The tools can be adapted to other datasets or extended to additional BrainAGE models. Future work may include developing a web-based interface to further reduce technical barriers and expand the use of brain age modelling in neuroimaging research.
84+
85+
## Acknowledgement
86+
We would like to thank BrainHack School 2025 for organizing this course and creating a supportive learning environment. As a team with diverse coding experience, we faced many challenges along the way. We are especially grateful to our group members, course instructor, and TA for their patience, guidance, and encouragement throughout the project.
87+
88+
## References
89+
* Franke K, Ziegler G, Klöppel S, Gaser C. 2010. Estimating the age of healthy subjects from T1-weighted MRI scans using kernel methods: exploring the influence of various parameters. NeuroImage. 50(3):883–892. https://doi.org/10.1016/j.neuroimage.2010.01.005
90+
* Cole JH, Ritchie SJ, Bastin ME, Valdés Hernández MC, Muñoz Maniega S, Royle N, Corley J, Pattie A, Harris SE, Zhang Q, et al. 2018. Brain age predicts mortality. Mol Psychiatry. 23(5):1385–1392. https://doi.org/10.1038/mp.2017.62
91+
* Rokicki J, Wolfers T, Nordhøy W, Tesli N, Quintana DS, Alnæs D, Richard G, Lange AM, Lund MJ, Norbom LB, et al. 2021. Multimodal imaging improves brain age prediction and reveals distinct abnormalities in patients with psychiatric and neurological disorders. Hum Brain Mapp. 42(6):1714–1726. https://doi.org/10.1002/hbm.25323
92+
* Habes M, Pomponio R, Shou H, Doshi J, Mamourian E, Erus G, Nasrallah IM, Launer LJ, Rashid T, Bilgel M, et al. 2021. The Brain Chart of Aging: Machine-learning analytics reveals links between brain aging, white matter disease, amyloid burden, and cognition in the iSTAGING consortium. Alzheimers Dement. 17(1):89–102. https://doi.org/10.1002/alz.12178
93+
* Boyle R, Knight SP, de Lange AMG, Abe Y, Kievit RA. 2021. Brain-predicted age difference score is related to specific cognitive functions: a multi-site replication analysis. Brain Imaging Behav. 15(1):327–345. https://doi.org/10.1007/s11682-020-00321-9
94+

0 commit comments

Comments
 (0)