Skip to main content

Basic commandline client for siibra - a software toolsuite for interacting with brain atlases

Project description

License

siibra - Software interface for interacting with brain atlases

Copyright 2020-2022, Forschungszentrum Jülich GmbH

Authors: Big Data Analytics Group, Institute of Neuroscience and Medicine (INM-1), Forschungszentrum Jülich GmbH

siibra is a Python client for working with brain atlas frameworks that integrate multiple brain parcellations and reference spaces across different spatial scales, and connect them with a multimodal regional data features. It aims to facilitate the programmatic and reproducible incorporation of brain region features from different sources into reproducible neuroscience workflows.

This repository implements a basic commandline interface (CLI) for siibra.

Note: ``siibra-cli`` is still in development. While care is taken that it works reliably, its API is not yet stable and you may still encounter bugs when using it.

siibra provides structured acccess to parcellation schemes in different brain reference spaces, including volumetric reference templates at both macroscopic and microscopic resolutions as well as surface representations. It supports both discretely labelled and continuous (probabilistic) parcellation maps, which can be used to assign brain regions to spatial locations and image signals, to retrieve region-specific neuroscience datasets from multiple online repositories, and to sample information from high-resolution image data. Among the datasets anchored to brain regions are many different modalities from in-vivo and post mortem studies, including regional information about cell and transmitter receptor densties, structural and functional connectivity, gene expressions, and more.

siibra is mainly developed by the Human Brain Project for accessing the EBRAINS human brain atlas. It stores much of its contents in the EBRAINS Knowledge Graph, and is designed to support the OpenMINDS metadata standards. Its functionalities include common actions known from the interactive viewer siibra explorer hosted on EBRAINS. In fact, the viewer is a good resource for exploring siibra’s core functionalities interactively: Selecting different parcellations, browsing and searching brain region hierarchies, downloading maps, identifying brain regions, and accessing multimodal features and connectivity information associated with brain regions. Feature queries in siibra are parameterized by data modality and anatomical location, while the latter could be a brain region, brain parcellation, or location in reference space. Beyond the functionality of siibra-explorer, the Python library also supports a range of data analysis features suitable for typical neuroscience workflows.

siibra hides much of the complexity that would be required to collect and interact with the individual paracellations,templates andd data repositories. By encapsulating many aspects of interacting with different maps and reference templates spaces, it also minimizes common errors like misinterpretation of coordinates from different reference spaces, mixing up label indices of brain regions, or utilisation of inconsistent versions of parcellation maps. It aims to provide a safe way of using maps defined across multiple spatial scales for reproducible analysis.

Installation

siibra-cli is available on pypi. To install the latest released version, simply run pip install siibra-cli. In order to work with the latest version from github, use pip install git+https://github.com/FZJ-INM1-BDA/siibra-cli.git@main.

Access to EBRAINS

siibra retrieves much of its data from the EBRAINS Knowledge Graph, which requires authentication. Therefore you have to provide an EBRAINS authentication token for using all features provided by siibra. Please make sure that you have a valid EBRAINS user account by registering to EBRAINS.

Help

If you run into issues, please open a ticket on EBRAINS support or directly file bugs and feature requests on github.

Acknowledgements

This software code is funded from the European Union’s Horizon 2020 Framework Programme for Research and Innovation under the Specific Grant Agreement No. 945539 (Human Brain Project SGA3).

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

siibra_cli-0.1a2.tar.gz (10.7 kB view details)

Uploaded Source

Built Distribution

siibra_cli-0.1a2-py3-none-any.whl (11.7 kB view details)

Uploaded Python 3

File details

Details for the file siibra_cli-0.1a2.tar.gz.

File metadata

  • Download URL: siibra_cli-0.1a2.tar.gz
  • Upload date:
  • Size: 10.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.0 CPython/3.9.12

File hashes

Hashes for siibra_cli-0.1a2.tar.gz
Algorithm Hash digest
SHA256 cf568dc7f9c418413dd9c70d0a96ae982ef79dc8ca1d18b02f7a291889f8ec08
MD5 7ebc58d10df32018f7110bc73e0b8e68
BLAKE2b-256 90ab4a2a8735d4db6e02ed6f739e805265726a17f8d00f9a3ac6957336723ad2

See more details on using hashes here.

File details

Details for the file siibra_cli-0.1a2-py3-none-any.whl.

File metadata

  • Download URL: siibra_cli-0.1a2-py3-none-any.whl
  • Upload date:
  • Size: 11.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.0 CPython/3.9.12

File hashes

Hashes for siibra_cli-0.1a2-py3-none-any.whl
Algorithm Hash digest
SHA256 30fc2351573fc327f8ce69b020c60cb94e29ee1c2132451d3e4f306affb353d3
MD5 1d44dc415ae095ef32c0e5c6b5495f41
BLAKE2b-256 5e39d7ce13938f9598700ddc1041fd80ca23f21638bb623a301e3815be784b6c

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page