Skip to content

Commit

Permalink
DOC: Miscellaneous improvements and fixes to the file format table
Browse files Browse the repository at this point in the history
Miscellaneous improvements and fixes to the file format table
- Avoid adding an additional column and link to the format documentation
  using the names.
- Fix the DICOM format extension: leave it to `none` and add a note
  about its most typical extension (`.dcm`).
- Remove the unnecessary `nii.gz` and `mgh.gz` file extensions: add a
  note about cases where files have been compressed using an third-party
  tool (e.g. gzip).
- Do not use third-party links for the NIfTI format: use the official
  NIfTI format webiste for its link.
- Redirect to the DICOM format documentation instead of the general
  DICOM standard landing page.
- Add Gordon Kindlmann as the origin/creator of the `NRRD` format.
- Remove unnecessary whitespaces in cells.
- Apply the changes to the table to the Jupyter notebook.
  • Loading branch information
jhlegarreta committed Dec 21, 2024
1 parent 659646a commit 1bafe03
Show file tree
Hide file tree
Showing 2 changed files with 23 additions and 17 deletions.
18 changes: 11 additions & 7 deletions code/01-scanner-to-computer.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -11,13 +11,17 @@
"\n",
"## Neuroimaging file formats\n",
"\n",
"|Format Name | File Extension | Origin |\n",
"|---|---|---|\n",
"| DICOM | none | ACR/NEMA Consortium |\n",
"| Analyze | .img/.hdr | Analyze Software, Mayo Clinic |\n",
"| NIfTI | .nii | Neuroimaging Informatics Technology Initiative |\n",
"| MINC | .mnc | Montreal Neurological Institute |\n",
"| NRRD | .nrrd | |\n",
"| Format Name | File Extension | Origin/Group |\n",
"|-------------|----------------|--------------|\n",
"| [DICOM](https://www.dicomstandard.org/current) | none (*) | ACR/NEMA Consortium |\n",
"| [Analyze](https://eeg.sourceforge.net/ANALYZE75.pdf) | `.img`/`.hdr` | Analyze Software, Mayo Clinic |\n",
"| [NIfTI](https://nifti.nimh.nih.gov/) | `.nii` (**) | Neuroimaging Informatics Technology Initiative |\n",
"| [MINC](https://www.mcgill.ca/bic/software/minc) | `.mnc` | Montreal Neurological Institute |\n",
"| [NRRD](https://teem.sourceforge.net/nrrd/format.html) | `.nrrd` | Gordon L. Kindlmann |\n",
"| [MGH](https://surfer.nmr.mgh.harvard.edu/fswiki/FsTutorial/MghFormat) | `.mgz` or `.mgh` | Massachusetts General Hospital |\n",
"\n",
"(*) DICOM files typically have a `.dcm` file extension.\n",
"(**) Some files are typically compressed and their extension may incorporate the corresponding compression tool extension (e.g. `.nii.gz`).\n",
"\n",
"From the MRI scanner, images are initially collected in the DICOM format and can be converted to these other formats to make working with the data easier.\n",
"\n",
Expand Down
22 changes: 12 additions & 10 deletions episodes/scanner-to-computer.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,16 +58,18 @@ exercises: 10

<h6 id="fileformats"> Common file formats:</h6>

| Format Name | File Extension | Origin/Group | More info|
| ----------- | -------------- | --------------------------------------------- |-----------
| DICOM | none or `.dc` | ACR/NEMA Consortium |https://www.dicomstandard.org/ |
| Analyze | `.img`/`.hdr` | Analyze Software, Mayo Clinic |https://eeg.sourceforge.net/ANALYZE75.pdf|
| NIfTI | `.nii` (or `.nii.gz`) | Neuroimaging Informatics Technology Initiative|https://brainder.org/2012/09/23/the-nifti-file-format/|
| MINC | `.mnc` | Montreal Neurological Institute |https://www.mcgill.ca/bic/software/minc|
| NRRD | `.nrrd` | |https://teem.sourceforge.net/nrrd/format.html|
| MGH |`.mgz` or `.mgh` (or `.mgh.gz`) | Massachusetts General Hospital|https://surfer.nmr.mgh.harvard.edu/fswiki/FsTutorial/MghFormat|


| Format Name | File Extension | Origin/Group |
|-------------|----------------|--------------|
| [DICOM](https://www.dicomstandard.org/current) | none (*) | ACR/NEMA Consortium |
| [Analyze](https://eeg.sourceforge.net/ANALYZE75.pdf) | `.img`/`.hdr` | Analyze Software, Mayo Clinic |
| [NIfTI](https://nifti.nimh.nih.gov/) | `.nii` (**)| Neuroimaging Informatics Technology Initiative |
| [MINC](https://www.mcgill.ca/bic/software/minc) | `.mnc` | Montreal Neurological Institute |
| [NRRD](https://teem.sourceforge.net/nrrd/format.html) | `.nrrd` | Gordon L. Kindlmann |
| [MGH](https://surfer.nmr.mgh.harvard.edu/fswiki/FsTutorial/MghFormat) | `.mgz` or `.mgh` | Massachusetts General Hospital |

(*) DICOM files typically have a `.dcm` file extension.
(**) Some files are typically compressed and their extension may incorporate the corresponding
compression tool extension (e.g. `.nii.gz`).

From the MRI scanner, images are initially collected in the DICOM format and can be converted to these other formats to make working with the data easier.

Expand Down

0 comments on commit 1bafe03

Please sign in to comment.