EBRAINS Knowledge Graph guide for software curation

Version 11.2 by jan on 2022/03/23 12:11

*** This Guide is not complete yet and needs further extension. It is in an alpha version. 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

To manually input meta data of your software into the KG, you use a tool called "KG Editor". The KG Editor can be reached at HBP Knowledge Graph Editor. Just log in with your HBP credentials.

After you are logged in, you are probably prompted to choose a space in a view like below:

image-20220323113258-3.png

From the available choices (should not be too many in your case) choose the one that corresponds to the title of your software. Something like swcuration-{your_software_name} should apply.

After that, you see the view below. now click on the little magnifyer glass symbol at the top.

image-20220323120123-6.png

After that, you see on the left side this list:

image-20220323120352-7.png

To register your software, you will need to create one instance "Software" and one or more instances "Software version". To create instances, just click the small +button that appears when you are hovering over the respective list entry. We recommed starting with "Software". After clicking the plus icon you will see a view like below:

image-20220323120955-9.png

Now you can start entering the information on your data!

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