Changes for page data-curation-copy
Last modified by eapapp on 2023/07/04 16:46
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -11,12 +11,11 @@ 11 11 12 12 == **Information to get started** == 13 13 14 -**[[REQUEST CURATION>>https://nettskjema.no/a/277393#/]] to share data, simulations, computational models, and software, - or toaddanew version of an existing one. **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 15 16 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 17 18 18 19 -(% style="text-align: center;" %) 20 20 Search existing data, models and software in [[the EBRAINS Knowledge Graph Search>>https://kg.ebrains.eu/search/?facet_type[0]=Dataset]] 21 21 22 22 ... ... @@ -37,6 +37,11 @@ 37 37 38 38 == **The EBRAINS curation process** == 39 39 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 + 40 40 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. 41 41 42 42 >The EBRAINS curation process involves organising and annotating neuroscientific data to make the data discoverable and reusable. ... ... @@ -43,90 +43,69 @@ 43 43 44 44 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. 45 45 46 -Curated data, models and software are made available in [[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 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 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]]. 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]]. 47 47 48 -The curation of data, models and software is different. Thus, below we explain the process for sharing for each research product separately. 49 49 53 +(% class="box infomessage" %) 54 +((( 55 + 56 +))) 50 50 58 +(% class="box successmessage" %) 59 +((( 60 + 61 +))) 62 + 51 51 ---- 52 52 53 -=== Step by step - Data ===65 +=== Step by step - Experimental data === 54 54 55 55 56 56 [[image:image-20230326054341-1.png]] 57 57 58 -==== [[[[image:image-20230324171114-2.png||height="176"width="125"]]>>https://drive.ebrains.eu/f/dfd374b9b43a458192e9/]]//Allyou need to know to share data on EBRAINS.//====70 +==== ==== 59 59 60 - 61 61 ==== **1. Provide some general information about your dataset** ==== 62 62 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. 63 63 64 -[[i mage:https://lh3.googleusercontent.com/zh7TvO6w04YGW9jIhfhmdT6CexdGs-AWOLfJXKRq7-tdHOu6ar1rOQx8o4rZevrjXqgPZ7-Ejv4b6X9XpgXuHpdUXi-mBTHIUnv5Vz-DktHt0sP-PZ3gE8XgZid3TV3swV1uTCBhHx11ge0pjP7RVxswGQ=s2048||height="85px;"width="91px;"]]**Fillinthe[[Curationrequest form>>https://nettskjema.no/a/277393#/]].**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. 65 65 66 -This form 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. 67 67 68 - 69 -[[image:https://lh6.googleusercontent.com/yw442oS6BwZOlY-_0BoVxyCW3DrdcJ5ogCes92iOD16_rgNEVk56aNMDaVWXFfBLYv24bHzmGgBF9wg0szjH70xzuRTqxoQAeuy3knNO7axCHoyZDXwtyTcMgFnYwbOYxOT29LK-zchrUKLW6Mle93kOkQ=s2048||height="94px;" width="94px;"]]**Fill in the [[Ethics and Regulatory compliance form>>https://nettskjema.no/a/224765]]**. 70 - 71 -This form collects the necessary information needed for us to evaluate whether we can ethically and legally share the data via EBRAINS. 72 - 73 - 74 74 ==== **2. Upload data ** ==== 75 75 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. 76 76 77 - [[image:https://lh5.googleusercontent.com/sieKO-kW8O18iPaUyonwyo4UfHBmtc2E9BDnjbx52j6J_uGmm-OzGAo7sloMk3sYwKa6QW3hYQsOA9N4H7uGQpca088Wrk0Nurpt_J3B0-NSbcaPNdZIh21otQcG6jnAxLGiKoEvkTyaDGTMk3fu7me8mQ=s2048||height="94px;"width="94px;"]]**Ensure data isstructuredconsistently priorto upload.**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. 78 78 79 - We look fororganizeddata, not organizedaccordingto ourstandard. This isto support thebroadestdegreeof sharingpossible.We do howeverrequire that the data isorganizedin a consistentandprecisemanner.Please see our// //[[collectionof guidelineson data organization>>https://drive.ebrains.eu/smart-link/25299f04-c4e5-4028-8f5f-3b8208f9a532/]]forfurtherguidance.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. 80 80 81 -[[image:https://lh5.googleusercontent.com/EWtYwfVlbeC-jqPasgmzidqc50GrkKIEgwXeUeql8aaMHIukmFdWEy0nufVWWATbxDDK3XwwZEDmASrbpCsBk1u0HpAd8x4ZgAMsMPRcWyrb9etlV6FgKE_QN2e6SqKxHE0rzkR8uI1rRW_5z21TFGYVnw=s2048||height="91px;" width="91px;"]]**Upload data to EBRAINS Storage, either using a drag-and-drop solution (opt. 1) or an interactive python script (opt. 2).** 82 82 83 -//Opt. 1. //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 -//Opt. 2. //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 -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. 89 - 90 90 If a data collection is already uploaded elsewhere, we may link to the already existing repository. 91 91 92 92 93 - (% style="color:#1a202c;font-family:inherit; font-size:23px" %)**3. Submit metadata**91 +==== **3. Submit metadata** ==== 94 94 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. 95 95 96 - [[image:https://lh5.googleusercontent.com/WS4T2LhF9znWWChn3Z550agLrrb-KTWdYVsJSv0lh4cGjKbjuN1WV68WER9xkYqi1UqN7KYZz7bImYz3_TpOuTuvma7T192QUiUZoyJVPk1fj5NSDSQh_kpIeBufAOdDtsDRpPKK_P5EDPqRCTAaOTNyCw=s2048||height="91px;"width="91px;"]]**Submit metadata usingour**[[EBRAINSMetadatawizard>>https://ebrains-metadata-wizard.apps.hbp.eu/]]**(opt.1),or throughtinteractionwith the KnowledgeGraph(opt.2)**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. 97 97 98 -//Opt. 1.// Manually submit the minimal required metadata via the [[EBRAINS Metadata wizard>>https://ebrains-metadata-wizard.apps.hbp.eu/]]. The minimal required metadata covers extended bibliographic information necessary to publish your dataset on EBRAINS. The submitted information, including uploaded files, will be sent to the Curation team automatically 99 99 100 -//Opt. 2.// To go beyond the minimal required metadata, you can directly interact with the Knowledge Graph (KG) in your private space. Within the private space, you can upload metadata and interact with them, moreover you can connect your metadata to existing publicly accessible entries. Access to your private space is granted upon the initiation of the curation process. You can access your private space via: 101 - 102 -* Knowledge Graph Editor: This User Interface allows you to manually enter metadata into your KG space and validate metadata that are programmatically uploaded. The Editor contains a basic set of openMINDS metadata templates, but can be extended to the full openMINDS metadata model on request. Access is granted once the request is accepted. 103 -* [[Fairgraph>>https://fairgraph.readthedocs.io/en/stable/]]: This is the recommended software tool for programmatic interaction with the KG. It allows you to programmatically upload openMINDS compliant metadata into your KG space and interact with existing metadata. 104 -* [[KG Core Python SDK>>https://github.com/HumanBrainProject/kg-core-sdks]]: This python package gives you full freedom in interacting with he KG. It allows you to upload any JSON-LD with metadata into your private space. Note, for dataset publications in EBRAINS, the JSON-LD metadata files have to comply to openMINDS. 105 - 106 -Datasets published through the EBRAINS Knowledge Graph have to be registered using **openMINDS compliant metadata** delivered as JSON-LD files. See this summary table for an overview of [[the minimally required openMINDS properties for publishing>>https://drive.ebrains.eu/lib/47995dbc-f576-4008-a76c-eefbfd818529/file/ebrains-minimum-required-metadata.xlsx]] on EBRAINS. 107 - 108 - 109 109 ==== **4. Write a Data Descriptor ** ==== 110 110 111 -[[image:https://lh4.googleusercontent.com/lMYEKOXzejbBydOdotWWteXQo7j363xRyntBGjcPZVEdtIU1CJYX7q1STpdr2JPZK4hpWWXk20UlkUOqDGL5kX6vnQVBSdrfUo6EGfXOwpuGq1Uygv0tTZJ0lRO6voJvg56QC2mufvjAcRXGfAKFOjtc6w=s2048||height="94px;" width="94px;"]]**Write a data descriptor by filling in **[[this template>>https://drive.ebrains.eu/f/a2e07c95b1a54090bbbc/?dl=1]]** . ** 112 - 113 113 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. 114 114 115 - Seeourphicabout thedatadescriptor for inspiration or guidance.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]]). 116 116 117 -Check out previous examples in the KG Search. See e.g., the data descriptor for the dataset "[[Anterogradely labeled axonal projections from the orbitofrontal cortex in rat>>https://doi.org/10.25493/2MX9-3XF]]". 118 118 119 119 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. 120 120 121 -==== [[[[image:image-20230324171109-1.png||height="191" width="135"]]>>https://drive.ebrains.eu/f/c1ccb78be52e4bdba7cf/]]//The EBRAINS Data descriptor at-a-glance// ==== 122 122 123 - 124 124 ==== **5. Preview and publish ** ==== 125 125 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. 126 126 127 -[[image:https://lh4.googleusercontent.com/XqT26Q4yWJK26cjtjhI4ToXoZZMxhT9LimG4Hk9mePxy0-KPKgpVIzcuiP5mOQowBgf2JjkrWUq2VbCmafWWZPJplEZALnFOlCZHLlQgzOx7fFwoBteyi_IlMLkPBS9vtOcdNIZ59HyLnQz4RsTQ0lUrSw=s2048||height="91px;" width="91px;"]]**Preview and approve the release of your dataset. **Once a Curator has assembled the dataset in the EBRAINS Knowledge Graph, combining the data, metadata and data descriptor, 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. 128 128 129 - 130 130 ---- 131 131 132 132 ==== **Sharing human data ** ==== ... ... @@ -133,81 +133,68 @@ 133 133 134 134 (% class="box floatinginfobox" %) 135 135 ((( 136 -**Human subject data that canbeshared on EBRAINS consists of:**119 +For **Human subject data**, the data must be //either// 137 137 138 138 - Post-mortem data 139 139 - Aggregated data 140 -- Strongly pseudonymizedor de-identifiedsubject data with a legal basis for sharing (e.g. Informed Consent)123 +- Pseudonymized subject data with a legal basis for sharing (e.g. Informed Consent) 141 141 142 -(% class="small" %)//If you have human data that do esnot classify as any of the above, please get in touch and we will clarify the available options. //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. // 143 143 ))) 144 144 145 - Human data shared on EBRAINSmustcomply with128 +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]]. 146 146 147 -Post-mortem and aggregated human data can be shared openly , given direct identifiers in the metadata are removed.Strongly pseudonymizedandde-identified datacanbeshared via the Human Data Gateway (HDG).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. 148 148 149 -The Human Data Gateway (HDG) was introduced in February 2021 as a response to the needs of multiple data providers who are bringing human subject data to EBRAINS. HDG covers the sharing of strongly pseudonymized or de-identified data, a limited range human subject data without direct identifiers and with very few indirect identifiers. 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. 150 150 151 -The HDG adds an an authentication layer on top of the data. This means that **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. **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. 152 152 153 -The HDG 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. 154 - 155 - 156 156 ---- 157 157 158 158 === Step by Step - Models === 159 159 141 +(% style="color:#e74c3c" %){{mention reference="XWiki.adavison" style="FULL_NAME" anchor="XWiki-adavison-1rb0hn"/}} 160 160 161 - ~1. Request curation using the[[Curation request form>>https://nettskjema.no/a/277393#/]]. You will becontactedbyacurator withmore information.143 +[place-holder-process-diagram] 162 162 145 +==== **1. model step 1 ** ==== 163 163 164 - //Additional information will beadded soon.//147 +Text 165 165 166 ----- 167 167 168 -=== Stepby Step-Software===150 +==== **2. model step 2** ==== 169 169 170 - [[[[image:swc-flow-no-header.png||alt="swc-flow.png"]]>>https://www.ebrains.eu/tools/ebrains-curation-request-form||rel="noopener noreferrer" target="_blank"]]152 +Text 171 171 172 -~1. Fill in the [[request form>>https://www.ebrains.eu/tools/ebrains-curation-request-form]]. You'll be contacted by a curator with further instructions. In these instructions you will find the links to your software and software version entries in the Knowledge Graph. 173 173 174 - 2. Enter the metadata of your software in your private space of the [[Knowledge Graph Editor>>url:https://editor.kg.ebrains.eu/]] by using the links provided by the curator. 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. 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.155 +---- 175 175 176 - 3.Aftera qualitycheck, we integrate andpublishtheinformation to the KnowledgeGraph. Your software is then searchable and usable for the neuroscience community.157 +=== Step by Step - Code === 177 177 178 - Ifyouwant tod a new versiontoan already curatedsoftware, pleaserequestthisvia the[[curation>>https://nettskjema.no/a/277393]].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"]] 179 179 180 -For more information, visit our [[Guide to Software Curation in the EBRAINS Knowledge Graph>>url:https://wiki.ebrains.eu/bin/view/Collabs/swc-guide]] or see our infographic below. 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. 181 181 182 -[[[[image:Thumb.png||alt="EBRAINS-Share-Software.pdf" height="203" style="float:left" width="139"]]>>attach:EBRAINS-Share-Software.pdf]] 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]]. 183 183 184 - 185 -==== //Software curation at a glance// ==== 186 - 187 - 188 - 189 - 190 190 ---- 191 191 192 -== **TheopenMINDSmetadataframework**==172 +=== Webservices and metadata models === 193 193 194 -openMINDS (open Metadata Initiative for Neuroscience Data Structures) is a community-driven, open-source metadata framework for graph database systems, such as the EBRAINS Knowledge Graph. It is composed of linked metadata models, libraries of serviceable metadata instances, and supportive tooling ([[openMINDS Python>>url:https://pypi.org/project/openMINDS/]], openMINDS Matlab). For exploring the openMINDS schemas, go to the [[HTML documentation>>url:https://humanbrainproject.github.io/openMINDS/]]. For a full overview of the framework, go to [[the openMINDS collab>>url:https://wiki.ebrains.eu/bin/view/Collabs/openminds/]] or the [[GitHub repository>>https://github.com/HumanBrainProject/openMINDS]]. 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" %) 195 195 196 -For feedback, requests, or contributions, please get in touch with the openMINDS development team via 197 - 198 -* the support-email: [[openminds@ebrains.eu>>path:mailto:openminds@ebrains.eu]] 199 -* the [[GitHub issue tracker>>url:https://github.com/HumanBrainProject/openMINDS/issues]] 200 -* the INCF NeuroStars [[openMINDS Community Forum>>url:https://neurostars.org/t/openminds-community-forum-virtual/20156]] 201 - 202 202 ---- 203 203 204 204 == **The curation team: meet the curators** == 205 205 206 -The EBRAINS curators help researchers publish their research using the EBRAINS Research Infrastructure. A curator’s job is similar to the job of an editor of a scientific journal, checking the data is organized, understandable, accessible and sufficiently described. 207 - 208 -The curators in EBRAINS are located in Oslo, Jülich, Trier and Paris. 209 - 210 - 211 211 **Located in Norway:** 212 212 213 213 |(% style="width:303px" %)((( ... ... @@ -291,46 +291,46 @@ 291 291 292 292 ---- 293 293 294 -== ** Add practicalvaluetoyour shareddata, model orsoftware** ==264 +== **Information and resources for researchers looking to share data** == 295 295 266 +Below you can find some resources that can come in handy if you are looking to share data via EBRAINS, or in general. 296 296 297 - ==== **Add a tutorial or learning resource ** ====268 +---- 298 298 299 -(% class="wikigeneratedid" id="H-LearningresourceA05Binformation5D" %) 300 -(% style="color:#000000" %)//More information will follow// 270 +=== **Improve your research product ** === 301 301 272 +(% class="wikigeneratedid" %) 273 +**{{mention reference="XWiki.adavison" style="FULL_NAME" anchor="XWiki-adavison-fkdv6h"/}}** 302 302 303 -==== ** Createaworkflow** ====275 +==== **Add a tutorial or learning resource to your research product ** ==== 304 304 305 -(% class="wikigeneratedid" id="H-Workflows5Binformation5D" %) 306 -(% style="color:#000000" %)//More information will follow// 277 +==== (% style="color:#e74c3c" %)- Learning resource [information](%%) ==== 307 307 308 ----- 309 309 310 -=== ** Showcaseshareddata,modelsorsoftwareinotherservices** ===280 +==== **Create a workflow for .... ? ** ==== 311 311 312 - Belowisa listof additionalservices that data, modelsorsoftwareshared via EBRAINScanbenefitfrom. EBRAINS iscontinuously looking to increasethe number ofinteroperableservices.282 +==== (% style="color:#e74c3c" %)- Workflows [information](%%) ==== 313 313 314 - **Viewer for 2D images **284 +---- 315 315 316 - *Integrateimage data with //the Mioviewer//: EBRAINS Multi-Image OpenSeadragonviewer providesan intuitive wayof navigating high-resolution 2D image series. It has browser-basedclassic pan and zoom capabilities. A collection can be displayedas a filmstrip (Filmstrip Mode) orasa table (Collection Mode)withadjustable numberof row and columns. See[[Mio viewer links available forthisdataset>>https://search.kg.ebrains.eu/?category=Dataset&q=nr2f1#9677359c-73fa-4425-b8fa-3de794e9017a]]asanexample. MioVieweruser manualis found [[here>>https://multi-image-osd.readthedocs.io/en/latest/index.html]].286 +=== **Integrate your data, models or software with other services** === 317 317 318 - **Viewerforequentialatlas-registered2Dimageswithannotationtions**288 +EBRAINS supports further integration for a variety of data, and is continuously looking to increase the number of interoperable services. 319 319 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]]. 320 320 * 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. 321 321 322 - **Use your research product in an interactive publication **295 +---- 323 323 324 - *Add your data, modelsor software to a// Live paper. //Read more about [[Livepapers onebrains.eu>>https://www.ebrains.eu/data/live-papers/live-papers]].297 +=== **The benefits of sharing data ** === 325 325 326 - **Interactive3Datlas viewerwithoptionsfor datavisualization**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. 327 327 328 - *Upload your data to //theSiibra//-explorer:Thesiibra-explorer isused forvisualizingvolumetric braindatainall the brainatlases provided by EBRAINS (Human, Monkey, RatandMouse). The siibra-explorer viewer usessiibra-api to enablenavigationof brainregion hierarchies,maps indifferent coordinatespaces, andlinkedregionaldatafeatures. Furthermore,it is connectedwiththesiibra toolsuiteproviding several analyticalworkflows. To learn moreabout how to registeryour data toatlases,readboutthe [[Atlas services on ebrains.eu>>https://ebrains.eu/services/atlases#Integratedatatoanatlas]].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. 329 329 330 ----- 331 331 332 -=== **The benefits of sharing data ** === 333 - 334 334 By sharing your data via EBRAINS, you gain access to the following benefits: 335 335 336 336 [[image:image-20230324170841-3.png]] ... ... @@ -339,10 +339,23 @@ 339 339 340 340 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. 341 341 312 + 342 342 ---- 343 343 344 -=== ** Frequentlyaskedquestions** ===315 +=== **At a glance: "Sharing experimental data on EBRAINS" ** === 345 345 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 + 346 346 ((( 347 347 ==== ==== 348 348