Warning:  Due to planned infrastructure maintenance, the EBRAINS Wiki and EBRAINS Support system will be unavailable for up to three days starting Monday, 14 July. During this period, both services will be inaccessible, and any emails sent to the support address will not be received.

Attention: We are currently experiencing some issues with the EBRAINS Drive. Please bear with us as we fix this issue. We apologise for any inconvenience caused.


Last modified by adavison on 2024/11/13 11:30
From version 38.1
edited by patriziaduhr
on 2022/11/13 09:37
Change comment: There is no comment for this version
To version 14.1
edited by jan
on 2022/03/23 12:16
Change comment: There is no comment for this version

Summary

Details

Page properties
Parent
... ... @@ -1,1 +1,1 @@
1 -Collabs.swc-guide.WebHome
1 +Collabs.sw-curation-nest-desktop.WebHome
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.patriziaduhr
1 +XWiki.jan
Content
... ... @@ -1,5 +1,5 @@
1 1  (% class="wikigeneratedid" %)
2 -**For any questions or support directly reach out to [[Jan Gründling>>mailto:gruendling@uni-trier.de]].**
2 +**~*~*~* 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>>mailto:gruendling@uni-trier.de]].~*~****
3 3  
4 4  
5 5  (% class="wikigeneratedid" %)
... ... @@ -7,46 +7,37 @@
7 7  
8 8  == How to enter software metadata manually ==
9 9  
10 -You will receive an email after the curator has created a space for you in the Knowledge Graph. This email contains a link to a software instance and a software version instance in your Space. These are already linked to each other (by the attribute "Has Version" of the software instance).
10 +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>>url:https://editor.kg.ebrains.eu/]]. Just log in with your HBP credentials.
11 11  
12 -**Before explaining the editing process, here are some helpful links:**
12 +After you are logged in, you are probably prompted to choose a space in a view like below:
13 13  
14 -* A description of the fields of the software and software version instances and values that these fields may take: [[https:~~/~~/humanbrainproject.github.io/openMINDS/v2/core/v3/products/softwareVersion.html>>url:https://humanbrainproject.github.io/openMINDS/v2/core/v3/products/softwareVersion.html]] and [[https:~~/~~/humanbrainproject.github.io/openMINDS/v2/core/v3/products/software.html>>url:https://humanbrainproject.github.io/openMINDS/v2/core/v3/products/software.html]]
15 -* additional information for each attribute: [[https:~~/~~/github.com/bweyers/HBPVisCatalogue/wiki/Attribute-Descriptions>>url:https://github.com/bweyers/HBPVisCatalogue/wiki/Attribute-Descriptions]]
16 -* a detailed description of the software features: [[https:~~/~~/github.com/bweyers/HBPVisCatalogue/wiki/Identified-Software-Features>>url:https://github.com/bweyers/HBPVisCatalogue/wiki/Identified-Software-Features]]
14 +[[image:image-20220323113258-3.png||height="386" width="681"]]
17 17  
18 -**Editing the software and software version instances:**
16 +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.
19 19  
20 -To register your software, you will need to input information for the instance "Software" and for  "Software version". After clicking the links in your email, you will see an instance editor view like below:
18 +After that, you see the view below. now click on the little magnifyer glass symbol at the top.
21 21  
22 -[[image:guide1.JPG]]
20 +[[image:image-20220323120123-6.png||height="412" width="1032"]]
23 23  
24 -As you can see in the screenshot above, some fields are marked with an asterisk (*). These are required. Keep in mind that this is how you present your software publicly to potential end-users or other researchers. Therefore it would be nice if as many fields as possible are filled in.
22 +After that, you see this list on the left side:
25 25  
26 -Some fields can be of different types, such as the field "developer" and "Full documentation". In the case of developer it is possible to enter a person or an organisation. The possible types are selectable on the right above the respective field, as shown in the following screenshots:
24 +[[image:image-20220323121426-1.png||height="202" width="258"]]
27 27  
28 -[[image:guideDev.JPG||height="109" width="600"]]
29 29  
30 -[[image:guide21.JPG||height="142" width="600"]]
27 +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:
31 31  
32 -For example, if you want to create a new person, an editing field opens in the right column of the instance editor view as shown in the following screenshot.
29 +[[image:image-20220323120955-9.png||height="802" width="712"]]
33 33  
34 -[[image:guide6.JPG]]
35 35  
36 -If you are not sure which type to use, please refer to the descriptions linked above or contact the curator.
32 +Now you can start entering the information on your data! Fields marked with an asterisk (*) are required. When you arrive at the "Has version" field, you can create one or more versions of your software to be curated.
37 37  
38 -After you have entered your information on the software, **do not forget to save your changes **(see screenshot below) and contact the curator.
34 +After you have entered the software, **do not forget to save your changes!**
39 39  
40 -[[image:guide4.JPG||height="189" width="400"]]
36 +[[image:image-20220323121238-10.png||height="170" width="382"]]
41 41  
42 -The curators will check the new software instances and move them to the correct space.
43 43  
44 -=== How to update an existing Software instances ===
39 +That's it. When you are done, just contact the curators via your ticket.
45 45  
46 -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".
47 -
48 -To make updating easier, we have already placed a copy of your last software version instance in the KG space that was created for you. 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 email or the ticket assigned with this case.
49 -
50 50  == How to upload software metadata programmatically ==
51 51  
52 52  To create a valid jsonld file, please use the [[API>>https://core.kg.ebrains.eu/swagger-ui/index.html?configUrl=/v3/api-docs/swagger-config]].
... ... @@ -56,4 +56,4 @@
56 56  
57 57  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.
58 58  
59 -[[image:image-20220323111341-2.png||height="74" width="186"]]
50 +[[image:image-20220323111341-2.png]]
guide1.JPG
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.patriziaduhr
Size
... ... @@ -1,1 +1,0 @@
1 -95.5 KB
Content
guide2.JPG
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.patriziaduhr
Size
... ... @@ -1,1 +1,0 @@
1 -16.3 KB
Content
guide21.JPG
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.patriziaduhr
Size
... ... @@ -1,1 +1,0 @@
1 -17.0 KB
Content
guide4.JPG
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.patriziaduhr
Size
... ... @@ -1,1 +1,0 @@
1 -13.9 KB
Content
guide5.JPG
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.patriziaduhr
Size
... ... @@ -1,1 +1,0 @@
1 -174.3 KB
Content
guide6.JPG
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.patriziaduhr
Size
... ... @@ -1,1 +1,0 @@
1 -174.3 KB
Content
guideDev.JPG
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.patriziaduhr
Size
... ... @@ -1,1 +1,0 @@
1 -16.3 KB
Content
image-20220323152326-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.jan
Size
... ... @@ -1,1 +1,0 @@
1 -70.9 KB
Content