Skip to main content
Donate to the Python Software Foundation or Purchase a PyCharm License to Benefit the PSF! Donate Now

The python sister project to CortexJDK

Project description

Travis-CI Build Status
Coverage Status Coverage Status
PyPI Package latest release PyPI Wheel Supported versions
Supported implementations Commits since latest release
Documentation Status

Cortexpy is a Python package for sequence analysis using linked and colored De Bruijn graphs such as the ones created by Cortex and Mccortex. This project aims to mirror many of the features contained in CortexJDK.

Cortexpy also comes with a command-line tool for basic inspection and manipulation of Cortex graphs with and without links.


The audience of cortexpy is researchers working with colored De Bruijn graphs and link information in Cortex and Mccortex format.

Free software

Cortexpy is free software; you can redistribute it and/or modify it under the terms of the Apache License version 2.0. Contributions are welcome. Please join us on GitHub.


pip install cortexpy


For more information, please see cortexpy documentation.

Citing cortexpy

If you use cortexpy in your work, please consider citing:

Akhter, Shirin, Warren W. Kretzschmar, Veronika Nordal, Nicolas Delhomme, Nathaniel R. Street, Ove Nilsson, Olof Emanuelsson, and Jens F. Sundström. “Integrative analysis of three RNA sequencing methods identifies mutually exclusive exons of MADS-box isoforms during early bud development in Picea abies.” Frontiers in Plant Science 9 (2018).


This code is maintained by Warren Kretzschmar <>. For bugs, please raise a GitHub issue.


  1. Install conda.

  2. Download development and testing tools:

    conda env create -f environment.yml -n my-dev-environment
  3. Activate development environment:

    conda activate my-dev-environment

All remaining commands in the development section need to be run in an activated conda dev environment.


make test

Deploy new cortexpy version to pypi

Requires access credentials for pypi.

make deploy

Building the docs

The documentation is automatically built by read-the-docs on push to master. To build the documentation manually:

# install sphinx dependencies
pip install docs/requirements.txt

make docs

Updating the dev environment

This section is experimental because it does not work on travis-CI yet.

# Create a new env from the high-level requirements file
conda env create -f environment.yml -n another-dev-env

# activate the new environment
conda activate another-dev-env

# save new env to environment.lock.yml
make lock

Project details

Release history Release notifications

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
cortexpy-0.46.4-cp36-cp36m-macosx_10_7_x86_64.whl (298.9 kB) Copy SHA256 hash SHA256 Wheel cp36
cortexpy-0.46.4.tar.gz (208.9 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page