Summary

• Page properties (2 modified, 0 added, 0 removed)

Details

Page properties

Author

...	...	@@ -1,1 +1,1 @@
1		-XWiki.ingrreit
	1	+XWiki.adavison

Content

...	...	@@ -211,11 +211,89 @@
211	211	=== Step by Step - Models ===
212	212
213	213
214		-~1. Request curation using the [[Curation request form>>https://nettskjema.no/a/277393#/]]. You will be contacted by a curator with more information.
	214	+==== 1. Start early ====
215	215
	216	+It is not necessary to wait until you are ready to publish to register your model with EBRAINS.
216	216
217		-//Additional information will be added soon.//
	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.
218	218
	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	+
219	219	----
220	220
221	221	=== Step by Step - Software ===
...	...	@@ -247,9 +247,6 @@
247	247	(% class="box floatinginfobox" %)
248	248	(((
249	249	[[[[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]]
250		-
251		-(% style="text-align: center;" %)
252		-//openMINDS GitHub//
253	253	)))
254	254
255	255	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]].