-
Notifications
You must be signed in to change notification settings - Fork 2
/
metadata.qmd
66 lines (50 loc) · 15 KB
/
metadata.qmd
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
# Metadata
All data is accompanied by metadata, or data about data and is important to every step in the FAIR principle;
- It makes data [Findable]{.underline} by being able to search for certain metadata 'chunks'.
- [Accessibility]{.underline} to the data is determined by or can be found in the metadata.
- It makes data [Interoperable]{.underline} so you can have your data operate with other systems, in our case a metadata explorer and our storage/distribution system.
- It describes the data in such a way that you can reliably [Re-use]{.underline} the data for your/their own research.
{width="400"}
Picture: [FAIR principles](https://www.ugent.be/img/doza/beleid/fair-data.png) / Patrick Hochstenbach / [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/)
::: {#guts-metadata}
## GUTS
The way that data is structured within GUTS results in metadata being present in three different ways.
- In the name of the file (file naming conventions can be found [here](https://eduardklap.github.io/guts-rdm/file-naming.html))
- In the folder location
- In an accompanying file (e.g. a .JSON file)
The table below presents an overview of all data types and where their metadata can be found.
::: {#metadata-table}
+----------------------+---------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------+
| <div> | **Data Type** | **Metadata** | **Metadata format** |
| | | | |
| **Data source** | | | |
| | | | |
| </div> | | | |
+----------------------+---------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------+
| EEG data | BioSemi Data Format (.bdf) | Can be found in the [**name of the file**]{.underline} (e.g. sub-guts-eur-001_ses-01_task-\[shortname\].bdf), or in the [**folder location**]{.underline} (e.g. data/sub-gutslei0001/anat/\*, meaning a file regarding the anatomical scans), or in an [**accompanying file**]{.underline} with the same name as the original file (e.g. sub-gutseur0001_ses-01_task-\[shortname\].json) | Filename, folder location, .json file |
+----------------------+---------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------+
| EEG tasks | E-Prime experiment file (.ebs) | \* | \* |
+----------------------+---------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------+
| EEG behavioral data | Tabular (.tsv) | Can be found in the [**name of the file**]{.underline} or in an [**accompanying file**]{.underline} with the same name. | Filename, .json file |
+----------------------+---------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------+
| MRI scans | NIfTI files (.nii.gz) | Can be found in the [**name of the file**]{.underline} (e.g. sub-gutseur0001_ses-01_inplaneT2.nii.gz), or in the [**folder location**]{.underline} (e.g. data/sub-gutslei0001/anat/\*, meaning a file regarding the anatomical scans), or in an [**accompanying file**]{.underline} with the same name as the original file (e.g. sub-gutseur0001_ses-01_inplaneT2.json) | Filename, folder location, .json file |
+----------------------+---------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------+
| fMRI tasks | E-Prime/OpenSesame/Presentation | \* | \* |
+----------------------+---------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------+
| fMRI behavioral data | NIfTI files (.nii.gz) | Can be found in the [**name of the file**]{.underline} (e.g. sub-gutseur0001_ses-01_task-\[shortname\]\_bold.nii.gz or task-\[shortname\]\_events.tsv), or in the [**folder location**]{.underline} (e.g. data/sub-gutseur0001/func/\*, meaning a file regarding the functional scans), or in an [**accompanying file**]{.underline} with the same name as the original file (e.g. sub-gutseur0001_ses-01_task-\[shortname\]\_bold.json) | Filename, folder location, .json file |
+----------------------+---------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------+
| ESM | Tabular (.tsv) | Can be found in the [**name of the file**]{.underline} (e.g. sub-gutseur0001_ses-01_task-\[shortname\]\_day-01.tsv), or in an [**accompanying file**]{.underline} with the same name (e.g. sub-gutseur0001_ses-01_task-\[shortname\]\_day-01.json). | Filename, .json file |
+----------------------+---------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------+
| Questionnaires | Tabular (.tsv) | Can be found in the [**name of the file**]{.underline} (e.g. guts-lei_ses-01_task-aiss.tsv), or in an [**accompanying file**]{.underline} with the same name (e.g. guts-lei_ses-01_task-aiss.json). | Filename, .json file |
+----------------------+---------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------+
| Hormonal data | Tabular (.tsv) | Can be found in the [**accompanying file**]{.underline} or in an [**accompanying file**]{.underline} with the same name. | Filename, .json file |
+----------------------+---------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------+
:::
How to create this metadata will be eplained in the page [How to convert your data to Yoda standards](https://eduardklap.github.io/guts-rdm/how-to-save-your-data.html)
:::
## Metadata Explorer
Metadata is shown in the [GUTS metadata explorer](https://guts-consortium.github.io/guts-explorer/) (currently a prototype version) and is divided in the following ways:
1. [General overview]{.underline} of the data including waves and general description.
2. [Participant information]{.underline} including *N,* number of dropouts and other general participant information per wave.
3. [Measure overview]{.underline} including measure name, category, description and type per measure and wave.
This explorer will include a [search function]{.underline} to find and select variables required for your research. These variables along with certain preset filters (age, wave, gender, etc.) can then be made into a package which and be requested for analysis.