Skip to main content

A Python library and set of command line utilities for exchanging Knowledge Graphs (KGs) that conform to or are aligned to the Biolink Model.

Project description

Knowledge Graph Exchange

Python Run testsDocumentation Status Quality Gate Status Maintainability Rating Coverage PyPI Docker

KGX (Knowledge Graph Exchange) is a Python library and set of command line utilities for exchanging Knowledge Graphs (KGs) that conform to or are aligned to the Biolink Model.

The core datamodel is a Property Graph (PG), represented internally in Python using a networkx MultiDiGraph model.

KGX allows conversion to and from:

KGX will also provide validation, to ensure the KGs are conformant to the Biolink Model: making sure nodes are categorized using Biolink classes, edges are labeled using valid Biolink relationship types, and valid properties are used.

Internal representation is a property graph, specifically a networkx MultiDiGraph.

The structure of this graph is expected to conform to the Biolink Model standard, as specified in the KGX format specification.

In addition to the main code-base, KGX also provides a series of command line operations.

Installation

The installation for KGX requires Python 3.7 or greater.

Installation for users

Installing from PyPI

KGX is available on PyPI and can be installed using pip as follows,

pip install kgx

To install a particular version of KGX, be sure to specify the version number,

pip install kgx==0.5.0

Installing from GitHub

Clone the GitHub repository and then install,

git clone https://github.com/biolink/kgx
cd kgx
python setup.py install

Installation for developers

Setting up a development environment

To build directly from source, first clone the GitHub repository,

git clone https://github.com/biolink/kgx
cd kgx

Then install the necessary dependencies listed in requirements.txt,

pip3 install -r requirements.txt

For convenience, make use of the venv module in Python3 to create a lightweight virtual environment,

python3 -m venv env
source env/bin/activate

pip install -r requirements.txt

To install KGX you can do one of the following,

pip install .

# OR 

python setup.py install

Setting up a testing environment

KGX has a suite of tests that rely on Docker containers to run Neo4j specific tests.

To set up the required containers, first install Docker on your local machine.

Once Docker is up and running, run the following commands:

docker run -d --name kgx-neo4j-integration-test
            -p 7474:7474 -p 7687:7687
            --env NEO4J_AUTH=neo4j/test
            neo4j:3.5.25
docker run -d --name kgx-neo4j-unit-test
            -p 8484:7474 -p 8888:7687
            --env NEO4J_AUTH=neo4j/test
            neo4j:3.5.25

Note: Setting up the Neo4j container is optional. If there is no container set up then the tests that rely on them are skipped.

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

kgx-1.0.0b0.tar.gz (68.0 kB view details)

Uploaded Source

Built Distributions

kgx-1.0.0b0-py3.8.egg (130.4 kB view details)

Uploaded Source

kgx-1.0.0b0-py3-none-any.whl (133.9 kB view details)

Uploaded Python 3

File details

Details for the file kgx-1.0.0b0.tar.gz.

File metadata

  • Download URL: kgx-1.0.0b0.tar.gz
  • Upload date:
  • Size: 68.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.56.0 CPython/3.8.1

File hashes

Hashes for kgx-1.0.0b0.tar.gz
Algorithm Hash digest
SHA256 e398c36ed322fa7c20b500c81e656955d8ca4a674a0a9e8fc386a60ee67ae81e
MD5 3df2e7bd4d73f4e12978f131356e6dfd
BLAKE2b-256 26d5ed33b0a7188fdfbbd8d095db69d5e1cf29c7e2dc9c2ec35eebde0ebc78cf

See more details on using hashes here.

Provenance

File details

Details for the file kgx-1.0.0b0-py3.8.egg.

File metadata

  • Download URL: kgx-1.0.0b0-py3.8.egg
  • Upload date:
  • Size: 130.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.56.0 CPython/3.8.1

File hashes

Hashes for kgx-1.0.0b0-py3.8.egg
Algorithm Hash digest
SHA256 5b81164496a3bb8e5a772bdc24dd2999ce79c6f5a4b71b4bbf5495466565842d
MD5 234deba2d2f84bcff225ce89551bcd99
BLAKE2b-256 f7e743e49e09760425dd8bcdbc686b90d88160c078df814df0afbd25b128c87d

See more details on using hashes here.

Provenance

File details

Details for the file kgx-1.0.0b0-py3-none-any.whl.

File metadata

  • Download URL: kgx-1.0.0b0-py3-none-any.whl
  • Upload date:
  • Size: 133.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.56.0 CPython/3.8.1

File hashes

Hashes for kgx-1.0.0b0-py3-none-any.whl
Algorithm Hash digest
SHA256 4566ddaf3b104bf745b9f29f5af52fc9f3ed0ec091a0895a124c75c290c5d29f
MD5 0c2c959319d883fd467fbc559298cd01
BLAKE2b-256 fe626fbede2b719041cd229bdec9b0b6098fd74c61e53d485f668ad55357644f

See more details on using hashes here.

Provenance

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