Skip to content

Commit 4c1ab04

Browse files
bendichterbendichter
authored
Merge pull request #131 from NeurodataWithoutBorders/add_edu_page
Add page for Education resources
2 parents 1ddda3c + 99982ac commit 4c1ab04

File tree

6 files changed

+241
-8
lines changed

6 files changed

+241
-8
lines changed

‎config/_default/menus.yaml‎

Lines changed: 15 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -62,20 +62,24 @@ main:
6262
weight: 4
6363
url: "organizing-nwb-events/"
6464
parent: "Community"
65-
- name: "Extending NWB"
65+
- name: "Teaching with NWB"
6666
weight: 5
67+
url: "community/educators/"
68+
parent: "Community"
69+
- name: "Extending NWB"
70+
weight: 6
6771
url: "extending-nwb/"
6872
parent: "Community"
6973
- name: "Working Groups"
70-
weight: 6
74+
weight: 7
7175
url: "working-groups/"
7276
parent: "Community"
7377
- name: "Supporting NWB"
74-
weight: 7
78+
weight: 8
7579
url: "supporting-nwb/"
7680
parent: "Community"
7781
- name: "Team"
78-
weight: 8
82+
weight: 9
7983
url: "team/"
8084
parent: "Community"
8185

@@ -142,17 +146,20 @@ community_links:
142146
- name: "Organizing NWB Events"
143147
weight: 4
144148
url: "/organizing-nwb-events"
145-
- name: "Extending NWB"
149+
- name: "Teaching with NWB"
146150
weight: 5
151+
url: "/community/educators"
152+
- name: "Extending NWB"
153+
weight: 6
147154
url: "/extending-nwb"
148155
- name: "Working Groups"
149-
weight: 6
156+
weight: 7
150157
url: "/working-groups"
151158
- name: "Supporting NWB"
152-
weight: 7
159+
weight: 8
153160
url: "/supporting-nwb"
154161
- name: "Contact Us"
155-
weight: 8
162+
weight: 9
156163
url: "/contact-us"
157164

158165
resources:

‎content/community/educators.md‎

Lines changed: 78 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,78 @@
1+
---
2+
title: "Teaching with NWB"
3+
weight: 2
4+
layout: "educators"
5+
resources_teaching_data:
6+
enable: true
7+
title: "Teaching Neuroscience with Real Data"
8+
intro_md: |
9+
Use real NWB datasets and ready-to-run notebooks to teach neuroscience concepts. If you're interested in using NWB datasets to teach neuroscience concepts:
10+
11+
1. **Explore Available Datasets**: Identify datasets appropriate for your course level and topics.
12+
2. **Use Educational Resources**: Leverage ready-to-use notebooks and guides, e.g., NWB4EDU and the OpenScope Databook.
13+
3. **Start Small**: Begin with a single lab or homework assignment using pre-existing analysis notebooks.
14+
4. **Share Your Experience**: Contribute your teaching materials back to the community to help other educators.
15+
boxes:
16+
- title: "NWB4EDU: Teaching and Learning with NWB Datasets"
17+
content: "NWB4EDU is an online book aimed at educators and students, providing a collection of Jupyter notebooks and teaching materials to learn about the NWB data standard and how to work with NWB files. Useful for introductory courses, labs, and self-paced learning."
18+
image: "/images/community_gallery/nwb4edu.png"
19+
url: "https://nwb4edu.github.io/"
20+
- title: "OpenScope Databook"
21+
content: "An educational resource built on Jupyter Book that teaches students how to analyze brain data using NWB files. The databook includes interactive tutorials, code examples, and visualizations that guide learners through real neuroscience data analysis workflows. Useful for guided, hands-on analysis assignments and tutorials."
22+
image: "/images/community_gallery/openscope_databook.png"
23+
url: "https://alleninstitute.github.io/openscope_databook/"
24+
- title: "DANDI Archive"
25+
content: "Find and access open neurophysiology datasets in NWB for classroom use, labs, and projects across modalities (ephys, imaging, behavior). Useful for sourcing real datasets for assignments and projects."
26+
image: "/images/tools/dandi/dandi_screenshot_07_24_2022.png"
27+
url: "https://dandiarchive.org/"
28+
- title: "Community Gallery"
29+
content: "Examples of labs using NWB and related tools for conversion, analysis, and reuse, useful for case studies and inspiration."
30+
url: "/community/gallery/"
31+
32+
resources_teaching_fair:
33+
enable: true
34+
title: "Teaching FAIR Data and Software Practices"
35+
intro_md: |
36+
Use NWB to teach FAIR principles, data standardization, and software best practices. If you're interested in teaching open science, data management, and software best practices:
37+
38+
1. **Use NWB as a Case Study**: Demonstrate FAIR principles (Findable, Accessible, Interoperable, Reusable) using a well-defined standard.
39+
2. **Teach Data Standardization**: Show students how standardized formats enable data sharing and reuse across laboratories.
40+
3. **Explore the Open-Source Ecosystem**: Practice version control, documentation, and collaboration with community-maintained tools.
41+
4. **Review Training Materials**: Draw from curated workshop resources and examples.
42+
5. **Join the Community**: Connect with other educators through events and working groups.
43+
boxes:
44+
- title: "Training Materials"
45+
content: "Recordings, slides, and materials from workshops and events on NWB, data standardization, and best practices. Useful for lectures, flipped-class prep, and instructor planning."
46+
image: "/images/publications-citing.png"
47+
url: "/training-materials/"
48+
- title: "PyNWB Tutorials"
49+
content: "Interactive Python tutorials for reading, writing, and analyzing NWB files. These tutorials include beginner-friendly examples suitable for students new to scientific programming. Useful for Python-based labs and homework."
50+
url: "https://pynwb.readthedocs.io/en/stable/tutorials/index.html"
51+
- title: "MatNWB Tutorials"
52+
content: "MATLAB-based tutorials for working with NWB data. Ideal for courses already using MATLAB as a primary teaching language. Useful for MATLAB-based courses and labs."
53+
url: "https://neurodatawithoutborders.github.io/matnwb/"
54+
- title: "NWB YouTube Channel"
55+
content: "Video tutorials, webinars, and recorded training sessions covering various aspects of NWB. Useful for visual demos and asynchronous learning."
56+
url: "https://www.youtube.com/@NeurodataWithoutBorders"
57+
- title: "Core Tools"
58+
content: "A list of core NWB tools and libraries for working with NWB data in Python and MATLAB. These tools provide the necessary functionality for reading, writing, and analyzing NWB files. Useful for setting up course environments and student projects."
59+
url: "/tools/core/"
60+
- title: "Analysis Tools"
61+
content: "A list of analysis tools that support NWB data. These tools can be used to perform various types of data analysis and visualization on NWB files and are useful for advanced analysis projects and demonstrations."
62+
url: "/tools/analysis/"
63+
64+
disclaimer:
65+
enable: true
66+
content: "**Disclaimer:** Reference herein to any specific product, process, or service by its trade name, trademark, manufacturer, or otherwise, does not constitute or imply its endorsement, recommendation, or favoring by the NWB development team, United States Government or any agency thereof, or The Regents of the University of California. Use of the NeurodataWithoutBorders name for endorsements is prohibited."
67+
---
68+
69+
Open data and standardized formats like NWB are valuable resources for transforming neuroscience education by providing students with access to real, high-quality datasets from leading research laboratories. The NWB format offers several key advantages for educational settings:
70+
71+
- **Teach with Real Data**: Give students hands-on experience with actual experimental data from leading laboratories rather than simulated datasets
72+
- **Standardized Structure**: Students learn a consistent data format with rich metadata that they'll encounter in research settings
73+
- **Multi-Modal Data**: Access datasets combining electrophysiology, imaging, behavior, and other modalities in a single format
74+
- **Software Ecosystem**: Extensive tools and libraries for reading, writing, and analyzing NWB data in Python and MATLAB
75+
- **Promote Reproducibility**: Teach best practices in data management, documentation, and reproducible research from the start
76+
- **Community Support**: Active community providing documentation, tutorials, and support for educators and learners
77+
78+
The NWB team is committed to supporting educators. If you have questions about using NWB in your teaching or would like to discuss educational initiatives, please [contact us](/contact-us/).

‎content/community/gallery.md‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
---
22
title: "Community Gallery"
33
weight: 1
4+
layout: "gallery"
45
gallery_section:
56
enable: true
67
title: "Data Conversion"
@@ -38,6 +39,10 @@ analysis_section:
3839
- title: "Neuromatch-AJILE12"
3940
content: "A package for exploratory analysis of long-term naturalistic human intracranial neural recordings and pose data as part of Dandiset 000055."
4041
url: "https://github.com/neurovium/Neuromatch-AJILE12"
42+
- title: "NWB4EDU: Teaching and Learning with NWB Datasets"
43+
content: "NWB4EDU is an online book aimed at educators and students, providing a collection of Jupyter notebooks and teaching materials to learn about the NWB data standard and how to work with NWB files."
44+
image: "/images/community_gallery/nwb4edu.png"
45+
url: "https://nwb4edu.github.io/"
4146

4247
publications_section:
4348
enable: true

‎layouts/community/educators.html‎

Lines changed: 143 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,143 @@
1+
{{ define "main" }}
2+
<div class="community-educators">
3+
{{/* Hero Section */}}
4+
<section class="hero teamSect d-flex justify-content-center align-items-center position-relative"
5+
style="background: radial-gradient(#063053e5, #062e52e5), url('/images/essentials/aboutBg.png');">
6+
<h1 class="inter-700 text-48 text-white text-center z-4">{{ .Title | markdownify }}</h1>
7+
<div class="position-absolute ellipses">
8+
<img src="/images/essentials/ellipses.png" alt="" class="ellipseW">
9+
</div>
10+
</section>
11+
{{/* End Hero Section */}}
12+
13+
<section class="section bg-white">
14+
<div class="container-lg">
15+
<div class="row">
16+
<div class="col-12">
17+
{{ .Content }}
18+
</div>
19+
</div>
20+
</div>
21+
</section>
22+
23+
{{/* Resources: Teach with Real Data */}}
24+
{{ with .Params.resources_teaching_data }}
25+
{{ if .enable }}
26+
<section class="section bg-dark-100">
27+
<div class="container-lg">
28+
<h3 class="inter-700 text-40 dark-900 mb-3">{{ .title | markdownify }}</h3>
29+
{{ if .intro_md }}
30+
<div class="inter-400 text-16 dark-700 lh-base">{{ .intro_md | markdownify }}</div>
31+
{{ else }}
32+
<p class="inter-400 text-16 dark-700 lh-base">{{ .content | markdownify }}</p>
33+
{{ with .intro }}
34+
<div class="inter-400 text-16 dark-700 lh-base mt-2">{{ . | markdownify }}</div>
35+
{{ end }}
36+
{{ with .steps }}
37+
<ol class="inter-400 text-16 dark-700 lh-base ps-3 mt-2">
38+
{{ range . }}
39+
<li class="mb-1"><strong>{{ .title }}</strong>: {{ .content }}</li>
40+
{{ end }}
41+
</ol>
42+
{{ end }}
43+
{{ end }}
44+
<div class="row g-4 justify-content-center pt-4">
45+
{{ range .boxes }}
46+
<div class="col-12 col-md-6">
47+
<div class="bg-white h-100 rounded-3 p-4 shadow-sm">
48+
<div class="d-flex flex-row">
49+
{{ if .image }}
50+
<div class="me-4 flex-shrink-0">
51+
<a href="{{ .url }}" target="_blank">
52+
<img src="{{ .image }}" alt="{{ .title }}" class="rounded-3 gallery-card-image" style="width: 100px; height: 100px; object-fit: cover;" onerror="this.parentElement.parentElement.style.display='none';">
53+
</a>
54+
</div>
55+
{{ end }}
56+
<div class="flex-grow-1">
57+
<a href="{{ .url }}" class="text-decoration-none" target="_blank">
58+
<h5 class="inter-700 text-18 dark-900 mb-2 text-decoration-underline">{{ .title | markdownify }}</h5>
59+
</a>
60+
<p class="inter-400 text-14 dark-700">{{ .content | markdownify }}</p>
61+
</div>
62+
</div>
63+
</div>
64+
</div>
65+
{{ end }}
66+
</div>
67+
</div>
68+
</section>
69+
{{ end }}
70+
{{ end }}
71+
{{/* End Resources: Teach with Real Data */}}
72+
73+
{{/* Resources: Teach FAIR + Software Practices */}}
74+
{{ with .Params.resources_teaching_fair }}
75+
{{ if .enable }}
76+
<section class="section bg-white">
77+
<div class="container-lg">
78+
<h3 class="inter-700 text-40 dark-900 mb-3">{{ .title | markdownify }}</h3>
79+
{{ if .intro_md }}
80+
<div class="inter-400 text-16 dark-700 lh-base">{{ .intro_md | markdownify }}</div>
81+
{{ else }}
82+
<p class="inter-400 text-16 dark-700 lh-base">{{ .content | markdownify }}</p>
83+
{{ with .intro }}
84+
<div class="inter-400 text-16 dark-700 lh-base mt-2">{{ . | markdownify }}</div>
85+
{{ end }}
86+
{{ with .steps }}
87+
<ol class="inter-400 text-16 dark-700 lh-base ps-3 mt-2">
88+
{{ range . }}
89+
<li class="mb-1"><strong>{{ .title }}</strong>: {{ .content }}</li>
90+
{{ end }}
91+
</ol>
92+
{{ end }}
93+
{{ end }}
94+
<div class="row g-4 justify-content-center pt-4">
95+
{{ range .boxes }}
96+
<div class="col-12 col-md-6">
97+
<div class="bg-dark-100 h-100 rounded-3 p-4 shadow-sm">
98+
<div class="d-flex flex-row">
99+
{{ if .image }}
100+
<div class="me-4 flex-shrink-0">
101+
<a href="{{ .url }}" target="_blank">
102+
<img src="{{ .image }}" alt="{{ .title }}" class="rounded-3 gallery-card-image" style="width: 100px; height: 100px; object-fit: cover;" onerror="this.parentElement.parentElement.style.display='none';">
103+
</a>
104+
</div>
105+
{{ end }}
106+
<div class="flex-grow-1">
107+
<a href="{{ .url }}" class="text-decoration-none" target="_blank">
108+
<h5 class="inter-700 text-18 dark-900 mb-2 text-decoration-underline">{{ .title | markdownify }}</h5>
109+
</a>
110+
<p class="inter-400 text-14 dark-700">{{ .content | markdownify }}</p>
111+
</div>
112+
</div>
113+
</div>
114+
</div>
115+
{{ end }}
116+
</div>
117+
</div>
118+
</section>
119+
{{ end }}
120+
{{ end }}
121+
{{/* End Resources: Teach FAIR + Software Practices */}}
122+
123+
124+
{{/* Disclaimer Section */}}
125+
{{ with .Params.disclaimer }}
126+
{{ if .enable }}
127+
<section class="section bg-dark-100">
128+
<div class="container-lg">
129+
<div class="row">
130+
<div class="col-12">
131+
<div class="p-4 bg-white rounded-3">
132+
<p class="inter-400 text-14 dark-700 lh-base">{{ .content | markdownify }}</p>
133+
</div>
134+
</div>
135+
</div>
136+
</div>
137+
</section>
138+
{{ end }}
139+
{{ end }}
140+
{{/* End Disclaimer Section */}}
141+
142+
</div>
143+
{{ end }}

‎layouts/community/single.html‎ renamed to ‎layouts/community/gallery.html‎

File renamed without changes.

‎static/images/community_gallery/nwb4edu.png‎

43.9 KB
Loading

0 commit comments

Comments
 (0)