Currently, at least within functional MRI, the specification has only one entity that typically distinguishes files from the same acquisition- echo. However, @tiborauer recently noted that this entity can be used for multi-echo fMRI (the standard use) and to separate single-echo acquisitions with different echoes, and the resulting files would have exactly the same names.
Part of the problem is that “run” is defined as “an uninterrupted repetition of data acquisition that has the same acquisition parameters and task”. Thus, it would be incorrect to increment the run entity across acquisitions of the single-echo BOLD scan, since the echo time is changing. This also highlights how “run” and “acquisition” aren’t quite synonyms.
Another part of the problem is that the echo entity doesn’t really have its own definition:
Multi-echo data MUST be split into one file per echo. Each file shares the same name with the exception of the _echo- key/value.
This says how users must label multi-echo data, but not how echo should be used in general. I think we should define echo as “within-acquisition”, so that, if the only thing that varies between files is that entity, those files can be assumed to come from the same acquisition. In cases of single-echo acquisitions with varying echo times, we should clarify that some other entity should distinguish the acquisitions, such as acq or run.
Given that #508 and #425 propose a number of new entities that refer to the same acquisition (or grouped scan collection, depending on how we define things), I think we should discuss the idea of a broader concept of “within-acquisition” and “between-acquisition” entities.
BTW, I know that I repeatedly said “acquisition” throughout this issue, but please see #529 about the idea of “grouped scan collections” and how that’s different from “acquisition”. I think that the within- and between- entities here would apply to those groups instead of specifically being limited to an “acquisition”.
Tagging @agahkarakuzu and @emdupre, with whom I talked about this in a call.
Currently, at least within functional MRI, the specification has only one entity that typically distinguishes files from the same acquisition- echo. However, @tiborauer recently noted that this entity can be used for multi-echo fMRI (the standard use) and to separate single-echo acquisitions with different echoes, and the resulting files would have exactly the same names.
Part of the problem is that “run” is defined as “an uninterrupted repetition of data acquisition that has the same acquisition parameters and task”. Thus, it would be incorrect to increment the run entity across acquisitions of the single-echo BOLD scan, since the echo time is changing. This also highlights how “run” and “acquisition” aren’t quite synonyms.
Another part of the problem is that the echo entity doesn’t really have its own definition:
This says how users must label multi-echo data, but not how echo should be used in general. I think we should define echo as “within-acquisition”, so that, if the only thing that varies between files is that entity, those files can be assumed to come from the same acquisition. In cases of single-echo acquisitions with varying echo times, we should clarify that some other entity should distinguish the acquisitions, such as acq or run.
Given that #508 and #425 propose a number of new entities that refer to the same acquisition (or grouped scan collection, depending on how we define things), I think we should discuss the idea of a broader concept of “within-acquisition” and “between-acquisition” entities.
BTW, I know that I repeatedly said “acquisition” throughout this issue, but please see #529 about the idea of “grouped scan collections” and how that’s different from “acquisition”. I think that the within- and between- entities here would apply to those groups instead of specifically being limited to an “acquisition”.
Tagging @agahkarakuzu and @emdupre, with whom I talked about this in a call.