Skip to content

Commit 2d73fbe

Browse files
satrasatra
committed
Merge remote-tracking branch 'origin/main'
* origin/main: Update README.md updated some model documentation
2 parents fcca06e + 7cb8927 commit 2d73fbe

File tree

2 files changed

+297
-0
lines changed

2 files changed

+297
-0
lines changed

‎README.md‎

Lines changed: 98 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -38,10 +38,108 @@ Want other specific resources included, add them here (or file an issue)
3838
* Do any of the existing platforms already do this?
3939
* Which comes closest?
4040

41+
42+
# Our Training Resource Description Model
43+
44+
Our current model (v_0.0.1) is expressed in YAML [here](model/model.yaml). A more human-readable version of that model is [here](model/model.md).
45+
46+
4147
# Project development (OHBM Hackathon)
4248

4349
OHBM 2025 - [project-ohbm-hackathon here](https://github.com/ohbm/hackathon2025/issues/7)
4450

51+
# Example Queries
52+
* I would like to find a 1 hour lecture to introduce git/github to novice first year graduate students in my Introduction to Computational Neuroscience course
53+
* I would like to find 1.5 hr multishell diffusion (dMRI) course video (in lecture style)
54+
* I would like to know whether the course depends on some installation requirements/ pre-requesites (other than skill level)
55+
* I would like to find a course on python that preps my undergraduate students for my neuroimaging with python class
56+
* I would like to find a 1-day workshop on "Introduction to Reproducible Neuroimaging" to provide to my lab of 20 members, who range from RA (data collection, data analysis) to clinical investigators.
57+
58+
* Can I find a hands-on tutorial for BIDS conversion of my DICOM data
59+
60+
### *By Skill Level or Prerequisites*
61+
62+
* “What beginner-level tutorials are available for fMRI analysis?”
63+
* “Are there any advanced courses that require experience with FreeSurfer?”
64+
65+
66+
### *By Software or Tool*
67+
68+
* “Show me all courses that use Python and AFNI.”
69+
* “Are there tutorials that involve SPM and are hands-on?”
70+
71+
72+
### *By Imaging Modality*
73+
74+
* “What training materials cover resting-state fMRI?”
75+
* “Any diffusion MRI (DWI) tutorials using open datasets?”
76+
77+
78+
### *By Format or Delivery*
79+
80+
* “What video-based tutorials are self-paced?”
81+
* “Are there instructor-led courses longer than 1 week?”
82+
83+
### *By Research Application*
84+
85+
* “Do you have any training focused on pediatric neuroimaging?”
86+
* “What resources are relevant for clinical research?”
87+
88+
89+
### *By Language or Accessibility*
90+
91+
* “Are there any Spanish-language courses on structural MRI?”
92+
* “Which tutorials include assessments or quizzes?”
93+
94+
95+
96+
## Example Use Stories
97+
98+
1. **New PhD Student**
99+
100+
“I’m just starting in a neuroimaging lab and I’ve never used FreeSurfer. I want a beginner-friendly, step-by-step guide in English, ideally with video or interactive examples. It should be focused on structural MRI.”
101+
102+
***Query:***
103+
* Level = Beginner
104+
* Software = FreeSurfer
105+
* Format = video OR tutorial
106+
* Modality = Structural
107+
* Language = English
108+
109+
2. **Clinical Neuroscientist Switching to Python**
110+
111+
“I’ve worked in clinical MRI research using SPM and MATLAB. I want to transition to Python and need resources on functional MRI analysis using open datasets.”
112+
113+
***Query:***
114+
* Software = SPM OR Python
115+
* Modality = Functional
116+
* Open dataset = Yes
117+
* Format = Hands-on / tutorial
118+
* Language = English
119+
120+
3. **Instructor Designing a Curriculum**
121+
122+
“I’m building a neuroimaging methods course and want to include diverse materials—lectures, blogs, tutorials—across beginner to advanced levels. I want content I can reuse, so open datasets are a plus.”
123+
124+
***Query:***
125+
Level = Beginner to Advanced
126+
Content format = Any
127+
Open dataset = Yes
128+
Delivery = Instructor
129+
130+
4. **International Learner**
131+
132+
“I’m a French-speaking student interested in learning about fMRI preprocessing using FSL.”
133+
134+
***Query:***
135+
* Language = French
136+
* Software = FSL
137+
* Modality = Functional
138+
139+
140+
141+
142+
45143
# Developer Documentation
46144

47145
## Frontend

‎model/model.md‎

Lines changed: 199 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,199 @@
1+
# TrainingProductsSchema
2+
3+
**Description:** A schema for tagged training products
4+
5+
## Classes
6+
7+
### TrainingProduct
8+
9+
**Description:** A training product with various attributes
10+
11+
#### Attributes
12+
13+
- **ID**
14+
- **Description:** ID
15+
- **Range:** string
16+
17+
- **Tag_Team**
18+
- **Description:** Tag Team
19+
- **Range:** string
20+
21+
- **Course_Name**
22+
- **Description:** Course Name
23+
- **Range:** string
24+
25+
- **URL**
26+
- **Description:** URL
27+
- **Range:** string
28+
29+
- **Level**
30+
- **Description:** Level
31+
- **Range:** Level_enum
32+
- **Options:**
33+
- Beginner
34+
- Intermediate
35+
- Advanced
36+
- NA
37+
38+
- **Platform**
39+
- **Description:** Platform
40+
- **Range:** Platform_enum
41+
- **Options:**
42+
- Mac
43+
- Windows
44+
- Linux
45+
- Docker
46+
- Jupyter
47+
- NA
48+
49+
- **Keywords**
50+
- **Description:** Keywords
51+
- **Range:** string
52+
53+
- **Course_Length**
54+
- **Description:** Course Length
55+
- **Range:** Course_Length_enum
56+
- **Options:**
57+
- <1 hr
58+
- 1-4 hrs
59+
- 1 day
60+
- 1-3 days
61+
- 1 week
62+
- 1+ weeks
63+
- NA
64+
65+
- **Instruction_Medium**
66+
- **Description:** Instruction Medium
67+
- **Range:** Content_format_enum
68+
- **Options:**
69+
- Hands-on tutorial / notebooks
70+
- lecture
71+
- video
72+
- notes
73+
- blog post
74+
- reference
75+
- slides
76+
- website
77+
- outline
78+
- meta-resource
79+
- Hybrid
80+
- NA
81+
82+
- **Delivery**
83+
- **Description:** Delivery
84+
- **Range:** Delivery_enum
85+
- **Options:**
86+
- self-paced
87+
- instructor
88+
- Discussion needed
89+
- NA
90+
91+
- **Language**
92+
- **Description:** Language
93+
- **Range:** Language_enum
94+
- **Options:**
95+
- English
96+
- French
97+
- Spanish
98+
- Chinese
99+
- Other
100+
- German
101+
- NA
102+
103+
- **Programming_Language**
104+
- **Description:** Programming Language
105+
- **Range:** Programming_language_enum
106+
- **Options:**
107+
- Python
108+
- R
109+
- shell scripting
110+
- Matlab
111+
- Git
112+
- NA
113+
114+
- **Neuroimaging_Software**
115+
- **Description:** Neuroimaging Software
116+
- **Range:** Neuroimaging_Software_enum
117+
- **Options:**
118+
- AFNI
119+
- SPM
120+
- FSL
121+
- Freesurfer
122+
- NA
123+
124+
- **Imaging_Modality**
125+
- **Description:** Imaging Modality
126+
- **Range:** Imaging_Modality_enum
127+
- **Options:**
128+
- DWI
129+
- Structural
130+
- Functional
131+
- Task-based
132+
- Resting-State
133+
- EEG
134+
- Behavioral
135+
- MEG
136+
- MRI
137+
- NA
138+
139+
- **Open_Dataset**
140+
- **Description:** Open Dataset
141+
- **Range:** Open_dataset_enum
142+
- **Options:**
143+
- Yes
144+
- No
145+
- NA
146+
147+
- **Last_Updated**
148+
- **Description:** Last Updated
149+
- **Range:** string
150+
151+
- **Functionality**
152+
- **Description:** Functionality
153+
- **Range:** string
154+
155+
- **Assessment**
156+
- **Description:** Assessment
157+
- **Range:** Assessment_enum
158+
- **Options:**
159+
- Yes
160+
- No
161+
- NA
162+
163+
- **Prerequisite**
164+
- **Description:** Prerequisite
165+
- **Range:** string
166+
167+
- **Source**
168+
- **Description:** Source
169+
- **Range:** string
170+
171+
- **Review**
172+
- **Description:** Review
173+
- **Range:** string
174+
175+
- **Exclude_from_ReproInventory**
176+
- **Description:** Exclude from ReproInventory
177+
- **Range:** Exclude_from_ReproInventory_enum
178+
- **Options:**
179+
- Yes
180+
- No
181+
- NA
182+
183+
- **Alias_Links**
184+
- **Description:** Alias Links
185+
- **Range:** string
186+
187+
- **Notes**
188+
- **Description:** Notes
189+
- **Range:** string
190+
191+
- **Quadrants**
192+
- **Description:** Quadrants
193+
- **Range:** Quadrants_enum
194+
- **Options:**
195+
- information-oriented (reference)
196+
- understanding-oriented (explanation)
197+
- learning-oriented (tutorials)
198+
- problem-oriented (how to guides)
199+
- NA

0 commit comments

Comments
 (0)