EBRAINS Knowledge Graph guide for software curation

Version 24.3 by jan on 2022/09/23 10:47

*** This Guide is not complete yet and needs further extension. For any questions or support directly reach out to Jan Gründling.***

This guide provides a starting point and reference for the process of entering information about your software into the EBRAINS Knowledge Graph (KG). There are two ways, the manual and the programmatical one:

How to enter software metadata manually

Fields marked with an asterisk (*) are required. When you are done, just contact the curators by answering to your ticket email.

To register your software, you will need to input information for the instance "Software" and for  "Software version". After clicking the links above, you will see an instance editor view like below:

image-20220323152326-1.png

After you have entered and information on the software, do not forget to save your changes!

-> image-20220323121238-10.png

How to update an existing Software instances

If you have registered a software previously, updating means adding a new instance of type "Software version". Curators will later link it to the existing instance of type "Software".

To make updating easier, we have already placed a copy of your last software version instance in the KG space that belongs to this collab. You can use that copy and just change the fields that require changes. Again - if you made all changes that you consider necessary, let the curator know via the ticket assigned with this case.

How to upload software metadata programmatically

To create a valid jsonld file, please use the API.

Authorizing for API usage.

Before using it, you need to authorize, using the "Authorize" button found in the top right corner of the API documentation (see below) or by using a service account.

image-20220323111341-2.png