Skip to content

Commit 606aa1f

Browse files
authored
Merge pull request #9 from HealthBioscienceIDEAS/8-intro-review-2026
8 intro review 2026
2 parents 3de9109 + c86dd75 commit 606aa1f

2 files changed

Lines changed: 52 additions & 42 deletions

File tree

episodes/imaging-data-structure-and-formats.Rmd

Lines changed: 47 additions & 37 deletions
Original file line numberDiff line numberDiff line change
@@ -370,13 +370,13 @@ This can result in complicated data that can be arranged in many different ways.
370370
Despite the structure of a neuroimaging study is fairly standard, so far there
371371
is no consensus on how to organize and share data obtained in neuroimaging
372372
experiments. The
373-
[Brain Imaging Data Structure (BIDS)](https://bids.neuroimaging.io/get_started.html)
373+
[Brain Imaging Data Structure (BIDS)](https://bids.neuroimaging.io/index.html)
374374
is a framework for organizing data in a standardized way.
375375
376376
The main specifications regard how to structure data/metadata within a
377377
hierarchy of folders and how to name files. The data you will use in this
378378
workshop will mostly be organized according to this standard. If you are
379-
interested, you can find the details of these specifications in the [BIDS starter kit](https://bids-standard.github.io/bids-starter-kit/index.html).
379+
interested, you can find the details of these specifications in the [BIDS starter kit](https://bids.neuroimaging.io/getting_started/index.html).
380380
381381
## Visualizing neuroimaging data - FSLeyes
382382
FSLeyes (pronounced **fossilize**) is the FSL image viewer for 3D and 4D data.
@@ -390,7 +390,7 @@ be likely to use throughout the workshop, while other more specific features
390390
will be introduced at a later point. If you are already familiar with FSLeyes,
391391
feel free to skip this part and move on to another section of the workshop.
392392
393-
For a full overview of what FSLeyes can do, take a look at the [FSLeyes user guide](https://open.win.ox.ac.uk/pages/fsl/fsleyes/fsleyes/userdoc/index.html).
393+
For a full overview of what FSLeyes can do, take a look at the [FSLeyes user guide](https://open.oxcin.ox.ac.uk/pages/fsl/fsleyes/fsleyes/userdoc/index.html).
394394
395395
### Getting started
396396
Assuming you are still in the `~/data/ImageDataVisualization` directory,
@@ -576,6 +576,7 @@ Now load in a second image (`sub-OAS30015_T1w_brain_pve_0.nii.gz`) using
576576
_File > Add from file_. This image is a tissue segmentation image of the
577577
cerebrospinal fluid. In the bottom-left panel is a list of loaded images
578578
- the _overlay list_.
579+
579580
![](fig/overlay_list_oasis.png){alt="Overlay list" height='150px'}
580581
581582
The overlay list shows the images which are currently loaded into FSLeyes.
@@ -711,10 +712,45 @@ Here are the screenshots you should see:
711712
:::::::::::::::::::::::::::::::::
712713
713714
For more information about the atlases available please refer to the
714-
[FSL Wiki](https://fsl.fmrib.ox.ac.uk/fsl/fslwiki/Atlases).
715+
[FSL Documentation](https://fsl.fmrib.ox.ac.uk/fsl/docs/other/datasets.html).
716+
715717
716718
Quit FSLeyes when you have finished looking at the atlases.
717719
720+
## Next steps
721+
In the [next episode on structural MRI](structural-mri.Rmd), we will learn how
722+
to align (register) the two images together to be able to look at the same
723+
point in the brain in both images.
724+
725+
## Stretch exercises
726+
If you have completed all of the above and want to keep working more on imaging structure and format, please try the [bonus exercises below](#bonus-exercises).
727+
728+
## Additional material
729+
For a more extensive tutorial on FSLeyes features, please refer to the
730+
[FSL course - FSLeyes practical](https://pages.fmrib.ox.ac.uk/fslcourse/practicals/intro1/index.html)
731+
732+
FSLeyes manual: https://open.oxcin.ox.ac.uk/pages/fsl/fsleyes/fsleyes/userdoc/index.html
733+
734+
## References
735+
* FSL course material: https://pages.fmrib.ox.ac.uk/fslcourse/website/online_materials.html
736+
* McCarthy, Paul. (2021). FSLeyes (1.2.0). Zenodo. https://doi.org/10.5281/zenodo.5504114
737+
* Michael Joseph, Jerrold Jeyachandra, and Erin Dickie (eds): "Data Carpentry: Introduction to MRI Data Analysis." Version 2019.11, November 2019,
738+
[https://github.com/carpentries-incubator/SDC-BIDS-IntroMRI](https://carpentries-incubator.github.io/SDC-BIDS-IntroMRI/open-mri-datasets/index.html)
739+
740+
::::::::::::::::::::::::::::::::::::: keypoints
741+
742+
- Images are sheets or cubes of numbers.
743+
- Medical image data is typically stored in DICOM or Nifti format. They include
744+
a header that contains information on the patient and/or the image characteristics.
745+
- An affine transformation maps the voxel location to real-world coordinates.
746+
- Medical image viewers allow to navigate an image, adjust contrast, and
747+
localise brain regions with respect to an atlas.
748+
749+
::::::::::::::::::::::::::::::::::::::::::::::::
750+
751+
## Bonus exercises
752+
If you have completed all of the above and want to keep working on this topic, please try the exercises below.
753+
718754
### BONUS EXERCISE: Viewing different imaging modalities
719755
So far we have seen examples of MRI T1-weighted scans (T1w). In research as
720756
well as in clinical setting, we acquire multiple imaging modalities from the
@@ -731,10 +767,10 @@ Let's take two imaging modalities from a different participant:
731767
`sub-OAS30003_T1w.nii.gz` and `sub-OAS30003_FLAIR.nii.gz`
732768
733769
::::::::::::::::::::::challenge
734-
*Do they have the same dimension?*
770+
*Do they have the same **dimension**?*
735771
736772
:::::::::::::::::::::: hint
737-
Use `fslhd` to get information on dimension and voxel size.
773+
Use `fslhd` to get information on dimension.
738774
::::::::::::::::::::::::::
739775
740776
:::::::::::::::::::::::: solution
@@ -747,18 +783,18 @@ image are 256 x 256 x 35.
747783
::::::::::::::::::::::::
748784
749785
::::::::::::::::::::::challenge
750-
*Do they have the same resolution?*
786+
*Do they have the same **resolution**?*
751787
752788
:::::::::::::::::::::: hint
753-
Use `fslhd` to get information on dimension and voxel size.
789+
Use `fslhd` to get information on voxel size.
754790
::::::::::::::::::::::::::
755791
756792
:::::::::::::::::::::::: solution
757793
**No**
758794
759795
From the same `fslhd` commands, the resolution can be found in
760796
the fields `pixdim1`, `pixdim2`, and `pixdim3`. For the T1 the resolution is
761-
1.20 x 1.05 x 1.05 mm. For the FLAIR it is 0.859 x 0.859 x 5.00mm
797+
1.20 x 1.05 x 1.05 mm. For the FLAIR it is 0.859 x 0.859 x 5.00 mm
762798
::::::::::::::::::::::::
763799
::::::::::::::::::::::::
764800
@@ -776,7 +812,7 @@ or by double clicking on the image name in
776812
the overlay list.
777813
778814
::::::::::::::::::::::challenge
779-
*Do they have the same orientation?*
815+
*Do they have the same **orientation**?*
780816
781817
:::::::::::::::::::::: hint
782818
Look at the location panel to help with information about orientation
@@ -787,6 +823,7 @@ Look at the location panel to help with information about orientation
787823
788824
In the bottom right panel you should see the warning:
789825
“Images have different orientations/fields of view”
826+
Even if the images were acquired from the same person in the same session, the position of the field of view is slightly different, so the images are not perfectly aligned. FSLeyes tries to align them as best as it can, but image registration is the analysis step that is usually needed if we want to align images.
790827
791828
::::::::::::::::::::::::
792829
::::::::::::::::::::::::
@@ -1104,31 +1141,4 @@ compliance with the BIDS standard:
11041141
::::::::::::::::::::::
11051142
::::::::::::::::::::::
11061143
1107-
## Next steps
1108-
In the [next episode on structural MRI](structural-mri.Rmd), we will learn how
1109-
to align (register) the two images together to be able to look at the same
1110-
point in the brain in both images.
1111-
1112-
## Additional material
1113-
For a more extensive tutorial on FSLeyes features, please refer to the
1114-
[FSL course - FSLeyes practical](https://open.win.ox.ac.uk/pages/fslcourse/practicals/intro1/index.html)
1115-
1116-
FSLeyes manual: https://open.win.ox.ac.uk/pages/fsl/fsleyes/fsleyes/userdoc/index.html
1117-
1118-
## References
1119-
* FSL course material: https://open.win.ox.ac.uk/pages/fslcourse/website/online_materials.html
1120-
* McCarthy, Paul. (2021). FSLeyes (1.2.0). Zenodo. https://doi.org/10.5281/zenodo.5504114
1121-
* Michael Joseph, Jerrold Jeyachandra, and Erin Dickie (eds): "Data Carpentry: Introduction to MRI Data Analysis." Version 2019.11, November 2019,
1122-
[https://github.com/carpentries-incubator/SDC-BIDS-IntroMRI](https://carpentries-incubator.github.io/SDC-BIDS-IntroMRI/open-mri-datasets/index.html)
1123-
1124-
::::::::::::::::::::::::::::::::::::: keypoints
1125-
1126-
- Images are sheets or cubes of numbers.
1127-
- Medical image data is typically stored in DICOM or Nifti format. They include
1128-
a header that contains information on the patient and/or the image characteristics.
1129-
- An affine transformation maps the voxel location to real-world coordinates.
1130-
- Medical image viewers allow to navigate an image, adjust contrast, and
1131-
localise brain regions with respect to an atlas.
1132-
1133-
::::::::::::::::::::::::::::::::::::::::::::::::
11341144

index.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -50,11 +50,11 @@ webinars ahead of time**. The links to the webinars and the slides are below.
5050

5151
| Webinar Title | Slides |
5252
| --- | --- |
53-
| [Data Structure and Formats](https://training.alz.org/products/4520/neuroimaging-pia-basics-of-neuroimaging-data-structure-and-formats) |[Slides](files/1_BasicsNeuroimaging_StructureFormat-Griffanti.pdf) |
54-
| [The Basics of Neuroimaging: Structural Magnetic Resonance Imaging (MRI)](https://training.alz.org/products/4524/neuroimaging-pia-the-basics-of-neuroimaging-structural-magnetic-resonance-imaging-mri) | [Slides](files/2_BasicsNeuroimaging_StructuralMRI-Cash.pdf) |
55-
| [Positron emission tomography (PET)](https://training.alz.org/products/4525/neuroimaging-pia-the-basics-of-neuroimaging-positron-emission-tomography-pet) | [Slides](files/3_BasicsNeuroimaging_PET-Betthauser.pdf) |
56-
| [Diffusion-Weighted Imaging (DWI)](https://training.alz.org/products/4526/neuroimaging-pia-the-basics-of-neuroimaging-diffusion-weighted-imaging-dwi) | [Slides](files/4_BasicsNeuroimaging_Diffusion_AlexaPB.pdf) |
57-
| [Functional Magnetic Resonance Imaging (fMRI)](https://training.alz.org/products/4528/neuroimaging-pia-the-basics-of-neuroimaging-functional-magnetic-resonance-imaging-fmri) | [Slides](files/5_BasicsNeuroimaging_Functional_Luigi.pdf) |
53+
| [Data Structure and Formats](https://istaart.alz.org/video/70) |[Slides](files/1_BasicsNeuroimaging_StructureFormat-Griffanti.pdf) |
54+
| [The Basics of Neuroimaging: Structural Magnetic Resonance Imaging (MRI)](https://istaart.alz.org/video/67) | [Slides](files/2_BasicsNeuroimaging_StructuralMRI-Cash.pdf) |
55+
| [Positron emission tomography (PET)](https://istaart.alz.org/video/66) | [Slides](files/3_BasicsNeuroimaging_PET-Betthauser.pdf) |
56+
| [Diffusion-Weighted Imaging (DWI)](https://istaart.alz.org/video/64) | [Slides](files/4_BasicsNeuroimaging_Diffusion_AlexaPB.pdf) |
57+
| [Functional Magnetic Resonance Imaging (fMRI)](https://istaart.alz.org/video/61) | [Slides](files/5_BasicsNeuroimaging_Functional_Luigi.pdf) |
5858

5959
At the workshop, we will all be using a standard environment, using a virtual machine (VM) hosted on the cloud. This ensures that everyone will be seeing the exact same screen for these lessons, regardless of if you are using a Mac or Windows operating system. You can find out more how to access this virtual machine below.
6060

0 commit comments

Comments
 (0)