Changes for page data-curation-copy

Last modified by eapapp on 2023/07/04 16:46

From version 195.2
edited by adavison
on 2023/06/14 15:36
Change comment: There is no comment for this version
To version 192.1
edited by eapapp
on 2023/06/13 10:26
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.adavison
1 +XWiki.eapapp
Content
... ... @@ -211,89 +211,11 @@
211 211  === Step by Step - Models ===
212 212  
213 213  
214 -==== 1. Start early ====
214 +~1. Request curation using the [[Curation request form>>https://nettskjema.no/a/277393#/]]. You will be contacted by a curator with more information.
215 215  
216 -It is not necessary to wait until you are ready to publish to register your model with EBRAINS.
217 217  
218 -By registering a model early in your project, you can take advantage of EBRAINS tools
219 -to keep track of simulations and to share them with your collaborators.
217 +//Additional information will be added soon.//
220 220  
221 -==== 2. Create/choose a Collab workspace ====
222 -
223 -We use EBRAINS Collaboratory "collab" workspaces to help manage the model curation process.
224 -
225 -In particular, we use collab membership (the "Team") to control who can view or edit your model metadata prior to publication.
226 -
227 -It is up to you whether you create a new collab for each model, or reuse an existing collab
228 -(it is no problem to have multiple models associated with a single collab).
229 -
230 -Collabs are also useful for storing simulation results, adding documentation for your model,
231 -and/or providing tutorials in Jupyter notebooks.
232 -
233 -==== 3. Upload code ====
234 -
235 -We recommend storing model code and/or configuration files in an online Git repository, for example on GitHub.
236 -This repository should be public when you publish the model, but a private repository can be used for model development.
237 -
238 -Alternatively, you can upload code to the Collab Drive or Bucket storage.
239 -
240 -==== 4.Submit metadata ====
241 -
242 -We recommend submitting metadata using the Model Catalog app, installed in your collab.
243 -
244 -To install it:
245 -
246 -1. click the "+ Create" button
247 -1. in the "Create Page" form, add a title, such as "Model Catalog", and select "Community App", then click "Create"
248 -1. scroll down until you find the "Model Catalog" app, click "Select", then "Save & View"
249 -
250 -You will then see a table of all the models and validation tests associated with this collab.
251 -If this is your first time using the app, the table will probably be empty.
252 -To add your model, click "+", fill in the form, then click "Add model".
253 -
254 -As development of your model proceeds, you can easily register new versions of the code,
255 -and new parameterizations by clicking "Add new version".
256 -
257 -If you prefer not to use the app, you can instead fill in the [[Curation request form>>https://nettskjema.no/a/277393#/]].,
258 -and you will be contacted by e-mail with further instructions.
259 -
260 -==== 5. Provide a reference dataset ====
261 -
262 -Once you're ready to publish your model entry in the EBRAINS Knowledge Graph,
263 -we encourage you to provide a dataset containing the simulation results produced by your model,
264 -following the process under "Step by step - Data" above.
265 -
266 -These reference data will be linked to the model, and will be helpful to anyone trying to
267 -reuse your model.
268 -
269 -We will soon introduce a "Reproducible" badge for all models that include a reference dataset,
270 -and whose simulation results can be reproduced by an EBRAINS curator.
271 -
272 -==== 6. Request publication, preview and publish ====
273 -
274 -Until you request your model entry to be published in the EBRAINS Knowledge Graph,
275 -only members of the collab will be able to view the model entry, in the Model Catalog app
276 -or using the Model Validation Python client.
277 -
278 -After publication, the model will appear in the [[EBRAINS public search results>>https://search.kg.ebrains.eu/?category=Model||rel="noopener noreferrer" target="_blank"]], and will receive a DOI.
279 -
280 -To request publication, [[contact EBRAINS support>>https://ebrains.eu/support||rel="noopener noreferrer" target="_blank"]], providing the collab name and the model name or ID.
281 -
282 -
283 -Curators will then perform a number of checks:
284 -
285 -1. Does the model description provide sufficient context to understand the purpose and use of the model?
286 -1. Does the code repository contain a licence file, explaining the conditions for reusing the code?
287 -1. Does the model have a clearly defined version identifier (e.g. v1.0). For models in a Git repository, the version identifier should match the name of a tag or release.
288 -
289 -The curators will also take a snapshot of your model code.
290 -
291 -* For models in public Git repositories, we archive a copy of the repository in Software Heritage.
292 -* For models in a collab Bucket or Drive, we make a read-only copy of the code in a public container in the EBRAINS repository.
293 -
294 -Once this is done, you will be invited to review a preview of how the model entry will appear in the KG Search,
295 -and will have the opportunity to request modifications prior to approval and publication.
296 -
297 297  ----
298 298  
299 299  === Step by Step - Software ===
... ... @@ -322,11 +322,6 @@
322 322  
323 323  == **The openMINDS metadata framework** ==
324 324  
325 -(% class="box floatinginfobox" %)
326 -(((
327 -[[[[image:https://github.com/HumanBrainProject/openMINDS/raw/main/img/light_openMINDS-logo.png||alt="openMINDS logo" height="87" width="164"]]>>https://github.com/HumanBrainProject/openMINDS]]
328 -)))
329 -
330 330  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]].
331 331  
332 332  For feedback, requests, or contributions, please get in touch with the openMINDS development team via
... ... @@ -443,6 +443,7 @@
443 443  |(% colspan="2" %)**Use your research product in an interactive publication**
444 444  |[[image:LivePaper_screenshot.PNG]]|Add your data, models or software to a// Live paper. //Read more about [[Live papers on ebrains.eu>>https://www.ebrains.eu/data/live-papers/live-papers]].
445 445  
363 +
446 446  ----
447 447  
448 448  ==== **Add a tutorial or learning resource ** ====