{"id":24562599,"url":"https://github.com/humanbrainproject/data-handling-tutorial","last_synced_at":"2025-03-16T23:14:08.725Z","repository":{"id":191650023,"uuid":"684611714","full_name":"HumanBrainProject/data-handling-tutorial","owner":"HumanBrainProject","description":null,"archived":false,"fork":false,"pushed_at":"2023-09-13T08:20:34.000Z","size":554,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":7,"default_branch":"main","last_synced_at":"2025-01-23T09:16:28.108Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/HumanBrainProject.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2023-08-29T13:48:53.000Z","updated_at":"2023-09-13T08:44:39.000Z","dependencies_parsed_at":"2023-08-30T23:56:30.685Z","dependency_job_id":null,"html_url":"https://github.com/HumanBrainProject/data-handling-tutorial","commit_stats":null,"previous_names":["humanbrainproject/data-handling-tutorial"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HumanBrainProject%2Fdata-handling-tutorial","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HumanBrainProject%2Fdata-handling-tutorial/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HumanBrainProject%2Fdata-handling-tutorial/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HumanBrainProject%2Fdata-handling-tutorial/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/HumanBrainProject","download_url":"https://codeload.github.com/HumanBrainProject/data-handling-tutorial/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243945623,"owners_count":20372897,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-01-23T09:16:32.976Z","updated_at":"2025-03-16T23:14:08.695Z","avatar_url":"https://github.com/HumanBrainProject.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"# EBRAINS Data Handling\n\nThis repository holds a collection of code examples that demonstrate how to handle data managed in the EBRAINS Knowledge Graph (KG) using the following tool packages:  \n- **EBRAINS KG Core Python SDK**: https://github.com/HumanBrainProject/kg-core-sdks    \n- **EBRAINS fairgraph**: https://github.com/HumanBrainProject/fairgraph  \n- **EBRAINS drive**: https://github.com/HumanBrainProject/ebrains-drive/  \n\nAlso helpful for handling EBRAINS data are:   \n- **EBRAINS KG Search**: https://search.kg.ebrains.eu/  \n- **EBRAINS KG QueryBuilder**: https://query.kg.ebrains.eu/  \n- **openMINDS**: https://openminds-documentation.readthedocs.io/en/latest/  \n\n## Installation\n\n**EBRAINS KG Core Python SDK**\n```\npip install ebrains-kg-core\n```\n\n**EBRAINS fairgraph**  \n```\npip install fairgraph\n```\n\n**EBRAINS drive**\n```\npip install ebrains_drive\n```\n\n### Set up a venv\nWe recommend to set up a venv as described [here](https://packaging.python.org/en/latest/guides/installing-using-pip-and-virtual-environments/#creating-a-virtual-environment).\n\nFor your convenience, you can install all the above packages by running\n```\npip install -r requirements.txt\n```\n\n## Background knowledge\n\nThe **EBRAINS Knowledge Graph** is a data management system with a graph database at it's core. A graph database is composed of nodes which store metadata in form of property-value pairs, and edges which define the relationship between nodes. Each node in a graph database receives a unique identifier and can be individually referenced. Data are typically described by the metadata of a multiple nodes and edges and different data can share the same nodes, building a searchable network.\n\nGraph databases are schema-less, meaning nodes and edges do not have to be constraint. This makes graph databases highly flexible and explicitly suitable for heterogenous data collections. However, to optimise the ability to query data in the graph database, the registration of nodes and edges have to be harmonised (constraint). For this purpose, the EBRAINS Knowledge Graph adopted the **openMINDS metadata framework**. The framework provides metadata models which are composed of interlinked metadata schemas that define the type of possible nodes, the content of a specfic node according to it's type, and the possible edges between the nodes within a graph database.\n\nBesides the graph database, the EBRAINS Knowledge Graph system includes supportive tooling or services for data registration, curation management, publication management, query building, automation environments, and statistics. Nearly all application programming interface (API) endpoints of the EBRAINS Knowledge Graph system require the authentication of a requesting user. For the EBRAINS Knowledge Graph system, the authorization of a user to read and/or write depends on the user's role. Within the graph database, roles can be defined globally, for publication stages (released vs in-progress), for specific virtual spaces, or for individual nodes.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhumanbrainproject%2Fdata-handling-tutorial","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhumanbrainproject%2Fdata-handling-tutorial","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhumanbrainproject%2Fdata-handling-tutorial/lists"}