From 6ab71309f8e8fced42afa11fdc9eed3a3d07027b Mon Sep 17 00:00:00 2001 From: Robert Smith Date: Tue, 23 Nov 2021 11:38:02 +1100 Subject: [PATCH] BEP016: Revise preprocessed DWI data example - Provide basic instructions rather than elaborating on rare use cases. - Remove JSON dictionary on preprocessing steps utilised as these relate to provenance and are therefore out of scope. Proposal for addressing bids-standard/bids-bep016#25. --- .../05-diffusion-derivatives.md | 51 ++++++++----------- 1 file changed, 20 insertions(+), 31 deletions(-) diff --git a/src/05-derivatives/05-diffusion-derivatives.md b/src/05-derivatives/05-diffusion-derivatives.md index e614e99d..022eb085 100644 --- a/src/05-derivatives/05-diffusion-derivatives.md +++ b/src/05-derivatives/05-diffusion-derivatives.md @@ -2,44 +2,33 @@ ## Preprocessed diffusion-weighted images -Multiple different versions of preprocessing can be stored for the same source -data. To distinguish them from each other, the `desc` filename keyword can be -used. Details of preprocessing performed for each variation of the processing -should be included in the pipeline documentation. +- As with [raw diffusion imaging data](../04-modality-specific-files/01-magnetic-resonance-imaging-data.md#required-gradient-orientation-information), + inclusion of gradient orientation information is REQUIRED. While + [the inheritance principle](../02-common-principles.md#the-inheritance-principle) + applies, it is common for DWI preprocessing to include rotation of + gradient orientations according to subject motion, so series-specific + gradient information is typically expected. + +- As per [file naming conventions for BIDS Derivatives](01-introduction.md#file-naming-conventions), + preprocessed DWI data must not possess the same name as that of the raw + DWI data. It is RECOMMENDED to disambiguate through use of the key-value + "`_desc-preproc`". + +- As per [common data types](02-common-data-types.md) for derivative data, a + JSON sidecar file is REQUIRED due to the REQUIRED `SkullStripped` field. + +Template: ```Text / sub-/ dwi/ - [_space-][_desc-