Skip to content

jkobject/benGRN

Folders and files

NameName
Last commit message
Last commit date

Latest commit

6367a02 · Feb 24, 2025
Dec 23, 2024
Feb 10, 2025
Jun 20, 2024
Aug 6, 2024
Aug 7, 2024
Oct 23, 2024
Aug 14, 2024
Oct 8, 2024
Dec 13, 2023
Dec 13, 2023
Dec 13, 2023
Jan 29, 2025
Jan 5, 2024
Dec 13, 2023
Jan 29, 2025
Jan 27, 2025
Nov 13, 2024
Aug 6, 2024
Aug 11, 2024
Feb 24, 2025
Oct 9, 2024

Repository files navigation

bengrn

codecov CI PyPI version Downloads Downloads Downloads GitHub issues Code style: black DOI

Benchmark your gene regulatory networks inference algorithm (from scRNAseq or bulk RNAseq dataset) with BenGRN

The package is supposed to work with GRnnData and only uses biological ground truth datasets.

It can run Genie3 & pyscenic on your data as a comparison

It has 3 main different types of key ground truth data to compare your GRN to:

  • Mc Calla et al.'s ChIP+Perturb ground truth
  • omnipath's literature curated ground truth
  • genome wide perturb seq 's dataset

You can find the documentation here

Install it from PyPI

pip install bengrn

Install it locally and run the notebooks:

git clone https://github.com/jkobject/benGRN.git
pip install -e benGRN

Usage

from bengrn import BenGRN
from bengrn import some_test_function

# a GRN in grnndata formart
grndata

BenGRN(grndata).do_tests()
#or
some_test_function(grndata)

see the notebooks in docs:

  1. omnipath
  2. genome wide perturb seq
  3. Mc Calla

/!\ offline mode

If you want to run the notebooks offline, you need to download the data first.

from bengrn import download_perturb_gt, download_GT_db, download_sroy_gt

download_perturb_gt()

Development

Read the CONTRIBUTING.md file.

Awesome Benchmark of Gene Regulatory Networks created by @jkobject