Last modified by maaike on 2022/07/05 20:42
From version 18.1
edited by maaike
on 2022/06/23 11:15
Change comment: There is no comment for this version
To version 21.2
edited by maaike
on 2022/06/23 12:29
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -28,7 +28,7 @@
28 28  
29 29  The Knowledge Graph search user inferface is a user-friendly interface for accessing and extracting data and metadata. Use of the Knowledge Graph search is free and most datasets are open to the public. Human datasets with identifiable information can only be accessed with an EBRAINS account.
30 30  
31 -Go to the Search UI: [https:~/~/search.kg.ebrains.eu.](https:~/~/search.kg.ebrains.eu)
31 +Go to the Search UI: [[https:~~/~~/search.kg.ebrains.eu/>>https://search.kg.ebrains.eu/]]
32 32  
33 33  ==== Refine search ====
34 34  
... ... @@ -59,10 +59,38 @@
59 59  
60 60  In this dataset, a number of subjects were used with a C57BL/6J (wildtype) genotype. These were 4-9 months old (adult mice) with a weight between 38 - 47 gram. They were tested three times under aneasthesia, which is captured by the "studied states" of the subject. Additional details regarding the tests is stored under additional remarks (currently not visible in the image).
61 61  
62 -= Knowledge Graph Query Builder =
62 += Programmatic access (API) =
63 63  
64 -= =
64 +The EBRAINS Knowledge Graph provides convenient tools and APIs for the implementation of queries into your scripts.
65 65  
66 +=== Request permission ===
67 +
68 +To be able to access the Knowledge Graph (KG) programmatically, you require:
69 +
70 +1. An EBRAINS account. Register for an account here: [[https:~~/~~/ebrains.eu/register/>>https://ebrains.eu/register/]]
71 +1. Register and request credentials for your KG client by emailing support@ebrains.eu
72 +
73 +=== Query Builder ===
74 +
75 +The query builder allows you to make, save, and reuse complex queries without any knowledge of graph query languages.
76 +
77 +Go to the Query Builder: [[https:~~/~~/query.kg.ebrains.eu>>https://query.kg.ebrains.eu/#state=6a41dd5b-3cf9-4263-8a65-83d41f27677a&session_state=638c33f5-4551-4d70-8b1d-a5c900aa62d0&code=300f25d8-caac-4576-9a21-195ccc93fd31.638c33f5-4551-4d70-8b1d-a5c900aa62d0.4214dba9-b6d0-4331-9837-3e75a10cda14]]
78 +
79 +==== Select a category ====
80 +
81 +A query for the Knowledge Graph is always executed against a specific data structure (e.g. a "Dataset version"). First select the data structure for your query.
82 +
83 +[[image:QB1.png||alt="Step 1: Select a category" height="520" width="700"]]
84 +
85 +
86 +==== Select a modality/experimental approach ====
87 +
88 +Similar to the facetted filters in the Knowledge Graph Search UI, we can refine our query by defining the experimental approach of our interest, for example electrophysiology.
89 +
90 +To ensure that all dataset versions with electrophysiology are queried, and none of the dataset versions without electrophysiology, we make this property required and we apply a filter to the label we are searching for (i.e. electrophysiology).
91 +
92 +[[image:QBstep2.png||alt="Step 2: Select modality" height="541" width="700"]]
93 +
66 66  = Who has access? =
67 67  
68 68  Describe the audience of this collab.
QB1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.maaike
Size
... ... @@ -1,0 +1,1 @@
1 +141.9 KB
Content
QBstep2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.maaike
Size
... ... @@ -1,0 +1,1 @@
1 +84.6 KB
Content