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 Build Status Documentation Status Quality Gate Status Maintainability Rating Coverage 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, briefly summarized here:

  • Nodes
    • id: CURIE; required
    • name: string; recommended
    • category: string; broad high level type. Corresponds to node label in Neo4j
    • other properties
  • Edges
    • subject: CURIE; required
    • edge_label: CURIE; required; Corresponds to edge label in Neo4j
    • object: CURIE, required
    • relation: CURIE; required
    • other properties

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

Installation for Users

KGX is available on PyPI and you can install KGX via python pip.

Note: the installation of KGX requires Python 3.7+

pip install kgx

Installation for Developers

Python 3.7+ and Core Tool Dependencies

Note: the installation of KGX requires Python 3.7+

You should first confirm what version of Python you have running and upgrade to v3.7 as necessary, following best practices of your operating system. It is also assumed that the common development tools are installed including git, pip, and all necessary development libraries for your operating system.

Getting the repository

Go to where you wish to host your local project repository and clone the repository:

cd /path/to/your/local/git/project/folder
git clone https://github.com/NCATS-Tangerine/kgx.git

# then enter into the cloned project repository
cd kgx

Configuring a virtual environment for KGX

For convenience, make use of the Python venv module to create a lightweight virtual environment.

Note that you may also have to install the appropriate venv package for Python 3.7.

For example, under Ubuntu Linux, you might

sudo apt-get install python3.7-venv  

Once venv is available, type:

python3 -m venv venv
source venv/bin/activate

Installing Python Dependencies

The Python dependencies of the application need to be installed into the local environment using a version of pip matched to your Python 3.7+ installation (assumed here to be called pip3).

Again, follow the specific directives of your operating system for the installation.

For example, under Ubuntu Linux, to install the Python 3.7 matched version of pip, type the following:

sudo apt-get install python3-pip

which will install the pip3 command.

At this point, it is advisable to separately install the wheel package dependency before proceeding further (Note: it is assumed here that your venv is activated)

pip3 install wheel

After installation of the wheel package, install KGX:

pip3 install -r requirements.txt

To install KGX,

python3 setup.py install

To test installation was successful, run the following:

kgx --help

which invokes the KGX CLI tool.

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-0.2.2.tar.gz (59.9 kB view details)

Uploaded Source

Built Distributions

kgx-0.2.2-py3.8.egg (70.0 kB view details)

Uploaded Source

kgx-0.2.2-py3-none-any.whl (72.1 kB view details)

Uploaded Python 3

File details

Details for the file kgx-0.2.2.tar.gz.

File metadata

  • Download URL: kgx-0.2.2.tar.gz
  • Upload date:
  • Size: 59.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.32.2 CPython/3.7.3

File hashes

Hashes for kgx-0.2.2.tar.gz
Algorithm Hash digest
SHA256 e6ed8779c7068f3834404a29e42c695fb389e2cd3e3f34b1b5e6362d059be67f
MD5 c09fd59dd4ecd8e2ceeac374842c7624
BLAKE2b-256 95e615b3b8e83dce62677bde6a676913196b53dc0f70942dfa2e822769f4f0a8

See more details on using hashes here.

Provenance

File details

Details for the file kgx-0.2.2-py3.8.egg.

File metadata

  • Download URL: kgx-0.2.2-py3.8.egg
  • Upload date:
  • Size: 70.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.32.2 CPython/3.7.3

File hashes

Hashes for kgx-0.2.2-py3.8.egg
Algorithm Hash digest
SHA256 c6bad232902cd35c1bacccc45beceee894bc7a4af2422b3555013274ef5f3f1f
MD5 9a0cd8d62545b795cc4d5a2f0adb9826
BLAKE2b-256 ab7900932066927ab3fa2cce78b778e2ad22ad44e6f20e5257b4ca7ad4a6afc4

See more details on using hashes here.

Provenance

File details

Details for the file kgx-0.2.2-py3-none-any.whl.

File metadata

  • Download URL: kgx-0.2.2-py3-none-any.whl
  • Upload date:
  • Size: 72.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.32.2 CPython/3.7.3

File hashes

Hashes for kgx-0.2.2-py3-none-any.whl
Algorithm Hash digest
SHA256 0a2af6dba7bb3e6e593b050a42c3207e97b971f8a4a79eaf0c47b2919b67f4e6
MD5 b062f4b83b9ca41be9ed535e6518982c
BLAKE2b-256 b6a6ca4e957d19fcb96d8c7169f288a7e46710f1f30ce203b54a80e4528763cc

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