This application will create _SFB_-conform meta data (_meta.json_ files) for all participants in the _participants.tsv_ file of you your study. The _meta.json files_ will include the subjects _ID_, _sex_ and _age_. Moreover it is possible to register a template _meta.json_ file, which values will be adopted into the newly created meta-files.
This application will create _SFB_-conform meta data (_meta.json_ files) for all participants in the _participants.tsv_ file of you your study. The _meta.json files_ will include the subjects _ID_, _sex_, _age_ and _record-date_. Moreover it is possible to register a template _meta.json_ file, which values will be adopted into the newly created meta-files.
### Requirements
It is required to have a Java version greater or equal to 1.8.0 installed. You can download the current Java Corretto here: https://docs.aws.amazon.com/de_de/corretto/latest/corretto-11-ug/downloads-list.html
...
...
@@ -11,6 +11,7 @@ The _participants.tsv_ has to follow the this [standard](https://bids-specificat
-`participant_id`: The exact name of the subject folder. Usually this is composed of two parts: "sub-" and the _SFB code_. The _SFB code_ will be extracted and used as _Subject ID_. The _SFB code_ cannot contain hyphens.
-`sex`: Sex of the subject (_m\[ale] or f\[emale])_.
-`age`: Age of the subject (in years).
- if one also wants to transfer the record date to the meta.json files. Then this information has to be included in the participants.tsv file. For each existing session a column should appear. The naming scheme of the columns must be consistent. The SFB suggests the following pattern: `day-1`, `day-2`, ..., `day-n`
### GUI Usage
Input fields top down:
...
...
@@ -21,7 +22,13 @@ Input fields top down:
If not used, meta-files will be empty besides subject-_ID_, _sex_, _age_ and the name of the Study.
1. _meta.json - File selector:_
Select the template _meta.json_ file.
3. _Convert:_
3. _Include record date from participants.tsv_
If checked then the application tries to transfer the record date from the participants.tsv to the corresponding meta.json file. This only works when:
- the session prefix is defined. This is done with the first input field. This prefix should be "ses-" but may vary if the session are named differently.
- the participants.tsv coloumn name prefix is defined. This is done with the second input field. This is the prefix of column names in the participants.tsv file. This is optimally `day-`.
- the date is in format YYYY-mm-dd[T HH:MM]
4. _Convert:_
Starts _meta.json_ creation process. Once finished, a pop-up message will inform the user. If subjects defined in the _participants.tsv_ are non existing, a warning message will be displayed.
**Please keep in mind that this application overwrites any already created _meta.json_ files in the subjects modality folders**