Wiki source code of test-ir2

Version 147.1 by ingrreit on 2023/06/05 09:24

Show last authors
1 == Publishing neuroscience data, models and software via EBRAINS ==
2
3
4 (% class="wikigeneratedid" %)
5 The aim of this collab is to provide you with detailed information about publishing data, simulations, computational models, and software via EBRAINS. If you want a quick overview of the sharing process, see [[https:~~/~~/ebrains.eu/service/share-data>>https://ebrains.eu/service/share-data]].
6
7 {{box title="**Contents**"}}
8 {{toc depth="3" start="2"/}}
9 {{/box}}
10
11
12 == **Information to get started** ==
13
14 **Get started! [[REQUEST CURATION>>https://nettskjema.no/a/277393#/]] to share data, simulations, computational models, and software, - or a new version of an existing one. **
15
16 Have you already published your data somewhere else? You can increase the exposure and impact of your shared dataset by also listing it on EBRAINS.
17
18
19 Search existing data, models and software in [[the EBRAINS Knowledge Graph Search>>https://kg.ebrains.eu/search/?facet_type[0]=Dataset]]
20
21
22 EBRAINS accepts data from all modalities and from all species, as well as models, software, web services and metadata models (collectively referred to as research products) for sharing. You'll find detailed information about how to share each research product below. 
23
24
25 (% class="box infomessage" %)
26 (((
27 We strongly recommend to **start preparing for data sharing as early as possible**. With a structured data repository and adequate notes on how the data was acquired, you greatly minimize the effort required to publish your data. The time it takes to share data on EBRAINS heavily depends on on the engagement from the researcher and how well the data and metadata is prepared before-hand. Contact us for personalised guidance on how to prepare for sharing.
28 )))
29
30 (% class="box successmessage" %)
31 (((
32 **Particular needs? Contact us! **The workflows for sharing can be modified for researchers or research groups aiming to frequently publish larger numbers of their research products through EBRAINS. Please contact the curation service team in such cases
33 )))
34
35 ----
36
37 == **The EBRAINS curation process** ==
38
39 (% class="box successmessage" %)
40 (((
41 EBRAINS accepts **experimental data,** of all modalities and from all species, **models**, **software**, **web services **and **metadata models**. You'll find detailed information about each research product below.
42 )))
43
44 In EBRAINS, multimodal and heterogenous neuroscience data, models and software are categorised and described in a standardised manner so that they can be effectively searched, compared, and analysed. This effort is referred to as curation. 
45
46 >The EBRAINS curation process involves organising and annotating neuroscientific data to make the data discoverable and reusable.
47
48 Behind this process is the EBRAINS Curation team. Our mandate is to support you in sharing your data in line with the [[**FAIR principles**>>https://www.go-fair.org/fair-principles/]], whether you choose to describe only the key aspects of your data, or can invest in adding more detailed metadata.
49
50 Curated data, models and software are made available in the [[the EBRAINS Knowledge Graph>>https://kg.ebrains.eu/]]. This makes the data and metadata discoverable in the [[Knowledge Graph Search>>url:https://search.kg.ebrains.eu/]] and programmatically via the [[Knowledge Graph API>>url:https://docs.kg.ebrains.eu/8387ccd27a186dea3dd0b949dc528842/api_endpoints.html]]. The data, models and software are integrated in the EBRAINS Knowledge Graph by interoperable metadata schemas as defined in [[openMINDS>>url:https://github.com/HumanBrainProject/openMINDS/wiki]].Data and models are linked to and discoverable via the species-specific [[EBRAINS siibra atlas viewer>>url:https://ebrains.eu/services/atlases/brain-atlases]] by using interoperable metadata schemas as defined in [[SANDS>>url:https://github.com/HumanBrainProject/SANDS/wiki]].
51
52
53 (% class="box infomessage" %)
54 (((
55
56 )))
57
58 (% class="box successmessage" %)
59 (((
60
61 )))
62
63 ----
64
65 === Step by step - Experimental data ===
66
67
68 [[image:image-20230326054341-1.png]]
69
70 ==== ====
71
72 ==== **1. Provide some general information about your dataset** ====
73
74 The [[Curation request form>>https://nettskjema.no/a/277393#/]] collects preliminary information about your data, allowing us to assess whether the dataset fits within the scope of EBRAINS. The submission generates a curation ID allowing us to track the case.
75
76 The [[Ethics and Regulatory compliance form>>https://nettskjema.no/a/224765]] collects the necessary information needed for us to evaluate whether we can safely and legally share the data on the EBRAINS platforms.
77
78
79 ==== **2. Upload data ** ====
80
81 EBRAINS offers secure, long-term storage at [[CSCS Swiss National Supercomputing Centre>>url:https://www.cscs.ch/]], with currently no upper limit of storage capacity. The data must be consistently structured prior to upload. 
82
83 For smaller datasets with a reasonable amount of files, we recommend using the Collab-Bucket solution (drag-and-drop). A Collab Bucket must first be assigned to a dataset, which happens when a datasets is accepted for sharing.
84
85 For larger datasets or datasets with a large amount of files, we recommend using a programmatic approach. The [[python script>>https://github.com/eapapp/ebrains-data-storage/tree/main/data-proxy]] is interactive and does not require any additional programming.
86
87
88 If a data collection is already uploaded elsewhere, we may link to the already existing repository.
89
90
91 ==== **3. Submit metadata** ====
92
93 Easily submit openMINDS-compatible metadata via our [[metadata wizard>>https://ebrains-metadata-wizard.apps.hbp.eu/]]. This form covers all the required metadata for sharing data via EBRAINS. When you're ready to 'Submit', the metadata and all uploaded files will be sent to the Curation team.
94
95 For power-users interested in exploring the full span of the openMINDS framework, please check out the [[openMINDS GitHub>>https://github.com/HumanBrainProject/openMINDS]] to learn more about how to programmatically gather your metadata. A stable version of the openMINDS package can be found on [[PyPi>>https://pypi.org/project/openMINDS/]]. We accept openMINDS metadata as JSON-LD (share these with us via curation-support@ebrains.eu). Additional documentation of openMINDS metadata submodules and schemas can be found on [[the openMINDS GitHub Wiki>>https://humanbrainproject.github.io/openMINDS/]]. We have prepared [[a list of the metadata properties that are required>>https://drive.ebrains.eu/lib/47995dbc-f576-4008-a76c-eefbfd818529/file/ebrains-minimum-required-metadata.xlsx]] for publishing data on EBRAINS.
96
97
98 ==== **4. Write a Data Descriptor ** ====
99
100 The Data Descriptor is a document helping others interpret and reuse (and prevent misuse) of your data, and is critical to achieve a basic level of FAIR. The document will be uploaded in the repository of the data, shared as a PDF. 
101
102 [[The template >>https://drive.ebrains.eu/f/a2e07c95b1a54090bbbc/?dl=1]]safely guides you through the process of making one. Check out previous examples in the KG Search, e.g. the Data Descriptor for a dataset containing histology images of the rat brain stained for an anterograde tracer (see [[an example>>https://doi.org/10.25493/2MX9-3XF]]).
103
104
105 Journal publications sufficiently describing the shared data, such as made available through [[Nature Scientific Data>>http://www.nature.com/sdata/about]], [[Elsevier Data in Brief>>http://www.journals.elsevier.com/data-in-brief/]], [[BMC Data note>>https://bmcresnotes.biomedcentral.com/submission-guidelines/preparing-your-manuscript/data-note]] and more, can replace the EBRAINS Data Descriptor.
106
107
108 ==== **5. Preview and publish ** ====
109
110 A Curator will assemble a dataset in the EBRAINS Knowledge Graph that combines the data, metadata and data descriptor. Once ready, the data provider will receive a private URL for previewing the dataset prior to release. We need an official approval from the data custodian{{footnote}}The Data Custodian is responsible for the content and quality of the Data and metadata, and is the person to be contacted by EBRAINS CS in case of any misconduct related to the Data. It is the obligation of a Data Custodian to keep EBRAINS informed about changes in the contact information of the authors of the Datasets provided by them ([[EBRAINS Data Provision Protocol - version 1.1>>https://strapi-prod.sos-ch-dk-2.exo.io/EBRAINS_Data_Provision_Protocol_dfe0dcb104.pdf]]).{{/footnote}} to release the dataset. Once released, a [[DataCite DOI>>https://datacite.org/]] will be generated for the dataset. If the identical data collection has received a DOI elsewhere, we recommend re-using the already issued DOI.
111
112
113 ----
114
115 ==== **Sharing human data ** ====
116
117 (% class="box floatinginfobox" %)
118 (((
119 For **Human subject data**, the data must be //either//
120
121 - Post-mortem data
122 - Aggregated data
123 - Pseudonymized subject data with a legal basis for sharing (e.g. Informed Consent)
124
125 (% class="small" %)//If you have human data that do not classify as any of the above, please get in touch and we will clarify the available options. //
126 )))
127
128 We must ensure data shared on EBRAINS comply with [[GDPR >>https://gdpr-info.eu/]]and [[EU directives>>https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=celex%3A32010L0063]]. The information we need to assess this is collected via our [[Ethics and Regulatory Compliance Survey>>https://nettskjema.no/a/224765]].
129
130 Post-mortem and aggregated human data can be shared openly. Pseudonymized data is shared via the Human Data Gateway (HDG) due to GDPR regulations. The HDG adds an authentication layer to the data.
131
132 **Data users** must request access to the data (via their EBRAINS account) and will receive access provided they actively accept the [[EBRAINS Access Policy>>https://ebrains.eu/terms#access-policy]], the [[EBRAINS General Terms of Use>>https://ebrains.eu/terms#general-terms-of-use]], and the [[EBRAINS Data Use Agreement>>https://ebrains.eu/terms#data-use-agreement]]. The account holder also have to accept that information about their request and access to specific data under HDG is being tracked and stored.
133 \\**Data owners** must be aware that sharing under the HDG affects the legal responsibilities for the data. They must agree to joint control of the data (see the [[Data Provision Protocol v1>>url:https://strapi-prod.sos-ch-dk-2.exo.io/EBRAINS_Data_Provision_Protocol_dfe0dcb104.pdf]], section 1.4 - 1.5) and the Data Protection Officers of the responsible institutions must have accepted that the data can be shared under HDG.
134 \\The Human Data Gateway (HDG) was introduced in February 2021 and developed across multiple teams in the HBP. The initiative to create the service and the initial design originated from EBRAINS Curation in close collaboration with the Data compliance team and the HBP Data Governance Working Group. HDG is a response to the needs of multiple data providers who are bringing data of human origin to EBRAINS. HDG covers the sharing of a limited range of data of human origin, i.e., data without direct identifiers and with very few indirect identifiers (strongly pseudonymized, de-identified). It is an extension of the existing services and does not replace the future EBRAINS Service for sensitive data (planned for 2024) which is outside the domain of the current EBRAINS Data and Knowledge services.
135
136
137 ----
138
139 === Step by Step - Models ===
140
141 (% style="color:#e74c3c" %){{mention reference="XWiki.adavison" style="FULL_NAME" anchor="XWiki-adavison-1rb0hn"/}}
142
143 [place-holder-process-diagram]
144
145 ==== **1. model step 1 ** ====
146
147 Text
148
149
150 ==== **2. model step 2** ====
151
152 Text
153
154
155 ----
156
157 === Step by Step - Code ===
158
159 [[[[image:swc-flow-no-header.png||alt="swc-flow.png"]]>>https://www.ebrains.eu/tools/ebrains-curation-request-form||rel="noopener noreferrer" target="_blank"]]
160
161 1. Fill in the [[request form>>https://www.ebrains.eu/tools/ebrains-curation-request-form]].[[[[image:Thumb.png||alt="EBRAINS-Share-Software.pdf" height="377" style="float:right" width="257"]]>>attach:EBRAINS-Share-Software.pdf]]
162 1. One of our creators will then open a ticket and contact you with futher instructions. In these instructions you will find the links to your software and software version entries in the Knowledge Graph.
163 1. In the next step you need to enter the metadata of your software in the [[Knowledge Graph Editor>>url:https://editor.kg.ebrains.eu/]] by using the links provided in the ticket. The links will lead you to the space in the KG, which was created especially for you. You can start directly with the editing of your software. Please provide the metadata for your software as complete as possible. This makes it easier for users to find and use your software. If you have questions feel free to contact the curation support.
164 1. After you have finished editing your entries, please let the curators know by replying to your ticket. We curate your metadata and get back to you, if necessary.
165 1. After a quality check, we integrate and publish the information to the Knowledge Graph. Your software is then searchable and usable for the neuroscience community.
166
167 If you want to add a new version to an already curated software, please write to [[curation-support@humanbrainproject.eu>>path:mailto:curation-support@humanbrainproject.eu]] or open a ticket at [[https:~~/~~/support.humanbrainproject.eu/.>>url:https://support.humanbrainproject.eu/]]
168 For more information, visit our [[guide>>url:https://wiki.ebrains.eu/bin/view/Collabs/swc-guide]].
169
170 ----
171
172 === Webservices and metadata models ===
173
174 (% class="wikigeneratedid" id="HContact...." %)
175 (% style="color:#e74c3c; font-size:16px" %){{mention reference="XWiki.adavison" style="FULL_NAME" anchor="XWiki-adavison-np253c"/}}(% style="color:#4a5568; font-size:16px" %)
176
177 ----
178
179 == **The curation team: meet the curators** ==
180
181 **Located in Norway:**
182
183 |(% style="width:303px" %)(((
184 [[image:My project2.jpg||height="209" width="167"]]
185
186 **Archana Golla**
187
188 (% class="small" %)Curation Scientist
189 Neuroscience (PhD)(%%)
190 (% class="small" style="color:#4a5568" %)**Behavioral neuroscience and microscopy**
191 )))|(% style="width:303px" %)(((
192 [[image:Camilla.jpg||alt="My project.jpg" height="209" width="167"]]
193
194 **Camilla H. Blixhavn**
195
196 (% class="small" %)Curation Scientist,
197 Phd Student
198 Neuroscience (M. Sc.)(%%)
199 (% class="small" style="color:#4a5568" %)**Neuroanatomy and data integration**
200 )))|(% style="width:303px" %)(((
201 [[image:My project (1).jpg||height="209" width="167"]]
202
203 **Ingrid Reiten**
204
205 (% class="small" %)Curation Scientist,
206 Phd Student
207 Neuroscience (M. Sc.)(%%)
208 (% class="small" style="color:#4a5568" %)**Neuroanatomy and structural connectivity**
209 )))|(% style="width:303px" %)(((
210 [[image:My project1.jpg||height="209" width="167"]]
211
212 **Sophia Pieschnik**
213
214 (% class="small" %)Curation Scientist
215 Neurocognitive Psychology (M. Sc.)(%%)
216 (% class="small" style="color:#4a5568" %)**Neuroimaging **
217 )))
218
219 |(% style="width:303px" %)(((
220 [[image:My project.jpg||height="209" width="167"]]
221
222 **Heidi Kleven**
223
224 (% class="small" %)Curation Scientist,
225 Phd Student
226 Neuroscience (M. Sc.)(%%)
227 (% class="small" style="color:#4a5568" %)**Neuroanatomy and brain atlases**
228 )))| | |
229
230
231 \\**Located in Germany:**
232
233 |(% style="width:303px" %)(((
234 [[image:My project (2).jpg||height="209" width="167"]]
235
236 **Jan Gündling**
237
238 (% class="small" %)Curation Scientist,
239 Phd Student
240 Sensors and Cognitive Psychology (M. Sc.)(%%)
241 (% class="small" style="color:#4a5568" %)**Human-Computer Interaction**
242 )))|(% style="width:303px" %)(((
243
244
245
246
247
248
249
250
251
252
253
254
255 **Lyuba Zehl**
256
257 (% class="small" %)Knowledge Systems Engineer
258 Dr. rer. nat. (Systems Neuroscience)(%%)
259 (% class="small" style="color:#4a5568" %)**Standard development, data & knowledge management, interdisciplinary communication, data analysis**
260 )))|(% style="width:303px" %) |
261
262 ----
263
264 == **Information and resources for researchers looking to share data** ==
265
266 Below you can find some resources that can come in handy if you are looking to share data via EBRAINS, or in general.
267
268 ----
269
270 === **Improve your research product ** ===
271
272 (% class="wikigeneratedid" %)
273 **{{mention reference="XWiki.adavison" style="FULL_NAME" anchor="XWiki-adavison-fkdv6h"/}}**
274
275 ==== **Add a tutorial or learning resource to your research product ** ====
276
277 ==== (% style="color:#e74c3c" %)- Learning resource [information](%%) ====
278
279
280 ==== **Create a workflow for .... ? ** ====
281
282 ==== (% style="color:#e74c3c" %)- Workflows [information](%%) ====
283
284 ----
285
286 === **Integrate your data, models or software with other services** ===
287
288 EBRAINS supports further integration for a variety of data, and is continuously looking to increase the number of interoperable services.
289
290 * Integrate image data with //the Mio viewer//: EBRAINS Multi-Image OpenSeadragon viewer provides an intuitive way of navigating high-resolution 2D image series. It has browser-based classic pan and zoom capabilities. A collection can be displayed as a filmstrip (Filmstrip Mode) or as a table (Collection Mode) with adjustable number of row and columns. See [[Mio viewer links available for this dataset>>https://search.kg.ebrains.eu/?category=Dataset&q=nr2f1#9677359c-73fa-4425-b8fa-3de794e9017a]] as an example. MioViewer user manual is found [[here>>https://multi-image-osd.readthedocs.io/en/latest/index.html]].
291 * Integrate atlas-registered 2D image data with //the LocaliZoom viewer//: The EBRAINS LocaliZoom serial section viewer displays series of registered 2D section images with atlas overlay, allowing the users to zoom into high-resolution images and have information about the brain regions. See the [[LocaliZoom links available for this dataset>>https://doi.org/10.25493/T686-7BX]] as an example. LocaliZoom user manual is found [[here>>https://localizoom.readthedocs.io/en/latest/index.html]].
292 * Add your data, models or software to a// Live paper//: (% style="color:#e74c3c" %)[description] {{mention reference="XWiki.adavison" style="FULL_NAME" anchor="XWiki-adavison-62mbgl"/}}
293 * Integrate your data to //the Siibra//-explorer: The siibra-explorer is used for visualizing volumetric brain data in all the brain atlases provided by EBRAINS (Human, Monkey, Rat and Mouse). The siibra-explorer viewer uses siibra-api to enable navigation of brain region hierarchies, maps in different coordinate spaces, and linked regional data features. Furthermore, it is connected with the siibra toolsuite providing several analytical workflows. To learn more about how to integrate your data to atlases, check out the [[Atlas services>>https://ebrains.eu/services/atlases#Integratedatatoanatlas]] on ebrains.eu.
294
295 ----
296
297 === **The benefits of sharing data ** ===
298
299 (% style="color:#000000" %)Sharing your data, models or code (research products) via EBRAINS makes it discoverable amongst other research products available in the (%%)[[(% style="color:#000000" %)EBRAINS Knowledge Graph>>https://kg.ebrains.eu/]](%%). This is made possible by the highly flexible metadata framework describing neuroscience data in detail.
300
301 (% style="color:#000000" %)EBRAINS is gradually implementing interconnected tools and analysis workflows developed in the Human Brain Project (HBP) to further enhance the output from adding your dataset to the database.
302
303
304 By sharing your data via EBRAINS, you gain access to the following benefits:
305
306 [[image:image-20230324170841-3.png]]
307
308
309
310 We support you to better follow the FAIR^^ ^^guiding principles for data management and stewardship{{footnote}}Wilkinson, M., Dumontier, M., Aalbersberg, I. et al. The FAIR Guiding Principles for scientific data management and stewardship. Sci Data 3, 160018 (2016). https://doi.org/10.1038/sdata.2016.18 {{/footnote}}.  Publishing data, models or code via EBRAINS will provide you with a citeable [[DataCite DOI>>https://www.doi.org/the-identifier/resources/handbook/]] for your research product.
311
312
313 ----
314
315 === **At a glance: "Sharing experimental data on EBRAINS" ** ===
316
317
318 |(% style="width:439px" %)(((
319 [[[[image:image-20230324171114-2.png||height="354" width="250"]]>>https://drive.ebrains.eu/f/dfd374b9b43a458192e9/]]
320 )))|(% style="width:461px" %)(((
321 [[[[image:image-20230324171109-1.png||height="352" width="250"]]>>https://drive.ebrains.eu/f/c1ccb78be52e4bdba7cf/]]
322 )))|(% style="width:416px" %)[[[[image:image-20230330120354-1.png||height="352" width="250"]]>>https://drive.ebrains.eu/f/707147a883b94fae8e69/]]
323 |(% style="width:439px" %)//Collection of useful information for researchers looking to share experimental data on EBRAINS.//|(% style="width:461px" %)//The EBRAINS data descriptor: a general overview //|(% style="width:416px" %)//Introduction to data organization: A [[collection of guidelines>>https://drive.ebrains.eu/smart-link/25299f04-c4e5-4028-8f5f-3b8208f9a532/]] on how to organise files and folders to ensure consistency and reproducibility in the future. //
324
325 ----
326
327 === **Common concerns - and answers ** ===
328
329 (((
330 ==== ====
331
332 (((
333 >The curation process is time consuming and difficult
334 )))
335 )))
336
337 (% class="wikigeneratedid" id="HHowcanIshareA0models3F" %)
338 Publishing your data naturally takes some time and effort but we will support you as much as possible. If communication is on a regular basis, we are able to finish basic curation - from the initial contact to dataset release - within two weeks.
339
340 >Sharing my data is not beneficial for me - only for others
341
342
343 When you publish your data via EBRAINS, we provide comprehensive data management support and safe long term storage - all free of charge. Additionally, your data can be cited, just like a scientific journal article. Sharing your data may even lead to new funding opportunities. Many funders specifically support projects that are part of the “Open Science” initiative.
344
345 >My data is too insignificant to share
346
347
348 There is no such thing as insignificant data. Data that is considered insignificant for a given topic, may have great significance for another. By making “insignificant” data publicly available, other researchers may find something interesting that was off-topic for your own purposes.
349
350 >My data can easily be misused if I share it with the world
351
352
353 Your data will be covered by a Creative Commons license of your choice. There are a variety of licenses available, enabling you to prevent use for specific purposes, e.g. commercial use.
354
355 >I don't think I'm allowed to share my data
356
357
358 Many institutions are still very careful about what can be shared and how, but the situation is constantly evolving. As a researcher providing data, you will be asked to fill out an ethics compliance survey which survey to ensure that data published through the EBRAINS platform has been collected according to EU regulations. We are working on solutions for sharing anonymised human data that complies with GDPR standards to protect the identity of research subjects.
359
360 >I can't share my data before my paper is published
361
362
363 If you do not want to share your data before publishing the results in an article, you can publish your dataset with an embargo status. This will make it possible to find information about the data without making the data itself available, and give you a citeable DOI.
364
365 >If I share my data before I publish the associated paper, I will lose my competitive edge
366
367
368 Publishing your data does not mean that others can use it however they want. Use of your data will require citation, and by choosing an appropriate Creative Commons licence you decide what others are allowed to do with it. If you still feel worried, you can publish your data under embargo, and in this way delay the date of data release, but still make it possible for others to find the information about the data.
369
370
371 ----
372
373 == Contact ==
374
375 [[curation-support@ebrains.eu>>mailto:curation-support@ebrains.eu]]
376
377
378 {{putFootnotes/}}
379 ~)~)~)~)~)~)
380 ~)~)~)
381 ~)~)~)~)~)~)~)~)~)
382 ~)~)~)~)~)~)