feat: Add example with all ways of calculating TotalReadoutTime

Author: effigies

fmaps/README.md

@@ -0,0 +1,8 @@
+# EPI fieldmap metadata test
+
+The total readout time is necessary to translate between deflections
+in the magnetic field and displacements induced by susceptibility artifacts.
+
+There are several ways to calculate the total readout time, given a BIDS
+dataset, and this example exists to demonstrate them.
+In particular this dataset SHOULD NOT emit `TOTAL_READOUT_TIME_MUST_DEFINE` errors.

fmaps/dataset_description.json

@@ -0,0 +1,4 @@
+{
+  "BIDSVersion": "1.10.0",
+  "Name": "EPI fieldmap metadata test"
+}

fmaps/sub-01/fmap/sub-01_acq-EES_dir-AP_epi.json

@@ -0,0 +1,4 @@
+{
+  "PhaseEncodingDirection": "j",
+  "EffectiveEchoSpacing": 0.00059
+}

fmaps/sub-01/fmap/sub-01_acq-EES_dir-AP_epi.nii

@@ -0,0 +1,5 @@
+{
+  "PhaseEncodingDirection": "j",
+  "EchoSpacing": 0.00059,
+  "ParallelReductionFactorInPlane": 2
+}

fmaps/sub-01/fmap/sub-01_acq-ES_dir-AP_epi.json

@@ -0,0 +1,6 @@
+{
+  "PhaseEncodingDirection": "j",
+  "WaterFatShift": 9.227266,
+  "EPIFactor": 35,
+  "ImagingFrequency": 127.7325
+}

fmaps/sub-01/fmap/sub-01_acq-ES_dir-AP_epi.nii

@@ -0,0 +1,6 @@
+{
+  "PhaseEncodingDirection": "j",
+  "WaterFatShift": 9.227266,
+  "EPIFactor": 35,
+  "MagneticFieldStrength": 3
+}

fmaps/sub-01/fmap/sub-01_acq-Freq_dir-AP_epi.json

@@ -0,0 +1,4 @@
+{
+  "PhaseEncodingDirection": "j",
+  "TotalReadoutTime": 0.05
+}

fmaps/sub-01/fmap/sub-01_acq-Freq_dir-AP_epi.nii

@@ -0,0 +1,6 @@
+{
+  "TaskName": "rest",
+  "PhaseEncodingDirection": "j",
+  "TotalReadoutTime": 0.05,
+  "RepetitionTime": 2
+}