Maintenance: Our production K8s cluster at JSC will be undergoing an update tonight, starting after 23:00 CEST. The cluster will be temporarily unavailable for approximately 20 minutes, and prod instances running at rke2-1-jsccloud may experience a brief downtime. Thank you for your understanding.


Last modified by lzehl on 2021/07/02 17:06
From version 67.1
edited by lzehl
on 2021/07/02 17:06
Change comment: There is no comment for this version
To version 43.1
edited by oschmid
on 2021/02/24 11:53
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -Metadata models and schemas
1 +Metadata models & schemas
Parent
... ... @@ -1,1 +1,1 @@
1 -Collabs.openminds.Documentation.WebHome
1 +Collabs.openminds.openMINDS core.WebHome
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.lzehl
1 +XWiki.oschmid
Content
... ... @@ -4,7 +4,7 @@
4 4  The openMINDS metadata models all consist of modular connectable metadata schemas. Each schema can be referenced by it's type and defines properties (including their expected value) for a set of related metadata.
5 5  
6 6  (% style="text-align: justify;" %)
7 -A short overview for each openMINDS metadata model can be found below, including links to full HTML descriptions for all schemas across all versions. Note that for some schemas, openMINDS provides also a library of controlled instances. The available controlled instances are listed in the HTML view for the respective schema.
7 +A short overview for each openMINDS metadata model can be found below, including links to full HTML descriptions for all schemas and links to available metadata instances for selected schemas.
8 8  
9 9  (% style="text-align: justify;" %)
10 10  Note that all metadata models are licensed under the MIT license.
... ... @@ -13,75 +13,145 @@
13 13  === openMINDS core ===
14 14  
15 15  (% style="text-align: justify;" %)
16 -The openMINDS core metadata model contains schemas that you can use to describe the general origin, resource location, and content of your research products in the field of neuroscience. Currently this metadata model comprises the following schemas (default: latest stable version):
16 +The openMINDS core metadata model contains schemas that can be used to describe the general origin, resource location, and content of research products in the field of neuroscience. Currently ( Feb 2021) this metadata model comprises 37 usable schemas, grouped into five classes:
17 17  
18 18  (% style="text-align: right;" %)
19 -(% class="small" style="color:#7f8c8d" %)Select a version and click on a schema to discover its full HTML description.
20 -{{html}}<iframe id="coreFrame" src="https://humanbrainproject.github.io/openMINDS/v2.0.0/core.html" width="100%" style="border:0; height: 35em"/>{{/html}}
19 +(% class="small" style="color:#7f8c8d" %)Click on a schema to discover its full HTML description.
20 +{{html clean="false"}}<span>
21 +<script>
22 +function resize(evt){
23 +alert('hello world');
24 +}
25 +</script>
21 21  
27 +<iframe src="https://humanbrainproject.github.io/openMINDS/core.html" width="100%" style="border:0; height: 28em" onload="resize"/>
28 +</span>{{/html}}
29 +
22 22  (% class="wikigeneratedid" style="text-align: justify;" %)
23 -For the schemas **##ContentType##**, **##License##**, and **##Protocol##**, openMINDS provides a library of controlled instances that were defined and reviewed by corresponding experts of the openMINDS development team (cf. also below). In particular within EBRAINS, the usage of these controlled instances increase the level of data integration inside the EBRAINS Knowledge Graph. Feel free to explore these instances (in the HTML view or on the GitHub) and make use them, inside or outside of EBRAINS.
31 +In case of EBRAINS, metadata representations (instances) of the schemas marked with an asterisk are centrally defined and maintained on a separate GitHub to guarantee more consistency across the database instances of the Knowledge Graph (cf. section openMINDS instances).
24 24  
25 25  (% class="wikigeneratedid" style="text-align: justify;" %)
26 -For further details or to review schemas of an older version of this metadata model, please check out the [[openMINDS core GitHub repository>>https://github.com/HumanBrainProject/openMINDS_core]].
34 +For details, contributing or reviewing examples please checkout as well the corresponding GitHub repository:
27 27  
36 +(% class="wikigeneratedid" %)
37 +[[https:~~/~~/github.com/HumanBrainProject/openMINDS_core>>https://github.com/HumanBrainProject/openMINDS_core||rel="noopener noreferrer" target="_blank"]]
38 +
28 28  === openMINDS SANDS ===
29 29  
30 30  (% style="text-align: justify;" %)
31 -The openMINDS SANDS (**S**patial **A**nchoring for **N**euroscience **D**ata **S**tructures) metadata model contains schemas that you can use to capture the anatomical location of your neuroscience data as well as to identify and highlight commonly used reference brain atlases and coordinate spaces. Currently this metadata model comprises the following schemas (default: latest stable version):
42 +The openMINDS SANDS (**S**patial **A**nchoring for **N**euroscience **D**ata **S**tructures) metadata model contains schemas that can be used to capture the anatomical location of neuroscience data as well as to identify and highlight commonly used reference brain atlases and coordinate spaces. Currently (Feb 2021) this metadata model comprises 12 metadata schemas:
32 32  
33 33  (% style="text-align: right;" %)
34 -(% class="small" style="color:#7f8c8d" %)Select a version and click on a schema to discover its full HTML description.
35 -{{html}}<iframe src="https://humanbrainproject.github.io/openMINDS/v2.0.0/SANDS.html" width="100%" style="border:0; height: 20em"/>{{/html}}
45 +(% class="small" style="color:#7f8c8d" %)Click on a schema to discover its full HTML description.
46 +{{html}}<iframe src="https://humanbrainproject.github.io/openMINDS/SANDS.html" width="100%" style="border:0; height: 8em"/>{{/html}}
36 36  
37 37  (% class="wikigeneratedid" style="text-align: justify;" %)
38 -For further details or to review schemas of an older version of this metadata model, please check out the [[openMINDS SANDS GitHub repository>>https://github.com/HumanBrainProject/openMINDS_SANDS]].
49 +For details, contributing or reviewing examples please checkout as well the corresponding GitHub repository:
39 39  
40 -=== openMINDS controlledTerms ===
51 +(% class="wikigeneratedid" %)
52 +[[https:~~/~~/github.com/HumanBrainProject/openMINDS_SANDS>>https://github.com/HumanBrainProject/openMINDS_SANDS]]
41 41  
54 +=== openMINDS controlledTerms - schemas ===
55 +
42 42  (% style="text-align: justify;" %)
43 -The openMINDS controlledTerms metadata model contains schemas that ensure consistent registration of well-defined terms, including linkages to existing ontological terms where applicable. Currently this metadata model comprises the following schemas (default: latest stable version):
57 +The openMINDS controlledTerms metadata model contains schemas that ensure consistent registration of well-defined terms, including linkages to existing ontological terms where applicable. Currently (Feb 2021) this metadata model comprises 38 nearly identical schemas:
44 44  
45 45  (% style="text-align: right;" %)
46 -(% class="small" style="color:#7f8c8d" %)Select a version and click on a schema to discover its full HTML description.
47 -{{html}}<iframe src="https://humanbrainproject.github.io/openMINDS/v2.0.0/controlledTerms.html" width="100%" style="border:0; height: 25em"/>{{/html}}
60 +(% class="small" style="color:#7f8c8d" %)Click on a schema to discover its full HTML description.
61 +{{html}}<iframe src="https://humanbrainproject.github.io/openMINDS/controlledTerms.html" width="100%" style="border:0; height: 25em"/>{{/html}}
48 48  
49 49  (% style="text-align: justify;" %)
50 -Except for **##TermSuggestion##**, the openMINDS controlledTerms metadata schemas differ only in their schema type which defines the terminology to which the correspondingly created metadata representations (instances) belong to.
64 +Except for TermSuggestion (marked with an asterisk), the openMINDS controlledTerms metadata schemas differ only in their type which defines the name of the terminology the correspondingly controlled terms are registered to (cf. openMINDS controlledTerms - terminologies).
51 51  
52 52  (% style="text-align: justify;" %)
53 -For all controlled terms schemas (except **##TermSuggestion##**), openMINDS provides a library of controlled instances that were defined and reviewed by corresponding experts of the openMINDS development team (cf. also below). In particular within EBRAINS, the usage of these controlled instances increase the level of data integration inside the EBRAINS Knowledge Graph. Feel free to explore these instances (in the HTML view or on the GitHub) and make use them, inside or outside of EBRAINS.
67 +Compared to these schemas, the TermSuggestion has one additional property ("terminology") where users can state to which terminology the new suggested (not yet controlled) term belongs to. Within the EBRAINS Knowledge Graph, the metadata representations for TermSuggestion will be regularly reviewed by the openMINDS development team in order to integrate these community driven suggestions into the controlledTerms terminologies and corresponding ontology (where applicable).
54 54  
55 -(% style="text-align: justify;" %)
56 -The **##TermSuggestion##** schema was introduced to facilitate community-driven requests for new controlled terms and respective instances for the properties **##"studyOption"##** and **##"studyTarget"##** (which needs are particularly difficult to predict). Correspondingly suggested metadata instances will be frequently evaluated and integrated as proper controlled instances on the GitHub repository be the openMINDS development team.
69 +(% class="wikigeneratedid" style="text-align: justify;" %)
70 +For details, contributing or reviewing examples please checkout as well the corresponding GitHub repository:
57 57  
58 -(% style="text-align: justify;" %)
59 -For further details or to review schemas of an older version of this metadata model, please check out the [[openMINDS controlledTerms GitHub repository>>https://github.com/HumanBrainProject/openMINDS_controlledTerms]].
72 +(% class="wikigeneratedid" %)
73 +[[https:~~/~~/github.com/HumanBrainProject/openMINDS_controlledTerms>>https://github.com/HumanBrainProject/openMINDS_controlledTerms]]
60 60  
61 -=== openMINDS computation ===
75 +=== openMINDS controlledTerms - terminologies ===
62 62  
63 -(% style="text-align: justify;" %)
64 -The openMINDS computation metadata model contains schemas that you can use to capture the provenance of simulations, data analysis and visualizations. Currently this metadata model comprises the following schemas (default: dev):
77 +The openMINDS instances repository holds a collection of metadata representations (instances) of selected schemas which content should be more controlled to ensure their consistent definition and usage for the entire EBRAINS Knowledge Graph. Currently the repository holds collections for the following schemas:
65 65  
66 66  (% style="text-align: right;" %)
67 -(% class="small" style="color:#7f8c8d" %)Select a version and click on a schema to discover its full HTML description.
68 -{{html}}<iframe src="https://humanbrainproject.github.io/openMINDS/v3/computation.html" width="100%" style="border:0; height: 20em"/>{{/html}}
80 +(% class="small" style="color:#7f8c8d" %)//**Coming soon:** //Click on a schema to discover its available instances.
69 69  
70 -(% class="wikigeneratedid" style="text-align: justify;" %)
71 -For further details or to review schemas of an older version of this metadata model, please check out the [[openMINDS computation GitHub repository>>https://github.com/HumanBrainProject/openMINDS_computation]].
82 +{{container layoutStyle="columns"}}
83 +(((
84 +(% class="small" %)
85 +AgeCategory
86 +AnatomicalAxesOrientation
87 +BehavioralTask
88 +BiologicalSex
89 +CellType
90 +ContributionType
91 +CriteriaQualityType
92 +DatasetType
93 +Disease
94 +DiseaseModel
95 +EthicsAssessment
96 +FileBundleGrouping
97 +FileUsageRole
98 +)))
99 +(((
100 +(% class="small" %)
101 +Genotype
102 +Language
103 +Laterality
104 +MetaDataModelType
105 +Modality
106 +ModelAbstractionLevel
107 +ModelScope
108 +OperatingDevice
109 +OperatingSystem
110 +Organ
111 +Phenotype
112 +PreparationType
113 +ProductAccessibility
114 +)))
115 +(((
116 +(% class="small" %)
117 +ProgrammingLanguage
118 +QualitativeOverlap
119 +SoftwareApplicationCategory
120 +SoftwareFeature
121 +Species
122 +Strain
123 +Technique
124 +Terminology
125 +TissueSampleType
126 +TypeOfUncertainty
127 +UnitOfMeasurement
128 +)))
129 +{{/container}}
72 72  
73 -=== openMINDS ephys ===
131 +=== openMINDS instances ===
74 74  
75 -(% style="text-align: justify;" %)
76 -(% style="color:#7f8c8d" %)(//**coming soon**//)
133 +The openMINDS instances repository holds a collection of metadata representations (instances) of selected schemas which content should be more controlled to ensure their consistent definition and usage for the entire EBRAINS Knowledge Graph. Currently the repository holds collections for the following schemas:
77 77  
78 -=== openMINDS instances ===
135 +(% style="text-align: right;" %)
136 +(% class="small" style="color:#7f8c8d" %)//**Coming soon:**// Click on a schema to discover its available instances.
79 79  
80 -(% style="text-align: justify;" %)
81 -For selected schemas, openMINDS provides a library of controlled instances that were defined and reviewed by corresponding experts of the openMINDS development team (cf. above). These instances are stored on the GitHub repository of the metadata model the respective schema belongs to. In particular within EBRAINS, the usage of these controlled instances increase the level of data integration inside the EBRAINS Knowledge Graph. Feel free to explore these instances (in the HTML view or on the GitHub) and make use them, inside or outside of EBRAINS.
138 +{{container layoutStyle="columns"}}
139 +(((
140 +(% class="small" %)
141 +contentType
142 +)))
143 +(((
144 +(% class="small" %)
145 +License
146 +)))
147 +(((
148 +(% class="small" %)
149 +DigitalIdentifierSchema
150 +)))
151 +{{/container}}
82 82  
83 -(% style="text-align: justify;" %)
84 -The libraries of these controlled instances will grow based on your feedback. If you miss an instance or terminology, feel free to make a corresponding request via our support email ([[openminds@ebrains.eu>>mailto:openminds@ebrains.eu]]) or raise an issue on the respective GitHub repository. Within EBRAINS, new controlled terms and respective instances for the properties **##"studyOption"##** and **##"studyTarget"##** (which needs are particularly difficult to predict) can also be made by filling out a **##TermSuggestion##** (cf. above).
153 +(% class="wikigeneratedid" style="text-align: justify;" %)
154 +For details, contributing or reviewing the openMINDS instances please checkout as well the corresponding GitHub repository:
85 85  
86 -(% style="text-align: justify;" %)
87 -All your request are reviewed regularly by the openMINDS development team, in order to integrate all community-driven suggestions (where applicable). In addition, your suggestions will be evaluated as possible extensions for the SciGraph ontologies, powered by the FAIR Data Informatics (FDI) Lab - SciCrunch Infrastrucutre and the INCF Knowledge Space team.
156 +(% class="wikigeneratedid" %)
157 +[[https:~~/~~/github.com/HumanBrainProject/openMINDS_instances>>https://github.com/HumanBrainProject/openMINDS_instances]]
Public

openMINDS